Sun Grid Engine maintains object lists for all types of hosts except for the master host. In the case of the administrative and submit hosts these lists simply provide the information whether or not a host has administrative or submit permission. In the case of the execution host object, further parameters, such as the load
information as reported by the cod_execd running on the host is stored there as
well as load parameter scaling factors to be provided by the Sun Grid Engine administrator.
The following sections explain how to configure the different host objects with the help of the Sun Grid Engine OSF/Motif graphical users interface qmon and from
58 58 58
58 Sun Grid Engine July 2001
The GUI administration is provided by a set of host configuration dialogues which are invoked by pushing the HostConfig icon button in the qmon main menu. The
available dialogues are the administration host configuration (see figure 2-2), the submit host configuration (see figure 2-3) and the execution host configuration (see figure 2-4). The dialogues can be switched by using the selection list button at the top of the screen.
The qconf command provides the command-line interface for the host object
management.
Administrative Hosts
The Administration Host Configuration dialogue is opened upon selecting
AdministrationHost in the tab widget on the top of the screen. The
administration host configuration dialogue is opened by default when the Host Config button is pressed for the first time.
With this dialogue hosts can be declared from which administrative Sun Grid Engine commands are allowed. The selection list in the center of the screen displays the hosts already declared to provide administrative permission. An existing host can be deleted from this list by clicking on its name with the left mouse button and by pushing the Delete button at the bottom of the dialogue. A new host can be added
by entering its name to the Hostname input window and pressing the Add button
Chapter 2 Installation and Administration Guide 59595959
The command-line interface for maintaining the list of administration hosts is provided by the following options to the qconf command:
qconf -ahhostname
add administrative host. Adds the specified host to the list of administrative hosts.
qconf -dhhostname
delete administrative host. Deletes the specified host from the list of administrative hosts.
FIGURE 2-2 FIGURE 2-2 FIGURE 2-2
60 60 60
60 Sun Grid Engine July 2001 qconf -sh
show administrative hosts. Displays a list of all currently configured administrative hosts.
Submit Hosts
The Submit Host Configuration dialogue is opened upon selecting SubmitHost in
the tab widget on the top of the screen. Hosts can be declared from which jobs can be submitted, monitored and controlled. No administrative Sun Grid Engine
commands are allowed from these hosts unless they are declared to be
administrative hosts also (see Administrative Hosts on page 58). The selection list in the center of the screen displays the hosts already declared to provide submit permission. An existing host can be deleted from this list by clicking on its name with the left mouse button and by pushing the Delete button at the bottom of the
dialogue. A new host can be added by entering its name to the Hostname input
Chapter 2 Installation and Administration Guide 61616161
The command-line interface for maintaining the list of submit hosts is provided by the following options to the qconf command:
qconf -ashostname
add submit host. Adds the specified host to the list of submit hosts.
qconf -dshostname
delete submit host. Deletes the specified host from the list of submit hosts. FIGURE 2-3
FIGURE 2-3 FIGURE 2-3
62 62 62
62 Sun Grid Engine July 2001 qconf -ss
show submit hosts. Displays a list of the names of all hosts currently configured to provide submit permission.
Execution Hosts
The Execution Host Configuration dialogue is opened upon selecting Execution Host in the tab widget on the top of the screen. Sun Grid Engine execution hosts can
be configured from this dialogue. No administrative or submit commands are automatically allowed from these hosts unless they are declared to be administrative or submit hosts also (see Administrative Hosts on page 58 and Submit Hosts on page 60).
The Hosts selection list displays the execution hosts already defined. The currently
configured load scaling factors, the access permissions and the resource availability for consumable and fixed complex attributes associated with the host are displayed in the LoadScaling, the AccessAttributes and the Consumable/Fixed Attributes display windows for the selected execution host. Please refer to
section The Complexes Concept, section User Access Permissions and section Load Parameters, for details on complex attributes, user access permissions and load parameters.
An existing host can be deleted from the list of execution hosts by clicking on its name with the left mouse button and by pushing the Delete button at the button
column on the right side of the dialogue. The execution daemon cod_execd on an
execution host can be shut down by pushing the Shutdown button for any selected
host. A new host can be added or modified pushing the Add or Modify button in
the button column. This will open the dialogue displayed in figure 2-5 on page 65 and described below.
Chapter 2 Installation and Administration Guide 63636363
The dialogue to add a new execution host or modify the configuration of an existing one allows for modification of all attributes associated with the host. The name of the execution host is displayed or can be added in the Host input window. Scaling
factors can be defined if Scaling is selected in the tab widget of the dialogue (see
figure 2-5 on page 65). FIGURE 2-4 FIGURE 2-4 FIGURE 2-4
64 64 64
64 Sun Grid Engine July 2001
All available load parameters are displayed in the Load column of the Load Scaling table and the corresponding definition of the scaling can be found in the ScaleFactor column. The ScaleFactor column can be edited. Valid scaling
factors are positive floating point numbers in fixed point or scientific notation. If Consumables/FixedAttributes is selected in the tab widget, the complex
attributes associated with the host can be defined (see figure 2-7 on page 66). The complexes (see section The Complexes Concept) associated with the host are the
global and the host complex or the administrator defined complexes attached to the host via the ComplexSelection area on the left bottom of the dialogue. Available
administrator defined complexes are displayed on the left and they can be attached or detached via the red arrows. The ComplexConfig icon button opens the top
level complex configuration dialogue in case you need further information on the current complex configuration or if you want to modify it.
The Consumable/FixedAttributes table in the right bottom area of the
dialogue enlists all complex attributes for which a value currently is defined. The list can be enhanced by clicking to the Name or Value button at the top. This will open
a selection list with all attributes attached to the host (i.e. the union of all attributes configured in the global, the host and the administrator defined complexes attached to this host as described above). The attribute selection dialogue is shown in figure
2-7 on page 66. Selecting one of the attributes and confirming the selection with the
Ok button will add the attribute to the Name column of the Consumable/Fixed Attributes table and will put the pointer to the corresponding Value field.
Modifying an existing value can be achieved by double-clicking with the left mouse button on the Value field. Deleting an attribute is performed by first selecting the
corresponding table line with the left mouse button. The selected list entry can be deleted either by typing CTRL-D or by clicking the right mouse button to open a
Chapter 2 Installation and Administration Guide 65656565 FIGURE 2-5
FIGURE 2-5 FIGURE 2-5
66 66 66
66 Sun Grid Engine July 2001 FIGURE 2-6 FIGURE 2-6 FIGURE 2-6
FIGURE 2-6 Modify Consumable/Fixed Attributes
FIGURE 2-7 FIGURE 2-7 FIGURE 2-7
Chapter 2 Installation and Administration Guide 67676767
If UserAccess is selected in the tab widget (figure 2-8 on page 67), the access
permissions to the execution host can be defined based on previously configured user access lists (section Configure User Access Lists with qmon).
The command-line interface for maintaining the list of execution hosts is provided by the following options to the qconf command:
qconf -ae[exec_host_template]
add execution host. Brings up an editor (default vi or corresponding to the $EDITOR environment variable) with an execution host configuration template. If
the optional parameter exec_host_template (the name of an already configured execution host) is present the configuration of this execution host is used as template. The execution host is configured by changing the template and saving to disk. See the host_confmanual page in the Sun Grid Engine Reference Manual for a
detailed description of the template entries to be changed.
qconf -dehostname
delete execution host. Deletes the specified host from the list of execution hosts. All entries in the execution host configuration are lost.
FIGURE 2-8 FIGURE 2-8 FIGURE 2-8
68 68 68
68 Sun Grid Engine July 2001
qconf -me hostname
modify execution host. Brings up an editor (default vi or corresponding to the $EDITOR environment variable) with the configuration of the specified execution
host as template. The execution host configuration is modified by changing the template and saving to disk. See the host_confmanual page in the Sun Grid
Engine Reference Manual for a detailed description of the template entries to be changed.
qconf -Me filename
modify execution host. Uses the content of filename as execution host configuration template. The configuration in the specified file must refer to an existing execution host. The configuration of this execution host is replaced by the file content. This
qconf option is useful for off-line execution host configuration changes, e.g. in cron jobs, as it requires no manual interaction.
qconf -se hostname
show execution host. Show the configuration of the specified execution host as defined in host_conf.
qconf -sel
show execution host list. Display a list of host names which are configured to be execution hosts.