httpdserver

In case of emergencies...

This document deals with restarting httpd services on gtoahpa.uit.no, i.e. the oahpa versions and NDS dictionaries on gtoahpa.

For the other virtual machines, see Restarting gtweb and Restarting gtlab

On gtoahpa, gtweb and gtlab, we use nginx for serving HTML and other applications. See how to restart nginx itself if needed (after an ordinary update it is not needed).

Restarting the dictionaries on gtoahpa

Log in to gtoahpa, log in as neahtta, go to /home/neahtta/neahtta and issue:

fab sanit restart_service
fab baakoeh restart_service

Restarting Oahpa versions on gtoahpa

Log in to gtoahpa.

Some Oahpa versions are on gtoahpa, others are on gtlab. To find which versions are on gtoahpa, write ls /home/|grep oahpa.

NOTE:We are now in the process of moving most of these to gtoahpa-01. Contact Cip or Chiara on issues concerning these.

Oahpas on gtoahpa:

The following is the list of Oahpas on gtoahpa as of 28.11.2018:

Oahpa name Language URL Comments
crk_oahpa Plains Cree oahpa.no/nehiyawetan  
fkv_oahpa Kven oahpa.no/kveeni  
hdn_oahpa Northern Haida oahpa.no/hdn_oahpa  
kpv_oahpa Komi Zyrian oahpa.no/kpvoahpa  
myv_oahpa Erzya oahpa.no/erzya   Should be online 3.-8.12.
univ_oahpa North Saami oahpa.no/davvi  
yrk_oahpa Tundra Nenets oahpa.no/yrkoahpa  
rus_oahpa Russian oahpa.no/rusoahpa  
udm_oahpa Udmurt oahpa.no/udm_oahpa   Restarted (note address)

Oahpas on gtoahpa-01:

The folowing is the list of oahpas already moved to gtoahpa-01:

Oahpa name Language URL
sjd_oahpa Kildin Saami gtoahpa-01.uit.no/kiilt
sma_oahpa South Saami gtoahpa-01.uit.no/aarjel
smn_oahpa Inari Saami gtoahpa-01.uit.no/aanaar
sms_oahpa Skolt Saami gtoahpa-01.uit.no/nuorti

Restarting on the old gtoahpa:

Once an Oahpa version is down, it must be restarted. Write (anywhere on the system)

 sudo service OAHPANAME restart

where OAHPANAME is the relevant Oahpa version (crk_oahpa, fkv_oahpa etc).

If only an Oahpa version has been down, this is enough. If the server has been totally down, you may need to start more. Here is the full list of services that should be started, in this order (there are dependencies between them):

  1. mysqld
  2. nginx
  3. php-fpm
  4. lookupserv

For each of the processes listed, issue (anywhere on the system) the command

    sudo service NAME restart

Thus, sudo service mysqld restart, etc.

After that, run all the Oahpa restarting commands:

sudo service crk_oahpa restart

etc.

Restarting Konteaksta

Konteaksta is running on the Tomcat web server. After upgrade of gtoahpa, as well as adding new components to Konteaksta, it is always recommended to restart Konteaksta (the script compiles the Konteaksta source code, redeploys it on Tomcat and restarts Tomcat). Restarting Konteaksta is also the first thing to try if the url oahpa.no/konteaksta gives "server error", e.g. "The page you are looking for is temporarily unavailable. Please try again later.".

To restart Konteaksta:

Log in to gtoahpa and issue the command:

    sudo service konteaksta restart 



Restarting oahpas the hard way, without the service script

There is an init.d script for restarting each oahpa instance, with a reference to the respective oahpa home catalogue, so they may thus be restarted via the service command, with the usual subcommands: restart, stop, start.

In case the sudo service etc. does not work, here is another option (we recommend you try the sudo service etc. first):

Go to the catalogue /home/fkv_oahpa/fkv_oahpa (and correspondingly for the other oahpa versions). Each Oahpa instance has a script in its root directory,

run_fastcgi.sh

, which stores a PID to a file to halt old fastcgi processes related to this Oahpa and start new ones. Write:

 sudo ./run_fastcgi.sh

The system may return an error message, along the lines of run_fastcgi.sh:line 1:#!/bin/bash:Ingen slik fil eller filkatalog, but that is not relevant. As long as you are in the right catalogue and the system finds the file run_fstcgi.sh, you are fine.

If running of the script results in error:

    ./run_fastcgi.sh: line 10: kill: (332) - Ingen slik prosess

then the process id saved in the file fastcgi.pid is wrong. In such a case you need to change the file. The command

    ps -ef | grep 'fkv_oahpa'

gives you a list of all fastcgi processes related to fkv_oahpa. There should be 6 processes for each oahpa. Check the time when the first process was started (the process that generates the remaining 5 processes). Write the PID of the process into the file fastcgi.pid and run the script run_fastcgi.sh again.

PHP applications, Wordpress in our case, are managed by a global server process, php-fpm. To restart this process:

	sudo service php-fpm restart