1SHARE_TREE(5)              Grid Engine File Formats              SHARE_TREE(5)
2
3
4

NAME

6       share_tree - Grid Engine share tree file format
7

DESCRIPTION

9       The   share   tree  defines  the  long-term  resource  entitlements  of
10       users/projects and of a hierarchy of arbitrary groups thereof.
11
12       The current share tree  can  be  displayed  via  the  qconf(1)  -sstree
13       option.  The  output follows the share_tree format description. A share
14       tree can be created and an existing can be modified via the -astree and
15       -mstree  options  to qconf(1).  Individual share tree nodes can be cre‐
16       ated, modified, deleted, or shown via the -astnode, -dstnode, -mstnode,
17       and -sstnode options to qconf(1).
18
19       Note:  Grid  Engine  allows  backslashes  (\) be used to escape newline
20       (\newline) characters. The backslash and the newline are replaced  with
21       a space (" ") character before any interpretation.
22

FORMAT

24       The format of a share tree file is defined as follows:
25
26       ·  A  new  node  starts  with  the attribute id, and equal sign and the
27          numeric identification number of the  node.  Further  attributes  of
28          that node follow until another id-keyword is encountered.
29
30       ·  The  attribute  type  defines, if a sharetree node references a user
31          (type=0), or a project (type=1)
32
33       ·  The attribute childnodes contains a comma separated  list  of  child
34          nodes to this node.
35
36       ·  The  parameter name refers to an arbitrary name for the node or to a
37          corresponding user (see user(5)) or project (see project(5)) if  the
38          node is a leaf node of the share tree. The name for the root node of
39          the tree is "Root" by convention.
40
41       ·  The parameter shares defines the share of the node among  the  nodes
42          with the same parent node.
43
44       ·  A user leaf node named 'default' can be defined as a descendant of a
45          project(5)) node in the share tree. The  default  node  defines  the
46          number  of shares for users  who are running in the project, but who
47          do not have a user node defined under the project. The default  user
48          node  is  a convenient way of specifying a single node for all users
49          which should receive an equal share of the  project  resources.  The
50          default node may be specified by itself or with other user(5)) nodes
51          at the same level below a project.  All  users,  whether  explicitly
52          specified  as  a  user node or those which map to the 'default' user
53          node must have a corresponding user(5)) object defined in  order  to
54          get shares. Do not configure a user(5)) object named 'default'.
55
56

EXAMPLES

58       Jobs of projects P1 and P2 get 50 shares, all other jobs get 10 shares.
59
60       id=0
61       name=Root
62       type=0
63       shares=1
64       childnodes=1,2,3
65       id=1
66       name=P1
67       type=1
68       shares=50
69       childnodes=NONE
70       id=2
71       name=P2
72       type=1
73       shares=50
74       childnodes=NONE
75       id=3
76       name=default
77       type=0
78       shares=10
79       childnodes=NONE
80

SEE ALSO

82       sge_intro(1), qconf(1), project(5), user(5).
83

85       See sge_intro(1) for a full statement of rights and permissions.
86
87
88
89GE 6.1                   $Date: 2007/10/09 15:21:20 $            SHARE_TREE(5)
Impressum