beostatus

Name

beostatus – Display status information about the cluster.

Synopsis

beostatus [–classic] [-c, –curses] [-H, –html] [-C, –combined-spider] [-d, –dots] [-l, –levometer] [-p, –pie] [-s, –spider] [-S, –stripchart] [-r, –remote=host] [-P, –port=port] [-U, –user=name] [–disable-ssl] [-u seconds, –update=seconds] [-v, –version] [-h, –help]

Description

beostatus is a utility that displays status information for the master node and all compute nodes in the cluster.

The default display is a graphical user interface (GUI) known as the “Classic” mode, which is a tabular format, one row per node, showing per-node specific state and resource usage information. An optional non-GUI “Curses” display mode is also available that shows the same per-node information as the “Classic” mode: the assigned number for each node, the node state, CPU usage, memory usage, swap space usage, root filesystem usage, and network bandwidth usage.

Alternate GUI display modes can be selected by beostatus command line option or by using a pulldown menu within each of the GUI displays.

Various filtering options are available in the “Curses” display mode that limit the displayed information to nodes that are being currently utilized by a specified user. Note: filtering functionality requires that TORQUE be installed on the cluster.

beostatus can also be used to access cluster state information for a remote node. This requires the presence of beoweb functionality on the remote node.

See the Administrator’s Guide for additional information about beostatus.

Options

The following options are available to the beostatus utility:

--classic

Display output in GUI “Classic” mode. This is the default display mode.

-c, --curses

Display output in non-GUI “Curses” mode. It displays the same information as the GUI “Classic” mode. It is appropriate for simple terminal windows and when X is unavailable.

-C, --combined-spider

Display output in GUI “Combined Spider” mode.

-d, --dots

Display output in GUI “Dots” mode. Each node is represented by a colored box. The user selects the status element that the box represents (e.g., node state or CPU utilization), and different colors indicate different status values for that element (e.g., node state “up” vs. “down”, or gradations of CPU loading).

-H, --html

Display output in HTML format.

-l, --levometer

Display output in GUI “Levometer” mode.

-p, --pie

Display output in GUI “Piechart” mode.

-P port, --port=port

When retrieving remote beostatus information, override the default port number 5000 with another port value.

-r host, --remote=host

Retrieve beostatus information from a remote host.

-s, --stripchart

Display output in GUI “Stripchart” mode.

-u seconds, --update=seconds

Override the default update rate of 5 seconds. Units are integer seconds.

-U name, --user=name

When retrieving remote beostatus information, authenticate as user name.

--disable-ssl

When retrieving remote beostatus information, don’t use SSL encryption.

-v, --version

Show version information.

-h, --help

Show usage information and exit. If -h is one of the first two options, all other options will be ignored. If -h is not one of the first two options, it will be ignored.

FILTERING OPTIONS

Various filtering options are available when in “Curses” mode. Each is enabled by a single lowercase letter keystroke, and is disabled by a matching uppercase letter keystroke:

f, F

Limit the display to only those nodes that are running TORQUE jobs for a specific user. If the current user is root, then beostatus prompts for a username; otherwise, the username defaults to the current user.

j, J

Limit the display to only those nodes that are running TORQUE jobs for a specific user, and yet those jobs have no processes actually executing. If the current user is root, then beostatus prompts for a username; otherwise, the username defaults to the current user.

p, P

Limit the display to only those nodes that are running processes (irrespective of TORQUE) for a specific user. If the current user is root, then beostatus prompts for a username; otherwise, the username defaults to the current user.

z, Z

Limit the display to only those nodes that are running TORQUE jobs for any user, and yet those jobs have no processes actually executing.

q, Q

Terminate the beostatus utility.

Examples

Print cluster status. Use “q” to exit continuously updating display:

[user@cluster user] $ beostatus -c
       BeoStatus - 3.0
Node  State  CPU 0  CPU 1  CPU 2  CPU 3  Memory   Swap   Disk   Network
 -1      up   0.2%  11.5%   0.0%   0.0%   12.4%   0.0%  38.2%     36 kBps
  0      up   0.0% 100.0%                  9.6%   0.0%   2.2%     23 kBps
  1      up  90.0%   0.0%                 22.1%   0.0%   2.2%     13 kBps
  2    down
  3    down