recfgct Command

Edit online

Purpose

Reconfigures the Reliable Scalable Cluster Technology (RSCT) subsystems.

Syntax

/opt/rsct/install/bin/recfgct [ -i Node_ID | -n | -s | -h ]

Description

Attention: Use this command with extreme caution.

The recfgct command is used to remove all RSCT data under the /var/ct directory, generate a new node ID, and make it appear as if the RSCT components are just installed. Because of the destructive nature of this command, it is not normally started by the system administrator. You must use this command only if you need to remove a duplicate node ID or if an IBM® service representative instructs you to use it.

When RSCT is first installed, a node ID is automatically generated. The node ID is a true random 64-bit number. Each system where RSCT is installed must have a unique node ID. If a copy of an operating system image (OSI) that has RSCT installed on it is installed on another system, the other system has the same node ID as the system from which the copy is made. This is referred to as cloning. For AIX® platform, cloning is typically performed using such AIX-supported commands and procedures as mksysb. These commands and procedures call recfgct automatically. For other platforms, the recfgct command must be run immediately after a cloned OSI is installed.

If the -s flag is specified, after all data under the /var/ct directory is removed, the node ID contained in the /etc/ct_node_id file is used to re-create the /var/ct/cfg/ct_node_id file.

Flags

-i Node_ID
Specifies the node ID that must be used. The node ID must contain 9 - 16 hexadecimal characters.
-n
Generates a new node ID. It is the default behavior if no option is specified.
-s
Saves the node ID.
-h
Writes the command usage statement to standard output and then exits.

Restrictions

The -h flag is supported on the following RSCT levels:
  • RSCT 2.4.9.1 (or later) for AIX 5.3
  • RSCT 2.5.1.1 (or later) for AIX 6.1 and all Linux® platforms
  • RSCT 3.1.0.0 (or later) for AIX 7.1 and later
If you try to run the recfgct -h command on a prior version of RSCT, the -h flag is ignored and all RSCT data is removed.

Files

/etc/ct_node_id
Contains a copy of the RSCT node ID
/var/ct/cfg/ct_node_id
Contains the RSCT node ID

Standard output

When the -h flag is specified, this command usage statement is written to standard output and then the command exits.

Exit status

0
The command ran successfully.
1
The command did not run successfully.

Security

Privilege control: only the root user must have execute (x) access to this command.

Implementation specifics

This command is part of the rsct.core fileset for the AIX operating system and rsct.core-3.1.0.0-0.platform.rpm package for Linux, Solaris, and Windows operating system, where platform is i386, ppc, ppc64, s390, or x86_64.

Location

/opt/rsct/install/bin/recfgct

Examples

  1. After installing a cloned operating system image, enter: 
    /opt/rsct/install/bin/recfgct