INSTALLING ELIXIR REPERTOIRE SERVER AS A WINDOWS SERVICE

Java Service wrapper is a third party product open source by tanukisoftware 
at http://wrapper.tanukisoftware.org/doc/english/introduction.html. 

Java Virtual Machine 
====================
We assume that you have current 32-bit JDK version (Java 6 or greater) 
installed in your system.  The open source version of the Tanuki software
is only for 32-bit versions. Please read their web site, mentioned above
for details of the available 64-bit versions. 

You may specify specific a location for the java VM in the 
windows-service\wrapper.conf file:

wrapper.java.command=java

CRITICAL STEPS
==============

First, copy the window-service-wrapper.exe to the bin directory.

When running as a Windows service, the user home directory path is not set. 
As a result the server license key cannot be loaded by default. 
You should copy the server license key, ElixirRepertoire8-Server-license.txt to 
the RepertoireServer\ext directory to ensure that it will be found.

Also, please edit the bin/windows-service/wrapper.conf file to set your 
user home path,   

wrapper.java.additional.5=-Duser.home=XXX

Where XXX is your specified user home path.


The steps to deploy Elixir Repertoire Server as a Windows service are: 

1. The directory named bin/windows-service contains all the necessary 
   files to run RepertoireServer as an windows service. All you need 
   to do is to execute windows-install-service.bat. 
   You may test to see if the install was successful by running the 
   console based application script, windows-ERS-app.bat.

2. The bin/windows-service  directory contains a file called wrapper.conf 
   which is controlling all the configurations needed for the application 
   as classpath, JVM parameters. 

3. The bin/windows-service directory contains a dll called wrapper.dll 
   which is doing the linking between Java application and Windows service. 
   It has the necessary jar files required for running the application.

4. The logs directory will create a file named Wrapper.log which will give 
   all the log messages during the process. However you can see that this 
   file size is increasing rapidly every time the service is started and 
   so may need a manual delete of this file. If you do not want to do so, 
   to limit the size of the wrapper.log file, you should enable log rolling 
   and then set the maximum number of log files.  For example, the following 
   properties will configure the Wrapper to roll the log file when it reaches 
   1MB in size and then keep the 5 most recent files. This will use a maximum 
   of 5MB of disk space. You can set the numbers even smaller of course if 
   you want.(Use "k" for kilobytes)

   wrapper.logfile.maxsize=512k
   wrapper.logfile.maxfiles=5

   If you really want to completely disable logging to the file, you can do 
   so by simply setting the log level to the file to NONE like this:

   wrapper.logfile.loglevel=NONE

5. Double click on windows-service/windows-install-service.bat after completing 
   the above steps, go to  Control Panel, Administrative Tools, Services, you 
   can see Elixir Report Server installed as a service there. Right click and 
   start it so that now Report will run as a service. 
   Similarly you may stop it as well.

6. To remove it from the list of services, execute 
   windows-service/windows-uninstall-service.bat, which will stop the service 
   if it is running and then will remove it from the list of installed services.

7. As this product is a third party product, please refer to
   http://wrapper.tanukisoftware.org for documentation and details. 
   For specific issues related to Elixir Repertoire Server please send your query 
   to Elixir Support. The support information can be found at our 
   home page http://www.elixirtech.com/  

=================
JAVA Service wrapper license is in the windows-service directory. 
You can get further details at http://wrapper.tanukisoftware.org.
Java and all Java-based trademarks and logos are trademarks or 
registered trademarks of Sun Microsystems, Inc. 
Microsoft and Windows are trademarks of Microsoft Corporation. 
All other trademarks are registered under their respective owners.
