rcxdrcheck

Name

[Windows Manager]

Installation_folder\SVROR\Manager\bin\rcxdrcheck - Disaster Recovery configuration check

[Linux Manager]

/opt/FJSVrcvmr/bin/rcxdrcheck - Disaster Recovery configuration check

Format

rcxdrcheck -mode {prepare| check} [-config_dir dir] 
                         [-dir dir] [-image_dir dir] [-map mapping_dir] 
                         [-mirror storage_file] [{-vmmgr vmmgr_file| -vm_pool pool_file}] 
                         [-global] [-tenant tenant1[,tenant2...]]

Function description

rcxdrcheck is the command to check the DR (Disaster Recovery) configuration.

This command performs the following checks on the switchover source site:

Items Checked by the DR Configuration Check Tool

Table B.1 Items Checked by the DR Configuration Check Tool
Check No.	Check Item
1	Presence of LUN replication in the switchover scope (excluding LUNs with OVM for SPARC configurations)
2	Whether there are virtual storage resources with avoidance of duplicated storage names applied
3	Whether files to be used during switchover have been created
4	Whether operations that require re-output of the configuration information file are performed on Resource Orchestrator after the configuration information file has been output
5	Whether the path of the image storage folder has been changed to "Switchover_information_storage_folder\Image"
6	For Active-Active operation Whether resource names overlap between the sites Whether the resources used for switchover have been released from the resource pool on the switchover destination site
6	For Active-Standby operation Whether resource names overlap between the sites
7	Whether the scopes of the network resources overlap between the sites
8	Whether the scopes of the address set resources overlap between the sites
9	Whether the servers and VM host resources required during switchover exist on the switchover destination site
10	Whether the network device resources required during switchover exist on the switchover destination site
11	Whether the same version level of ROR CE managers are used on both sites
12	Whether the installation folder of the ROR CE manager on both sites matches
13	Whether the admin LAN IP address of the admin server is same on both sites
14	That IP addresses set for the storage devices registered in the admin server do not overlap between sites
15	That configured server IP addresses do not overlap between sites
16	Whether address set resources and network resources are stored in the tenant
17	Whether the prefixes used for software IDs differ between sites
18	If the DR definition file (fa_dr.rcxprop) is correctly configured
19	If resources with the same names as the resources on the switchover source site exist on the switchover destination site

If necessary, before executing this command, edit the following definition file for the DR configuration check tool, using the ROR manager for the target site.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\drcheck.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/drcheck.rcxprop

It is necessary to specify the -config_dir option when all of the following conditions are met:

"rcxdrcheck_prepare_define" is not specified in the definition file
The command is executed with "prepare" specified for the "-mode" option

When all of the following conditions are met, it is necessary to specify the -config_dir option.

"rcxdrcheck_check_define" is not specified in the definition file
The command is executed with "check" specified for the "-mode" option

It is necessary to specify the -dir option when all of the following conditions are met:

"#rcxmgrexport_define" is not specified in the DR definition file (fa_dr.rcxprop)
The command is executed with "check" specified for the "-mode" option

Set the following items in the definition file for the DR configuration check tool.

For the values that can be set for each item, refer to the following example.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\drcheck.rcxprop.sample

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/drcheck.rcxprop.sample

Table B.2 Items to Set in the Definition File of the DR Configuration Check Tool
Item Name	Content
DR_switchover_method	Specify the switchover method. If this item is not configured, an inquiry message is output when the command is executed.
DR_operation_method	Specify the DR switchover operation method. If this item is not configured, an inquiry message is output when the command is executed.
excluded_check_items	Specify the items that will not be checked. When this item has not been configured, the DR configuration check is performed for all check items.
rcxdrcheck_prepare_define	Specify the folder to which the configuration information of the switchover destination site used by the DR configuration check tool is output. This folder is the folder on the ROR manager on the switchover destination site. Secure 100 MB or more free space for the storage folder.
rcxdrcheck_check_define	Specify the folder in which the configuration information of the switchover destination site used by the DR configuration check tool is stored. This folder is the folder on the ROR manager on the switchover source site. Secure 100 MB or more free space for the storage folder.

Subcommands

None.

Option

-mode {prepare| check}

Specify "prepare" or "check".

Table B.3 Operation Modes of the DR Configuration Check Tool
Option to Specify	Target Site of the rcxdrcheck Command	Remarks
prepare	Switchover destination site	The information of the ROR manager.
check	Switchover source site	The DR configuration check tool is executed.

-config_dir dir

When "prepare" is specified for the -mode option

Specify the folder to which the configuration information of the switchover destination site used by the DR configuration check tool is output. This folder is the folder on the ROR manager on the switchover destination site.

Example

[Windows Manager]

>Installation_folder\SVROR\Manager\bin\rcxdrcheck -mode prepare -config_dir C:\Users\Administrator\work\drcheck_prepare_dir <RETURN>

[Linux Manager]

# /opt/FJSVrcvmr/bin/rcxdrcheck -mode prepare -config_dir /root/work/drcheck_prepare_dir <RETURN>

When omitted, the information is stored in the folder specified for "rcxdrcheck_prepare_define" in the following file:

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\drcheck.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/drcheck.rcxprop

Example

[Windows Manager]

#Specify the rcxdrcheck export folder 
#ex) rcxdrcheck_prepare_define=D:\Export\drcheck_prepare_dir 
rcxdrcheck_prepare_define=D:\Export\drcheck_prepare_dir

[Linux Manager]

#Specify the rcxdrcheck export folder 
#ex) rcxdrcheck_prepare_define=D:\Export\drcheck_prepare_dir 
rcxdrcheck_prepare_define=/DRExport/Export/drcheck_prepare_dir

When "check" is specified for the -mode option

Specify the folder in which the configuration information of the switchover destination site used by the DR configuration check tool is stored. This folder is the folder on the ROR manager on the switchover source site.

Example

[Windows Manager]

>Installation_folder\SVROR\Manager\bin\rcxdrcheck -mode check -config_dir C:\Users\Administrator\work\drcheck_check_dir <RETURN>

[Linux Manager]

# /opt/FJSVrcvmr/bin/rcxdrcheck -mode check -config_dir /root/work/drcheck_check_dir <RETURN>

When omitted, the information is stored in the storage folder specified for "rcxdrcheck_check_define" in the following file:

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\drcheck.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/drcheck.rcxprop

Example

[Windows Manager]

#Specify the rcxdrcheck check folder 
# ex) rcxdrcheck_check_define=D:\Export\drcheck_check_dir 
rcxdrcheck_check_define=D:\Export\drcheck_check_dir

[Linux Manager]

#Specify the rcxdrcheck check folder 
# ex) rcxdrcheck_check_define=D:\Export\drcheck_check_dir 
rcxdrcheck_check_define=/DRExport/Export/drcheck_check_dir

-dir dir

When "check" is specified for the -mode option, specify the following options, if necessary.

Specify the folder on the switchover source site where the Disaster Recovery switchover information is stored.

Example

[Windows Manager]

>Installation_folder\SVROR\Manager\bin\rcxdrcheck -mode check -dir D:\Export\ManagerExport <RETURN>

[Linux Manager]

# /opt/FJSVrcvmr/bin/rcxdrcheck -mode check -dir /DRExport/Export/ManagerExport <RETURN>

When omitted, it is handled as though the ManagerExport folder, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

When specifying this option, also specify the following options, if necessary.

-image_dir
-map
-mirror
-vmmgr
-vm_pool

-image_dir dir

Specify the image file storage folders of physical servers. When specifying the -dir option, also specify this option.

When the -dir option and this option are omitted, it is handled as if the Image folder, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

-map mapping_dir

Specify the folder in which the mapping files that define the relationships of the server names between the switchover source site and the switchover destination site are stored. When specifying the -dir option, also specify this option.

When the -dir option and this option are omitted, it is handled as if the MAP folder, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

When changing the physical server name registered in the server tree or the VM management software name registered in the management software tree between the switchover source site and the switchover destination site, create a file under the MAP folder with the following content before executing the rcxdrcheck command.

Any file name can be used.
Comments cannot be set in this definition file.
Blank lines in this definition file are regarded as meaningless and skipped.
Enter the physical server mapping definitions in a single file.
When defining physical server mapping, enter "#PhysicalServer" in a single line in this definition file. Enter the mapping definitions for physical servers after this line.
Each physical server mapping definition should be stated in a single line, separating two corresponding physical server names using a comma (",").
Enter mapping definitions for VM management software in a single file.
When defining VM management software mapping, enter "#VMManagementSoftware" in a single line in this definition file. Enter the mapping definitions for VM management software after this line.
Each VM management software mapping definition should be stated in a single line, separating two corresponding VM management software names using a comma (",").

Example

#PhysicalServer 
Server1-1,Server2-1 Server1-2,Server2-2#VMManagementSoftware 
VMM1-1,VMM2-1 VMM1-2,VMM2-2 
Server1-1 and Server1-2 are the server names on the switchover source site. 
Server2-1 and Server2-2 are the server names on the switchover destination site. 
VMM1-1 and VMM1-2 are the VM management software names on the switchover source site. 
VMM2-1 and VMM2-2 are the VM management software names on the switchover destination site.

Information

Mapping definitions of physical servers and VM management software can be described in the MAP folder using either one of the following file configurations.

Enter descriptions in a single file
Enter descriptions in (two) different files

When including both the definition of physical server mapping and the definition of VM management software in the same file, do not give the descriptions as follows:

Describing the physical server mapping definitions after the line including "#VMManagementSoftware", and before the line including "#PhysicalServer"
Describing the VM management software mapping definitions after the line including "#PhysicalServer", and before the line including "#VMManagementSoftware"

-vm_pool vm_pool

Specify the definition file that defines the VM pool to which the VM host belongs. When this option is specified, the pre-check operation is performed assuming that virtual L-Server switchover is specified. When specifying the -dir option, also specify this option.

When the -dir option and this option are omitted, it is handled as if the vm_pool.csv file, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

Create the file defining VM hosts on which the switchover target virtual L-Server is operating under the switchover information storage folder as follows.

Specify the file name as vm_pool.csv.
Lines beginning with sharp signs ("#") are comments in this definition file.
Blank lines in this definition file are regarded as meaningless and skipped.

Example

#vmpool_name,vmhost_name,vmhost_type 
/VMHostPool,192.168.2.1,VMware 
/VMHostPool,192.168.2.2,OVM-SPARC 
/tenant1/TenantVMHostPool,vmhost1.example.org,VMware 
/tenant1/TenantVMHostPool,vmhost2.example.org,OVM-SPARC 
/tenant2/TenantVMHostPool,192.168.10.15

Specify the VM pool name of the switchover source site for vmpool_name.
Specify the VM host name (displayed on the server tree of the ROR console in the switchover destination site) of the switchover destination site to be registered in the vmpool_name in the switchover destination site for vmhost_name.

Specify the VM host type for vmhost_type.

"VMware" and "OVM-SPARC" can be specified for vmhost_type. If this option is omitted, "VMware" is set.

When registering multiple VM hosts in a VM pool, enter multiple lines.

-vmmgr vmmgr_file

Specify the VM management software definition file to register VM management software on the switchover destination site. When this option is specified, the pre-check operation is performed assuming that physical/virtual L-Server switchover is specified. When specifying the -dir option, also specify this option.

When the -dir option and this option are omitted, it is handled as if the vmmgr_file.txt file, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

Create the information in the switchover information storage folder in order to register VM management software of Resource Orchestrator on the switchover destination site.

Specify the file name as vmmgr_file.txt.
Lines beginning with sharp signs ("#") are comments in this definition file.
Blank lines in this definition file are regarded as meaningless and skipped.

Example

#name soft name ip user name password physical-lserver 
vcenter, vmware-vc, 192.168.1.24, admin, admin, no 
scvmm, ms-scvmm, 192.168.100.77, root, root, yes

-mirror storage_file

Specify the intermediate files for mapping that were output by executing the rcxstorage command with the -recovery option and -mode prepare option on the switchover source site. When specifying the -dir option, also specify this option.

When the -dir option and this option are omitted, it is handled as if the storage_file file, which is stored at one level higher than the folder specified for "#rcxmgrexport_define" in the following file, is specified.

[Windows Manager]

Installation_folder\SVROR\Manager\etc\customize_data\fa_dr.rcxprop

[Linux Manager]

/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

-global

Performs the DR configuration check on global resources.

When this option and the -tenant option are omitted, the DR configuration check is performed on all resources on the switchover source site.

-tenant tenant1

Performs the DR configuration check on tenant resources and the global resources related to the tenant.

When this option and the -global option are omitted, the DR configuration check is performed on all resources on the switchover source site.

Exit Status

This command returns the following values:
0: The command executed successfully.

1: An error has occurred.

Check Results

The following check results are output in the "Result" for each check item.

OK: When DR can be executed correctly after checking the target items
ERROR: When DR cannot be executed due to setting errors found when checking the target items
WARNING: When DR can be executed, however settings that are not recommended were found when checking the target items
SKIPPED: The target item is an item specified in "excluded_check_items" in the definition file for the DR configuration check tool

For corrective actions for ERROR and WARNING messages, refer to "C.3 Error Messages Regarding rcxdrcheck".

Example

When outputting the information from the ROR manager on the switchover destination site
```
>rcxdrcheck -mode prepare <RETURN>
```

When performing a check of the DR configuration check tool on the switchover source site

>rcxdrcheck -mode check <RETURN> 
Please select the switchover method. 
<DR Switchover Method> 
1:Physical L-Server switchover 
2:Physical/Virtual L-Server switchover 
3:Virtual L-Server switchover 
4:both Physical L-Server switchover and Physical/Virtual L-Server switchover 
5:both Physical L-Server switchover and Virtual L-Server switchover 
=>1 
Please select the type of DR operation method. 
<DR Operation Method> 
1:Active-Active 
2:Active-Standby 
=>1 
[hh:mm:ss] Disaster Recovery check tool start... 
[hh:mm:ss] (01/19): Correctness of Storage Replication : completed 
[hh:mm:ss] (02/19): Confliction of Storage Names : skipped 
[hh:mm:ss] (03/19): Integrality of Rcxrecovery Input Files : completed 
[hh:mm:ss] (04/19): Consistency of rcxmgrexport output : completed 
[hh:mm:ss] (05/19): Location of Physical Image Folder : completed 
[hh:mm:ss] (06/19): Confliction of Resource Name : completed 
[hh:mm:ss] (07/19): Confliction of Network Resource : completed 
[hh:mm:ss] (08/19): Confliction of AddressSet Resource : completed 
[hh:mm:ss] (09/19): Consistency of Server Resource : completed 
[hh:mm:ss] (10/19): Consistency of Network Device : completed 
[hh:mm:ss] (11/19): Consistency of ROR Manager Version : completed 
[hh:mm:ss] (12/19): Consistency of ROR manager Installation Folder : completed 
[hh:mm:ss] (13/19): Consistency of Admin Lan IP Address : completed 
[hh:mm:ss] (14/19): Confliction of Storage Units' IP Addresses : completed 
[hh:mm:ss] (15/19): Confliction of Servers' IP Addresses : completed 
[hh:mm:ss] (16/19): Use of Global AddressSet and Network : completed 
[hh:mm:ss] (17/19): Confliction of Software ID : completed 
[hh:mm:ss] (18/19): Correctness of definition file configuration : completed 
[hh:mm:ss] (19/19): Consistency of Resource Name : completed 
[hh:mm:ss] Disaster Recovery check tool end... 
Check result are shown as the following: 
Total: 19 
OK: 16 
ERROR: 1 
WARNING: 1 
SKIPPED: 1 
Item 01: Correctness of Storage Replication 
Result : ERROR 
Detail: 
ERROR:Storage resources on the switchover source site are not replicated.target=storage_name1,storage_name2 
Item 02: Confliction of Storage Names 
Result : SKIPPED 
Item 03: Integrality of Rcxrecovery Input Files 
Result : OK 
Item 04: Consistency of rcxmgrexport output 
Result : OK 
Item 05: Location of Physical Image Folder 
Result : OK 
Item 06: Confliction of Resource Name 
Result : OK 
Detail: 
Item 07: Confliction of Network Resource 
Result : OK 
Item 08: Confliction of AddressSet Resource 
Result : OK 
Item 09: Consistency of Server Resource 
Result : OK 
Item 10: Consistency of Network Device 
Result : WARNING 
Detail: 
WARNING:Network devices have not been prepared on the destination site.target= net_dev1,net_dev2... 
Item 11: Consistency of ROR Manager Version 
Result : OK 
Item 12: Consistency of ROR manager Installation Folder 
Result : OK 
Item 13: Consistency of Admin Lan IP Address 
Result : OK 
Item 14: Confliction of Storage Units' IP Addresses 
Result : OK 
Item 15: Confliction of Servers' IP Addresses 
Result : OK 
Item 16: Use of Global AddressSet and Network 
Result : OK 
Item 17: Confliction of Software ID 
Result : OK 
Item 18: Correctness of definition file configuration 
Result : OK 
Item 19: Consistency of Resource Name 
Result : OK

B.6 rcxdrcheck

Name

Format

Function description

Subcommands

Option

Exit Status

Check Results

Example