IBM Books

Administration Guide

csmsetupks Command

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:

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

  1. To set up Kickstart for all premanaged nodes:
    csmsetupks -P
    
  2. To set up Kickstart for all nodes in a node group named mynodes, plus one other node:
    csmsetupks -N mynodes -n clsnode14
    
  3. To set up Kickstart for a single node and copy any Red Hat files:
    csmsetupks -n clsnode4 -p /images/disk1:/images/disk2
    
  4. 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.

Author

Sean Safron - cluster@us.ibm.com


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]