main.hlp

openPBS的开放源代码

xpbsmon is the node monitoring GUI for PBS. It is used for displaying
graphically information about nodes, execution hosts in a PBS environment. In
a PBS environment, you have a list of sites managed  by PBS, and each site runs
server, and each server runs jobs on one or more execution hosts (nodes).

On each node, the list of jobs that are running on it will
be displayed as well as any system parameters that are specified by the
administrator to monitor. Some attributes like state, properties, and the list
of running jobs on each node are obtained through the PBS server, while system
parameters are obtained in terms of queries that are communicated to the MOM
daemon running on a node. Therefore, for the latter to work, the GUI must be
run as root and the host where xpbsmon is running has been given explicit
permission by the MOM daemon to post queries to it (done via the $clienthost
keyword on its config file).

The topmost window of xpbsmon can be viewed as consisting of 3 parts: menu,
main, info regions.


============
Menu Region
============

The menu region displays a row of command buttons

	(Site, Pref, AutoUpdate, Help, About, Close)

that signal some action with the left click of the mouse over a button. 

Site 		- displays the list of sites that have been added using the 
		  "Pref.." button. Dragging the mouse and releasing it over the
		  site name will display the nodes view for that site on the
		  main region.

Pref 		- brings up a dialog box that will allow you to add sites,
		  servers to each site, as well as a window to other dialog
		  boxes for specifying list of nodes known to a server, as well
		  as any system parameters to monitor for each node.

AutoUpdate	- brings up a dialog box for enabling/disabling auto updates of
		  data. If updating is currently enabled, then this button will
		  appear in a different color.

Help		- contains this help page.

About		- tells about who the author is and where to send comments,
		  bugs, and suggestions.

Close		- for exiting xpbsmon plus saving current setup information
		  in the user's $HOME/.xpbsmonrc file. Information saved
		  include any of the data specified in the preferences dialog
		  box.

View Types	- these are represented by the minimize, maximize buttons 
		  located at the rightmost edge of the menu region. The
		  minimize button will display the current site in ICON
		  mode were each node is represented as small boxes that
		  are colored depending on status but various information 
		  about node is not shown. The maximize button will show the
		  current site in FULL mode where each node is shown in
		  bigger colored boxes and various information about node is
		  in view.

===========
Main Region
===========
This area (site box) shows nodes information for the site selected through the
"Site.." button. Thus, only one site at a time can be displayed from this
area. The site box displays the name of the site at the top,  the
server/nodes info at the middle, and the color information at the
bottom.  Each server specified is represented graphically by a box (called a
server box)  containing the server display label, the list of nodes 
(in even smaller boxes called node boxes) known to the server, and various
collective status information like # of nodes used, available,
reserved, offline, down, or of unknown status. The node box can be
clicked with the left mouse button to display more information about the node
(or get a bigger view). Information include what jobs are running on it,
and values to certain system parameters specified by the administrator to
monitor.

===========
Info Region
===========

This area will show the progress of some actions of xpbsmon like updating
data for the current view. Look into the info box for errors.

================
User Preferences
================
A global xpbsmon resources file (set by the administrator) is read first and 
then the user's preference file, $HOME/.xpbsmonrc is loaded. Keep in mind that
within an Xresources file (Tk only), later entries take precedence. For
example, suppose in your .xpbsmonrc file, the following entries appear in order:

xpbsmonrc*backgroundColor: blue
*backgroundColor:       green

The later entry "green" will take precedence even though the first one is more
precise and longer matching.

Some of the things that can be set in the personal preferences file are fonts,
colors, and site information. In fact, a complete listing is described in the
following:

Node Box Colors
---------------

You can easily change the colors assigned to node boxes by modifying the
following resources: 

*nodeColorNOINFO:       black
- color when information for the node it represents could not be obtained. 

*nodeColorFREE:   green
- color of canvas when node it represents is up.

*nodeColorINUSEshared: #98f5ff
- color when node it represents has more than  1  job running  on it, or when
  node has been marked by the server that manages it as "job-sharing".

*nodeColorINUSEexclusive:        #87ceff #a0522d #1e90ff #a9a9a9 #8470ff #a020f0
- list of colors to assign to a node box when host it represents  is running
  only 1 job, or when node has been marked by the server that manages it as
  "time- sharing".  xpbsmon  will  use this list to assign 1 distinct color per
  job unless all the  colors  have been  exhausted,  in  which case, colors
  will start getting assigned more than once  in  a  round-robin fashion.


*nodeColorDOWN: red
- color when node it represents is down.

*nodeColorRSVD: yellow
- color when node it represents is reserved.

*nodeColorOFFL: orange
- color when node it represents is offline.


Node Box Properties
-------------------

Resource names beginning with "*small" or "*node" apply to the properties of the
node boxes. A node box is made of an outer frame where the node label sits on
top, the canvas (smaller box) is on the middle, and possibly some horizontal/
vertical scrollbars.

*smallForeground:       #150567
- applies to the color of text inside the canvas.

*smallBackground:       #ffefdb
- applies to the color of the frame.

*smallBorderWidth:      2
- distance (in pixels) from other node boxes.

*smallRelief:   raised
- how node box will visually appear (style).

*smallScrollBorderWidth:        2
- significant only in FULL mode, this is the distance of the horizontal/vertical
  scrollbars from the canvas and lower edge of the frame.

*smallScrollBackground: #ffefdb
- background color of the scrollbars

*smallScrollRelief:     sunken
- how scrollbars would visually appear (style).

*smallCanvasBackground: #ffefdb
- color of the canvas (later overridden depending on status of the node it
  represents) 

*smallCanvasBorderWidth:        1
- distance of the canvas from the frame and possibly the scrollbars.

*smallCanvasRelief:     flat
- how the canvas is visually represented (style).

*smallLabelBorderWidth: 0
- the distance of the node label from the canvas and the topmost edge of the
  frame. 

*smallLabelBackground:  #ffefdb
- the background of the area of the node label that is not filled.

*smallLabelRelief:      flat
- how the label would appear visually (style).

*smallLabelForeground:  #150567
- the color of node label text.

*smallLabelFont:        -misc-fixed-bold-r-normal--13-100-100-100-c-70-iso8859-1
- the font to use for the node label text.

*smallLabelFontWidth:   7
- font width (in pixels) of *smallLabelFont

*smallLabelFontHeight:  13
- font height (in pixels) of *smallLabelFont

*smallTextFont: -misc-fixed-medium-r-normal--9-90-75-75-c-60-iso8859-1
- font to use for the text that appear inside a canvas. 

*smallTextFontWidth:    6
- font width (in pixels) of *smallTextFont.

*smallTextFontHeight:   9
- font height (in pixels) of *smallTextFont.

*nodeColorTrough:       white
- color of trough part (the  /100 portion) of a canvas scale item.