General updates to the xcatsetup man page.
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9155 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
bp-sawyers
parent
6477c621ab
commit
79b2621515
@ -91,9 +91,10 @@ Hostname ranges must start with 1 (or 01, etc.). I.e. use node01-node80, instea
|
||||
|
||||
The B<config file> is organized in stanza format and supports the keywords in the sample file below. Comment lines
|
||||
begin with "#". Stanzas can be ommitted if you do not want to define that type of object.
|
||||
The only hostname formats supported are those in this sample file, although you can change the base
|
||||
The only hostname formats supported are those shown in this sample file, although you can change the base
|
||||
text and the numbers. For example, hmc1-hmc3 could be changed to hwmgmt01-hwmgmt12.
|
||||
The hostnames specified must sort correctly. I.e. use node01-node80, instead of node1-node80.
|
||||
This sample configuration file is for a 2 building block cluster.
|
||||
|
||||
xcat-site:
|
||||
domain = cluster.com
|
||||
@ -103,50 +104,53 @@ The hostnames specified must sort correctly. I.e. use node01-node80, instead of
|
||||
topology = 32D
|
||||
|
||||
xcat-hmcs:
|
||||
hostname-range = hmc1-hmc3
|
||||
starting-ip = 10.201.1.1
|
||||
hostname-range = hmc1-hmc2
|
||||
starting-ip = 10.200.1.1
|
||||
|
||||
xcat-frames:
|
||||
# these are the connections to the BPCs
|
||||
hostname-range = bpc1-bpc6
|
||||
starting-ip = 10.202.1.1
|
||||
num-frames-per-hmc = 2
|
||||
hostname-range = frame[1-6]
|
||||
starting-ip = 10.200.2.1
|
||||
num-frames-per-hmc = 3
|
||||
# this lists which serial numbers go with which frame numbers
|
||||
vpd-file = vpd.stanza
|
||||
vpd-file = vpd2bb.stanza
|
||||
|
||||
xcat-cecs:
|
||||
# these are the connections to the FSPs. Either form of hostname is supported.
|
||||
# These are the connections to the FSPs. Either form of hostname is supported.
|
||||
#hostname-range = cec01-cec60
|
||||
hostname-range = f[1-6]c[01-10]
|
||||
hostname-range = f[1-6]c[01-12]
|
||||
# If you use the frame/cec hostname scheme above, but do not have a consistent
|
||||
# number of cecs in each frame, xcat can delete the cecs that do not get
|
||||
# supernode numbers assigned to them.
|
||||
delete-unused-cecs = 1
|
||||
starting-ip = 10.203.1.1
|
||||
starting-ip = 10.200.3.1
|
||||
# lists the HFI supernode numbers for each group of cecs in each frame
|
||||
supernode-list = supernodelist.txt
|
||||
supernode-list = supernodelist2bb.txt
|
||||
# If you do not want to specify the supernode-list at this time and you have a consistent
|
||||
# number of cecs in each frame, you can instead just use this setting:
|
||||
#num-cecs-per-frame = 12
|
||||
|
||||
xcat-building-blocks:
|
||||
num-frames-per-bb = 2
|
||||
num-cecs-per-bb = 20
|
||||
num-frames-per-bb = 3
|
||||
num-cecs-per-bb = 32
|
||||
|
||||
xcat-lpars:
|
||||
num-lpars-per-cec = 8
|
||||
# If you set these, then do not set the corresponding attributes in the other node stanzas below.
|
||||
# Except you still need to set xcat-service-nodes:starting-ip (which is the ethernet adapter)
|
||||
hostname-range = f[1-6]c[01-12]p[1-8]
|
||||
starting-ip = 11.1.1.1
|
||||
starting-ip = 10.1.1.1
|
||||
aliases = -hf0
|
||||
# ml0 is for aix. For linux, use bond0 instead.
|
||||
otherinterfaces = -hf1:12.1.1.1,-hf2:13.1.1.1,-hf3:14.1.1.1,-ml0:15.1.1.1
|
||||
otherinterfaces = -hf1:11.1.1.1,-hf2:12.1.1.1,-hf3:13.1.1.1,-ml0:14.1.1.1
|
||||
|
||||
xcat-service-nodes:
|
||||
num-service-nodes-per-bb = 2
|
||||
# which cecs within the bldg block that the SNs are located in
|
||||
cec-positions-in-bb = 1,20
|
||||
cec-positions-in-bb = 1,32
|
||||
# this is for the ethernet NIC on each SN
|
||||
#hostname-range = sn1-sn6
|
||||
starting-ip = 16.1.1.1
|
||||
#hostname-range = sn1-sn4
|
||||
starting-ip = 10.10.1.1
|
||||
# this value is the same format as the hosts.otherinterfaces attribute except
|
||||
# the IP addresses are starting IP addresses
|
||||
#otherinterfaces = -hf0:10.10.1.1,-hf1:10.11.1.1,-hf2:10.12.1.1,-hf3:10.13.1.1,-ml0:10.14.1.1
|
||||
@ -154,14 +158,14 @@ The hostnames specified must sort correctly. I.e. use node01-node80, instead of
|
||||
xcat-storage-nodes:
|
||||
num-storage-nodes-per-bb = 3
|
||||
# which cecs within the bldg block that the storage nodes are located in
|
||||
cec-positions-in-bb = 5,10,15
|
||||
#hostname-range = stor01-stor09
|
||||
cec-positions-in-bb = 12,20,32
|
||||
#hostname-range = stor1-stor6
|
||||
#starting-ip = 10.20.1.1
|
||||
#aliases = -hf0
|
||||
#otherinterfaces = -hf1:10.21.1.1,-hf2:10.22.1.1,-hf3:10.23.1.1,-ml0:10.24.1.1
|
||||
|
||||
xcat-compute-nodes:
|
||||
#hostname-range = n001-n465
|
||||
#hostname-range = n001-n502
|
||||
#starting-ip = 10.30.1.1
|
||||
#aliases = -hf0
|
||||
# ml0 is for aix. For linux, use bond0 instead.
|
||||
@ -177,31 +181,53 @@ in the cluster must be specified (A-side only).
|
||||
|
||||
Here is a sample file:
|
||||
|
||||
bpc1:
|
||||
objtype=node
|
||||
serial=99200G1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
frame1:
|
||||
objtype=node
|
||||
serial=99200A1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
bpc2:
|
||||
objtype=node
|
||||
serial=99200D1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
frame2:
|
||||
objtype=node
|
||||
serial=99200B1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
...
|
||||
frame3:
|
||||
objtype=node
|
||||
serial=99200C1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
frame4:
|
||||
objtype=node
|
||||
serial=99200D1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
frame5:
|
||||
objtype=node
|
||||
serial=99200E1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
frame6:
|
||||
objtype=node
|
||||
serial=99200F1
|
||||
mtm=9A00-100
|
||||
side=A
|
||||
|
||||
=head2 Supernode Numbers for CECs
|
||||
|
||||
The B<supernode-list> file lists what supernode numbers should be given to each CEC in each frame.
|
||||
Here is a sample file:
|
||||
|
||||
bpc1: 0, 1, 16
|
||||
bpc2: 17, 32
|
||||
bpc3: 33, 48, 49
|
||||
bpc4: 64 , 65, 80
|
||||
bpc5: 81, 96
|
||||
bpc6: 97(1), 112(1), 113(1), 37(1), 55, 71
|
||||
frame1: 0, 1, 16
|
||||
frame2: 17, 32
|
||||
frame3: 33, 48, 49
|
||||
frame4: 64 , 65, 80
|
||||
frame5: 81, 96
|
||||
frame6: 97(1), 112(1), 113(1), 37(1), 55, 71
|
||||
|
||||
The name before the colon is the node name of the frame BPC. The numbers after the colon are the supernode numbers
|
||||
to assign to the groups of CECs in that frame from bottom to top. Each supernode contains 4 CECs, unless it is immediately
|
||||
@ -216,7 +242,7 @@ VPD data or supernode numbers at this time.
|
||||
use-direct-fsp-control = 1
|
||||
|
||||
xcat-frames:
|
||||
hostname-range = bpc[1-2]
|
||||
hostname-range = frame[1-2]
|
||||
|
||||
xcat-cecs:
|
||||
hostname-range = cec[01-24]
|
||||
@ -375,6 +401,39 @@ using this option.
|
||||
|
||||
1 An error has occurred.
|
||||
|
||||
=head1 EXAMPLES
|
||||
|
||||
=over 3
|
||||
|
||||
=item 1.
|
||||
|
||||
Use the sample config.txt file at the beginning of this man page to create all the objects/nodes for a
|
||||
2 building block cluster.
|
||||
|
||||
xcatsetup config.txt
|
||||
|
||||
The output:
|
||||
|
||||
Defining site attributes...
|
||||
Defining HMCs...
|
||||
Defining frames...
|
||||
Defining CECs...
|
||||
Defining building blocks...
|
||||
Defining LPAR nodes...
|
||||
|
||||
=item 2.
|
||||
|
||||
Use the simpler config file shown earlier in this man page to create just the frame and cec objects:
|
||||
|
||||
xcatsetup config-simple.txt
|
||||
|
||||
The output:
|
||||
|
||||
Defining frames...
|
||||
Defining CECs...
|
||||
|
||||
=back
|
||||
|
||||
=head1 FILES
|
||||
|
||||
/opt/xcat/sbin/xcatsetup
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user