startrpdomain Command

Purpose

Brings a peer domain that has already been defined online.

Syntax

startrpdomain [ -A │ -L ] [-t timeout] [ -Q quorum_type | quorum_type_name ] [-m fanout] [-h] [-w [-s Seconds]] [-TV] peer_domain

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 run 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 bring the peer domain online. By default, the latest version of the peer domain configuration found on at least half of the nodes is used. Specifying the -A flag causes the latest version of the peer domain configuration found on all of the nodes defined in the peer domain to be used. Specifying the -L flag causes the configuration on the local node 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 value 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 half of the 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

-A

Finds and uses the latest version of the peer domain configuration information from all of the nodes in the peer domain. This flag cannot be specified if the -L flag is specified. If neither flag (-A or -L) is specified, the latest version of the peer domain configuration information from at least half of the nodes in the peer domain is used.

-L

Uses the latest version of the peer domain configuration information that is on the local node. This flag cannot be specified if the -A flag is specified. If neither flag (-A or -L) is specified, the latest version of the peer domain configuration information from at least half of the nodes in the peer domain is used.

-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 half of the nodes can be found. The default timeout value is 120 seconds.

-Q quorum_type | quorum_type_name

Enables you to override the startup quorum mode. This can be specified as an integer quorum type or quorum type name. If you do not specify this flag, startup quorum mode will be specified using the mkrpdomain command's -Q flag (or the default quorum mode for your environment) when you created the peer domain. You can override the quorum startup mode only if the quorum mode has been defined as normal or quick. The valid values are:

0 │ normal

Specifies normal start-up quorum rules. Half of the nodes will be contacted for configuration information.

1 │ quick

Specifies quick start-up quorum rules. One node will be contacted for configuration information.

-m fanout

Specifies the maximum number of threads to use for this start operation. The -m flag overrides the default fanout value for the specified peer domain. This value is stored as a persistent attribute in the peer domain's IBM.PeerNode class. fanout can be an integer from 16 to 2048.

-h

Writes the command's usage statement to standard output.

-s

Specifies the wait time in seconds for the peer domain to be online before the command completes when the -s flag is used with the -w flag. If the waiting time exceeds the number of seconds, the command returns, but the online operation continues. The default value is 300 seconds (5 minutes). Use 0 to specify that the command must not return until the peer domain is online (no timeout on waiting).

-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.

-w

Waits for the peer domain to be online before the command completes. Use the -s flag to specify the waiting time in seconds.

Parameters

peer_domain

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.

CT_IP_AUTHENT

When the CT_IP_AUTHENT environment variable exists, the RMC daemon uses IP-based network authentication to contact the RMC daemon on the system that is specified by the IP address to which the CT_CONTACT environment variable is set. CT_IP_AUTHENT only has meaning if CT_CONTACT is set to an IP address; it does not rely on the domain name system (DNS) service.

Restrictions

This command must be run from a node that is defined to the peer domain.

Implementation Specifics

This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset for AIX®.

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

Location

/opt/rsct/bin/startrpdomain