The Science Data System (SDS) command line interface provides numerous functions for operators to interact with HySDS components.

Accessing the SDS CLI:

1. SSH into Mozart as the hydsops user.

2. Once connected, input the command: sds (#1) to display a list of possible commands (#2) available for the sds cli. It looks like this:

   Open

   

Figure 1: (#1) sds command to display positional arguments, (#2) list of arguments

Status

Enter sds status to show the status of the HySDS components, including: RabbitMQ, Redis, and Elasticsearch (#3). Here is an example status output:

Open

Figure 2: (#3) Elasticsearch status in sds cli

Start

The sds start command starts all supervisord services. Examples include: sds start all, sds start mozart, sds start factotum, sds start metrics, & sds start grq.

Stop

The sds stop command shuts down all system services and all supervisor services on every machine. Examples include: sds stop all, sds stop grq, sds stop mozart, sds stop factotum, & sds stop metrics.

Restart

The sds restart command …. restarts all system services. Examples include: sds restart all, sds restart grq, sds restart mozart, sds restart factotum, & sds restart metrics.

Reset

The sds reset command clears out all the jobs and tasks from Mozart. This command is useful when things are stuck; reset clears out all previous runs. Examples include: sds reset all, sds reset grq, sds reset mozart, sds reset factotum, & sds reset metrics.

Supervisord

When you don’t want to use the sds cli, and want to to do something more sophisticated. Supervisord is a process watcher. Generally when a worker is isn’t running properly. It abstracts away the details of the components for the operator.

{{A process manager,

supervisorctl update = Reload config and add/remove as necessary, and will restart affected programs.

supervisorctl reread = Reload the daemon’s configuration files, without add/remove (no restarts)

supervisorctl status = Get all process status info.

supervisorctl stop all = Stop all processes

supervisorctl start all = Start all processes

supervisorctl help<action> = Print help for <action>