For new implementations ensure that you use the new installer folder which comes ready with openmrs 1.6.3

For sites already running openmrs express, follow the instructions below to upgrade to 1.6.3Follow these instructions carefully to upgrade your system from 1.6.0 to 1.6.3 which has an important bug fix. We will also update the patient summary report and the data integrity queries. The instructions seem lengthy but it was just to make sure you get the details to the dot. We will endeavour to automate the upgrades in the future.

Summary of upgrade process:

1. Backup the existing database

2. Download openmrs.war file for openmrs 1.6.3 if you did not get it in the update folder

3. Un deploy the current openmrs.war file through tomcat

4. Deploy the openmrs 1.6.3 war file

5. Launch openmrs 1.6.3

6. Login and run updates

7. Replace the patient creation page files manually

8. Upgrade the patient summary sheet report

9. Run the sql file that will upgrade your data integrity checks

Details are below

1. To backup the existing system, stop mysql and copy the folder called “data” under “C:\Program Files\WHO\OpenMRS\mysql-5.0.51a-win32\” and store it in a safe place.

2. Download openmrs.war from http://sourceforge.net/projects/openmrs/files/releases/OpenMRS_1.6.3/

openmrs.war/download

3. Undeploy openmrs.war file

To undeploy openmrs go to the computer on which openmrs was installed, open Mozilla and type the address http://localhost:8079/ to open a window like that one below

Click the Tomcat Manager link and enter the user name “admin” and password “system” when prompted. On the tomcat manager page, click undeploy openmrs as shown in the picture below.

4. Deploy the file “openmrs.war” you downloaded or that one provided in the update folder by clicking the browse button under the “WAR file to deploy” section as show in the screenshot below.

If openmrs is successfully deployed, you should see it appear in the applications as shown below.

5. To launch openmrs, click on the openmrs path in the page above or simply open firefox and type “localhost:8079/openmrs” and you should see the maintenance screen as shown below. Log in as an administrator and click run updates on the next screen.

6. Login and run updates

When your update is done, your regular openmrs home screen should show as below. You can find the version at the bottom of the page as shown in this small picture below.

The home screen

Note that the patient creation page will need manual updating as some fields will be missing after this upgrade. As seen in the screen shot below, the address is missing and will be updated in the next steps

7. The district, subcounty , parish and village are missing on your patient creation page. To fix this; stop your tomcat service as shown in the picture below and then replace the files “openmrs-servlet” and “messages” on your computer under the folder “ C:\Program Files\WHO\OpenMRS\apache-tomcat-6.0.16\webapps\openmrs\WEB-INF” with the copies provided in your update folder.

Restart tomcat and your patient creation page should look like the usual as shown below.

8. To upgrade your patient summary sheet report login to openmrs and go to administration>Manage Birt Reports

Click edit under the patient summary sheet report

Browse and select the file 150.rptdesign under the upgrade folder and upload it as shown below

9. To upgrade your data integrity checks, run this sql on your database through navicat. Get in touch with me at nmusinguzi@gmail.com if your navicat trial version has expired.

Open Navicat , openmrs database and create a new query under the openmrs database

Copy the content of the file update.sql and paste it in the new query and run it.

Congratulations! You have successfully upgraded your system from OpenMRS 1.6.0 to OpenMRS 1.6.3

With this upgrade come a few changes some of which are not noticeable.

- The patient summary sheet was updated but will look exactly like that on the previous system

- You no longer have issues with dates when entered as dd-mm-yy

- The data integrity checks have been modified