Commands Reference, Volume 3

mkrpdomain Command

Purpose

Creates a new peer domain definition.

Syntax

mkrpdomain [-t TS_port] [-g GS_port] [-c] [-h] [-TV] domain_name node_name1 [node_name2 ... ]

mkrpdomain [-t TS_port] [-g GS_port] [-c] -f file_name [-h] [-TV]

Description

The mkrpdomain command creates a new peer domain definition with the name specified by the domain_name parameter. The nodes specified by node_name are defined to the new peer domain. A peer domain can be used to provide high-availability services when configuring application and system resources.

The preprpnode command must have been run on each of the nodes to be defined to the peer domain. The preprpnode command prepares the security environment for the peer domain operations. See the preprpnode command for more information about peer domain definition requirements. Only those nodes that have the appropriate security setup will be successfully defined to the peer domain.

If the UDP port numbers for group services and topology services are not available on all of the nodes to be defined to the peer domain, the mkrpdomain command will fail. The command will also fail if the domain name is already being used or if any node cannot be successfully defined to the peer domain.

The mkrpdomain command does not bring the peer domain online automatically. To bring the peer domain online, run the startrpdomain command. Nodes can be added to and removed from the peer domain using the addrpnode and rmrpnode commands.

A node can be defined in more than one peer domain but it can be online in only one peer domain at a time.

Flags

-t TS_port: Specifies the topology services port number. This UDP port is used for daemon-to-daemon communication. Any unused port in the range 1024 to 65535 can be assigned. The command will fail if the specified port is unavailable. The default is 12347.
-g GS_port: Specifies the group services port number. This UDP port is for daemon-to-daemon communication. Any unused port in the range 1024 to 65535 can be assigned. The command will fail if the specified port is unavailable. The default is 12348.
-c: Continues to run the mkrpdomain command on the remaining nodes.
By default, if the mkrpdomain command fails on any node, it will fail on all nodes. The -c flag overrides this behavior, so that the mkrpdomain command will run on the other nodes, even if it fails on one node.
-f file_name: Reads a list of node names from file_name.
-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 the new peer domain to be created. The name can contain any printable character. The name cannot be IW.
node_name1 [node_name2 ... ]: Specifies the node (or nodes) to include in this peer domain definition. The node name is the IP address or the long or short version of the DNS hostname. The node name must resolve to an IP address. The node on which the command runs is automatically defined to this peer domain and specifying it is optional.

Security

The user of the mkrpdomain command needs write permission to the IBM.PeerDomain resource class on each node that is to be defined to the peer domain. This is set up by running the preprpnode command on each node that is to be defined to the domain, specifying the name of the node on which the user will run mkrpdomain.

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

Any node to be defined to the peer domain must be reachable from the node on which this command runs.

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 define a peer domain consisting of nodeA with the domain name ApplDomain, run one of these commands on nodeA:
```
mkrpdomain ApplDomain

mkrpdomain ApplDomain nodeA
```
To define a peer domain consisting of nodeA, nodeB, and nodeC with the domain name ApplDomain, run this command on nodeA, nodeB, or nodeC:
```
mkrpdomain ApplDomain nodeA nodeB nodeC
```
To define a peer domain consisting of nodeA and nodeB with domain name ApplDomain, topology services port number 1200, and group services port number 2400, run this command on nodeA or nodeB:
```
mkrpdomain -t 1200 -g 2400 ApplDomain nodeA nodeB
```

Location

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

Files

The /etc/services file is modified.

Related Information

Commands: addrpnode, lsrpdomain, lsrpnode, preprpnode, rmrpdomain, rmrpnode, startrpdomain, stoprpdomain