Commands Reference, Volume 1

addrpnode Command

Purpose

Adds one or more nodes to a peer domain definition.

Syntax

addrpnode [-c] [-h] [-TV] node_name1 [node_name2 ... ]

addrpnode [-c] -f file_name | "-" [-h] [-TV]

Description

The addrpnode command adds the specified nodes to the online peer domain on which the command is run. The command must be run on a node that is online to the peer domain in which the new nodes are to be added. The added nodes are not brought online in the peer domain. Use the startrpnode command to bring the added nodes online. Use the preprpnode command on each node to be added to the peer domain to set up the proper security environment.

A node can be defined in multiple peer domains but can only be online in one peer domain. More than half of the nodes must be online to add one or more nodes to the domain.

Flags

-c

Continues processing the command as long as at least one node can be added to the peer domain.

-f file_name | "-"

Reads a list of node names from file_name. Each line of the file is scanned for one node name. The pound sign (#) indicates that the remainder of the line (or the entire line if the # is in column 1) is a comment. Use -f "-" to specify STDIN as the input file.

-h

Writes the command's usage statement to standard output.

-T

Writes the command's trace messages to standard error. For your software service organization's use only.

-V

Writes the command's verbose messages to standard output.

Parameters

node_name1 [node_name2 ... ]

Specifies the node (or nodes) to be added to the peer domain definition. The node name is the IP address or the long or short version of the DNS host name. The node name must resolve to an IP address.

Security

The user of the addrpnode command needs write permission for the IBM.PeerNode resource class on each node that is to be added to the peer domain. This is set up by running the preprpnode command on each node to be added. Specify the names of all the nodes online in the peer domain with the preprpnode command. This gives the online nodes the necessary authority to perform operations on the nodes to be added.

Exit Status

0

The command ran successfully.

1

An error occurred with RMC.

2

An error occurred with a command-line interface script.

3

An incorrect flag was entered on the command line.

4

An incorrect parameter was entered on the command line.

5

An error occurred that was based on incorrect command-line input.

Environment Variables

CT_CONTACT

Determines the system where the session with the resource monitoring and control (RMC) daemon occurs. When CT_CONTACT is set to a host name or IP address, the command contacts the RMC daemon on the specified host. If CT_CONTACT is not set, the command contacts the RMC daemon on the local system where the command is being run. The target of the RMC daemon session and the management scope determine the resource classes or resources that are processed.

Restrictions

This command must be run on a node that is online in the peer domain in which the new nodes are to be added.

Standard Input

When the -f "-" flag is specified, this command reads one or more node names from standard input.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output. All verbose messages are written to standard output.

Standard Error

All trace messages are written to standard error.

Examples

To add the nodes nodeB and nodeC to the peer domain ApplDomain where nodeA is already defined and online to ApplDomain, run this command on nodeA:

addrpnode nodeB nodeC

Location

/usr/sbin/rsct/bin/addrpnode

Contains the addrpnode command

Related Information

Commands: lsrpnode, mkrpdomain, preprpnode, rmrpnode, startrpdomain, startrpnode