Steps to deployment
Web Platform
This section will get you started installing and configuring OpenMRS from start to finish. These instructions are for manually installing OpenMRS.
System Requirements
| Target Patients | Minimum Requirements |
|---|---|
| 100s of patients | 1 GHz processor or better, 256 MB of memory or more, 40 GB hard drive or larger. You can set up the server on a laptop for demonstration or testing purposes. |
| 10,000 patients | 1.5+ GHz, 2 GB of memory, and 150+ GB of disk space with RAID and appropriate backup facilities. |
| 250,000 patients | AMPATH is supporting an OpenMRS instance with over 250,000 patients with two 2.26 GHz quad processors, 16 GB of memory, and 500 GB of disk space with RAID and appropriate backup facilities. |
Install Java
| Step | Description |
|---|---|
| 1 | Download the latest stable release of the Java Runtime Environment (JRE). For the standalone version you will only need the Java Runtime Environment (JRE) not Java Development Kit (JDK). Minimum version required is Java 6 although it is recommended to install Java 7 |
Install Tomcat
| Step | Description |
|---|---|
| 1 | Download Tomcat 6.0.29. You can use the exe version, which installs Tomcat as a service or the zip archive. |
| 2 | Execute the file and install running the default settings. |
| 3 | Accept default destination folder |
| 4 | Accept HTTP/1.1 Connector Port 8080. |
| 5 | Set Administrator login (username/password). |
| 6 | Accept the Java directory detected. |
| 7 | Select Install Tomcat. |
| 8 | After installation is complete you will need to change users roles by following this directory on your windows explorer: C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf. |
| 9 | Open the Tomcat users file (e.g. C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\tomcat-users.xml) in a text editor. |
| 10 | Create a new user called admin with the roles admin, manager and manager-gui. This file should be protected so you will need to open it as Administrator (right-click on your text editor and select "Run as administrator") user name="admin" password="XXXXXX" roles="tomcat,admin,manager,manager-gui"/ |
Install MySQL
| Step | Description |
|---|---|
| 1 | Download the latest MySQL installer. |
| 2 | Run the install program (.msi). |
| 3 | Accept the license agreement. |
| 4 | Under Feature Selection select Full Installation Setup and select the right Architecture for your computer (32-bit / 64-bit). |
| 5 | Click next and you will be shown a list of applications that you need in order to meet the requirements for installing all services. Make sure you satisfy all the requirements, if not, please install the missing applications on your machine. |
| 6 | On the next configuration options select “Developer Machine”. |
| 7 | Leave all other settings to default. |
| 8 | Enter a username and password. Note: These will be the credentials for the user with root privileges. Do Not Forget the Password. |
| 9 | Click next and finish the installation. |
Deploy OpenMRS
| Step | Description |
|---|---|
| 1 | Ensure that Tomcat is started. |
| 2 | Download the latest stable release of OpenMRS. |
| 3 | Navigate to http://localhost:8080/manager/html and enter your Tomcat administrator credentials (username and password chosen when installing Tomcat). |
| 4 | In the Tomcat Web Application Manager, enter the location of the downloaded openmrs.war fileto deploy. |
| 5 | At the end of this process, the web page will refresh and /openmrs should be displayed under Applications. Apache Tomcat should also start the application (Running = True; and in Commands, Stop is underlined). |
Start using OpenMRS
| Step | Description |
|---|---|
| 1 | Ensure that Tomcat is started.After you have finished configuring OpenMRS, RELOAD the application in Tomcat Manager. |
| 2 | Open http://localhost:8080/openmrs. You will see a login page. If you're using the OpenMRS standalone package, the page is at http://localhost:8080/openmrs-standalone. |