Configuring DWAPI to correctly transmit Facility details

Step 1: Identify the IP Address for KenyaEMR Access
To determine the IP address used to access KenyaEMR in your facility, follow these steps from the server hosting the EMR:

1. Check the KenyaEMR Access URL
   The IP address typically appears in the format:
   http://192.168.1.2:8080/openmrs

2. In some cases, the system may use a local reference such as:
   http://localhost:8080/openmrs

3. If the URL uses localhost
   This means the actual IP address is not explicitly shown. To reveal it:
   • Open the terminal window on the server.
   • Run the command: ifconfig
   This will display the network configuration, including the actual IP address assigned to the server.

Note: If you encounter an error while running the ifconfig command, it may be because the net-tools package is not installed. To resolve this, run the following command:
sudo apt install net-tools

An active internet connection is required to install the package.

Alternatively, you can simply locate the IP address directly from the browser’s address bar, as shown in the highlighted example below, and proceed to the next step.

Step 2:

1. Launch the DWAPI Application and navigate to the Configurations section (Step 1).
2. Expand the Configuration menu and select EMR Settings (Step 2).
3. Wait for the list of EMR systems to load. Locate KenyaEMR and click the Action button next to it (Step 3).
4. This will open the Protocols page. Under the Protocol section, click on the REST Endpoints tab (Step 4).
5. Once done, proceed to the next step.

Step 3:

1. After clicking the REST Endpoints tab (Step 1), the Base URL field will appear below.
2. Review the address displayed under Base URL. If it differs from the IP address identified in Step 1, it must be updated.
3. To edit the Base URL:
   • Click the Edit icon (Step 2).
   • This will open the URL field for editing.
4. Proceed to next step

Step 4:

1. In the REST Base URL editor window, verify that the displayed address matches the IP identified in Step 1.
2. If the address is different, update it accordingly. Ensure the format follows the structure:
   
   (Note: Your IP may vary based on your facility’s configuration.)
3. Click Save to apply the changes and exit the editor.

Important:
• Double-check that the IP address is correct
• Ensure there are no spaces in the URL to avoid transmission errors.

This is awesome