Supported Platforms

Elixir Repertoire Server 7.x supports any Java SE version 5.0 Runtime Environment (JRE) update 8 (or later) compliant platforms such as the following:

• Windows
• Solaris (including 10)
• AIX
• Linux
• HP-UX
• Macintosh OS X (10.2 or higher)

Hardware Requirements

Elixir software is able to run on a usual entry level system available in the market. As long as the operating system and the Java runtime is able to operate smoothly, Elixir software itself only requires an incremental amount of RAM. The primary demand for hardware resources comes from the volume of data retrieval (requiring more RAM), the complexity of rendering logic (speed of processor will benefit), and concurrency of rendering (multiple processors or cores will help).

You may refer to the "System requirements for the Java Runtime Environment 5.0" at http://www.java.com/en/download/help/5000011000.xml.

A recommended minimum configuration would be 512MB, and for more advanced usage, 1GB or even 2GB is common.

A total of 140 MB disk space is recommended. This consists of the following:

• 40MB for the Elixir Repertoire Server software, documentations and samples.
• Up to 80 MB for the Java runtime (depending on the version)
• 20 MB reserved space for other 3rd party add-on software like database drivers. Intel® Pentium® 4 Processor with 800MHz or more is required

Installing Elixir Repertoire Server 7.x

1. Ensure Java is pre-installed.
   
   • The software strictly requires a Java VM version 5_08 to start
     
   • Tip, To test if your system is Java enabled, open a Command Prompt
     or equivalent Console and enter

     java -version

     . This will show
     the version of Java installed in your system, if any.
     
     
   • StartServer / StopServer script reference to JAVA_HOME that is defined on the machine.
     If it is not defined, modify the script to the JVM location.
     
     
   • Default of maximum 512 MB as defined in StartServer script.
     Ensure that it does not exceed the available memory on the machines.
     



2. Unzip or unpack the archive (e.g. Repertoire-Server-7.x.x.zip) to a suitable location on your machine.
   
   • To unzip ElixirReportServer.zip, you can use either using a GUI
     utility like winzip or type the following command at the command
     prompt to unzip ElixirReportServer.zip into a location of your
     choice which will be referred to as .
     

                    unzip ElixirReportServer.zip
                 

     
     or
     

                  jar -xvf ElixirReportServer.jar 
                    

     
     (You will need Java to be installed to extract a jar file)
     
     

     where unzip ElixirReportServer.zip is replaced by the name of your
     Elixir Report package file name.
     
     This command will create an ElixirReportServer sub-directory (in
     the current directory) which contains everything that you needed to
     run Elixir Report Server.
     




3. Deploying License Keys
   
   • The license key is provided as a Java Archive(JAR). The key can be
     deployed using the command line with:
     
     In Console mode:-
     

                  java -jar product-license-deployer.jar -c
                

     
     In Graphical Interface mode:-
     

                  java -jar product-license-deployer.jar
               

   • You may also manually deploy the key by unjaring (unzip) the key file.
     file. If deploying manually, copy the license key to the your user
     License can be deployed / defined in either
     
     • $ERS_HOME/<ext> =Supported from version 6.0 onwards=
     • $USER_HOME
     • classpath



4. Third Party Library
   
   • To be placed in $ERS_HOME/<ext>.
   
   
   • Includes JDBC driver, customed Java classes.
   
   



5. Running the Report Server
   • The default Server Listener Port is 8080.
   
   
   • To run the server for Unix-like operating systems, use the
     startServer.sh. You should then see log messages from Elixir
     Report Server components as they are deployed in the server log
     file (look in the log directory for server.log).
     
     The last few messages should say similar as below:-
     

         Server 7.1.0 [20070822: build 501]<br>
         Copyright 2007 Elixir Technology Pte Ltd<br>
      

   
   
   • Alternatively, you can use the Java Client application shipped with
     the report server to the test the connection to the report server.
     The Java Client application can be found in the
     $ERS_HOME\clients\demo\JavaClientApp
     



6. Troubleshooting the report server (Optional)
   
   • f the report server is not running, you might have to add in the
     "-Djava.awt.headless=true" in the startServer.sh then re-start the
     report server.
     
     For example:
     
     

          $JAVACMD -mx512M -Djava.awt.headless=true -Delixir.home=..<br>
          -Delixir.config=../config -jar<br>
          -Djava.security.auth.login.config=../config/auth.conf<br>
          -Djava.security.policy=../config/java2.policy<br>
          RepertoireServer-Launcher.jar<br>
          

   • Check through the server.log for possible cause.



7. You should only configure the report server after you have verified,
   the report server is properly installed and running.