xlsmon - a graphical user interface for cluster load monitoring
xlsmon [ standard X11/Motif flags... ]
A Motif graphical user interface for monitoring the load on the hosts in an LSF cluster. xlsmon displays the configuration and load information of hosts in the load sharing cluster. This information is sorted and displayed in tables, bar charts and strip charts, which are updated periodically. The load information displayed includes 15-sec CPU queue length, 1-min CPU queue length, 15-min CPU queue length, 1-min CPU utilization, 1-min paging rate (pg/s), 1-min disk I/O rate (Kbytes/s), number of login users, interactive idle time (min), available /tmp space (Mbytes), available swap space (Mbytes), available memory (Mbytes), and external load indices (see also lsmon(1) ).
The main window of xlsmon consists of a viewing area, a message area and a menu bar.
The viewing area displays a host icon for each of the hosts in the LSF cluster. Each icon changes shape and color according to the current status of the host.
The message area prints information about status changes of the hosts and error messages that might result from the user performing operations through xlsmon.
The menu bar contains the following items: File, View, Options and Help.
File The File menu contains the following items:
Refresh
Refresh the contents of the viewing area.
Clean Message
Clean the messages in the message area.
Exit Close the xlsmon main window and all subwindows.
View The View menu allows users to pop up separate windows to display detailed information about hosts in the system. The menu contains the following items:
Detailed Load...
Pop up the «Detailed Host Load» window to display the load
indices of the selected hosts in bar charts (see the section
«Detailed Host Load Window").
History of Load...
Pop up the «History of Host Load» window to display the recent
values of the load indices of the selected hosts in strip charts
(see the section «History of Host Load Window").
Cluster Configuration...
Pop up «Cluster Configuration» window to display configuration of
the hosts in table form (see the section «Cluster Configuration
Window").
Options
The Options menu allows users to modify the operating behavior of
xlsmon. The menu contains the following items:
Set Options...
Display a dialog box, which contains controls that affect the
xlsmon's features, including display refresh period, warning bell
volume, print command, «History of Host Load» and «Cluster Configuration"
window auto resize options.
Save Options
Save the current settings of the features to the configuration
file ~/.XLsmon. This file, if available, is read when xlsmon is
started to obtain the configuration file features.
Restore Options
Restore the settings of the features from the last saved configuration
file ~/.XLsmon.
Help The Help menu contains the following items:
On Version...
Pop up a message dialog displaying the version, date and product
information for LSF.
On Window...
Pop up on-line Help window to display the information about the
tasks that you can perform with the xlsmon (see the section «Help
Window").
On Help...
Pop up on-line Help window to display the information about how
to use the on-line help (see the section «Help Window").
Detailed Host Load Window
The «Detailed Host Load» window displays the load indices of the
selected hosts in bar charts. This window consists of a menu and a
viewing area.
The menu bar for the «Detailed Host Load» window contains the following items: File, View and Help.
File The File menu contains the following item:
Exit Close the «Detailed Host Load» window.
View The View menu allows the user to choose displaying the load by hosts or by index and change the display features. Any change to the display features made in this View menu only affect this window, not the main xlsmon window.
The menu contains the following items:
Display by load index
Display load by index in the viewing area. This is the
default.
Display by host
Display load by hosts in the viewing area.
Load index selection...
Pop up a dialog box to let the user select the load indices
to display in the viewing area. The default is to show all
the load indices.
Host selection...
Pop up a dialog box to let the user select the hosts to
display in the viewing area. The default is all hosts in
the LSF cluster.
Help Same as the Help menu of the main window.
History of Host Load Window
The «History of Host Load» window displays information in strip chart
format on the recent values of the load indices of the selected hosts.
This window consists of a menu and a scrolled viewing area that displays strip charts of host load indices. The menu bar for the «History of Host Load» window contains the following items: File, View and Help.
File The File menu contains the following item:
Exit Close the «History of Host Load» window.
View Allow the user to select hosts and load indices that are displayed in strip charts. The menu contains the following items:
Load index selection...
Pop up a dialog box to let the user select the load indices
to display in the viewing area.
Host selection...
Pop up a dialog box to let the user to select the hosts to
display in the viewing area. The default is all hosts in
the LSF cluster.
Help Same as the Help menu of the main window.
Cluster Configuration Window
The «Cluster Configuration» window lists in tabular form the hosts
that are participating in load sharing together with their configuration
information. The information includes: host name, host type,
host model, CPU factor, number of CPUs, number of local disks, total
memory, total swap space, maximum /tmp space, the execution priority
for remote jobs, whether the host runs LSF servers or not, available
resources denoted by resource names, run windows during which the host
is open for sharing loads from other hosts, and busy thresholds for
scheduling interactive jobs (for more information, see lsf.cluster(5)
and lshosts(1)
).
The menu bar for the «Cluster Configuration» window contains the following items: File, View and Help.
File The File menu contains the following items:
Refresh
Refresh the configuration information listed in the table.
This is useful after an LSF system reconfiguration (see
lsadmin(8)
).
Exit Close the «Cluster Configuration» window.
View Allow the user to select the hosts to display in the table and refresh the table information. It contains the following item:
Host Selection...
Pop up a dialog box to let the user select the hosts to list
in the table. The default is all hosts in the LSF cluster.
Help Same as the Help menu of the main window.
Help Window
The Help window displays on-line documentation. It contains a menu
bar, a scrolled hypertext window and «Previous", «Next» and «Close"
push buttons.
There are highlighted items. By clicking the items the window displays the related parts of text about the items. The highlighted items use a different color and font that can be set in the default file.
A history of the 100 last pages displayed is kept in memory that can be recalled with the «Previous» and «Next» buttons.
The menu bar for the Help window contains the following items: File and Help.
File The File menu contains the following items:
Save As...
Pop up a file selection dialog, let user input a text file
name to save the content of the window.
Print
Send the content of the window to the printer. The resource
of xlsmon for the print command is «printCommand". The print
command can also be set or changed in the Set Options window.
Exit Close the Help window.
Help The Help menu contains the following items:
On Version...
Pop up a message dialog displaying the version, date and
product information for LSF.
On Help...
Pop up the Help window to display the information about how
to use the on-line help.
The xlsmon application uses the values in the X default files when you logged in and uses the appropriate resource specification values to customize the appearance of the xlsmon window. The format for a resource specification in the X default files is:
[name*]resource: value
name specifies the application name or the name string that restricts
the resource assignment to that application or to a component of an
application. If this argument is not specified, the resource assignment
is globally available to all X applications.
resource specifies the resource.
value specifies the value that is to be assigned to the resource.
Because each toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you can form the name string by adding widget class and name identifiers to the string. For further information about adding class and name identifiers, see X(1X) .
For xlsmon, the application class is XLsmon and the application name is xlsmon.
In addition to the general resources listed in X(1X) , the resources available for the xlsmon work area are:
refreshRate
Specify the period of xlsmon refreshing load indices. The permissible
range of refresh period is 15 to 200 seconds.
WarningBell
Specify the volumn of alarm bell. The alarm bell sounds when a
host becomes busy or unavailable. The permissible range is 0 to
100. A larger value produces a louder sound. A value of zero
turns the bell off.
printCommand
Specify the command to print xlsmon on line help. The default
command is «lp".
~/.Xdefaults
XLSF_APPDIR/XLsmon
~/.XLsmon
lsmon(1) , lsload(1) , lshosts(1) , lsf.cluster(5) , lsadmin(8) , X(1X)
LSF User's Guide