Sun Grid Engine Information Center
Administering Sun Grid Engine
Index

Configuring Hosts With QMON

The QMON Host Configuration dialog box has four tabs:

• Execution Host tab
• Administration Host tab
• Submit Host tab
• Host Groups tab

The qconf command provides the command-line interface for managing host objects. See Configuring Hosts From the Command Line for more details.

Configuring Execution Hosts With QMON

Before you configure an execution host, you must first install the software on the execution host as described in How to Install Execution Hosts.

About the Execution Host Tab

To configure execution hosts, click the Host Configuration button on the QMON Main Control window, and then click the Execution Host tab. The Execution Host tab looks like the following figure:

Note Administrative or submit commands are allowed from execution hosts only if the execution hosts are also declared to be administration or submit hosts. See Configuring Administration Hosts With QMON and Configuring Submit Hosts With QMON.

Note the following in the Execution Host tab:

• The Hosts list displays the execution hosts that are already defined.
• The Load Scaling list displays the currently configured load-scaling factors for the selected execution host. See Load Parameters for information about load parameters.
• The Access Attributes list displays access permissions. See Managing User Access for information about access permissions.
• The Consumables/Fixed Attributes list displays resource availability for consumable and fixed resource attributes associated with the host. See Configuring Complex Resource Attributes for information about resource attributes.
• The Reporting Variables list displays the variables that are written to the reporting file when a load report is received from an execution host. See Defining Reporting Variables for information about reporting variables.
• The Usage Scaling list displays the current scaling factors for the individual usage metrics CPU, memory, and I/O for different machines. Resource usage is reported by sge_execd periodically for each currently running job. The scaling factors indicate the relative cost of resource usage on the particular machine for the user or project running a job. These factors could be used, for instance, to compare the cost of a second of CPU time on a 400 MHz processor to that of a 600 MHz CPU. Metrics that are not displayed in the Usage Scaling list have a scaling factor of 1.

How to Add or Modify an Execution Host

1. To add or modify an execution host, on the QMON Main Control window, click the Host Configuration button.
   
   
2. Click the Execution Host tab.
   
   
3. Click Add or Modify.
   The Add/Modify Exec Host dialog box appears as shown in the following figure. The Add/Modify Exec Host dialog box enables you to modify all attributes associated with an execution host. The name of an existing execution host is displayed in the Host field.
   
   
   
4. To add a new execution host, type its name in the Host field.
   
   
5. To define scaling factors, click the Scaling tab.
   • The Load column of the Load Scaling table lists all available load parameters. The Scale Factor column lists the corresponding definitions of the scaling. You can edit the Scale Factor column. Valid scaling factors are positive floating-point numbers in fixed-point notation or scientific notation.
   • The Usage column of the Usage Scaling table lists the current scaling factors for the usage metrics CPU, memory, and I/O. The Scale Factor column lists the corresponding definitions of the scaling. You can edit the Scale Factor column. Valid scaling factors are positive floating-point numbers in fixed-point notation or scientific notation.
     
6. To define the resource attributes to associate with the host, click the Consumables/Fixed Attributes tab.
   The Consumables/Fixed Attributes table lists all resource attributes for which a value is currently defined.
   
   

   Tip Use the Complex Configuration dialog box if you need more information about the current complex configuration, or if you want to modify it. For details about complex resource attributes, see Configuring Complex Resource Attributes.

   
   You can enhance the list by clicking either the Name or the Value column name. The Attribute Selection dialog box appears, which includes all resource attributes that are defined in the complex.
   

   • To add an attribute to the Consumables/Fixed Attributes table, select the attribute, and then click OK.
   • To modify an attribute value, double-click a Value field, and then type a value.
   • To delete an attribute, select the attribute, and then press Control-D or click mouse button 3.
     Click Ok to confirm that you want to delete the attribute.
     
7. Define access permissions based upon an existing project or upon user access lists.
   
   • To define user access permissions to the execution host based on previously configured user access lists, click the User Access tab.
     
     
   • To define project access permissions to the execution host based on previously configured projects, click the Project Access tab.
     
     
     
8. To define reporting variables, click the Reporting Variables tab.
   
   The Available list displays all the variables that can be written to the reporting file when a load report is received from the execution host.
   
   • To add a variable to the Selected list, select a reporting variable from the Available list, and then click the red right arrow .
     
   • To remove a reporting variable from the Selected list, select the variable, and then click the left red arrow.

How to Delete an Execution Host

1. To delete an execution host, on the QMON Main Control window, click the Host Configuration button.
   
   
2. Click the Execution Host tab.
   
   
3. In the Execution Host dialog box, select the host that you want to delete, and click Delete.

How to Shut Down an Execution Host Daemon

1. To shut down an execution host daemon, on the QMON Main Control window, click the Host Configuration button.
   
   
2. Click the Execution Host tab.
   
   
3. In the Execution Host dialog box, select a host, and click Shutdown.

Configuring Administration Hosts With QMON

Use the Administration Host tab to configure hosts on which administrative commands are allowed. The Host list displays the hosts that already have administrative permission.

How to Add or Remove an Administration Host With QMON

To configure Administration Hosts with QMON, do the following:

1. On the QMON Main Control window, click the Host Configuration button.
   The Host Configuration dialog box appears and displays the Administration Host tab as shown in the following figure.
   
   

   Note The Administration Host tab is displayed by default when you click the Host Configuration button for the first time.

   
   

2. To add a new administration host, type its name in the Host field, and then click Add, or press the Return key.
   
   
3. To delete an administration host, select the administrative host name from the list, and then click Delete.

Configuring Submit Hosts With QMON

Use the Submit Host tab to declare the hosts from which jobs can be submitted, monitored, and controlled. The Host list displays the hosts that already have submit permission.

Note No administrative commands are allowed from submit hosts unless the hosts are also declared to be administration hosts. See Configuring Administration Hosts With QMON for more information.

How to Add or Remove a Submit Host With QMON

1. On the QMON Main Control window, click the Host Configuration button.
   The Host Configuration dialog box appears.
   
   
2. Click the Submit Host tab.
   The Submit Host page appears as shown in the following figure.
   
   
   
3. To add a submit host, type the submit host name in the Host field, and then click Add, or press the Return key.
   
   
4. To delete a submit host, select the submit host name from the list, and then click Delete.

Configuring Host Groups With QMON

Use the Host Groups tab to configure host groups. The Hostgroup list displays the currently configured host groups. The Members list displays all the hosts that are members of the selected host group.

About the Host Groups Tab

To group similar hosts together, click the Host Configuration button on the QMON Main Control window, and then click the Host Groups tab.

Host groups enable you to use a single name to refer to multiple hosts. A host group can include other host groups as well as multiple individual hosts. Host groups that are members of another host group are subgroups of that host group.

For example, you might define a host group called @bigMachines that includes the following members:

• @solaris64
• @solaris32
• fangorn
• balrog

The initial @ sign indicates that the name is a host group. The host group @bigMachines includes all hosts that are members of the two subgroups @solaris64 and @solaris32. @bigMachines also includes two individual hosts, fangorn and balrog.

How to Add or Modify a Host Group With QMON

1. On the QMON Main Control window, click the Host Configuration button.
   The Host Configuration dialog box appears.
   
   
2. Click the Host Groups tab.
   The Host Groups page appears, as shown in the following figure.
   
   
   
3. To add a host group, click Add.
   The Add/Modify Host Group dialog box appears, as shown in the following figure.
   
   Type a host group name in the Hostgroup field.
   The host group name must begin with an @ sign.
   
   
4. To change information about a host group, select the host group in the Hostgroup list and click Modify.
   The Add/Modify Host Group dialog box appears and provides information about the selected host group.
   
   • To add a host to the Members list for the selected host group, type the host name in the Host field and click the red arrow.
   • To add a host group as a subgroup, select a host group name from the Defined Host Groups list and click the red arrow.
   • To remove a host or a host group, select it from the Members list and click the trash icon.
     
5. Click Ok to save your changes and close the dialog box.
   Click Cancel to close the dialog box without saving your changes.