NAME¶
share_tree - Grid Engine share tree file format
DESCRIPTION¶
The share tree defines the long-term resource entitlements of users/projects and
of a hierarchy of arbitrary groups thereof. Note that it is normally necessary
to maintain users explicitly to use a share tree, rather than use automatic
creation and (specifically) destruction, or at least set
auto_user_delete_time to 0; see
The current share tree can be displayed via the
-sstree or
-sst
options. The output follows the
share_tree format description. A share
tree can be created and an existing one can be modified via the
-astree
and
-mstree options to The
-sst option shows a formatted share
tree (tree view). Individual share tree nodes can be created, modified,
deleted, or shown via the
-astnode,
-dstnode,
-mstnode,
and
-sstnode options to
Note, Grid Engine allows backslashes (\) be used to escape newline characters.
The backslash and the newline are replaced with a space character before any
interpretation.
The format of a share tree file is defined as follows:
- •
- A new node starts with the attribute id, an equal sign and the
numeric identification number of the node. Further attributes of that node
follow until another id keyword is encountered.
- •
- The attribute type defines whether a sharetree node references a
user (type=0), or a project (type=1).
- •
- The attribute childnodes contains a comma-separated list of child
nodes to this node.
- •
- The parameter name refers to an arbitrary name for the node, or to
a corresponding user (see or project (see if the node is a leaf node of
the share tree. The name of the root node of the tree is "Root"
by convention.
- •
- The parameter shares defines the share of the node among the nodes
with the same parent node.
- •
- A user leaf node named 'default' can be defined as a descendant of a node
in the share tree. The default node defines the number of shares for users
who are running in the project, but who do not have a user node defined
under the project. The default user node is a convenient way of specifying
a single node for all users which should receive an equal share of the
project resources. The default node may be specified by itself or with
other nodes at the same level below a project. All users, whether
explicitly specified as a user node or those which map to the 'default'
user node, must have a corresponding object defined in order to get
shares. Do not configure a object named 'default'.
EXAMPLES¶
Jobs of projects P1 and P2 get 50 shares, all other jobs get 10 shares.
id=0
name=Root
type=0
shares=1
childnodes=1,2,3
id=1
name=P1
type=1
shares=50
childnodes=NONE
id=2
name=P2
type=1
shares=50
childnodes=NONE
id=3
name=default
type=0
shares=10
childnodes=NONE
SEE ALSO¶
COPYRIGHT¶
See for a full statement of rights and permissions.