Administration Guide
Name
csmsetupks - Configures Kickstart and defines the nodes to be installed to the
CSM database.
Synopsis
csmsetupks [-h]
csmsetupks [-v | -V]
[-ppath | -x]
[-P | -a |
[-Nnode_groups][-n
node_list]]
Description
The csmsetupks command collects configuration information
and uses the Linux Kickstart configuration file template to generate a
Kickstart configuration file for each node. The Linux Kickstart
configuration template is located in
/opt/csm/install/kscfg.tmpl.InstallDistributionNameInstallDistributionVersion.
For example,
/opt/csm/install/kscfg.tmpl.RedHat7.1.
The generated configuration file contains the information that the
csmsetupks command has collected. The generated configuration
file on the node is called
/csminstall/csmInstallCSMVersion/kickstart.InstallDistributionNameInstallDistributionVersion/node-ipaddr-kickstart.
For example,
/csminstall/csm/1.2/kickstart.Linux7.1/9.117.241.32-kickstart.
For more details on the template and the generated file, particularly how and
when to modify them, see kscfg.tmpl File, and see the sample annotated kscfg.tmpl
file in IBM CSM for Linux: Software Planning and Installation
Guide.
- Note:
- For the current version of the template, see
/opt/csm/install/kscfg.tmpl.RedHat7.1 and
/opt/csm/install/kscfg.tmpl.RedHat7.2 on your
system.
Specifically, csmsetupks performs these tasks:
Attribute values can be set by specifying attribute/value pairs on the
command line in the form Attr=value. If the value is a string
that contains spaces or other special characters, the value must be enclosed
in quotation marks. Valid attributes are:
- Netmask
- Gateway
- Nameservers ( a comma-separated list of nameserver host names or IP
addresses)
The default value for the attributes is the value that those
attributes have on the management server. These values are used when
creating the /etc/dhpd.conf file.
Options
- -h
- Writes usage information to standard output.
- -P
- Set up Kickstart for all nodes whose Mode attribute is
PreManaged.
- -a
- Setup Kickstart for all nodes. This cannot be used with the
-n, -N or -P flags.
- -N node_groups
- Provide a comma-separated list of node groups for Kickstart setup.
This cannot be used with the -a or -P
options.
- -n node_list
- Provide a comma-separated list of nodes for Kickstart setup. This
cannot be used with the -a or -P options.
- -p pkg_path
- Specifies one or more directories, separated by colons, that contain
copies of the Red Hat CD-ROMs
(path1:path2:path3). The
default is /mnt/cdrom.
- -v | -V
- Writes the verbose messages of the command to standard output.
- -x
- Specifies to not copy Red Hat disks. This cannot be used with the
-p option.
Examples
- To set up Kickstart for all premanaged nodes:
csmsetupks -P
- To set up Kickstart for all nodes in a node group named mynodes,
plus one other node:
csmsetupks -N mynodes -n clsnode14
- To set up Kickstart for a single node and copy any Red Hat files:
csmsetupks -n clsnode4 -p /images/disk1:/images/disk2
- To set up Kickstart on a node, but not copy any Red Hat files:
csmsetupks -n clsnode2 -x
Files
- /opt/bin/csmsetupks
- Location of the csmsetupks program.
- /var/log/csm/csmsetupks.log
- Location of the log file on the management server for the
csmsetupks command. Up to five copies of this log are
maintained. Old logs receive a numeric suffix up to 4. The
oldest file is csmsetupks.log.4.
- /opt/csm/install/kscfg.tmpl.InstallDistributionNameInstallDistributionVersion
- Location of the Kickstart configuration file template. Currently,
RedHat is the only supported value for
InstallDistributionName, and 7.1 and
7.2 are the valid values for
InstallDistributionVersion.
- /opt/csm/install/firstboot.tmpl.InstallDistributionNameInstallDistributionVersion
- Location of the Kickstart configuration file template. Currently,
RedHat is the only supported value for
InstallDistributionName, and 7.1 and
7.2 are the valid values for
InstallDistributionVersion.
- /etc/dhcpd.conf
- Location of the DHCP configuration file.
- /etc/dhcpd.conf.precsm
- Location of the DHCP configuration file that is backed up the first time
csmsetupks is run.
- /etc/dhcpd.conf.bak
- Every time csmsetupks modifies the
/etc/dhcpd.conf file, it is backed up with this
name.
- /csminstall/pxelinux.cfg/node-ipaddr-in-hex
- Location of the PXE configuration file, where
node-ipaddr-in-hex represents the host IP address in hexadecimal
format (use the /usr/bin/gethostip tool to help translate from IP
address format to HEX format). This file is modified by the
csmsetupks and installnode command during different phases
of the installation.
- /csminstall/csm/InstallCSMVesion/kickstart.InstallDistributionNameInstallDistributionVersion/node-ipaddr-kickstart
- Location of the Kickstart configuration file generated for the
node.
See Also
The definenode, getmacs, installms,
installnode man pages.
- IBM CSM for Linux: Software Planning and Installation Guide for
more information on the installation processes.
- IBM CSM for Linux: Hardware Planning and Control Guide for
information on hardware control.
Author
Sean Safron - cluster@us.ibm.com
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]