Top
ServerView Resource Orchestrator Cloud Edition V3.1.2 DR Option Instruction
FUJITSU Software
Appendix B Commands > B.6 rcxdrcheck
PreviousNext

B.6 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...]]

Description

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

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

Check No.

Check Item

1

Presence of LUN replication in the switch scope

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

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

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:

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

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

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

Item Name

Description

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.


Options

-mode {prepare|check}

Specify "prepare" or "check".

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
-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 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
/VMHostPool,192.168.2.1
/VMHostPool,192.168.2.2
/tenant1/TenantVMHostPool,vmhost1.example.org
/tenant1/TenantVMHostPool,vmhost2.example.org
/tenant2/TenantVMHostPool,192.168.10.15

  • Specify the VM pool name of the switchover source site for vmpool_name, and 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.

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

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


Examples

PreviousNext
Copyright 2012-2015 FUJITSU LIMITED