Upon Receiving Your Gear

2019 status: Partially correct; needs to be updated

A package has arrived containing Buendia hardware for you. What now?

Here's how to check that your gear is all working properly. With your laptop on hand, follow the steps below.

Contents

Your package should contain:

• A server (20 cm x 20 cm square box), and possibly a second backup server
• Some tablets, possibly enclosed or plain
• At least one tablet charger
• A wireless networking access point, and possibly wireless bridges as well

You should also have been given:

• The wifi network name (most likely "buendia")
• The wifi password
• The OpenMRS password

Get the network up

Your first step is to get a wifi network up. If you received a wifi AP, power it on.

(Or, you may be using an existing wifi network. In this case, configure your wifi network with the network name and password you were provided, and be sure to disable DHCP on your network.)

Power up the server

You only need one server. Take one server unit and connect it to power; its yellow light should come on. (After five minutes, or if the server has already been on for five minutes, the green light will be on instead. Because the server has very long-lasting batteries, the server may have been powered on throughout its travels to you.)

The server should already be configured to connect to the wifi network with the name and password you were provided.

If you have more than one server, ensure that only one is on at a time. (If your backup server is also on, both servers will attempt to join the same wifi network and conflict with each other; some patient data will get randomly stored on one server and some will get stored on the other. This is bad!)

Check server status with your laptop

Grab your laptop and join the wireless network, using the network name and password you were provided. Once it has joined, open a web browser on your laptop and go to http://server/. You should see a status page.

Note that because the server provides network addresses (using DHCP), your laptop won't be able to join the network if the server is off or the server has not joined the network.

Set the server clock

When a server is off, its clock does not tick. So when a server first arrives, its clock will most likely be incorrect.

Ensure that your laptop has the correct time (most likely it will be keeping its own clock accurately set from the Internet). Then go to the status page at http://server/ and click Server clock, then click Set the server clock to set the server's clock to match your laptop.

This step is essential. If the server clock is incorrect, the dates and times on the patient records will all be wrong.

Ensure the server is serving

When the server initially boots up, its yellow light will be on and it will not be serving. The heading at the bottom of the status page will say CURRENTLY DOWN. This is normal. It takes about five minutes to start up. The status page also indicates how much time has elapsed since boot; if it has been less than five minutes you can expect the server to be down.

After five minutes, the green light should come on, and the heading at the bottom of the status page will say CURRENTLY SERVING. If this does not happen after five minutes, your server has a problem.

You can reboot your server using the Reboot link on the status page. A white light on the server will flash, then the yellow light will come on. Five minutes later, the green light should come on.

Set up a tablet

Turn on one of the tablets. If you are using a tablet housed in an enclosure, you can wake it up by placing it on a tablet charger.

On the tablet, join the wifi network, using the network name and password you were given.

On the tablet, open Chrome (or any web browser) and navigate to http://server/. On that page click Download client app, then click the buendia-client-x.y.apk file, download it, and install it. When the download is complete, you can pull down the notification area or open the "Downloads" app to find the downloaded file and tap it there to install it.

Wait for the server's green light to come on, if it's not already on. If the app is started while the server is not yet ready, it may get stuck. If you need to force the app to restart, tap the app-switcher button (the pile of squares), find the "Buendia" app in the list of thumbnails, and swipe it to the side to remove it from the list. Then open the app again.

On the tablet, open the "Buendia" app. You will most likely get an error message saying that the password is wrong. Tap Settings or CHECK to go to the settings, tap OpenMRS password, and enter the OpenMRS password you were provided. Use the back button to get back to the app.

At this point the user list should load up. Each user is represented by a square. Initially there is only one user, "Guest User". Tap it; the app should then sync its data with the server (patients, locations, and so on).

After the sync has finished, you'll see the main screen of the app, with a list of locations and zones. You're good to go.