How To Install EliHIS
In order install and start using / testing EliHIS, you need to install minimum Java Runtime Engine 1.6 (Java 6) on your server. Based on your distribution, you can also use OpenJDK to run EliHIS server.
To install Java Runtime Engine 1.6, open the terminal and enter the following commands:
$> yum install java-1.6.0-openjdk
or you can install any version of Java Runtime Engine above 1.6 provided by your distribution by typing:
$> yum install java
You can also download and install Oracle Java however installation of Oracle Java will not be covered in this tutorial.
After a successful installation, when you type:
$> java -version
you should see an output like below:
openjdk version "1.8.0_191"
OpenJDK Runtime Environment (build 1.8.0_191-b12)
OpenJDK 64-Bit Server VM (build 25.191-b12, mixed mode)
If you see an error, you may need to follow another tutorial on how to install java runtime engine on your distribution. After you successfully install java runtime engine, please follow the steps below.
Second step is to install a DBMS. This tutorial will cover installation of MySQL (MariaDB) as EliHIS has built-in support for MySQL (MariaDB). In order to install MySQL (MariaDB) on your server, enter following command:
$> yum install mysql-server
Any MySQL version above 5.1 can be used for EliHIS. This command above will most likely install MariaDB in recent versions of your Linux distribution as MySQL has been acquired by Oracle and GNU version is now maintained under the name “MariaDB”.
Next step is downloading EliHIS build. EliHIS build is a single Jar (compressed java archive) file that you can execute from the command line. It is bundled with redistributable libraries to make running the server ultra simple.
Create folders for EliHIS:
$> mkdir /usr/local/elihis
$> mkdir /usr/local/elihis/bin
$> cd /usr/local/elihis/bin
Get latest version from server:
$> wget http://eliverse.com/dl/elihis/builds/elihis-server-2.0.3.jar
Go back to parent folder, create a www folder to download web contents:
$> cd ..
$> mkdir www
$> cd www
Next, we will checkout latest web contents to www folder:
svn checkout svn://eliverse.com/elihis-www ./
Now we need to import a test database. Go back to parent folder, create a temp folder and go into temp folder.
$> cd ..
$> mkdir temp
$> cd temp
Download test database export which contains all hospital definitions in USA.
$> wget http://eliverse.com/dl/elihis/db/elihis-test-usa-hospitals.zip
Unzip downloaded database export:
$> unzip elihis-test-usa-hospitals.zip
Login to mysql and create a database and a user:
$> mysql -u root
> CREATE DATABASE elihis_test;
> GRANT ALL PRIVILEGES ON elihis_test.* TO 'elihis_test'@'localhost' IDENTIFIED BY 'elihis_test';
Next, we will import test database to newly created mysql database:
$> mysql -u root elihis_test < elihis-test-usa-hospitals.sql
Now all is set and we are ready start EliHIS. Go back to parent folder and go into bin folder. Enter following command:
$> cd ..
$> cd bin
$> java -jar elihis-server-2.0.3.jar -Xmx:512m --dbuser:elihis_test --dbpassword:elihis_test --dbname:elihis_test --port:5522 --root:/usr/local/elihis/www --dbms:mysql --install --instance:elihis1
EliHIS will start caching a lot of data from the database. Caching takes a long time during start-up, please wait for it.
Now, open your browser and enter the following URL:
If you see a login window, congragulations! You have succesfully installed EliHIS.
If you want to start EliHIS like a daemon, you can also start it using nohup command as described below:
$> nohup java -jar elihis-server-2.0.3.jar -Xmx:512m --dbuser:elihis_test --dbpassword:elihis_test --dbname:elihis_test --port:5522 --root:/usr/local/elihis/www --dbms:mysql --install --instance:elihis1 &
You may now proceed to Configuring EliHIS