Sun Microsystems
Products & Services
 
Support & Training
 
 

Previous Previous     Contents     Index     Next Next
Chapter 3

Configuring Complex Resource Attributes

This chapter describes how to configure resource attribute definitions. Resource attribute definitions are stored in an entity called the grid engine system complex. In addition to background information relating to the complex and its associated concepts, this chapter provides detailed instructions on how to accomplish the following tasks:

Complex Resource Attributes

The complex configuration provides all pertinent information about the resource attributes users can request for jobs with the qsub -l or qalter -l commands. The complex configuration also provides information about how the grid engine system should interpret these resource attributes.

The complex also builds the framework for the system's consumable resources facility. The resource attributes that are defined in the complex can be attached to the global cluster, to a host, or to a queue instance. The attached attribute identifies a resource with the associated capability. During the scheduling process, the availability of resources and the job requirements are taken into account. The grid engine system also performs the bookkeeping and the capacity planning that is required to prevent oversubscription of consumable resources.

Typical consumable resource attributes include:

  • Available free memory

  • Unoccupied licenses of a software package

  • Free disk space

  • Available bandwidth on a network connection

Attribute definitions in the grid engine complex define how resource attributes should be interpreted.

The definition of a resource attribute includes the following:

  • Name of the attribute

  • Shortcut to reference the attribute name

  • Value type of the attribute, for example, STRING or TIME

  • Relational operator used by the scheduler

  • Requestable flag, which determines whether users can request the attribute for a job

  • Consumable flag, which identifies the attribute as a consumable resource

  • Default request value that is taken into account for consumable attributes if jobs do not explicitly specify a request for the attribute

  • Urgency value, which determines job priorities on a per resource basis

Use the QMON Complex Configuration dialog box, which is shown in Figure 3-1, to define complex resource attributes.

Configuring Complex Resource Attributes With QMON

In the QMON Main Control window, click the Complex Configuration button. The Complex Configuration dialog box appears.

Figure 3-1 Complex Configuration Dialog Box

Dialog box titled Complex Configuration. Shows resource attributes
and fields for defining new attributes. Shows Commit, Cancel, and Help buttons.

The Complex Configuration dialog box enables you to add, modify, or delete complex resource attributes.

To add a new attribute, first make sure that no line in the Attributes table is selected. In the fields above the Attributes table, type or select the values that you want, and then click Add.


Note - If you want to add a new attribute and an existing attribute is selected, you must clear the selection. To deselect a highlighted attribute, hold down the Control key and click mouse button 1.


You can add a new attribute by copying an existing attribute and then modifying it. Make sure that the attribute name and its shortcut are unique.

To modify an attribute listed in the Attributes table, select it. The values of the selected attribute are displayed above the Attributes table. Change the attribute values, and then click Modify.

To save configuration changes to a file, click Save. To load values from a file into the complex configuration, click Load, and then select the name of a file from the list that appears.

To delete an attribute in the Attribute table, select it, and then click Delete.

See the complex(5) man page for details about the meaning of the rows and columns in the table.

To register your new or modified complex configuration with sge_qmaster, click Commit.

Assigning Resource Attributes to Queues, Hosts, and the Global Cluster

Resource attributes can be used in the following ways:

  • As queue resource attributes

  • As host resource attributes

  • As global resource attributes

A set of default resource attributes is already attached to each queue and host. Default resource attributes are built in to the system and cannot be deleted, nor can their type be changed.

User-defined resource attributes must first be defined in the complex before you can assign them to a queue instance, a host, or the global cluster. When you assign a resource attribute to one of these targets, you specify a value for the attribute.

The following sections describe each attribute type in detail.

Previous Previous     Contents     Index     Next Next