There are two ways to install OpenMRS: Standalone, and Enterprise. You must have Java 6 or higher installed on your system to run OpenMRS. OpenMRS Standalone provides a simplified installation option with an embedded database and web server. It is a great way to evaluate and explore OpenMRS, letting you get a local version up and running within minutes, and includes download options with sample data.
OpenMRS Standalone should run fine for smaller installations (fewer than 10,000 patient records), but if you are setting up a larger installation, we recommend using the Enterprise installation. If you are not sure which makes sense, you can start with a standalone installation and migrate your data to the enterprise version later. OpenMRS Enterprise is appropriate for larger installations. If you already have a Java servlet container and a database installed, and you want to set up OpenMRS to use these resources, you should also use OpenMRS Enterprise.
OpenMRS Standalone To install the standalone version, download the ZIP file and decompress it, then double-click the openmrs-standalone. jar file to run it. The first time you run this file, it will install OpenMRS and open your browser to the new OpenMRS instance. Do not delete or rename any files or folders after decompressing the ZIP file. These files and folders are required by the standalone installer. Alternatively, from the command line, you can navigate to the decompressed folder and run the following command: java -jar standalone-1. 1. jar
On Linux, you can also double-click on the file named run-on-linux. sh. If you are prompted for how to run it, just select run. Alternatively, you can use a command line shell to navigate to the decompressed folder and run the following command: ./run-on-linux. sh Upgrading Standalone To upgrade a copy of OpenMRS Standalone, do the following: Stop the previous version of OpenMRS Standalone and exit the application. Download and extract the most recent version of OpenMRS Standalone. Copy your database directory from the previous version to this new OpenMRS directory.
Copy your openmrs-standalone-runtime. properties from the previous version to this new OpenMRS directory. Install OpenMRS Standalone as described above. The new version of OpenMRS will run with your old data. Logging in By default, the initial username and password are as follows: Username: admin Password: Admin123 You must immediately change the admin password after installation for security purposes. To change your password, click My Profile in the upper right of OpenMRS, and choose the Change Login Info tab. Update your password, then click Save Options.
You can also change your username, and provide your real name, on this screen. Stopping and Restarting As long as OpenMRS is running, you can return to the application by opening the following URL in your browser. http://localhost:8081/openmrs-standalone/ Before you change certain preferences, such as the port on which MySQL or Tomcat runs, you must stop the application. To stop the application, use the Stop button in the user interface, or choose File > Quit. Alternatively, run the JAR file on the command line with a -stop parameter.
You can restart the GUI by clicking Start, or double-clicking on the JAR file again. Alternatively, you can run the JAR file with a -start parameter. By default, OpenMRS runs the MySQL database on port 3316, and the Tomcat server on port 8081. To use a different port, stop the application, then change the port number in the openmrs-standalone-runtime. properties file or in the GUI, and restart. To override the port from the command line, run the JAR file with a -tomcatport or -mysqlport parameter. Changing the port number will change the URL used to access the application.
To access the application, you can choose File > Launch Browser, or run the JAR file with a -browser parameter. OpenMRS Enterprise You must have Apache Tomcat and MySQL installed on your system before installing the enterprise version of OpenMRS. Download the Enterprise WAR package from http://openmrs. org/download/ Navigate to the Tomcat Web Application Manager and enter your Tomcat administrator credentials. http://localhost:8080/manager/html Browse to the location of the openmrs. war package, and deploy it. The initial setup which follows may take some time.
At the end of the process, the Web Application Manager will refresh, and /openmrs should be displayed in the list of applications. Tomcat should also start the application (Running = True). Open the OpenMRS web application to complete the initial setup process. http://localhost:8080/openmrs Getting Started with OpenMRS Enterprise The first time you run OpenMRS, the setup wizard will help you configure your installation. Follow the instructions in this wizard to set up your database, and populate it with test data if necessary.