From 79b26215151a7912b8b5c2aa82980d6ec7db3317 Mon Sep 17 00:00:00 2001 From: bp-sawyers Date: Sat, 26 Mar 2011 17:39:37 +0000 Subject: [PATCH] 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 --- xCAT-client/pods/man8/xcatsetup.8.pod | 137 ++++++++++++++++++-------- 1 file changed, 98 insertions(+), 39 deletions(-) diff --git a/xCAT-client/pods/man8/xcatsetup.8.pod b/xCAT-client/pods/man8/xcatsetup.8.pod index 42acf6f35..fb079e714 100644 --- a/xCAT-client/pods/man8/xcatsetup.8.pod +++ b/xCAT-client/pods/man8/xcatsetup.8.pod @@ -91,9 +91,10 @@ Hostname ranges must start with 1 (or 01, etc.). I.e. use node01-node80, instea The B 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 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