Managing services (AEN 4.2.1) — Anaconda Enterprise 4.4 documentation

Anaconda Enterprise: Documentation

# Managing services (AEN 4.2.1)

The tasks on this page assume that the 3 AEN nodes are installed in the following locations:

- Server–`/opt/wakari/wakari-server/`.
- Gateway–`/opt/wakari/wakari-gateway/`.
- Compute-Launcher–`/opt/wakari/wakari-compute/`.

- Checking the status of server node processes
- Checking the status of gateway node processes
- Checking the status of compute node processes
- Starting AEN services
- Verifying that AEN services are set to start with the system
- Stopping AEN services
- Restarting AEN services
- Identifying extraneous processes
- Removing extraneous processes

## Checking the status of server node processes

1. Run:

       # service wakari-server status
       wk-server                   RUNNING    pid 20758, uptime 5 days, 0:30:23
       worker                      RUNNING    pid 20757, uptime 5 days, 0:30:23

   OR

       root@server # ps -Hu wakari
         PID TTY          TIME CMD
       20756 ?        00:02:26 .supervisord
       20757 ?        00:05:58   mtq-worker
       20758 ?        00:00:08   wk-server
       20765 ?        00:02:00     wk-server
       20766 ?        00:01:55     wk-server
       20767 ?        00:02:20     wk-server
       20770 ?        00:02:02     wk-server

2. Run:

       root@server # service nginx status
       nginx (pid  26303) is running...

For more information on server processes, see Server processes.

## Checking the status of gateway node processes

Run:

    # service wakari-gateway status
    wk-gateway                       RUNNING    pid 1137, uptime 5 days, 1:59:28

OR

    root@gateway # ps -Hu wakari
      PID TTY          TIME CMD
     1136 ?        00:01:59 .supervisord
     1137 ?        00:00:02   wk-gateway

For more information on gateway processes, see Gateway processes.

## Checking the status of compute node processes

Run:

    # service wakari-compute status
    wk-compute                       RUNNING    pid 22050, uptime 3 days, 1:03:19

OR

    root@compute # ps -Hu wakari
      PID TTY          TIME CMD
     1150 ?        00:02:01 .supervisord
     1152 ?        00:00:01   wk-compute

For more information on compute node processes, see Compute processes.

## Starting AEN services

Services should start automatically both when they are first installed and at any point when the system is restarted.

If you need to manually start an AEN service, you must start each node independently, because they may be running on separate machines.

NOTE: The process is basically the same for each node, but the path to the correct commands vary.

To manually start a service:

- On the server node, run:

      service wakari-server start

- On the gateway node, run:

      service wakari-gateway start

- On a compute node, run:

      service wakari-compute start

## Verifying that AEN services are set to start with the system

To verify that AEN services are set up to start automatically:

1. Run the following command on each node:

       chkconfig --list | grep wakari

2. If services are missing, add them:

       chkconfig --add [wakari-server|wakari-gateway|wakari-compute]

3. Restart the services.

## Stopping AEN services

CAUTION: Do not stop or kill supervisord without first stopping wk-compute and any other processes that use it.

You must stop services on each node independently, because they may be running on separate machines.

To stop an AEN service:

- On the server node, run:

      service wakari-server stop

- On the gateway node, run:

      service wakari-gateway stop

- On a compute node, run:

      service wakari-compute stop

  Compute nodes may have running processes that are not automatically stopped. To stop them, run:

      sudo /opt/wakari/wakari-compute/bin/wk-compute-apps kill-all

## Restarting AEN services

- On the server node, run:

      service wakari-server restart

- On the gateway node, run:

      service wakari-gateway restart

- On a compute node, run:

      service wakari-compute restart

## Identifying extraneous processes

To get a complete list of the processes running under the wakari user account, run `ps -Hu wakari`.

EXAMPLE:

    root@server # ps -Hu wakari
       PID TTY          TIME CMD
     20756 ?        00:02:26 .supervisord
     20757 ?        00:05:58   mtq-worker
     20758 ?        00:00:08   wk-server
     20765 ?        00:02:00     wk-server
     20766 ?        00:01:55     wk-server
     20767 ?        00:02:20     wk-server
     20770 ?        00:02:02     wk-server

     root@server # ps -f -C nginx
     UID     PID  PPID  C STIME TTY     TIME CMD
     root  26303     1  0 12:18 ?   00:00:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
     nginx 26305 26303  0 12:18 ?   00:00:00 nginx: worker process

     root@gateway # ps -Hu wakari
       PID TTY          TIME CMD
      1136 ?        00:01:59 .supervisord
      1137 ?        00:00:02   wk-gateway

     root@compute # ps -Hu wakari
       PID TTY          TIME CMD
      1150 ?        00:02:01 .supervisord
      1152 ?        00:00:01   wk-compute

- wk-server, wk-gateway and wk-compute should have PIDs reported by supervisorctl.

- The nginx master process should have a PID reported by service nginx status.

- If you have installed more than one AEN node on a single machine, the processes from all of the installed nodes should be displayed for that machine.

- On compute node(s), any AEN applications currently being run by users will be present.

  EXAMPLE:

      root@compute # ps -Hu wakari
        PID TTY          TIME CMD
       1150 ?        00:00:00 .supervisord
       1152 ?        00:00:00   wk-compute
       1340 ?        00:00:00 bash
       1341 ?        00:00:00   notebookwrapper

## Removing extraneous processes

If extra wk-server, wk-gateway, wk-compute, or supervisord processes are present, use the `kill` command to remove them to prevent issues with AEN.

You can safely restart any process that you remove in error.