Page Comparison

Ports Used

            OpenMRS Installation requires the use of two ports, 3306 and 8080. Port 3306 is the default port for MySQL and 8080 is the Installing OpenMRS on Ubuntu involves setting up a few key dependencies, configuring necessary ports, and compiling the platform itself. This guide will walk you through each step, ensuring you have everything in place for a successful installation.

Before you start, make sure your system meets the prerequisites outlined below. You'll need to check and install several dependencies, configure your environment, and finally, compile and run OpenMRS.

Ports used

OpenMRS requires two specific ports to be available during installation:

• Port 3306: The default port for MySQL.

• Port 8080: The default port for the Jetty server.

            Both ports must be open and have no existing connections. Before going any further, make sure to kill all processes running on those ports with the following commands.

                        fuser -k 3306/tcp

                        fuser -k To ensure these ports are open and free from any existing connections, execute the following commands in your terminal:

fuser -k 3306/tcp
fuser -k 8080/tcp

Dependencies

            Before building and compiling OpenMRS make sure you have or install the following dependencies:

Java JRE

            Check for the JRE by going into the Terminal and typing

                        javac –version

            If Java is installed, the result should be Before diving into the installation, you’ll need to verify and install several dependencies to ensure OpenMRS runs smoothly on your Ubuntu system.

Java Runtime Environment (JRE)

First, check if you have the JRE installed by running:

javac -version

 OpenMRS requires Java 1.6 or higher, and platform for Platform 2.x requires , Java 1.8 .

Image Removed 

            If you don’t have Java installed, you should get a message returned that says “The program java can be found in the following packages”. Then execute the command:

                        sudo apt-get install default-jre

Java JDK

            Check for the JDK by going into the Terminal and typing

                        java –version

            The result should look something like this:

Image Removed 

            Again, OpenMRS requires at least java 1.6, and platform is required. If Java is not installed, you’ll see a message prompting you to install it:

sudo apt-get install default-jre

Java Development Kit (JDK)

Next, confirm that the JDK is installed with:

java -version

As with the JRE, OpenMRS requires at least Java 1.6, and Platform 2.x requires Java 1.8.             If you didn’t have Java installed and you just installed the JDK is not installed, execute use the following command:                        sudo

sudo apt-get install default-jdk

...

MySQL

            You must know your MySQL root password or have a database ready with a username and password. To check if you have MySQL installed, simply type mysql into the Terminal. If you don’t have it installed use the command:

...

If you have another version of Java installed, ensure that Java 1.8 is the active version by executing:

sudo update-alternatives --config java

...

MySQL

For OpenMRS Platform 2.3, MySQL 5.7 is recommended. For versions 2.2 and below, MySQL 5.6 is preferred. Check your current MySQL version by running:

mysql --version

For older versions of Ubuntu, you may install MySQL using:

sudo apt-get install mysql-server-5.7

Image Removed 

            You will need to input the password of your machine. You will then get the message “Do you want to continue? [Y/n]” assuming you want to continue, type y then hit the enter key.

            You will then After installation, you’ll be prompted to set a root password for MySQL. It should look like this:

Image Removed 

You will be asked to repeat the password you typed.

Note: Make sure that your firewall accepts tcp connection on port 3306 for mysql. Also make sure that Ensure your firewall allows TCP connections on port 3306, and your hosts.deny file allows permits access to your localhost.

Maven

            OpenMRS uses Maven to compile and generate source files. To see if you have maven, use the following command in the Terminal:

                        mvn

            Maven is essential for compiling and generating source files in OpenMRS. Verify its presence with:

mvn

If Maven is not installed, you should get the message “The program ‘mvn’ is currently not installed. You can install it by typing: sudo apt install maven”. Follow those instructions.

Getting the OpenMRS-core follow the prompt to install it:

sudo apt install maven

Getting the OpenMRS Core from GitHub

To get access the source code, follow the instructions provided on this page:

https://wiki.openmrs.org/display/docs/Using+Git

            Make sure you put the Using Git page. Make sure to place the openmrs-core directory into the your home directory of your machine. 

Downloading a User Interface Module

            Any Starting with version after 2.0, OpenMRS does not include a built-in user interface. This means you will You’ll need to download one yourselfmanually. To download get the Legacy UI Module, follow the instructions on this page:  

                         https://wiki.openmrs.org/display/docs/User+Interface+Modules

            Then you’ll want to the User Interface Modules page.

Once downloaded, move the legacyui-(version#)-SNAPSHOT.omod file into the ~/.OpenMRS/modules directory. If you want to To do this manually in the Files window, go :

1. Go to the Home directory

...

1. .

2. Press Ctrl+H to

...

1. reveal hidden folders.

...

2. Navigate to the .OpenMRS folder and place the UI .omod file in the modules folder.

Compiling the OpenMRS Platform

             In the Terminal, go In your terminal, navigate to the most outer outermost project directory (in this case, inside the openmrs-core directory) and type the command:

                        mvn clean install

            This may take a while run:

mvn clean install

This process may take some time, depending on your machine. Your Terminal should be looking something like this:

Image Removed 

            This It will compile, run tests, build all artifacts, and install them into your local repository. 

Running OpenMRS

            Move To start OpenMRS, move into the “webapp” webapp directory inside the “openmrsopenmrs-core” core and run the command:                        mvn

mvn jetty:run

            Wait for “the message [INFO] Started Jetty Server” which look like this:

Image Removed 

            Now open a Server. Once it appears, open your web browser and go to:

http://localhost:8080/openmrs

            After it asks you to select a After selecting your preferred language, you should see this

the installation screen.

Click here if choosing Advanced Installation Method

Click here if choosing Test Installation Method

If you choose the Simple Installation method, your screen should look like this:

Image Removed

The "Password" field is the password you set when you downloaded MySQL above.  

...

• Simple Installation Method: If chosen, the default username is admin and the default password is Admin123.

...

• You can also

...

• decide whether

...

• to include demo data

...

• .

...

...

• Advanced Installation Method: Recommended if you’ve previously created the

...

• OpenMRS database.

By following these steps, you should have a fully functional OpenMRS installation on your Ubuntu system. If you encounter any issues or need further assistance, refer to the related articles or reach out to the OpenMRS community for support.