...

1. Server Unavailability (Error code 4xx)

Case 1: Client is not able to access the server 

1. You can use the following ways to check if the service is available.

   1. Navigate to the server URL/IP 

      1. Use a locally installed browser to navigate to the server URL

         Code Block
         https://boresha-afya-stage.smartregister.org/opensrp/ or 63.32.56.42

   2. Ping the URL/IP address i.e

      Code Block
      ping 63.32.56.42

2. Depending on the results of step 1, if the server returns a response that denotes that the service is available you can attempt any of the following steps

   1. Connect to the server, you can use an ssh client for this:

      Code Block
      ssh user@serverip.com

   2. Check that the actual service in the server is  running.

      1. Use systemctl to check that OpenSRP , OpenMRSand/ nginx services are running. You can use these commands 

         Code Block
         systemctl status tomcat-openrsp

         Code Block
         systemctl status tomcat-openmrs

         Code Block
         systemctl status nginx

      2. Use systemctl to start or restart any of the services that are down

         Code Block
         systemctl  restart ‘service-name’

   3. If the services are running , confirm that all that port 8080 is allowing all incoming traffic to the server

      Code Block
      sudo lsof -i -P -n | grep LISTEN

...

i. For tomcat logs , these are OpenSRP/OpenMRS logs, navigate apps logs, you can use the command below

cdtail -f  /home/openrsp/tomcat-opensrp/logs/catalina.out 

tail -f /home/opensrp/tomcat-opensrp/logs/localhost.2020-03-26.log

tail -f /home/openmrs/.OpenMRS/openmrs.log

/home/openmrs/tomcat-openmrs/logs/catalina.out

ii.Confirm that the services are running and the server is okay. If the server is down, you can infer the reason from the log files.Some common causes for service shutting down are:

...