arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Add pods for new commands

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@214 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
lissav 2008-01-07 17:37:19 +00:00
parent 4b6929af18
commit fc81e91d3f
3 changed files with 321 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

117
xCAT-client-2.0/pods/man1/lslpp.1.pod Normal file
View File

@ -0,0 +1,117 @@
=head1 NAME
B<lslpp> - Queries selected networked services configuration information.
=head1 SYNOPSIS
I<lsslp [-h|--help]>
I<lsslp [-v|--version]>
I<lsslp [-V|--verbose] [-b ip[,ip..]][-w][-r|-x|-z][-s BPA|MM|IVM|RSA|FSP|HMC]>
=head1 DESCRIPTION
The lsslp command queries selected service types using the -s flag. All service types are returned if the -s flag is not specified. If a specific broadcast address is not specified using the -b flag, the broadcast is performed out all broadcast enabled network adapters. The optional -r, -x, and -z flags format the output.
=head1 OPTIONS
B<-b> IP(s) the command will broadcast out.
B<-h> Display usage message.
B<-r> Raw slp response.
B<-s> Service type interested in discovering.
B<-v> Command Version.
B<-V> Verbose output.
B<-w> Writes output to xCAT database.
B<-x> XML format.
B<-z> Stanza formated output.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. To list all discovered HMC service types in tabular format, enter:
I<lsslp -s HMC>
Output is similar to:
device type-model serial-number ip-addresses
HMC 7310CR2 103F55A 1.1.1.115 2.2.2.164 3.3.3.102
HMC 7310CR2 105369A 3.3.3.103 2.2.2.103 1.1.1.163
HMC 7310CR3 KPHHK24 3.3.3.154 2.2.2.110 1.1.1.154
2. list all discovered FSP service types in raw response format on subnet 30.0.0.255, enter:
I< lsslp -b 3.0.0.255 -s FSP -r>
Output is similar to:
(type=cec-service-processor),(serial-number=10A3AEB),(machinetype-model=9117-570),(fru-serial-number=YL11C5338102),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.94,1.1.1.147),(web-url=https://3.0.0.94:473 ), (slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
(type=cec-service-processor),(serial-number=10A3E2B),(machinetype-model=9117-570),(fru-serial- number=YL11C5338250),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.95,1.1.1.147), (web-url=https://3.0.0.95:473 ),(slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
3. To list all discovered MM service types in XML format and write the output to the xCAT database, enter:
I <lsslp -s MM -x -w>
<Output is similar to:
<Node>
<device>MM</device>
<hostname>mm01</hostname>
<ip-addresses>1.1.1.19</ip-addresses>
<serial-number>78AG034</serial-number>
<type-model>86772XX</type-model>
</Node>
4. To list all discovered MM service types in stanza format and write the output to the xCAT database, enter:
I<lsslp -s MM -z -w>
Output is similar to:
mm01:
objtype=node
device=MM
type-model=86772XX
serial-number=78AG034
ip-addresses=1.1.1.19
=head1 FILES
/opt/xcat/bin/lslpp
=head1 NOTES
This command is part of the xCAT software product.

52
xCAT-client-2.0/pods/man1/makedhcp.1.pod Normal file
View File

@ -0,0 +1,52 @@
=head1 NAME
B<makedhcp> -Creates new dhcp configuration files and updates live dhcp configuration using omapi.
=head1 SYNOPSIS
I<makedhcp [h|--help]>
I<makedhcp [-n]>
I<makedhcp noderange [-s statements]>
=head1 DESCRIPTION
The makedhcp command with the -n option will create a dhcpd.conf file to allow xCAT to manage the DHCP configuration, including certain general parameters such as a dynamic range and omapi configuration. With a noderange, makedhcp will inject configuration data pertinent to the specified nodes that immediately takes effect without a reset.
=head1 OPTIONS
B<-h> Display usage message.
B<-n> Create a new dhcpd.conf file.
B<-s> For the input noderange, the argument will be interpreted like dhcpd.conf text.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. The following example, will cause dhcp on the next request to set root-path appropriately for only node5. Note some characters (e.g. ") must be doubly escaped (once for the shell, and once for the OMAPI layer).
I<makedhcp node5 -s 'option root-path \"172.16.0.1:/install/freebsd6.2/x86_64\";'>
=head1 FILES
/opt/xcat/bin/mkdhcp
=head1 NOTES
This command is part of the xCAT software product.

152
xCAT-client-2.0/pods/man1/rscan.1.pod Normal file
View File

@ -0,0 +1,152 @@
=head1 NAME
B<rscan> - Collects node information from one or more hardware control points.
=head1 SYNOPSIS
I<rscan [-h|--help]>
I<rscan [-v|--version]>
I<rscan [-V|--verbose] noderange [-w][-x|-z]>
=head1 DESCRIPTION
The rscan command lists hardware information for each node managed by the hardware control points specified in noderange.
Note that the first line of the output always contains information about the hardware control point itself. When using the rscan command to generate output for HMC or IVM hardware control points, note that FSPs and BPAs are included in the output.
=head1 OPTIONS
B<-h> Display usage message.
B<-v> Command Version.
B<-V> Verbose output.
B<-w> Writes output to xCAT database.
B<-x> XML format.
B<-z> Stanza formated output.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. To list all nodes managed by HMC hmc01 in tabular format, enter:
I<rscan hmc01>
Output is similar to:
type name id type-model serial-number address
hmc hmc01 7310-C05 10F426A hmc01
fsp Server-9117-MMA-SN10F6F3D 9117-MMA 10F6F3D 3.3.3.197
lpar lpar3 4 9117-MMA 10F6F3D
lpar lpar2 3 9117-MMA 10F6F3D
lpar lpar1 2 9117-MMA 10F6F3D
lpar p6vios 1 9117-MMA 10F6F3D
2.To list all nodes managed by IVM ivm02 in XML format and write the output to the xCAT database, enter:
I<rscan ivm02 -x -w>
Output is similar to:
<Node>
<address>ivm02</address>
<id></id>
<name>ivm02</name>
<serial-number>10B7D1G</serial-number>
<type>ivm</type>
<type-model>9133-55A</type-model>
</Node>
<Node>
<address>3.3.3.91</address>
<id></id>
<name>Server-9133-55A-SN10B7D1G</name>
<serial-number>10B7D1G</serial-number>
<type>fsp</type>
<type-model>9133-55A</type-model>
</Node>
<Node>
<address></address>
<id>1</id>
<name>10-B7D1G</name>
<serial-number>10B7D1G</serial-number>
<type>lpar</type>
<type-model>9133-55A</type-model>
</Node>
<Node>
<address></address>
<id>2</id>
<name>lp2</name>
<serial-number>10B7D1G</serial-number>
<type>lpar</type>
<type-model>9133-55A</type-model>
</Node>
3. To list all nodes managed by Management Module mm03 in stanza format and write the output to the xCAT database, enter:
I <rscan mm03 -z -w>
<Output is similar to:
SN#IBM:
objtype=node
type=mm
id=0
type-model=8852-22Z
serial-number=23A4328
address=mm01
blade1:
objtype=node
type=blade
id=1
type-model=8853-SWZ
serial-number=23AD188
address=
blade2:
objtype=node
type=blade
id=3
type-model=7971-6AZ
serial-number=23A0052
address=
=head1 FILES
/opt/xcat/bin/rscan
=head1 NOTES
This command is part of the xCAT software product.