# Upgrading UgandaEMR

The upgrade process from 1.x to 2.x is no longer supported as of January 2021, as the majority of installations have migrated to the new 2.x or 3.x series

The upgrade across 2.x and 3.x versions is done by deploying a new WAR file

## Using a WAR file

There are two approaches

1. Inbuilt Command Menu
2. Manual Replacement of WAR file

### Using Windows Command Menu

TBD: Add Screenshots to illustrate the menus

1. Goto Start Menu Select All Programs (Windows 7) or All apps (Windows 10).
2. Select UgandaEMR then select Upgrade UgandaEMR War File.
3. This will popup a window. in it select install.
4. Browse to the location of the war file. then upgrade and click open.
5. When upgrade is complete it will give you a message to proceed to browser.

### Manual Replacement of WAR file

TBD

## Adding/Upgrading Modules

This section provides steps to add and/or upgrade a single module

### Adding a new module

A new module is usually added to provide new functionality and features that were not currently available.

1. Login as a user with administration privileges
2. Click legacy administration link as circled in the image below\
   ![System Administration Link](https://github.com/METS-Programme/ugandaemr-usermanual/blob/master/images/legacy_system-administration_link.png)
3. Select the Manage Modules link\
   ![Manage Modules Link](/files/-M4y-SyzuIcngJKvPUFP)
4. On the Manage modules page, click the Add/Upgrade module button\
   ![Add Module](/files/-M4y-Sz2uy6Pd6St6Rvq)
5. In the popup window use the browse button under Upgrade Existing module to select the module file from your computer, then click Upload\
   ![Upload Module](/files/-M4y-Sz9Pmxos19e-HtO)
6. The module will be uploaded and started, which is seen by having a red button next to the name of the module

### Upgrading a module

In this case the modules to be upgraded will be uploaded through the administration interface

1. Login as a user with administration privileges
2. Click legacy administration link as circled in the image below\
   ![System Administration](/files/-M4y-SzFfe0VB3DySrgL)
3. Select the Manage Modules link\
   ![Module List](/files/-M4y-SzHTpyto1FzILC7)
4. On the Manage modules page, click the Add/Upgrade module button\
   ![Add Module](/files/-M4y-Sz2uy6Pd6St6Rvq)
5. In the popup window use the browse button under Upgrade Existing module to select the module file from your computer, then click Upload![Upload Module](/files/-M4y-SzLaVdd5-f21_Y7) 6.The module will be uploaded and started, which is seen by having a red button next to the name of the module


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mets-programme.gitbook.io/ugandaemr-documentation/overview-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.