b857a25081
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@15604 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
135 lines
2.9 KiB
Plaintext
135 lines
2.9 KiB
Plaintext
=head1 NAME
|
|
|
|
B<xcatstanzafile> - Format of a stanza file that can be used with xCAT data object definition commands.
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
A stanza file contains information that can be used to create xCAT data object definitions. A stanza file can be used as input to several xCAT commands. The stanza file contains one or more individual stanzas that provide information for individual object definitions. The following rules must be followed when creating a stanza file:
|
|
|
|
=over 2
|
|
|
|
=item *
|
|
|
|
An object stanza header consists of the object name followed by a colon, (":").
|
|
|
|
=item *
|
|
|
|
Attribute lines must take the form of Attribute=Value.
|
|
|
|
=item *
|
|
|
|
Attribute name might include the character dot ("."), like passwd.HMC and nicips.eth0.
|
|
|
|
=item *
|
|
|
|
Only one stanza can exist for each object name.
|
|
|
|
=item *
|
|
|
|
All stanzas except for default stanzas must have a value set for "objtype".
|
|
|
|
=item *
|
|
|
|
Comments beginning with the "#" pound sign may be added to the file. A comment must be on a separate line.
|
|
|
|
=item *
|
|
|
|
When parsing the file, tab characters and spaces are ignored.
|
|
|
|
=item *
|
|
|
|
Each line of the file can have no more than one header or attribute definition.
|
|
|
|
=item *
|
|
|
|
If the header name is "default-<object type>:" the attribute values in the stanza are considered default values for subsequent definitions in the file that are the same object type.
|
|
|
|
=item *
|
|
|
|
Default stanzas can be specified multiple times and at any point in a stanza file. The values apply to all definitions following the default stanzas in a file. The default values are cumulative; a default attribute value will remain set until it is explicitly unset or changed.
|
|
|
|
=item *
|
|
|
|
To turn off a default value, use another default stanza to set the attribute to have no value using a blank space.
|
|
|
|
=item *
|
|
|
|
When a specific value for an attribute is provided in the stanza, it takes priority over any default value that had been set.
|
|
|
|
=back
|
|
|
|
|
|
The format of a stanza file should look similar to the following.
|
|
|
|
default-<object type>:
|
|
attr=val
|
|
attr=val
|
|
. . .
|
|
|
|
<object name>:
|
|
objtype=<object type>
|
|
attr=val
|
|
attr=val
|
|
. . .
|
|
|
|
<object name>:
|
|
objtype=<object type>
|
|
attr=val
|
|
attr=val
|
|
. . .
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
=over 3
|
|
|
|
=item 1)
|
|
|
|
Sample stanza file:
|
|
|
|
mysite:
|
|
objtype=site
|
|
rsh=/bin/rsh
|
|
rcp=/bin/rcp
|
|
installdir=/xcatinstall
|
|
domain=ppd.pok.ibm.com
|
|
|
|
MSnet01:
|
|
objtype=network
|
|
gateway=1.2.3.4
|
|
netmask=255.255.255.0
|
|
nameserver=5.6.7.8
|
|
|
|
default-node:
|
|
next_osimage=aix61
|
|
network=MSnet01
|
|
groups=all,compute
|
|
|
|
node01:
|
|
objtype=node
|
|
MAC=A2E26002C003
|
|
xcatmaster=MS02.ppd.pok.com
|
|
nfsserver=IS227.ppd.pok.com
|
|
|
|
node02:
|
|
objtype=node
|
|
MAC=A2E26002B004
|
|
xcatmaster=MS01.ppd.pok.com
|
|
nfsserver=IS127.ppd.pok.com
|
|
|
|
grp01:
|
|
objtype=group
|
|
members=node1,node2,node3
|
|
|
|
=back
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
This file is part of xCAT software product.
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<mkdef(1)|mkdef.1>, L<lsdef(1)|lsdef.1>, L<rmdef(1)|rmdef.1>, L<chdef(1)|chdef.1>
|