medAL-suite documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 ====

    * [[https://winscp.net/eng/download.php|WinSCP]]
        * 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.
    * [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|Putty]]
        * 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.
    * [[https://www.pgadmin.org/download/|pgAdmin]]
        * 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
    * [[https://keepass.info/download.html|KeePass]], this tool is an utility to manage all your passwords

==== Useful resources ====
    * [[https://artisan.page/|All available artisan commands]] Details on every artisan available commands
    * [[https://dokku.com/docs/deployment/application-management/|dokku]] More information on Dokku commands
    * [[https://github.com/dokku/dokku-postgres|dokku-postgres]] More information on Postgres Dokku container
    * [[https://dokku.com/docs/deployment/logs/|dokku-logs]] Know more about Dokku logs management
    * [[https://www.postgresql.org/docs/13/app-psql.html|psql]] Every available psql commands
    * [[https://www.postgresql.org/docs/9.3/app-pgdump.html|pg_dump]] Backup the database
    * [[https://www.postgresql.org/docs/9.2/app-pg-dumpall.html|pg_dumpall]] Backup all the database
    * [[https://www.postgresql.org/docs/9.2/app-pgrestore.html|pg_restore]] Restore a backup

==== Useful Terminal Commands ====

[[https://kinsta.com/blog/linux-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
<code bash>
scp zip1.zip username@<server_ip>:/var/lib/dokku/data/storage/<app_name>/app/cases_zip/2XlcgspHJlCuqDPQFJhzLZaR5s0SGPDAOdwxlMWw.zip
</code>

==== Other resources ====

  * [[https://doc.medal-suite.org/doku.php?id=medal-creator:troubleshooting-guide|medAL-//creator// troubleshooting guide]]
  * [[https://doc.medal-suite.org/doku.php?id=medal-reader:troubleshooting-guide|medAL-//reader// troubleshooting guide]]
  * [[https://doc.medal-suite.org/doku.php?id=medal-hub:troubleshooting-guide|medAL-//hub// troubleshooting guide]]
  * [[https://doc.medal-suite.org/doku.php?id=medal-data:troubleshooting-guide|medAL-//data// troubleshooting guide]]