Page Comparison

This guide will take you through the steps needed to install Firefox, Java, Tomcat, and Jetty, preparing your system for running OpenMRS.

Step 1: Install Firefox

Begin by installing Firefox, which will be necessary to access and manage OpenMRS.

• Instructions:
  Follow the

  instructions under https://support.mozilla.org/en-US/kb/install-firefox-linux

  detailed installation instructions for Linux at the following link: Install Firefox on Linux.

Step 2: Install

...

Ubuntu

You can install the OpenJDK on it's own as a package

...

Java

Java is essential for running OpenMRS, and the installation process varies depending on your operating system.

For Ubuntu:

• Option 1: Install OpenJDK Directly

  Code Block
  language bash
  sudo apt-get install openjdk-8-jdk

...

• Option 2: Install OpenJDK as a

...

• Dependency of Tomcat

  Code Block
  language bash
  sudo apt-get install tomcat7

...

For Other Operating Systems:

• Download Java:

  • Obtain the Java 8 release version of the Java Runtime Environment (JRE) from the official site.

• Install Java:

  • Run the installer

...

• • or unzip the contents,

...

• • depending on the provided package.

  • Accept the license agreement to complete the installation.

Step 3: Install Tomcat

Other operating systems

...

Tomcat is the application server that will run OpenMRS. You can either install it as a package or manually from a zip archive.

Option 1: Manual Installation on Other Operating Systems

1. Download Tomcat:

   • Get the zip archive of Tomcat 7.0.99

...

Unpack the zip file to a suitable location such as /opt on Linux or /Library on Mac OSX

...

1. • from the official website.

2. Unpack Tomcat:

   Code Block
   language bash
   sudo useradd tomcat7 cd /opt sudo tar zxvf apache-tomcat-7.0.99.tar.gz

...

1. sudo ln -s apache-tomcat-7.0.99 tomcat7

...

1. sudo chown tomcat7.tomcat7 apache-tomcat-7.0.99

2. Configure Tomcat Users:

   • Open the Tomcat users file (e.g., /opt/tomcat/conf/tomcat-users.xml)

...

1. • as root:

     Code Block
     language bash
     sudo nano /opt/tomcat/conf/tomcat-users.

...

1. • xml

   • Add a user with admin and manager roles:

     Code Block
     language xml
     <user name="admin" password="XXXXXX" roles="tomcat,admin,manager,manager-gui"/>

...

Run the following command from a terminal

...

Option 2: Installation as a Debian Package (Not Recommended)

1. Install Tomcat:

   Code Block
   language bash
   sudo apt-get install tomcat7

2. Configure Tomcat Users:

   • Open the Tomcat users file (e.g., /etc/tomcat/tomcat-users.xml)

...

1. • as root:

     Code Block
     language bash
     sudo nano /etc/tomcat/tomcat-users.xml

...

1. • Add a user with admin and manager roles:

     Code Block
     language xml
     <user name="admin" password="XXXXXX" roles="tomcat,admin,manager,manager-gui"/>

2. Adjust Security Settings:

   • Turn off

...

1. • the Tomcat security flag

...

1. • :

     Code Block
     language bash
     sudo nano /etc/init.d/tomcat7

...

1. • Find

...

1. • TOMCAT7_SECURITY=yes

...

1. • and change it to

...

1. • TOMCAT7_SECURITY=no

...

1. • .

2. Create OpenMRS

...

1. Application Data Directory:

   Code Block
   language bash
   sudo mkdir /usr/share/tomcat6/.OpenMRS

...

1. sudo chown -R tomcat7:root /usr/share/tomcat7/.OpenMRS

...

Step 4: Install Jetty (Alternative to Tomcat)

Jetty is another application server option for running OpenMRS, particularly in a Linux environment.

...

Jetty Installation Steps

1. Download Jetty:

   • Obtain Jetty 7.4.5

...

1. • from the official site (avoid version 7.5.4

...

Unpack the tar file to your preferred directory (I usually use /usr/share/jetty)

...

1. • , which may have compatibility issues with your JDK).

2. Unpack Jetty:

   Code Block
   language bash
   sudo mkdir /usr/share/jetty

...

1. cd /usr/share/jetty

...

1. sudo mv /path/to/

...

1. jetty/jetty-distribution-(version).tar.gz .

...

1. sudo tar xfz jetty-distribution-(

...

1. version).tar.gz

...

1. sudo mv jetty-distribution-(version)/* .

...

1. sudo rm -rf jetty-distribution(version)

Now to make it start when you start the system and make Jetty a service

1. Set Up Jetty as a Service:

   • Copy the Jetty startup script:

     Code Block
     language bash
     sudo cp bin/jetty.sh /etc/init.d/jetty

   • Edit /etc/init.d/jetty to

...

1. • define the paths for Java and Jetty:

     Code Block
     language bash
     JAVA_HOME=

...

1. • /path/to/java

...

1. • JETTY_HOME=/usr/share/jetty

...

1. • // or

...

1. • your

...

1. • Jetty installation directory

...

1. Start Jetty:

   • Place the openmrs.war file in

...

1. • /usr/share/jetty/webapps/

...

1. • .

   • Start Jetty using the command:

     Code Block
     language bash
     sudo /etc/init.d/jetty start

Step

...

5: Install

...

Ubuntu

You can install the OpenJDK on it's own as a package

...

MySQL

Finally, you need to set up a MySQL database to store the OpenMRS application data.

For Ubuntu:

• Install MySQL:

  Code Block
  language bash
  sudo apt-get install mysql-server

• Set a Root Password:

  • During installation, you will be prompted to enter a root password. Remember this for configuring OpenMRS.