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.[edit]

Requirements

Installed in a VM with 512 MB of RAM and 8 GB of (virtual) hard disk space.

[edit]

Installation

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

...

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.5 Use 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)
[edit]

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)

[edit]

Step 1

Under Do you currently have an OpenMRS database installed that you would like to connect to?, select No.

...

http://archive.openmrs.org/wiki/Image:Configure_step_2.png

[edit]

Step 3

Under Do you want updates to the database to be automatically applied on started up when a new web application is deployed?, select Yes and press Continue.

http://archive.openmrs.org/wiki/Image:Configure_step_3.png[edit]

Step 4

Enter and re-enter a long password with mixed case characters and numbers and press Continue.

http://archive.openmrs.org/wiki/Image:Configure_step_4.png[edit]

Step 5

Leave everything blank and press Continue.

http://archive.openmrs.org/wiki/Image:Configure_step_5.png

[edit]

Step 6

Press Finish.

http://archive.openmrs.org/wiki/Image:Configure_step_6.png

[edit]

Notes

If you need login or password info, try these defaults (as used in examples above):

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

...

If you have any questions, email the mailing list for assistance.[edit]

Sources

http://openmrs.org/wiki/OpenMRS_Appliance original

...