diff --git a/create_man_pages.py b/create_man_pages.py index 3002f2d20..2a5ff368a 100755 --- a/create_man_pages.py +++ b/create_man_pages.py @@ -130,7 +130,7 @@ for component in COMPONENTS: cmd = "perl -I %s/share/perl5 %s/bin/%s " %(prefix_path, prefix_path, POD2RST) cmd += " --infile=%s --outfile=%s --title=%s.%s" %(pod_input, rst_output, title, man_ver) - print cmd + # print cmd os.system(cmd) if man_ver == '1' or man_ver == '8': fix_vertical_bar(rst_output) diff --git a/docs/source/advanced/index.rst b/docs/source/advanced/index.rst index 851788614..dacf235d0 100755 --- a/docs/source/advanced/index.rst +++ b/docs/source/advanced/index.rst @@ -22,5 +22,4 @@ Advanced Topics softlayer/index.rst switches/index.rst sysclone/index.rst - webservices/index.rst zones/index.rst diff --git a/docs/source/guides/admin-guides/references/man5/auditlog.5.rst b/docs/source/guides/admin-guides/references/man5/auditlog.5.rst index 142d68d3a..d177660f8 100644 --- a/docs/source/guides/admin-guides/references/man5/auditlog.5.rst +++ b/docs/source/guides/admin-guides/references/man5/auditlog.5.rst @@ -27,11 +27,7 @@ DESCRIPTION *********** - -.. code-block:: perl - - Audit Data log. - +Audit Data log. ******************** diff --git a/docs/source/guides/admin-guides/references/man5/eventlog.5.rst b/docs/source/guides/admin-guides/references/man5/eventlog.5.rst index 8387bb43c..f75afb9de 100644 --- a/docs/source/guides/admin-guides/references/man5/eventlog.5.rst +++ b/docs/source/guides/admin-guides/references/man5/eventlog.5.rst @@ -104,11 +104,7 @@ eventlog Attributes: \ **rawdata**\ - - .. code-block:: perl - - The data that associated with the event. - + The data that associated with the event. diff --git a/docs/source/guides/admin-guides/references/man5/ipmi.5.rst b/docs/source/guides/admin-guides/references/man5/ipmi.5.rst index 5122a442c..84b8cfde1 100644 --- a/docs/source/guides/admin-guides/references/man5/ipmi.5.rst +++ b/docs/source/guides/admin-guides/references/man5/ipmi.5.rst @@ -50,14 +50,11 @@ ipmi Attributes: \ **bmcport**\ + In systems with selectable shared/dedicated ethernet ports, this parameter can be used to specify the preferred port. 0 means use the shared port, 1 means dedicated, blank is to not assign. + .. code-block:: perl - In systems with selectable shared/dedicated ethernet ports, - this parameter can be used to specify the preferred port. 0 - means use the shared port, 1 means dedicated, blank is to not - assign. - The following special cases exist for IBM System x servers: For x3755 M3 systems, 0 means use the dedicated port, 1 means diff --git a/docs/source/guides/admin-guides/references/man5/mpa.5.rst b/docs/source/guides/admin-guides/references/man5/mpa.5.rst index e44e0f87d..4b03e9d12 100644 --- a/docs/source/guides/admin-guides/references/man5/mpa.5.rst +++ b/docs/source/guides/admin-guides/references/man5/mpa.5.rst @@ -63,9 +63,14 @@ mpa Attributes: \ **slots**\ The number of available slots in the chassis. For PCM, this attribute is used to store the number of slots in the following format: ,, Where: - = number of rows of slots in chassis - = number of columns of slots in chassis - = set to 0 if slots are vertical, and set to 1 if slots of horizontal + + + .. code-block:: perl + + = number of rows of slots in chassis + = number of columns of slots in chassis + = set to 0 if slots are vertical, and set to 1 if slots of horizontal + diff --git a/docs/source/guides/admin-guides/references/man5/nics.5.rst b/docs/source/guides/admin-guides/references/man5/nics.5.rst index 4855c0a56..6b3e28c29 100644 --- a/docs/source/guides/admin-guides/references/man5/nics.5.rst +++ b/docs/source/guides/admin-guides/references/man5/nics.5.rst @@ -44,7 +44,8 @@ nics Attributes: \ **nicips**\ - Comma-separated list of IP addresses per NIC. To specify one ip address per NIC: + Comma-separated list of IP addresses per NIC. + To specify one ip address per NIC: !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 To specify multiple ip addresses per NIC: !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. @@ -102,9 +103,9 @@ nics Attributes: \ **nicaliases**\ Comma-separated list of hostname aliases for each NIC. - Format: eth0!,eth1!| - For multiple aliases per nic use a space-separated list. - For example: eth0!moe larry curly,eth1!tom|jerry + Format: eth0!,eth1!| + For multiple aliases per nic use a space-separated list. + For example: eth0!moe larry curly,eth1!tom|jerry @@ -121,7 +122,7 @@ nics Attributes: \ **nicdevices**\ - Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by |. !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. + Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by | . !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. diff --git a/docs/source/guides/admin-guides/references/man5/noderes.5.rst b/docs/source/guides/admin-guides/references/man5/noderes.5.rst index 36c9fb575..8d2bae399 100644 --- a/docs/source/guides/admin-guides/references/man5/noderes.5.rst +++ b/docs/source/guides/admin-guides/references/man5/noderes.5.rst @@ -51,12 +51,17 @@ noderes Attributes: \ **netboot**\ The type of network booting to use for this node. Valid values: - Arch OS valid netboot options - x86, x86_64 ALL pxe, xnba - ppc64 <=rhel6, <=sles11.3 yaboot - ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp - ppc64le NonVirtualize ALL petitboot - ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp + + + .. code-block:: perl + + Arch OS valid netboot options + x86, x86_64 ALL pxe, xnba + ppc64 <=rhel6, <=sles11.3 yaboot + ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp + ppc64le NonVirtualize ALL petitboot + ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp + diff --git a/docs/source/guides/admin-guides/references/man5/prescripts.5.rst b/docs/source/guides/admin-guides/references/man5/prescripts.5.rst index 6b8b0ebc6..13f42e25c 100644 --- a/docs/source/guides/admin-guides/references/man5/prescripts.5.rst +++ b/docs/source/guides/admin-guides/references/man5/prescripts.5.rst @@ -44,10 +44,9 @@ prescripts Attributes: \ **begin**\ - The scripts to be run at the beginning of the nodeset(Linux), - nimnodeset(AIX) or mkdsklsnode(AIX) command. + The scripts to be run at the beginning of the nodeset(Linux), nimnodeset(AIX) or mkdsklsnode(AIX) command. The format is: - [action1:]s1,s2...[|action2:s3,s4,s5...] + [action1:]s1,s2...[| action2:s3,s4,s5...] where: - action1 and action2 for Linux are the nodeset actions specified in the command. For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command' @@ -59,28 +58,20 @@ prescripts Attributes: myscript1,myscript2 (all actions) diskless:myscript1,myscript2 (AIX) install:myscript1,myscript2|netboot:myscript3 (Linux) - - - .. code-block:: perl - - All the scripts should be copied to /install/prescripts directory. - The following two environment variables will be passed to each script: - NODES a coma separated list of node names that need to run the script for - ACTION current nodeset action. - - If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script - will get invoked for each node in parallel, but no more than number of instances - will be invoked at at a time. If it is not specified, the script will be invoked - once for all the nodes. - + All the scripts should be copied to /install/prescripts directory. + The following two environment variables will be passed to each script: + NODES a coma separated list of node names that need to run the script for + ACTION current nodeset action. + If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script + will get invoked for each node in parallel, but no more than number of instances + will be invoked at at a time. If it is not specified, the script will be invoked + once for all the nodes. \ **end**\ - The scripts to be run at the end of the nodeset(Linux), - nimnodeset(AIX),or mkdsklsnode(AIX) command. - The format is the same as the 'begin' column. + The scripts to be run at the end of the nodeset(Linux), nimnodeset(AIX),or mkdsklsnode(AIX) command. The format is the same as the 'begin' column. diff --git a/docs/source/guides/admin-guides/references/man5/storage.5.rst b/docs/source/guides/admin-guides/references/man5/storage.5.rst index a2183e3ef..5182c1c82 100644 --- a/docs/source/guides/admin-guides/references/man5/storage.5.rst +++ b/docs/source/guides/admin-guides/references/man5/storage.5.rst @@ -43,9 +43,14 @@ storage Attributes: \ **osvolume**\ Specification of what storage to place the node OS image onto. Examples include: - localdisk (Install to first non-FC attached disk) - usbdisk (Install to first USB mass storage device seen) - wwn=0x50000393c813840c (Install to storage device with given WWN) + + + .. code-block:: perl + + localdisk (Install to first non-FC attached disk) + usbdisk (Install to first USB mass storage device seen) + wwn=0x50000393c813840c (Install to storage device with given WWN) + @@ -93,9 +98,9 @@ storage Attributes: \ **controller**\ - The management address to attach/detach new volumes. - In the scenario involving multiple controllers, this data must be - passed as argument rather than by table value + The management address to attach/detach new volumes. + In the scenario involving multiple controllers, this data must be + passed as argument rather than by table value diff --git a/docs/source/guides/admin-guides/references/man5/vm.5.rst b/docs/source/guides/admin-guides/references/man5/vm.5.rst index ece3064cc..1b079118b 100644 --- a/docs/source/guides/admin-guides/references/man5/vm.5.rst +++ b/docs/source/guides/admin-guides/references/man5/vm.5.rst @@ -128,7 +128,8 @@ vm Attributes: \ **virtflags**\ - General flags used by the virtualization method. For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: + General flags used by the virtualization method. + For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: imageformat=[raw|fullraw|qcow2] raw is a generic sparse file that allocates storage on demand fullraw is a generic, non-sparse file that preallocates all space diff --git a/docs/source/guides/admin-guides/references/man5/xcatdb.5.rst b/docs/source/guides/admin-guides/references/man5/xcatdb.5.rst index 86806e6ae..e92b439c9 100644 --- a/docs/source/guides/admin-guides/references/man5/xcatdb.5.rst +++ b/docs/source/guides/admin-guides/references/man5/xcatdb.5.rst @@ -329,11 +329,7 @@ The tables are: auditlog(5)|auditlog.5 - - .. code-block:: perl - - Audit Data log. - + Audit Data log. diff --git a/docs/source/guides/admin-guides/references/man7/eventlog.7.rst b/docs/source/guides/admin-guides/references/man7/eventlog.7.rst index 7837a6c39..ff31cbe01 100644 --- a/docs/source/guides/admin-guides/references/man7/eventlog.7.rst +++ b/docs/source/guides/admin-guides/references/man7/eventlog.7.rst @@ -107,11 +107,7 @@ eventlog Attributes: \ **rawdata**\ (eventlog.rawdata) - - .. code-block:: perl - - The data that associated with the event. - + The data that associated with the event. diff --git a/docs/source/guides/admin-guides/references/man7/group.7.rst b/docs/source/guides/admin-guides/references/man7/group.7.rst index 0e76c6a07..c3b62073b 100644 --- a/docs/source/guides/admin-guides/references/man7/group.7.rst +++ b/docs/source/guides/admin-guides/references/man7/group.7.rst @@ -71,87 +71,45 @@ group Attributes: \ **bmcport**\ (ipmi.bmcport) + In systems with selectable shared/dedicated ethernet ports, this parameter can be used to specify the preferred port. 0 means use the shared port, 1 means dedicated, blank is to not assign. + .. code-block:: perl - In systems with selectable shared/dedicated ethernet ports, - - this parameter can be used to specify the preferred port. 0 - - means use the shared port, 1 means dedicated, blank is to not - - assign. - - - The following special cases exist for IBM System x servers: - - For x3755 M3 systems, 0 means use the dedicated port, 1 means - shared, blank is to not assign. - - For certain systems which have a mezzaine or ML2 adapter, there is a second - value to include: - - - For x3750 M4 (Model 8722): - - - 0 2 1st 1Gbps interface for LOM - - 0 0 1st 10Gbps interface for LOM - - 0 3 2nd 1Gbps interface for LOM - - 0 1 2nd 10Gbps interface for LOM - - - For x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4: - - - 0 Shared (1st onboard interface) - - 1 Dedicated - - 2 0 First interface on ML2 or mezzanine adapter - - 2 1 Second interface on ML2 or mezzanine adapter - - 2 2 Third interface on ML2 or mezzanine adapter - - 2 3 Fourth interface on ML2 or mezzanine adapter @@ -568,17 +526,12 @@ group Attributes: .. code-block:: perl - Arch OS valid netboot options - - x86, x86_64 ALL pxe, xnba - - ppc64 <=rhel6, <=sles11.3 yaboot - - ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp - - ppc64le NonVirtualize ALL petitboot - - ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp + Arch OS valid netboot options + x86, x86_64 ALL pxe, xnba + ppc64 <=rhel6, <=sles11.3 yaboot + ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp + ppc64le NonVirtualize ALL petitboot + ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp @@ -598,142 +551,85 @@ group Attributes: \ **nicaliases**\ (nics.nicaliases) Comma-separated list of hostname aliases for each NIC. - - - .. code-block:: perl - - Format: eth0!,eth1!| - - For multiple aliases per nic use a space-separated list. - - For example: eth0!moe larry curly,eth1!tom|jerry - + Format: eth0!,eth1!| + For multiple aliases per nic use a space-separated list. + For example: eth0!moe larry curly,eth1!tom|jerry \ **niccustomscripts**\ (nics.niccustomscripts) Comma-separated list of custom scripts per NIC. !,!, e.g. eth0!configeth eth0, ib0!configib ib0. The xCAT object definition commands support to use niccustomscripts. as the sub attribute - . \ **nicdevices**\ (nics.nicdevices) - Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by |. !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. + Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by | . !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. \ **nicextraparams**\ (nics.nicextraparams) Comma-separated list of extra parameters that will be used for each NIC configuration. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes. - - If multiple ip addresses are associated with each NIC: - - !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. - - The xCAT object definition commands support to use nicextraparams. as the sub attributes. - + If only one ip address is associated with each NIC: + !,!, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes. + If multiple ip addresses are associated with each NIC: + !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. + The xCAT object definition commands support to use nicextraparams. as the sub attributes. \ **nichostnameprefixes**\ (nics.nichostnameprefixes) - Comma-separated list of hostname prefixes per NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!,..., for example, eth0!eth0-,ib0!ib- - - If multiple ip addresses are associcated with each NIC: - - !|,!|,..., for example, eth0!eth0-|eth0-ipv6i-,ib0!ib-|ib-ipv6-. - - The xCAT object definition commands support to use nichostnameprefixes. as the sub attributes. - - Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnameprefixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention - + Comma-separated list of hostname prefixes per NIC. + If only one ip address is associated with each NIC: + !,!,..., for example, eth0!eth0-,ib0!ib- + If multiple ip addresses are associcated with each NIC: + !|,!|,..., for example, eth0!eth0-|eth0-ipv6i-,ib0!ib-|ib-ipv6-. + The xCAT object definition commands support to use nichostnameprefixes. as the sub attributes. + Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnameprefixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention \ **nichostnamesuffixes**\ (nics.nichostnamesuffixes) - Comma-separated list of hostname suffixes per NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!,..., for example, eth0!-eth0,ib0!-ib0 - - If multiple ip addresses are associcated with each NIC: - - !|,!|,..., for example, eth0!-eth0|-eth0-ipv6,ib0!-ib0|-ib0-ipv6. - - The xCAT object definition commands support to use nichostnamesuffixes. as the sub attributes. - - Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnamesuffixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention - + Comma-separated list of hostname suffixes per NIC. + If only one ip address is associated with each NIC: + !,!,..., for example, eth0!-eth0,ib0!-ib0 + If multiple ip addresses are associcated with each NIC: + !|,!|,..., for example, eth0!-eth0|-eth0-ipv6,ib0!-ib0|-ib0-ipv6. + The xCAT object definition commands support to use nichostnamesuffixes. as the sub attributes. + Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnamesuffixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention \ **nicips**\ (nics.nicips) - Comma-separated list of IP addresses per NIC. To specify one ip address per NIC: - - - .. code-block:: perl - - !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 - - To specify multiple ip addresses per NIC: - - !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. - - Note: The primary IP address must also be stored in the hosts.ip attribute. The nichostnamesuffixes should specify one hostname suffix for each ip address. - + Comma-separated list of IP addresses per NIC. + To specify one ip address per NIC: + !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 + To specify multiple ip addresses per NIC: + !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. + Note: The primary IP address must also be stored in the hosts.ip attribute. The nichostnamesuffixes should specify one hostname suffix for each ip address. \ **nicnetworks**\ (nics.nicnetworks) Comma-separated list of networks connected to each NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!, for example, eth0!10_0_0_0-255_255_0_0, ib0!11_0_0_0-255_255_0_0 - - If multiple ip addresses are associated with each NIC: - - !|,!|, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks. as the sub attributes. - + If only one ip address is associated with each NIC: + !,!, for example, eth0!10_0_0_0-255_255_0_0, ib0!11_0_0_0-255_255_0_0 + If multiple ip addresses are associated with each NIC: + !|,!|, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks. as the sub attributes. \ **nicsadapter**\ (nics.nicsadapter) Comma-separated list of extra parameters that will be used for each NIC configuration. - - - .. code-block:: perl - - !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. - + !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. @@ -775,9 +671,7 @@ group Attributes: .. code-block:: perl localdisk (Install to first non-FC attached disk) - usbdisk (Install to first USB mass storage device seen) - wwn=0x50000393c813840c (Install to storage device with given WWN) @@ -875,73 +769,34 @@ group Attributes: \ **prescripts-begin**\ (prescripts.begin) - The scripts to be run at the beginning of the nodeset(Linux), - - - .. code-block:: perl - - nimnodeset(AIX) or mkdsklsnode(AIX) command. - - The format is: - - [action1:]s1,s2...[|action2:s3,s4,s5...] - - where: - - - action1 and action2 for Linux are the nodeset actions specified in the command. - - For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command' - - and 'standalone for nimnodeset command. - - - s1 and s2 are the scripts to run for action1 in order. - - - s3, s4, and s5 are the scripts to run for actions2. - - If actions are omitted, the scripts apply to all actions. - - Examples: - - myscript1,myscript2 (all actions) - - diskless:myscript1,myscript2 (AIX) - - install:myscript1,myscript2|netboot:myscript3 (Linux) - - - - All the scripts should be copied to /install/prescripts directory. - - The following two environment variables will be passed to each script: - - NODES a coma separated list of node names that need to run the script for - - ACTION current nodeset action. - - - - If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script - - will get invoked for each node in parallel, but no more than number of instances - - will be invoked at at a time. If it is not specified, the script will be invoked - - once for all the nodes. - + The scripts to be run at the beginning of the nodeset(Linux), nimnodeset(AIX) or mkdsklsnode(AIX) command. + The format is: + [action1:]s1,s2...[| action2:s3,s4,s5...] + where: + - action1 and action2 for Linux are the nodeset actions specified in the command. + For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command' + and 'standalone for nimnodeset command. + - s1 and s2 are the scripts to run for action1 in order. + - s3, s4, and s5 are the scripts to run for actions2. + If actions are omitted, the scripts apply to all actions. + Examples: + myscript1,myscript2 (all actions) + diskless:myscript1,myscript2 (AIX) + install:myscript1,myscript2|netboot:myscript3 (Linux) + All the scripts should be copied to /install/prescripts directory. + The following two environment variables will be passed to each script: + NODES a coma separated list of node names that need to run the script for + ACTION current nodeset action. + If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script + will get invoked for each node in parallel, but no more than number of instances + will be invoked at at a time. If it is not specified, the script will be invoked + once for all the nodes. \ **prescripts-end**\ (prescripts.end) - The scripts to be run at the end of the nodeset(Linux), - - - .. code-block:: perl - - nimnodeset(AIX),or mkdsklsnode(AIX) command. - - The format is the same as the 'begin' column. - + The scripts to be run at the end of the nodeset(Linux), nimnodeset(AIX),or mkdsklsnode(AIX) command. The format is the same as the 'begin' column. @@ -1121,9 +976,7 @@ group Attributes: .. code-block:: perl = number of rows of slots in chassis - = number of columns of slots in chassis - = set to 0 if slots are vertical, and set to 1 if slots of horizontal @@ -1161,15 +1014,9 @@ group Attributes: \ **storagcontroller**\ (storage.controller) - The management address to attach/detach new volumes. - - - .. code-block:: perl - - In the scenario involving multiple controllers, this data must be - - passed as argument rather than by table value - + The management address to attach/detach new volumes. + In the scenario involving multiple controllers, this data must be + passed as argument rather than by table value @@ -1409,27 +1256,16 @@ group Attributes: \ **vmvirtflags**\ (vm.virtflags) - General flags used by the virtualization method. For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: - - - .. code-block:: perl - - imageformat=[raw|fullraw|qcow2] - - raw is a generic sparse file that allocates storage on demand - - fullraw is a generic, non-sparse file that preallocates all space - - qcow2 is a sparse, copy-on-write capable format implemented at the virtualization layer rather than the filesystem level - - clonemethod=[qemu-img|reflink] - - qemu-img allows use of qcow2 to generate virtualization layer copy-on-write - - reflink uses a generic filesystem facility to clone the files on your behalf, but requires filesystem support such as btrfs - - placement_affinity=[migratable|user_migratable|pinned] - + General flags used by the virtualization method. + For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: + imageformat=[raw|fullraw|qcow2] + raw is a generic sparse file that allocates storage on demand + fullraw is a generic, non-sparse file that preallocates all space + qcow2 is a sparse, copy-on-write capable format implemented at the virtualization layer rather than the filesystem level + clonemethod=[qemu-img|reflink] + qemu-img allows use of qcow2 to generate virtualization layer copy-on-write + reflink uses a generic filesystem facility to clone the files on your behalf, but requires filesystem support such as btrfs + placement_affinity=[migratable|user_migratable|pinned] diff --git a/docs/source/guides/admin-guides/references/man7/node.7.rst b/docs/source/guides/admin-guides/references/man7/node.7.rst index 0d871ee82..a0484fe5d 100644 --- a/docs/source/guides/admin-guides/references/man7/node.7.rst +++ b/docs/source/guides/admin-guides/references/man7/node.7.rst @@ -83,87 +83,45 @@ node Attributes: \ **bmcport**\ (ipmi.bmcport) + In systems with selectable shared/dedicated ethernet ports, this parameter can be used to specify the preferred port. 0 means use the shared port, 1 means dedicated, blank is to not assign. + .. code-block:: perl - In systems with selectable shared/dedicated ethernet ports, - - this parameter can be used to specify the preferred port. 0 - - means use the shared port, 1 means dedicated, blank is to not - - assign. - - - The following special cases exist for IBM System x servers: - - For x3755 M3 systems, 0 means use the dedicated port, 1 means - shared, blank is to not assign. - - For certain systems which have a mezzaine or ML2 adapter, there is a second - value to include: - - - For x3750 M4 (Model 8722): - - - 0 2 1st 1Gbps interface for LOM - - 0 0 1st 10Gbps interface for LOM - - 0 3 2nd 1Gbps interface for LOM - - 0 1 2nd 10Gbps interface for LOM - - - For x3750 M4 (Model 8752), x3850/3950 X6, dx360 M4, x3550 M4, and x3650 M4: - - - 0 Shared (1st onboard interface) - - 1 Dedicated - - 2 0 First interface on ML2 or mezzanine adapter - - 2 1 Second interface on ML2 or mezzanine adapter - - 2 2 Third interface on ML2 or mezzanine adapter - - 2 3 Fourth interface on ML2 or mezzanine adapter @@ -568,17 +526,12 @@ node Attributes: .. code-block:: perl - Arch OS valid netboot options - - x86, x86_64 ALL pxe, xnba - - ppc64 <=rhel6, <=sles11.3 yaboot - - ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp - - ppc64le NonVirtualize ALL petitboot - - ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp + Arch OS valid netboot options + x86, x86_64 ALL pxe, xnba + ppc64 <=rhel6, <=sles11.3 yaboot + ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp + ppc64le NonVirtualize ALL petitboot + ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp @@ -598,142 +551,85 @@ node Attributes: \ **nicaliases**\ (nics.nicaliases) Comma-separated list of hostname aliases for each NIC. - - - .. code-block:: perl - - Format: eth0!,eth1!| - - For multiple aliases per nic use a space-separated list. - - For example: eth0!moe larry curly,eth1!tom|jerry - + Format: eth0!,eth1!| + For multiple aliases per nic use a space-separated list. + For example: eth0!moe larry curly,eth1!tom|jerry \ **niccustomscripts**\ (nics.niccustomscripts) Comma-separated list of custom scripts per NIC. !,!, e.g. eth0!configeth eth0, ib0!configib ib0. The xCAT object definition commands support to use niccustomscripts. as the sub attribute - . \ **nicdevices**\ (nics.nicdevices) - Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by |. !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. + Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by | . !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes. \ **nicextraparams**\ (nics.nicextraparams) Comma-separated list of extra parameters that will be used for each NIC configuration. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes. - - If multiple ip addresses are associated with each NIC: - - !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. - - The xCAT object definition commands support to use nicextraparams. as the sub attributes. - + If only one ip address is associated with each NIC: + !,!, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes. + If multiple ip addresses are associated with each NIC: + !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. + The xCAT object definition commands support to use nicextraparams. as the sub attributes. \ **nichostnameprefixes**\ (nics.nichostnameprefixes) - Comma-separated list of hostname prefixes per NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!,..., for example, eth0!eth0-,ib0!ib- - - If multiple ip addresses are associcated with each NIC: - - !|,!|,..., for example, eth0!eth0-|eth0-ipv6i-,ib0!ib-|ib-ipv6-. - - The xCAT object definition commands support to use nichostnameprefixes. as the sub attributes. - - Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnameprefixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention - + Comma-separated list of hostname prefixes per NIC. + If only one ip address is associated with each NIC: + !,!,..., for example, eth0!eth0-,ib0!ib- + If multiple ip addresses are associcated with each NIC: + !|,!|,..., for example, eth0!eth0-|eth0-ipv6i-,ib0!ib-|ib-ipv6-. + The xCAT object definition commands support to use nichostnameprefixes. as the sub attributes. + Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnameprefixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention \ **nichostnamesuffixes**\ (nics.nichostnamesuffixes) - Comma-separated list of hostname suffixes per NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!,..., for example, eth0!-eth0,ib0!-ib0 - - If multiple ip addresses are associcated with each NIC: - - !|,!|,..., for example, eth0!-eth0|-eth0-ipv6,ib0!-ib0|-ib0-ipv6. - - The xCAT object definition commands support to use nichostnamesuffixes. as the sub attributes. - - Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnamesuffixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention - + Comma-separated list of hostname suffixes per NIC. + If only one ip address is associated with each NIC: + !,!,..., for example, eth0!-eth0,ib0!-ib0 + If multiple ip addresses are associcated with each NIC: + !|,!|,..., for example, eth0!-eth0|-eth0-ipv6,ib0!-ib0|-ib0-ipv6. + The xCAT object definition commands support to use nichostnamesuffixes. as the sub attributes. + Note: According to DNS rules a hostname must be a text string up to 24 characters drawn from the alphabet (A-Z), digits (0-9), minus sign (-),and period (.). When you are specifying "nichostnamesuffixes" or "nicaliases" make sure the resulting hostnames will conform to this naming convention \ **nicips**\ (nics.nicips) - Comma-separated list of IP addresses per NIC. To specify one ip address per NIC: - - - .. code-block:: perl - - !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 - - To specify multiple ip addresses per NIC: - - !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. - - Note: The primary IP address must also be stored in the hosts.ip attribute. The nichostnamesuffixes should specify one hostname suffix for each ip address. - + Comma-separated list of IP addresses per NIC. + To specify one ip address per NIC: + !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 + To specify multiple ip addresses per NIC: + !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. + Note: The primary IP address must also be stored in the hosts.ip attribute. The nichostnamesuffixes should specify one hostname suffix for each ip address. \ **nicnetworks**\ (nics.nicnetworks) Comma-separated list of networks connected to each NIC. - - - .. code-block:: perl - - If only one ip address is associated with each NIC: - - !,!, for example, eth0!10_0_0_0-255_255_0_0, ib0!11_0_0_0-255_255_0_0 - - If multiple ip addresses are associated with each NIC: - - !|,!|, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks. as the sub attributes. - + If only one ip address is associated with each NIC: + !,!, for example, eth0!10_0_0_0-255_255_0_0, ib0!11_0_0_0-255_255_0_0 + If multiple ip addresses are associated with each NIC: + !|,!|, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks. as the sub attributes. \ **nicsadapter**\ (nics.nicsadapter) Comma-separated list of extra parameters that will be used for each NIC configuration. - - - .. code-block:: perl - - !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. - + !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. @@ -781,9 +677,7 @@ node Attributes: .. code-block:: perl localdisk (Install to first non-FC attached disk) - usbdisk (Install to first USB mass storage device seen) - wwn=0x50000393c813840c (Install to storage device with given WWN) @@ -881,73 +775,34 @@ node Attributes: \ **prescripts-begin**\ (prescripts.begin) - The scripts to be run at the beginning of the nodeset(Linux), - - - .. code-block:: perl - - nimnodeset(AIX) or mkdsklsnode(AIX) command. - - The format is: - - [action1:]s1,s2...[|action2:s3,s4,s5...] - - where: - - - action1 and action2 for Linux are the nodeset actions specified in the command. - - For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command' - - and 'standalone for nimnodeset command. - - - s1 and s2 are the scripts to run for action1 in order. - - - s3, s4, and s5 are the scripts to run for actions2. - - If actions are omitted, the scripts apply to all actions. - - Examples: - - myscript1,myscript2 (all actions) - - diskless:myscript1,myscript2 (AIX) - - install:myscript1,myscript2|netboot:myscript3 (Linux) - - - - All the scripts should be copied to /install/prescripts directory. - - The following two environment variables will be passed to each script: - - NODES a coma separated list of node names that need to run the script for - - ACTION current nodeset action. - - - - If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script - - will get invoked for each node in parallel, but no more than number of instances - - will be invoked at at a time. If it is not specified, the script will be invoked - - once for all the nodes. - + The scripts to be run at the beginning of the nodeset(Linux), nimnodeset(AIX) or mkdsklsnode(AIX) command. + The format is: + [action1:]s1,s2...[| action2:s3,s4,s5...] + where: + - action1 and action2 for Linux are the nodeset actions specified in the command. + For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command' + and 'standalone for nimnodeset command. + - s1 and s2 are the scripts to run for action1 in order. + - s3, s4, and s5 are the scripts to run for actions2. + If actions are omitted, the scripts apply to all actions. + Examples: + myscript1,myscript2 (all actions) + diskless:myscript1,myscript2 (AIX) + install:myscript1,myscript2|netboot:myscript3 (Linux) + All the scripts should be copied to /install/prescripts directory. + The following two environment variables will be passed to each script: + NODES a coma separated list of node names that need to run the script for + ACTION current nodeset action. + If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script + will get invoked for each node in parallel, but no more than number of instances + will be invoked at at a time. If it is not specified, the script will be invoked + once for all the nodes. \ **prescripts-end**\ (prescripts.end) - The scripts to be run at the end of the nodeset(Linux), - - - .. code-block:: perl - - nimnodeset(AIX),or mkdsklsnode(AIX) command. - - The format is the same as the 'begin' column. - + The scripts to be run at the end of the nodeset(Linux), nimnodeset(AIX),or mkdsklsnode(AIX) command. The format is the same as the 'begin' column. @@ -1133,9 +988,7 @@ node Attributes: .. code-block:: perl = number of rows of slots in chassis - = number of columns of slots in chassis - = set to 0 if slots are vertical, and set to 1 if slots of horizontal @@ -1185,15 +1038,9 @@ node Attributes: \ **storagcontroller**\ (storage.controller) - The management address to attach/detach new volumes. - - - .. code-block:: perl - - In the scenario involving multiple controllers, this data must be - - passed as argument rather than by table value - + The management address to attach/detach new volumes. + In the scenario involving multiple controllers, this data must be + passed as argument rather than by table value @@ -1445,27 +1292,16 @@ node Attributes: \ **vmvirtflags**\ (vm.virtflags) - General flags used by the virtualization method. For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: - - - .. code-block:: perl - - imageformat=[raw|fullraw|qcow2] - - raw is a generic sparse file that allocates storage on demand - - fullraw is a generic, non-sparse file that preallocates all space - - qcow2 is a sparse, copy-on-write capable format implemented at the virtualization layer rather than the filesystem level - - clonemethod=[qemu-img|reflink] - - qemu-img allows use of qcow2 to generate virtualization layer copy-on-write - - reflink uses a generic filesystem facility to clone the files on your behalf, but requires filesystem support such as btrfs - - placement_affinity=[migratable|user_migratable|pinned] - + General flags used by the virtualization method. + For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: + imageformat=[raw|fullraw|qcow2] + raw is a generic sparse file that allocates storage on demand + fullraw is a generic, non-sparse file that preallocates all space + qcow2 is a sparse, copy-on-write capable format implemented at the virtualization layer rather than the filesystem level + clonemethod=[qemu-img|reflink] + qemu-img allows use of qcow2 to generate virtualization layer copy-on-write + reflink uses a generic filesystem facility to clone the files on your behalf, but requires filesystem support such as btrfs + placement_affinity=[migratable|user_migratable|pinned] diff --git a/perl-xCAT/db2man b/perl-xCAT/db2man index 55d738ce9..233fd2fd3 100755 --- a/perl-xCAT/db2man +++ b/perl-xCAT/db2man @@ -416,8 +416,8 @@ parentheses, what tables each attribute is stored in. EOS2 foreach my $a (sort keys %attrlist) { - my $d = join("\nor\n", @{$attrlist{$a}->{'descriptions'}}); - $d =~ s/\n/\n\n/sg; # if there are newlines, double them so pod sees a blank line, otherwise pod will ignore them + my $d = join("\n\nor\n\n", @{$attrlist{$a}->{'descriptions'}}); + #$d =~ s/\n/\n\n/sg; # if there are newlines, double them so pod sees a blank line, otherwise pod will ignore them my $t = '(' . join(', ',@{$attrlist{$a}->{'tables'}}) . ')'; #print FILE "\nB<$a> - $d\n"; print FILE "\n=item B<$a> $t\n\n$d\n"; diff --git a/perl-xCAT/xCAT/Schema.pm b/perl-xCAT/xCAT/Schema.pm index e7b7b0d97..27dd95318 100755 --- a/perl-xCAT/xCAT/Schema.pm +++ b/perl-xCAT/xCAT/Schema.pm @@ -213,7 +213,8 @@ use xCAT::ExtTab; 'nicmodel' => 'Model of NICs that will be provided to VMs (i.e. e1000, rtl8139, virtio, etc)', 'bootorder' => 'Boot sequence (i.e. net,hd)', 'clockoffset' => 'Whether to have guest RTC synced to "localtime" or "utc" If not populated, xCAT will guess based on the nodetype.os contents.', - 'virtflags' => 'General flags used by the virtualization method. For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: + 'virtflags' => 'General flags used by the virtualization method. + For example, in Xen it could, among other things, specify paravirtualized setup, or direct kernel boot. For a hypervisor/dom0 entry, it is the virtualization method (i.e. "xen"). For KVM, the following flag=value pairs are recognized: imageformat=[raw|fullraw|qcow2] raw is a generic sparse file that allocates storage on demand fullraw is a generic, non-sparse file that preallocates all space @@ -275,10 +276,11 @@ use xCAT::ExtTab; table_descr => 'Node storage resources', descriptions => { node => 'The node name', - controller => 'The management address to attach/detach new volumes. - In the scenario involving multiple controllers, this data must be - passed as argument rather than by table value', + controller => 'The management address to attach/detach new volumes. +In the scenario involving multiple controllers, this data must be +passed as argument rather than by table value', osvolume => "Specification of what storage to place the node OS image onto. Examples include: + localdisk (Install to first non-FC attached disk) usbdisk (Install to first USB mass storage device seen) wwn=0x50000393c813840c (Install to storage device with given WWN)", @@ -396,10 +398,7 @@ use xCAT::ExtTab; descriptions => { node => 'The node name or group name.', bmc => 'The hostname of the BMC adapater.', - bmcport => ' In systems with selectable shared/dedicated ethernet ports, - this parameter can be used to specify the preferred port. 0 - means use the shared port, 1 means dedicated, blank is to not - assign. + bmcport => 'In systems with selectable shared/dedicated ethernet ports, this parameter can be used to specify the preferred port. 0 means use the shared port, 1 means dedicated, blank is to not assign. The following special cases exist for IBM System x servers: @@ -527,6 +526,7 @@ use xCAT::ExtTab; password => 'Password to use to access the management module. If not specified, the key=blade row in the passwd table is used as the default.', displayname => 'Alternative name for BladeCenter chassis. Only used by PCM.', slots => 'The number of available slots in the chassis. For PCM, this attribute is used to store the number of slots in the following format: ,, Where: + = number of rows of slots in chassis = number of columns of slots in chassis = set to 0 if slots are vertical, and set to 1 if slots of horizontal @@ -647,12 +647,13 @@ use xCAT::ExtTab; node => 'The node name or group name.', servicenode => 'A comma separated list of node names (as known by the management node) that provides most services for this node. The first service node on the list that is accessible will be used. The 2nd node on the list is generally considered to be the backup service node for this node when running commands like snmove.', netboot => 'The type of network booting to use for this node. Valid values: - Arch OS valid netboot options - x86, x86_64 ALL pxe, xnba - ppc64 <=rhel6, <=sles11.3 yaboot - ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp - ppc64le NonVirtualize ALL petitboot - ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp + + Arch OS valid netboot options + x86, x86_64 ALL pxe, xnba + ppc64 <=rhel6, <=sles11.3 yaboot + ppc64 >=rhels7, >=sles11.4 grub2,grub2-http,grub2-tftp + ppc64le NonVirtualize ALL petitboot + ppc64le PowerKVM Guest ALL grub2,grub2-http,grub2-tftp ', tftpserver => 'The TFTP server for this node (as known by this node). If not set, it defaults to networks.tftpserver.', @@ -1341,7 +1342,7 @@ use xCAT::ExtTab; id => 'The location or the resource name where the event occurred.', #In RMC it's the resource name and attribute name severity => 'The severity of the event. Valid values are: informational, warning, critical.', message => 'The full description of the event.', - rawdata => ' The data that associated with the event. ', # in RMC, it's the attribute value, it takes the format of attname=attvalue[,atrrname=attvalue....] + rawdata => 'The data that associated with the event. ', # in RMC, it's the attribute value, it takes the format of attname=attvalue[,atrrname=attvalue....] comments => 'Any user-provided notes.', disable => "Do not use. tabprune will not work if set to yes or 1", }, @@ -1355,7 +1356,7 @@ use xCAT::ExtTab; }, compress => 'YES', tablespace => 'XCATTBS32K', - table_desc => ' Audit Data log.', + table_desc => 'Audit Data log.', descriptions => { recid => 'The record id.', audittime => 'The timestamp for the audit entry.', @@ -1382,10 +1383,10 @@ use xCAT::ExtTab; # Do not put description text past column 88, so it displays well in a 100 char wide window. # ----------------------------------------------------------------------------------| begin => -"The scripts to be run at the beginning of the nodeset(Linux),\n" . +"The scripts to be run at the beginning of the nodeset(Linux)," . " nimnodeset(AIX) or mkdsklsnode(AIX) command.\n" . " The format is:\n" . -" [action1:]s1,s2...[|action2:s3,s4,s5...]\n" . +" [action1:]s1,s2...[| action2:s3,s4,s5...]\n" . " where:\n" . " - action1 and action2 for Linux are the nodeset actions specified in the command. \n" . " For AIX, action1 and action1 can be 'diskless' for mkdsklsnode command'\n" . @@ -1396,17 +1397,17 @@ use xCAT::ExtTab; " Examples:\n" . " myscript1,myscript2 (all actions)\n" . " diskless:myscript1,myscript2 (AIX)\n" . -" install:myscript1,myscript2|netboot:myscript3 (Linux)\n\n" . +" install:myscript1,myscript2|netboot:myscript3 (Linux)\n" . " All the scripts should be copied to /install/prescripts directory.\n" . " The following two environment variables will be passed to each script: \n" . " NODES a coma separated list of node names that need to run the script for\n" . -" ACTION current nodeset action.\n\n" . +" ACTION current nodeset action.\n" . " If '#xCAT setting:MAX_INSTANCE=number' is specified in the script, the script\n" . " will get invoked for each node in parallel, but no more than number of instances\n" . " will be invoked at at a time. If it is not specified, the script will be invoked\n" . " once for all the nodes.\n", - end => "The scripts to be run at the end of the nodeset(Linux),\n" . - " nimnodeset(AIX),or mkdsklsnode(AIX) command. \n" . + end => "The scripts to be run at the end of the nodeset(Linux)," . + " nimnodeset(AIX),or mkdsklsnode(AIX) command." . " The format is the same as the 'begin' column.", comments => 'Any user-written notes.', disable => "Set to 'yes' or '1' to comment out this row.", @@ -1463,7 +1464,8 @@ use xCAT::ExtTab; table_desc => 'Stores NIC details.', descriptions => { node => 'The node or group name.', - nicips => 'Comma-separated list of IP addresses per NIC. To specify one ip address per NIC: + nicips => 'Comma-separated list of IP addresses per NIC. + To specify one ip address per NIC: !,!,..., for example, eth0!10.0.0.100,ib0!11.0.0.100 To specify multiple ip addresses per NIC: !|,!|,..., for example, eth0!10.0.0.100|fd55::214:5eff:fe15:849b,ib0!11.0.0.100|2001::214:5eff:fe15:849a. The xCAT object definition commands support to use nicips. as the sub attributes. @@ -1491,16 +1493,16 @@ use xCAT::ExtTab; If multiple ip addresses are associated with each NIC: !|,!|, for example, eth0!10_0_0_0-255_255_0_0|fd55:faaf:e1ab:336::/64,ib0!11_0_0_0-255_255_0_0|2001:db8:1:0::/64. The xCAT object definition commands support to use nicnetworks. as the sub attributes.', nicaliases => 'Comma-separated list of hostname aliases for each NIC. - Format: eth0!,eth1!| - For multiple aliases per nic use a space-separated list. - For example: eth0!moe larry curly,eth1!tom|jerry', + Format: eth0!,eth1!| + For multiple aliases per nic use a space-separated list. + For example: eth0!moe larry curly,eth1!tom|jerry', nicextraparams => 'Comma-separated list of extra parameters that will be used for each NIC configuration. If only one ip address is associated with each NIC: !,!, for example, eth0!MTU=1500,ib0!MTU=65520 CONNECTED_MODE=yes. If multiple ip addresses are associated with each NIC: !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes. The xCAT object definition commands support to use nicextraparams. as the sub attributes.', - nicdevices => 'Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by |. !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes.', + nicdevices => 'Comma-separated list of NIC device per NIC, multiple ethernet devices can be bonded as bond device, these ethernet devices are separated by | . !|,!, e.g. bond0!eth0|eth2,br0!bond0. The xCAT object definition commands support to use nicdevices. as the sub attributes.', nicsadapter => 'Comma-separated list of extra parameters that will be used for each NIC configuration. !|,!|, for example, eth0!MTU=1500|MTU=1460,ib0!MTU=65520 CONNECTED_MODE=yes.', comments => 'Any user-written notes.',