jajs_rpsite

Format

jajs_rpsite
     [-h logical-host-name]
     [-m {SET|SETSAME|CHANGE|UNSET} | -v | -V]

To Page Top

Description

The jajs_rpsite command sets up JP1/AJS3 for operation in disaster recovery mode using the disk copy and mirroring functionality of the hardware.

The following processing can be performed according to the specified option:

• Set up a new logical host to operate as the main site

• Change the logical host that operates as the main site

• Exit disaster recovery mode

• Display the name of the logical host operating as the main site

• Display whether the site is the main site or remote site

You can execute this command only in the standard configuration.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Arguments

To Page Top

Notes

• Before you start copying between the shared disks by means of the hardware functions, make sure that you specify the -m SET or -m SETNAME option to configure the logical host that will operate as the main site. If you do not designate the logical host that is to operate as the main site, JP1/AJS3 services will not be deactivated at the remote site.

• Do not execute the jajs_rpsite command repeatedly in quick succession. In addition, do not execute this command at the same time and on the same logical host as the command jajs_rpenvexport, jajs_rpenvimport, or jajs_spmd. If you do so, the following problems might occur:

  • The message output is incorrect. For example, an invalid message might be output or a message that would normally be output does not appear.

  • The jajs_rpsite command results in an error.

  • The configuration definition information becomes invalid, disabling further operation of JP1/AJS3.

• Before you execute the -m SET, -m SETNAME, -m CHANGE, or -m UNSET option, stop disk copying by hardware functions between the shared disks.

• If you execute the -m SET, -m SETNAME, or -m CHANGE option at the main site while information is being copied from the main site to the remote site, the command will end abnormally because the logical host that is to operate as the main site has already been specified.

• Execute the -m SET, -m SETNAME, and -m CHANGE options at the site that is to operate as the main site.

• Execute the -m UNSET options at both the main site and remote site.

• After executing the command jajs_rpsite with the option -m SET, -m SETSAME, or -m UNSET, check whether the settings for operation in disaster recovery mode were correctly specified or removed. To check this, execute the command jajs_rpsite with the -v or -V option.

• If you execute this command at the remote site while information is being copied from the main site to the remote site, the shared disks cannot be accessed and the command will end abnormally.

• The command terminates abnormally if the shared disks of the logical hosts are not mounted.

• To reconfigure operation in disaster recovery mode, remove the settings for operation in disaster recovery mode by using the option -m UNSET, and then respecify the settings by using the option -m SET or -m SETSAME.

To Page Top

Return values

To Page Top

Example

The following examples show operation in disaster recovery mode, using the disk copy and mirroring functionality of the hardware.

To Page Top

Example 1

In the following example, logical hosts are configured by using different names, and LHOST_M is specified for the main-site logical host.

jajs_rpsite -h LHOST_M -m SET

To Page Top

Example 2

In the following example, logical hosts are configured by using the same name, and LHOST_M is specified for the main-site logical host.

jajs_rpsite -h LHOST_M -m SETSAME

To Page Top

Example 3

In the following example, logical hosts are configured by using different names, and the main-site logical host switches to LHOST_R (which is currently operating as the remote site) during failover.

jajs_rpsite -h LHOST_R -m CHANGE

To Page Top

Example 4

In the following example, logical hosts are configured by using the same name, and the main-site logical host switches to LHOST_M (which is currently operating as the remote site) during failover.

jajs_rpsite -h LHOST_M -m CHANGE

To Page Top

Example 5

Display the name of the logical host currently operating as the main site in the following configuration:

• Main site: Logical host (LHOST_M)

• Remote site: Logical host (LHOST_R)

jajs_rpsite -h LHOST_M -v

or

jajs_rpsite -h LHOST_R -v

To Page Top

Example 6

In the examples below, the command displays whether each specified logical host is currently operating as the main site or as the remote site, where the main site and remote site are as follows:

• Main site: Logical host (LHOST_M)

• Remote site: Logical host (LHOST_R)

jajs_rpsite -h LHOST_M -V

or

jajs_rpsite -h LHOST_R -V

To Page Top

Example 7

Exit disaster recovery mode in the following configuration:

• Main site: Logical host (LHOST_M)

• Remote site: Logical host (LHOST_R)

jajs_rpsite -h LHOST_M -m UNSET

and

jajs_rpsite -h LHOST_R -m UNSET

To Page Top

Output example 1

The following shows an output example when you specify the -v option to display the name of the logical host currently operating as the main site:

> jajs_rpsite -h LHOST_M -v
LHOST_R

To Page Top

Output example 2

The following examples show the output when the -V option is specified to display whether the specified logical host is currently operating as the main site or the remote site:

> jajs_rpsite -h LHOST_M -V
Main
 
> jajs_rpsite -h LHOST_R -V
Remote

To Page Top