Workload Manager shares File

Purpose

Contains the definition of the number of shares of all the resources allocated to superclasses or subclasses for a given configuration.

Description

The shares file in the /etc/wlm/Config directory describes the resource allocations for the superclasses of the WLM configuration named Config. If the superclass named Super of this configuration has subclasses defined, the resource allocations for the subclasses are defined in the file /etc/wlm/Config/Super/shares.

The file is organized into stanzas that are named after WLM classes and contain attribute-value pairs specifying the number of shares allocated to the class for the various resources. The attribute names identify the resource. The shares value is either an integer between 1 and 65535 or a hyphen (-) to indicate that WLM does not regulate the class for the given resource. The hyphen is the system default.

Attributes

Each stanza names a WLM class that must exist in the classes file at the corresponding level (superclass or subclass).

The following are class attributes defined in the shares file:

Item	Description
CPU	Specifies the number of CPU shares allocated to the class
memory	Specifies the number of physical memory shares allocated to the class
diskIO	Specifies the number of disk I/O shares allocated to the class

The default values mentioned above are the system default and can be modified using a special stanza named "default."

Consider the following stanza at the beginning of the shares file:

default:
    CPU           = 10
    diskIO       = 4

This stanza defines the default values for the number of shares for CPU and disk I/O so that if the CPU and diskIO attributes are not specified for some or all of the classes specified, the attributes default to 10 and 4, respectively. In this example, the default value for physical memory is still a hyphen, meaning no regulation. Classes that use only default values for all the resource types can be omitted in the shares file.

Security

The shares file must have write permission for root user only. The shares file for superclasses must have write permission for the adminuser and admingroup for the superclass.

If no adminuser exists for the superclass, the files should be owned by root. If no admingroup exists for a superclass, the shares file for the superclass should be owned by the system group and should have no write permission for group.

Example

The following is an example of a typical /etc/wlm/Config/shares file:

* System Defined Classes
* In this example, the system administrator uses
* only default values for the System
* and Shared
* superclasses, and those are omitted
* in the file
* The system administrator gives non
* default values
* only for the Default class:
*
Default:
    CPU    = 5
    memory = 10
*
* User defined classes
*
Super1:
    CPU     = 8
    memory  = 20
    diskIO = 6
Super2:
   memory  = 12
    diskIO = 6

Note: The asterisk (*) is a comment character.

Files

Item	Description
shares	Defines the resource entitlements for the superclasses or subclasses of a WLM configuration