Administration Guide
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
- To install all premanaged nodes, enter:
updatenode -P
- 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
- 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 ]