forcerpoffline Command

Purpose

Forces a peer domain to be offline.

Description

The forcerpoffline command must be used only if a node is in a pending online state and you are unable to bring it online using the startrpdomain command. This scenario can occur if you try to bring the node online while the domain is operating under quorum. If you are not sure why the node is stuck in the pending online state, run the ctsnap command before using the forcerpoffline command. As a result of running the forcerpoffline command, the configuration resource manager subsystem (IBM.ConfigRM) and the RMC subsystem (ctrmc) are recycled.

Parameters

domain_name

Specifies the name of a previously defined peer domain that is to be forced offline.

Flags

-h

Writes the command usage statement to standard output.

Files

The /var/ct/cfg/current_cluster file and the /var/ct/cfg/default_cluster file are modified.

Standard output

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

Exit status

0

The command ran successfully.

1

The command terminated due to an underlying RMC error.

2

The command terminated due to an underlying error in the command script.

3

The command terminated because the user specified a non-valid flag.

4

The command terminated because the user specified a non-valid parameter.

5

The command terminated due to a user error (specifying a domain name that does not exist, for example).

Security

You must have root authority to run this command.

Implementation specifics

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

Location

/opt/rsct/bin/forcerpoffline