In the last step, you completed the node planning templates for your nodes. When defining your nodes (in an upcoming step) the information contained in the completed node planning templates needs to be supplied to the definenode command. It can either be entered into a node definition (nodedef) file, or it can be entered at the command line. A nodedef file allows you to enter the host names of the nodes, and all the attributes that you wish to define in a file and thus avoid the error-prone task of having to type all of the information on the command line. If you intend to use a nodedef file, start with the sample file in /opt/csm/install/nodedef.sample and complete the information from the node planning template that you completed earlier. For large numbers of nodes, IBM suggests using the nodedef file and not the command line. For a small number of nodes, you can simply enter the information on the management server command line with the definenode command (in the next step).
The following is an example of a typical nodedef file.
# Cluster System Management Node Definition File # # Node Definition File Rules # # 1. A stanza header consists of the node name followed by a colon (:). # # 2. Attribute lines must take the form of Attribute=Value. # # 3. If a line is not blank, a comment, a header, or an attribute=value # pair then the command will skip to the next valid header. # # 4. A warning message will be issued for invalid attributes but the # code will continue. # # 5. Each line of the file may have only one header or attribute definition. # # 6. Only one stanza may exist for each node. # # 7. If the header keyword is "default" then the attribute values in # the stanza are considered default values for subsequent node definitions. # # 8. Default stanzas may be specified multiple times and at any point # in a definition file. The values apply to all definitions following # it in the file. The default values are cumulative. That is, a default # attribute value will stay set until it is explicitly unset or changed. # # 9. To "turn off" a default value set the attribute to nothing (blank). # # 10. When a specific value for an attribute is provided in the node # stanza it will take priority over any default value that had been set. # # 11. Comments beginning with the pound sign (#) may be added to the # file. Comments must be on a separate line. # # 12. When parsing the file, tab characters and spaces are ignored. # # 13. Some attribute values will be set by default by the definenode # command when this file is used as input. # # The following attributes will be set based on what is installed # on the management server. # # InstallOSName - "Linux" # InstallDistributionName - Linux distribution (ex. RedHat) # InstallDistributionVersion - Linux distribution version # InstallPkgArchitecture - (ex. "i386") # InstallCSMVersion - version of CSM # # # define a set of netfinity nodes # # # nfnode01: # ManagementServer=c5bs.ppd.xyz.com # HWControlPoint=asm04 # PowerMethod=netfinity # ConsoleMethod=esp # ConsoleServer=esp15 # ConsoleServerNumber=1 # ConsolePortNumber=0 # InstallOSName=Linux # InstallCSMVersion=1.3.0 # InstallDistributionVersion=7.2 # nfnode02: # ManagementServer=c5bs.ppd.xyz.com # HWControlPoint=asm04 # PowerMethod=netfinity # ConsoleMethod=esp # ConsoleServer=esp15 # ConsoleServerNumber=2 # ConsolePortNumber=0 # InstallOSName=Linux # InstallCSMVersion=1.3.0 # InstallDistributionVersion=7.1 # nfnode03: # ManagementServer=c5bs.ppd.xyz.com # HWControlPoint=asmn02 # PowerMethod=netfinity # ConsoleMethod=esp # ConsoleServer=esp16 # ConsoleServerNumber=3 # ConsolePortNumber=0 # InstallOSName=Linux # InstallCSMVersion=1.3.0 # InstallDistributionVersion=7.1 # nfnode10: # ManagementServer=c5bs.ppd.xyz.com # InstallOSName=Linux # PowerMethod=netfinity # ConsoleMethod=esp # HWControlPoint=asm02 # ConsoleServer=esp15 # ConsoleServerNumber=2 # ConsolePortNumber=0 # InstallCSMVersion=1.2.0 # InstallDistributionVersion=7.2 # # # using default values. # # default: # PowerMethod=netfinity # ConsoleMethod=esp # ConsoleServer=esp15 # ConsoleServerNumber=2 # ConsolePortNumber=0 # InstallOSName=Linux # InstallCSMVersion=1.2.0 # HWControlPoint=asm03 # ManagementServer=c5bs.ppd.xyz.com # InstallDistributionVersion=7.2 # nfnode11: # ConsolePortNumber=1 # nfnode12: # HWControlPoint=asm04 # ConsolePortNumber=2 # nfnode13: # HWControlPoint=asm05 # ConsolePortNumber=3
If you don't intend to use a nodedef file, skip ahead to the next step.
See the nodedef man page or CSM for Linux: Administration Guide for more details about the node definition file.