Installer

Installers are built from the build script (here). A separate installer is created for each context. They differ only in the name of the war file (the code is the same they are just named differently) and the database for a new install.

Currently the installers only work on linux (and mac OS). There are no plans to add one for Windows.

The installer will not download and install the prerequisites, Tomcat and Postgresql, but it will check that they exist and that they are the correct versions.

##Use The installer comes as a compressed file so the first step is to uncompress it.

 gunzip KenyaOpenElis_5.1_Installer.tar.gz
 tar xf KenyaOpenElis_5.1_Installer.tar

This will create a directory ./KenyaOpenElis_5.1_Installer/linux/.....

change to the linux directory. There is a README_INSTALL file which looks very much like what is below

###Installing OpenELIS on Linux

The installer has to be run from a writable file system. This means that running it from a CD will not work.
It should be copied to the local file system.

The install script, setup_OpenELIS.py will install global OpenELIS.

The version being installed will depend on the war file included with the installer.

It is assumed that python, tomcat5.5 and postgresql 8.3 or later have already been installed on the target machine.
Python is needed to run the script and tomcat and postgresql are required for the application. The script will check for the correct versions before it continues.

THE SCRIPT MUST BE RUN WITH ROOT PERMISSIONS.
The installation targets do not allow non-admins to write to them and the database has to bootstrap to add OpenELIS users It should also be run from the directory where the script lives

Options for the running the script

setup_OpenELIS.py <options>
    This script must be run as sudo or else it will fail due to permission problems.

-install  - Installs OpenELIS.  Assumes that there is not a partial install

-installBackup - Installs just the backup.  Will overwrite any existing backup

-installCrossTabs - Install just the crosstab functionality into Postgress to allow export to work

-update - Updates OpenElis.  Checks to insure that the instance being updated is the same as the installed

-uninstall - Removes OpenELIS from the system optionally including the database. Make sure you have the clinlims password written down someplace

-version - The version number of this installer

-help - This screen

Both the update and uninstall options will backup the application war file, the tomcat configuration file, database dump and any plugins to the rollback directory. By example

The application file for 12/10/2012 at 5:30:17 PM

.\rollback\2012_10_12-19_30_17\haitiOpenElis.war

The configuration file

.\rollback\2012_10_12-19_30_17\haitiOpenElis.xml

The database backup file

.\rollback\2012_10_12-19_30_17\openElis.backup

When doing an update any plugins will be reinstalled

---

Examples for running

install:

sudo python ./setup_OpenELIS.py -install

update:

sudo python ./setup_OpenELIS.py -update

un-install:

sudo python ./setup_OpenELIS.py -uninstall