Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated wiki to instruct users about changes from debian 5 to 8

...

A description of how to install OpenMRS 1.5.1 on Debian 5  on Debian 8 (stable / LennyJessie) server; this was performed in a VirtualBox VM, but should work on a server.

...

Installation

Download the Debian 5 8 (stable) installer CD.iso (~180MB~630MB) from the Debian homepage

...

Restart (as requested)

Edit your repository sources.list (/etc/apt/sources.list) to include Java (non-free) nano /etc/apt/sources.list
add non-free to the 2 lines ending in "main" e.g. for UK repos: deb . Do this by adding "non-free contrib" to each repo line. It should look something like:

Code Block
deb http://security.debian.org/ jessie/updates main contrib non-free
deb-src http://security.debian.org/ jessie/updates main contrib non-free
deb http://ftp.de.debian.org/debian/ jessie-updates main contrib non-free
deb-src http://ftp.de.debian.org/debian/ jessie-updates main contrib non-free
deb http://ftp.

...

de.debian.org/debian

...

/ jessie main contrib non-free

...


deb-src http://ftp.

...

de.debian.org/debian

...

/ jessie main contrib non-free


If you have necessary .deb files on a CD / iso (rather than downloading from internet) and copy all the .debs to /var/cache/apt/archives:

Code Block
mount -t iso9660 -o ro /dev/cdrom /cdrom

...


cp /cdrom/*.deb /var/cache/apt/archives/


Install the components : apt-get install default-jre
apt-get install sun-java6-jdk
apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps
Allow a Tomcat Admin user (tomcat; select a more secure password than "tomcat") /etc/init.d/tomcat5.5 stop
nano /var/lib/tomcat5.5/conf/tomcat-users.xml<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role as root, install mysql (remember the root password which you use as this will be used later), and make sure tomcat7 is not running for configuration:

Code Block
apt install build-essential git openjdk-7* tomcat7 tomcat7-admin tomcat7-common  mysql-server curl
systemctl stop tomcat7


Create a tomcat user able to perform operations. Edit /etc/tomcat7/tomcat-users.xml to have the following (edit the password to something more secure!)

Code Block
<role rolename="tomcat"/>
<role rolename="admin"/>

...


<role rolename="manager"/>

...


<role rolename="

...

manager-gui"/>

...


<user

...

 name="

...

admin" password=

...

"admin" roles="tomcat,admin,manager,manager-gui"/>

...


</tomcat-users>

/etc/init.d/tomcat5.5 start 

Remove tha the Tomcat Java security (? unnecessary if only 1 Tomcat application present) nano . Edit /etc/init.d/tomcat5.5Use the Java security manager? (yes/no)
TOMCAT6tomcat7 and make sure that the line containing TOMCAT7_SECURITY is set to "no"

Code Block
TOMCAT7_SECURITY=no

 

Create the necessary directory for OpenMRS settings

Code Block
mkdir /usr/share/

...

tomcat7/.OpenMRS

...


chown -R

...

 tomcat7:root /usr/share/

...

tomcat7/.OpenMRS

...


Reload deamon due to changes to init.d and start tomcat7

Code Block
systemctl daemon-reload 
service tomcat7 start

 

From a networked client computer, go to webpage (replcing ipaddress with the actual IP of the OpenMRS server):

http://ipaddress:81808080/ to check Apache working http://ipaddress:81808080/manager/html to login to Apache (tomcat / tomcat)

Deploy openmrs.war file (download from this site)

Configuration

You can now proceed with the OpenMRS setup wizard. Outlined below are recommended defaults if this is the first time you are using OpenMRS. Only change what is noted below.

...

Start at http://ipaddress:81808080/openmrs (where ipaddress = e.e. 192.168.1.2)

...

  • OpenMRS: admin/test -> admin/Password.1
  • Tomcat: tomcat/tomcat
  • MySQL: root/openmrs
  • Debian 5 7 Appliance: root/openmrs or openmrs/openmrs

...