Differences

This shows you the differences between two versions of the page.

--- it-maintenance-troubleshooting [2022/03/16 14:33] – [Internet / Medal-Reader Issues] lu8266
+++ it-maintenance-troubleshooting [2022/04/27 07:46] (current) – [Other resources] Sylvain
@@ Line 3: / Line 3: @@
 ===== Purpose and Scope =====
 In this page, you will learn how to perform the basic IT maintenance & troubleshooting for Health Facilities.
 ===== Responsibilities and Procedures =====
@@ Line 14: / Line 11: @@
 ==== 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 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
+- 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 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.
+- 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 ====
-==== Security Updates ====
+- 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
-  - To execute security updates, you will need a USB keyboard and a screen with an HDMI/micro-HDMI cable
+==== #MustHaveDevTools ====
-  - 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''
+    * [[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 ====
-==== Internet / Medal-Reader Issues ====
+[[https://kinsta.com/blog/linux-commands/|Useful Linux basics commands]] If you want to know more about the commands you'll have to use
-  - 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
-  - If some medical history questions doesn't showning up try to delete the application cache in the storage settings of medAL-reader and relaunch the android app
+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]]
-  - [[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]]