Deprecated: Constant E_STRICT is deprecated since 8.4, the error level was removed in /home/clients/1b9c47b1c842666ff86618c80bfe1a7b/sites/doc.medal-suite.org/inc/init.php on line 47
====== 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 scp zip1.zip username@:/var/lib/dokku/data/storage//app/cases_zip/2XlcgspHJlCuqDPQFJhzLZaR5s0SGPDAOdwxlMWw.zip ==== 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]]