table of contents
other versions
- wheezy 6.2u5-7.1
- jessie-backports 8.1.9+dfsg-1~bpo8+1
- testing 8.1.9+dfsg-4
- unstable 8.1.9+dfsg-4
QMON(1) | Sun Grid Engine User Commands | QMON(1) |
NAME¶
qmon - X-Windows OSF/Motif graphical user's interface for Sun Grid EngineSYNTAX¶
qmon [options]DESCRIPTION¶
Qmon allows administrators and users to manipulate the Sun Grid Engine system from an X-Window environment. Qmon provides various dialogues linked together in multiple ways. For each task the user wishes to accomplish via qmon a corresponding dialogue is provided. There are multiple ways to address the proper dialogue for a certain task:- •
- The qmon main window that comes up first on start-up contains icon buttons for all major administrative and user tasks. A functionality tooltip is displayed when pointing at the different icons.
- •
- A Task pulldown menu button appears in the qmon main window menu bar. Clicking on it opens a list of available tasks. Selecting one of them opens the corresponding dialogue.
- •
- The Task pulldown menu also contains the key accelerators which can be used to invoke the task dialogues directly from the main window by pressing a certain button sequence on the keyboard.
- •
- While navigating through a certain dialogue and its dialogue subhierarchy, links to other dialogues occur whenever a connection between both dialogues is obvious. Pushing the buttons that identify the links opens up the other dialogues.
OPTIONS¶
The supported options are the standard X Toolkit options as described in section Options. Furthermore, qmon supports:- -cmap
- Installs a private color map for qmon. This is sometimes useful if other applications have already allocated lots of colors and if qmon, therefore, prints corresponding error messages. Note, however, that using a private color map will result in color map switches whenever you enter or leave qmon windows.
- -fontFamily {big|medium|small}
- Notifies qmon to use different sized font families for different resolution sizes.
- -help
- Displays usage information.
- -nologo
- Startup without logo.
DIALOGUES¶
Job Control¶
The Job Control dialogue provides a folder of tabulated lists of the still pending jobs, already running jobs and recently finished jobs. The dialogue allows for detailed information on the jobs as well as for the deletion and suspension of jobs being selected. In addition the job control dialogue offers links to the Submit dialogue in order to submit new jobs or to change attributes of pending jobs ( Qalter button). The shown displayed fields in the tabular display and the jobs displayed can be customized by pressing the Customize button. This customization can be saved to the ~/.qmon_preferences file and is used on following startups for the initial configuration of the Job Control dialogue.Queue Control¶
The Queue Control dialogue with its sub-dialogue hierarchy enables the user to control the status of the Sun Grid Engine queues being actually configured in the system and allows the administrator to add new queues or to modify or delete already existing ones. The Queue Control dialogue shows a tabbed view of Cluster Queues or their corresponding Queue Instances in a tabular way.Submit¶
The Job Submission dialogue serves for submitting batch and interactive jobs and is also invoked when changing attributes of pending jobs from the Job Control dialogue explained above ( Qalter button). To toggle between batch and interactive jobs please use the Batch/Interactive button at the top of the button column on the right side of the Job Submission screen.Complex Config¶
The Complex Config allows the administrator to add new complex attributes or to modify or delete existing ones (see The complex configuration dialogue provides a tabulated list of the complex attribute entries and an input region for the declaration of new or modified entries. The Add button updates the tabulated list with a new attribute. The Modify button changes a highlighted existing entry. The Delete button removes the highlighted attributes. The Load and Save buttons allow saving or reloading the whole attribute list to or from file. The Ok button registers the additional or modified complex attributes withHost Config¶
Four types of host related lists can be maintained via the Host Config dialogue:Administration Hosts Submit Hosts Host Groups Execution Hosts
Cluster Config¶
This dialogue maintains the cluster global configuration as well as host specific derivatives (see When opened, the dialogue displays a selection list for all hosts which have a configuration assigned. The special name "global" refers to the cluster global configuration. By pushing the Add/Modify button a sub-dialogue is opened, which allows for modification of the cluster configuration. For host specific configurations the 'global' host specific configuration fields are set insensitive and only the allowed parameters can be manipulated.Scheduler Config¶
The Scheduler Configuration dialogue provides the means to change the behavior of the Sun Grid Engine scheduler thread part of process. The dialogue contains a representation for all scheduler configuration parameters as described in It is subdivided in the two sections General Parameters and Load Adjustments which can be selected via the corresponding tabs. The Ok button registers any changes withCalendar Config¶
The Calendar Config allows the administrator to add new calendars or to modify or delete existing ones (see The dialogue offers a selection list for the existing calendars and displays the configuration of the one being selected. By pushing the Delete button, the selected calendar is deleted from the configuration. Pushing the Add/Modify button will open a calendar configuration dialogue, which allows to create new calendars or which provides the means to change the existing ones. The Ok button registers the additional or modified calendar withUser Config¶
User permissions are controlled via the User Config dialogue. The tab widget in the left section of the dialogue allows for selecting betweenConfiguration of Manager accounts. Configuration of Operator accounts. Definition of Usersets. Definition of User accounts.
PE Config¶
Parallel environment (PE) interfaces can be configured with this dialogue. PE interfaces are necessary to describe the way how parallel programming environments like PVM (Parallel Virtual Machine), MPI (Message Passing Interface) or shared memory parallel systems are to be instantiated and to impose access restrictions onto the PEs. When the dialogue is opened a list of the already configured PEs is displayed together with the current configuration (see of the selected PE interface. To add new PE interfaces or to modify existing ones, an Add and a Modify button is available which opens a PE interface configuration sub-dialogue. After applying the changes and quitting this sub-dialogue with the OK button, the new or modified PE interface is registered withCheckpoint Config¶
Checkpointing environment interfaces can be configured with this dialogue. Checkpointing environments are necessary to describe the attributes which the different checkpointing methods and their derivatives on various operating system platforms supported by Sun Grid Engine have. When the dialogue is opened a list of the already configured checkpointing environments is displayed together with the current configuration (see of the selected checkpointing environment. To add new checkpointing environment or to modify existing ones, an Add and a Modify button is available which opens a checkpointing environment configuration sub-dialogue. After applying the changes and quitting this sub-dialogue with the OK button, the new or modified checkpointing environment is registered withTicket Conf¶
This dialogue offers an overview and editing screen for allocating tickets to the share-based, functional and override scheduling policies. The Deadline Job button opens the User Conf dialogue box. Please change to the Userset sub-dialogue and select the userset named "deadlineusers". Only users of this userset may submit deadline jobs.Project Conf¶
This button opens a dialog for creating projects.Browser¶
The Object Browser dialogue's purpose is manifold: First of all, Sun Grid Engine and qmon messages such as notification of error or success concerning a previously taken action can be displayed in the dialogue's output window. Also the standard output and the standard error output of qmon can be diverted to the Object Browser output window.- •
- Queue configurations are displayed as soon as the mouse pointer enters a queue icon in the top level Queue Control dialogue (see above). This facility is activated by pushing the Queue button in the Object Browser dialogue.
- •
- Detailed job information is printed as soon as the user moves the mouse pointer over a line in the Job Control dialogue (see above) being assigned to a running or pending job.
- •
- Additionally job scheduling information is displayed in the browser if the Why ? button in the Job Control dialogue is pressed. In this case the Browser dialogue is opened implicitly and any scheduling related information is displayed.
Exit¶
The Exit icon button is not linked with a dialogue. Its sole purpose is to close all active qmon dialogues and to exit the application.RESOURCES¶
The available resources, their meaning and the syntax to be followed in order to modify them are described in the default qmon resource file (see the section Files below for the location of the resource file).ENVIRONMENTAL VARIABLES¶
- SGE_ROOT
- Specifies the location of the Sun Grid Engine standard configuration files.
- SGE_CELL
- If set, specifies the default Sun Grid Engine cell. To
address a Sun Grid Engine cell qmon uses (in the order of
precedence):
The name of the cell specified in the
environment variable SGE_CELL, if it is set.
The name of the default cell, i.e. default.
- SGE_DEBUG_LEVEL
- If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug information is generated is defined.
- SGE_QMASTER_PORT
- If set, specifies the tcp port on which is expected to listen for communication requests. Most installations will use a services map entry instead to define that port.
RESTRICTIONS¶
If the line to be entered in an editing window is longer than the width of the window, then the text just runs off the end of the window.FILES¶
<sge_root>/qmon/Qmon Qmon sample resources file /usr/lib/X11/defaults/Qmon Qmon system resources file $HOME/Qmon Qmon user resources file $HOME/.qmon_preferences Qmon job/queue customization file
SEE ALSO¶
COPYRIGHT¶
See and the information provided in <sge_root>/3rd_party/qmon for a statement of further rights and permissions and for credits to be given to public domain and freeware widget developers.$Date$ | SGE 6.2u5 |