share_tree - Grid Engine share tree file format
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 user(5).
The current share tree can be displayed via the qconf(1) -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 qconf(1). 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 qconf(1).
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:
o 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.
o The attribute type defines whether a sharetree node references a
user (type=0), or a project (type=1).
o The attribute childnodes contains a comma-separated list of child
nodes to this node.
o The parameter name refers to an arbitrary name for the node, or to a
corresponding user (see user(5)) or project (see project(5)) if the
node is a leaf node of the share tree. The name of the root node of
the tree is "Root" by convention.
o The parameter shares defines the share of the node among the nodes
with the same parent node.
o A user leaf node named 'default' can be defined as a descendant of a
project(5) 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 user(5) 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 user(5) object defined in order to
get shares. Do not configure a user(5) object named 'default'.
Jobs of projects P1 and P2 get 50 shares, all other jobs get 10 shares.
sge_intro(1), qconf(1), qmon(1), sge_share_mon(1), project(5), user(5).
See sge_intro(1) for a full statement of rights and permissions.
SGE 8.1.3pre 2011-05-19 SHARE_TREE(5)
Man(1) output converted with