Commands Reference, Volume 5

startrpdomain Command

Purpose

Brings a peer domain that has already been defined online.

Syntax

startrpdomain [-t timeout] [-A] [-h] [-TV] domain_name

Description

The startrpdomain command brings a defined peer domain online by starting the resources on each node belonging to the peer domain.

The startrpdomain command must be run on a node that is defined to the peer domain. The command invites all offline nodes defined to the peer domain to come online in the peer domain every time the command is run for the peer domain. The command can be executed more than once in the peer domain. If all the nodes defined in the peer domain are already online, no action is performed.

The startrpdomain command determines the peer domain configuration to use to bring the peer domain online by examining the peer domain configuration on the nodes defined to the peer domain. The latest version of the peer domain configuration information that is found is used to make the peer domain online. By default, the latest version of the peer domain configuration found from a quorum of nodes is used. Specifying the -A flag causes the latest version of the peer domain configuration found from all of nodes defined in the peer domain to be used. In determining the latest version of the peer domain configuration information, a configuration timeout defines when to stop checking versions and begin to bring the peer domain online. The default timeout is 120 seconds. The timeout value can be changed using the -t flag. The timeout value should be at least long enough so that the latest version of the peer domain configuration information from at least a quorum of nodes can be found.

A node can only be online to one peer domain at a time. The startrpdomain command cannot be run on a node for a peer domain when another peer domain is already online for that node.

Flags

-t timeout: Specifies the timeout value in seconds. This flag limits the amount of time used to find the latest version of the peer domain configuration. When the timeout value is exceeded, the latest version of the peer domain configuration information found thus far is used. The timeout value should be long enough so that the latest version of the peer domain configuration information from at least a quorum of nodes can be found. The default timeout value is 120 seconds.
-A: Finds and uses the latest version of the peer domain configuration information from all of the nodes in the peer domain. If this flag is not specified, the latest version of the peer domain configuration information from a quorum of the nodes in the peer domain is used.
-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

domain_name: Specifies the name of a previously-defined peer domain that is to be brought online.

Security

The user of the startrpdomain command needs write permission for the IBM.PeerDomain resource class on each node that is defined to the peer domain. By default, root on any node in the peer domain has read and write access to this resource class through the configuration resource manager.

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.
6: The peer domain definition does not exist.

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 from a node that is not defined to the peer domain.

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

In these examples, nodeA is one of the nodes defined to ApplDomain.

To bring ApplDomain online, run this command on nodeA:
```
startrpdomain ApplDomain
```
To bring ApplDomain online using all of the nodes in the peer domain (instead of a quorum of nodes) to obtain the latest version of the peer domain configuration information, run this command on nodeA:
```
startrpdomain -A ApplDomain
```
To bring ApplDomain online using a peer domain configuration timeout value of 240 seconds to ensure that a quorum of nodes in the peer domain is used, run this command on nodeA:
```
startrpdomain -t 240 ApplDomain
```

Location

/usr/sbin/rsct/bin/startrpdomain: Contains the startrpdomain command

Files

The /etc/services file is modified.

Related Information

Commands: lsrpdomain, lsrpnode, mkrpdomain, preprpnode, stoprpdomain