IBM Books

Administration Guide

updatenode Command

Name

updatenode - Updates or installs CSM packages and CFM configuration files across the cluster.

Synopsis

updatenode [-h ] [-v | -V] [-a | -P | -M] [-f ][-k] [-t | --test] [-I | --installcsm] [-F | --cfm] [--cfmoptions "Options to pass to CFM"] [-N Node_group [, Node_group ...]] [ host [host...]]

Description

The updatenode command runs on the management server and updates/installs all CSM software and files on the target nodes. Currently, the updatenode command updates/installs CSM packages and user-defined CFM configuration files.

The updatenode command can be used to install CSM on a premanaged node. During this process the premanaged node is added to the CSM cluster (and converted to a ManagedNode). For convenience, updatenode may also be initiated through the definenode -U command. This will call updatenode when definenode has completed.

The updatenode command can also be used to update existing CSM nodes. It will only install/update CSM packages and CFM configuration files that are outdated or nonexistent on the target machines.

Since the updatenode command calls both the dsh and cfmupdatenode commands, it utilizes their respective default scaling fanouts. The dsh fanout can be set with the DSH_FANOUT environment variable. The --cfmoptions -M max_child_process flag should be specified on the updatenode command line to specify the cfmupdatenode fanout.

By default, updatenode performs both CSM installation and configuration file distribution (through CFM). However, updatenode can be instructed to only perform some of these tasks with command line options. If called with only the [-I | --installcsm] flags, updatenode will only perform installation/updates of CSM packages. If called with either the [-F | --cfm] or [--cfmoptions] flags, updatenode will only distribute configuration files. Calling updatenode with both the [-I | --installcsm] and [-F | --cfm] flags results in the default behavior: updatenode performs both CSM installation and CFM file distribution.

The UpdatenodeFailed node attribute is set for each target node at the conclusion of the updatenode command. If updatenode was successful, the UpdatenodeFailed value is set to zero. Any other value means that updatenode encountered significant errors during execution to the given node.

Options

-h
Shows usage information.

-v | -V
Verbose Mode.

-a
Performs updates on all nodes.

-P
Performs updates on all nodes whose Mode is PreManaged.

-M
Performs updates on all nodes whose Mode is Managed.

-f
Forces the updates of CSM packages. Performs a binary check on configuration files (this is the equivalent of running cfmupdatenode -c).

-k
Exchanges RSCT public keys, host name, and node identifier between the node and the management server. Only use this option if the host name, node identifier, or public key of either machines has changed. At the time this option is used, you must trust your network to ensure that a rogue machine is not going to insert its public key in place of the public key of the real node.

-t | --test
Only reports what would be done by the command. Does not perform any updates.

-I | --installcsm
Installs/updates the CSM code sets. If neither -I nor -F are specified, both operations are performed. When individual command line options are used, updatenode only performs the actions specified by the given options. Note that the -I option is typed as an uppercase i.

-F | --cfm
Updates the configuration files from /cfmroot. If neither -I nor -F are specified, both operations are performed. When individual command line options are used, updatenode only performs the actions specified by the given options through the use of the cfmupdatenode command.

--cfmoptions "options to pass to CFM"
Forwards options to the cfmupdatenode command. This flag implies the [--F | --cfm] flag. All options following the --cfmoptions operand must be enclosed within double quotes. These options are allowed: [-b], [[-y] |[-c]], [-r 'remote_shell_path'], [-t timeout], [-M 'max_child_process'], [ -d 'distfile_location'], [-F filename].

-N Node_group [, Node_group ...].
Specifies one or more node groups on which to run the command. This flag may not be used with either of the -a, -P, or -M options.

host ...
Specifies a list of node hostnames (or IP addresses) on which to run the command. Hostnames may not be specified with either of the -a, -P, or -M options.

Examples

  1. To install all premanaged nodes, enter:
    updatenode -P
    
  2. To update all managed nodes automatically every weekday morning at 0800, add this line to your crontab file:
    0  8 * * * /opt/csm/bin/updatenode -M
    
  3. To test what updatenode will do on the FTP_server node group, type:
    updatenode -t -N FTP_server
    

Files

/cfmroot
The directory on the Management server that contains the cluster's configuration files.

/opt/csm/bin/cfmupdatenode
Location of the cfmupdatenode command.

/opt/csm/bin/updatenode
Location of the updatenode command.

/var/log/csm/updatenode.log
Location of the log file on the management server for the updatenode command. Up to five copies of this log are maintained. Old logs receive a numeric suffix up to 4. The oldest file is updatenode.log.4.

/var/log/csm/install.log
Location of the log file on each node containing installation information. Up to five copies of this log are maintained. Old logs receive a numeric suffix up to 4. The oldest file is install.log.4

See Also

The definenode, dsh, and cfmupdatenode man pages.

Author

Jennifer Cranfill - cluster@us.ibm.com


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