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