User Tools

Site Tools


IT Maintenance and Troubleshooting

Purpose and Scope

In this page, you will learn how to perform the basic IT maintenance & troubleshooting for Health Facilities.

Responsibilities and Procedures

All of the following procedures must be applied by a local IT coordinator or if the IT coordinator allows it, a technician on the Health Facility.

Lost / Broken / Stolen IT equipment

- If any equipment has any issue that stops it from working, you may try turning it off and on and see if that helps - If the equipment is stolen / lost / definitely broken, you shall order the same equipment and reapply the settings written in the installation SOP

LocalData Stop / Start / Crash Recovery

- If for any reasons the tablets do not work anymore, you may restart the Raspberry to see if this solves the issue. To do so, simply unplug the USB-C cable wait a few seconds and plug it back in. Wait 3 mins and see if your issue is solved. - If the issue persists, you need to perform the localData install SOP on the Raspberry PI once again.

Security Updates

- To execute security updates, you will need a USB keyboard and a screen with an HDMI/micro-HDMI cable - Plug the screen and keyboard in the Raspberry PI, and login with the normal User / Password - Execute the command: git pull - Then: shutdown -r 0

Internet / Medal-Reader Issues

- Check if the tablet is connected to the correct Wi-Fi (Dynamic) - Reboot the router by unplugging it / plugging in back OR by long pressing the power button until no more lights can be seen from it, then press shortly on it to turn it back on - Check with a phone User that has the same operator as the 4G router if there is a general internet issue


    • WinSCP is a free SFTP, SCP, Amazon S3, WebDAV, and FTP client for Windows.
    • This tool will help you to access all files on your server and for example to retrieve a json in the failures folder or a log file.
    • PuTTY is a free and open-source terminal emulator, serial console and network file transfer application. It supports several network protocols, including SCP, SSH, Telnet, rlogin, and raw socket connection. It can also connect to a serial port.
    • This will help you connect directly to your server.
    • pgAdmin is the most popular and feature rich Open Source administration and development platform for PostgreSQL, the most advanced Open Source database in the world.
    • This tool will help you to retrieve information from the medAL-data database for example
  • KeePass, this tool is an utility to manage all your passwords

Useful resources

Useful Terminal Commands

Useful Linux basics commands If you want to know more about the commands you'll have to use

Exemple to retrieve a zip file

scp username@<server_ip>:/var/lib/dokku/data/storage/<app_name>/app/cases_zip/

Other resources

it-maintenance-troubleshooting.txt · Last modified: 2022/04/27 07:46 by Sylvain