This is an old revision of the document!
Table of Contents
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
#MustHaveDevTools
-
- 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
- All available artisan commands Details on every artisan available commands
- dokku More information on Dokku commands
- dokku-postgres More information on Postgres Dokku container
- dokku-logs Know more about Dokku logs management
- psql Every available psql commands
- pg_dump Backup the database
- pg_dumpall Backup all the database
- pg_restore Restore a backup
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 zip1.zip username@<server_ip>:/var/lib/dokku/data/storage/<app_name>/app/cases_zip/2XlcgspHJlCuqDPQFJhzLZaR5s0SGPDAOdwxlMWw.zip