Top
ServerView Resource Orchestrator Cloud Edition V3.4.0 DR Option Instruction
FUJITSU Software

B.1 rcxmgrexport

Name

[Windows Manager]

Installation_folder\SVROR\Manager\bin\rcxmgrexport - Collecting switchover information of Disaster Recovery

[Linux Manager]

/opt/FJSVrcvmr/bin/rcxmgrexport - Collecting switchover information of Disaster Recovery

Format

rcxmgrexport -help 
rcxmgrexport [-dir directory] [[-noretry]| [-timeout value]] 
rcxmgrexport -interval minutes [-base] | off rcxmgrexport -event on [-base] | off 
rcxmgrexport -status rcxmgrexport [-drlist [-error]] [-dir dir]

Function description

rcxmgrexport is the command used to collect information necessary for switchover using DR (Disaster Recovery).

Subcommands

None.

Option

-help
Specify this option to display the instructions for using this command.
-dir directory

Specify the folder to store information necessary for switchover using Disaster Recovery.

Example

[Windows Manager]

>Installation_folder\SVROR\Manager\bin\rcxmgrexport -dir D:\Export\ManagerExport <RETURN>

[Linux Manager]

# /opt/FJSVrcvmr/bin/rcxmgrexport -dir /DRExport/Export/ManagerExport <RETURN>

When omitted, the information is stored in the folder specified in the following file.

[Windows Manager]

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

[Linux Manager]

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

-noretry

Use this option to return directly to the command prompt without waiting for the operation being executed on the admin server to complete its execution.

Export can only be performed when no other operation is being executed. If an operation is being executed, this command will return an error.

-timeout value

Use this option to wait the number of seconds specified in value for completion of the operation being performed on the admin server. If the operation is not completed within the specified time, this command will return an error.

If this option is omitted, the default value (3600 seconds) is set. When this option is specified, value can be specified between 1 and 172800 (2 days).

Use this option to return an error when the operation being executed on the admin server does not complete its execution after the expiration of the number of seconds specified in value.

Periodical export may not be able to start its process while the manager is executing a time-consuming operation such as L-Server creation. Specify this option to cancel the operation after the specified number of seconds has elapsed.

The following message is output at a 600-second interval while the operation is running.

INFO:Manager operation is still running

-interval minutes | off

Specify this subcommand when periodically starting or stopping the operations to collect the information necessary for switchover to Disaster Recovery.

When starting the operation, specify the time interval for collection in minutes. Specify an integer between 1 and 1439.

The information is collected at the time interval specified in minutes. Only the newest version of the collected information remains.

When stopping operations, specify "off".

When operation is started, rcxmgrexport, rcxrepdef, and rcxstorage are executed periodically.

The information necessary for switchover using Disaster Recovery is stored in the folder specified using default=directory in the following file.

Therefore, set values for rcxmgrexport, rcxrepdef, and rcxstorage.

[Windows Manager]

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

[Linux Manager]

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

The operations to collect switchover information are the same type as operations with the -noretry option and the -timeout option omitted.

To check whether periodical collection of the information necessary for switchover using Disaster Recovery is enabled, use the -status option to check the setting.

When periodical collection is configured, the log of collection operations is stored at the following location:

[Windows Manager]

Installation_folder\SVROR\Manager\var\dr\rcxmgrexport_interval*

[Linux Manager]

/var/opt/FJSVrcvmr/dr/rcxmgrexport_interval*

-event on | off

When starting or stopping operation, specify the information necessary for switchover to Disaster Recovery to collect the information at the timing of collection of configuration definition information.

When starting operations, specify "on". Only the newest version of the collected information remains.

When stopping operations, specify "off".

When operation is started, rcxmgrexport, rcxrepdef, and rcxstorage are executed at the timing of information collection.

The information necessary for switchover using Disaster Recovery is stored in the folder specified in the following file.

Set values for rcxmgrexport, rcxrepdef, and rcxstorage.

[Windows Manager]

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

[Linux Manager]

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

The timing of information collection is as follows.

  • rcxmgrexport

    • L-Platform operations (creation, modification, deletion, starting, stopping)
  • rcxrepdef

    • Registration of resources to a storage pool, Unregistration of resources from a storage pool
    • L-Server creation, L-Server deletion (when Dynamic LUN mirroring is used)
    • Attachment of disks to an L-Server, Detachment of disks from an L-Server (when Dynamic LUN mirroring is used)
  • rcxstorage

    • L-Server creation, L-Server deletion
    • Attachment of disks to an L-Server, Detachment of disks from an L-Server

The range of the operations to collect switchover information using the rcxmgrexport command is the same as those with the -noretry option and the -timeout option omitted.

Required Option Setting Information for the rcxrepdef Command

Before starting automatic switchover information collection, edit the following DR definition file to provide necessary argument information for the rcxrepdef command that is executed for information collection.

[Windows Manager]

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

[Linux Manager]

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

Lines other than the following that begin with sharp signs ("#") are comments in this DR definition file.

  • #rcxrepdef_define
  • #rcxstorage_define
  • #rcxmgrexport_define
  • #rcxrecovery_define
  • #dr_storagepool
  • #exclude_lserver
  • #salvage_define
  • #DR Operation Method
  • #Config File Switchover

Blank lines in this DR definition file are regarded as meaningless and skipped.

#rcxrepdef_define 
# (omitted) 
# 
ccm, ,argument value for -local option, argument value for -remote option 
snapmirror, ,argument value for -local option, argument value for -remote option 
navisphere,argument value for -rhost option, argument value for -local option, argument value for -remote option 
solutionenabler,argument value for -rhost option, argument value for -local option, argument value for -remote option

For details on the values to be set, refer to "5.22 rcxrepdef" in the "Reference Guide (Command/XML) CE".

To check whether collection of the information necessary for switchover using Disaster Recovery upon update of the configuration definition information is enabled, use the -status option to check the setting.

The log of switchover information collection that is performed during configuration changes can be found in the following location.

[Windows Manager]

Installation_folder\SVROR\Manager\var\dr\rcxmgrexport_event*

[Linux Manager]

/var/opt/FJSVrcvmr/dr/rcxmgrexport_event*

Note

The collection methods enabled with the -interval option and the -event option cannot be used simultaneously. When switching the methods, execute the command specifying "off" in the option to stop the present operation. After that, execute the other command to start the new operation.

-base

When operation is started with the -event on option or the -interval option also specified, only rcxmgrexport is executed at the timing of information collection.

Specify this option when using "virtual L-Server switchover (VM guest)", not "physical L-Server switchover (physical OS)" as the switchover method.

-status
Displays whether the -interval and -event options are enabled or disabled.
-drlist

Use this option to display the following resource types of the DR target resources.

  • Tenants
  • L-Platforms
  • L-Servers
  • Images
-error

As both DR target storage and non DR target storage are being used, the following resource types that cannot be switched are displayed.

  • L-Servers
  • Images
-dir dir

Specify the folder to store information necessary for switchover using Disaster Recovery.

When specifying the -drlist or the -drlist -error option, specify the folder in which the exported data collected using the rcxmgrexport command is stored.

When omitted, the information will be stored in the folder specified as the output destination of the rcxmgrexport command in the following file:

[Windows Manager]

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

[Linux Manager]

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

Note

When the switchover information is collected manually using the command rather than using automatic collection using the -interval option or the -event option, switchover information collected in the past is not automatically deleted.

For this reason, when old versions of switchover information are no longer necessary, delete such information manually.

Example

Switchover information storage folders are composed as follows.

To delete the information other than the newest switchover information, delete the folders (in this example, the lines with [Deletion target]) other than the ones with the latest time stamp.

\ROR20140212123224 [Deletion target] 
\ROR20140324100000 
\CFMG20140212123224 [Deletion target] 
\CFMG20140324100000 
\CONFIG_FILE20140212123224 [Deletion target] 
\CONFIG_FILE20140324100000 
\CTMG_CHARGE20140212123224 [Deletion target] 
\CTMG_CHARGE20140324100000 
\CTMG_METER20140212123224 [Deletion target] 
\CTMG_METER20140324100000 
\OtherBackupFiles\disk_vstorage_info20140212123224 [Deletion target] 
\OtherBackupFiles\disk_vstorage_info20140324100000

Requirements

Permissions

Refer to "5.1.2 Roles and Available Operations" in the "Design Guide CE".

Location

Admin server

Exit Status

This command returns the following values:

0
The command executed successfully.
1
An error has occurred.

Example

 rcxmgrexport <RETURN> 
=== MMM DD HH:MM:SS YYYY === : Exporting ServerView Resource Orchestrator config info ..... 
=== MMM DD HH:MM:SS YYYY === : OK 
=== MMM DD HH:MM:SS YYYY === : Exporting ServerView Resource Orchestrator config files ..... 
=== MMM DD HH:MM:SS YYYY === : OK 
=== MMM DD HH:MM:SS YYYY === : Exporting ServerView Resource Orchestrator Service Configuration Manager config info ..... 
=== MMM DD HH:MM:SS YYYY === : OK 
=== MMM DD HH:MM:SS YYYY === : Exporting ServerView Resource Orchestrator Service Catalog Manager charging info ..... 
=== MMM DD HH:MM:SS YYYY === : OK 
=== MMM DD HH:MM:SS YYYY === : Exporting ServerView Resource Orchestrator Service Catalog Manager metering log ..... 
=== MMM DD HH:MM:SS YYYY === : OK 

> rcxmgrexport -drlist <RETURN> 
TYPE NAME 
---- ---- 
L-Server /tenant_1/l-server_1 
Image /image_1 
Image /image_2 

> rcxmgrexport -drlist -error <RETURN> 
TYPE NAME 
---- ---- 
L-Server /tenant_1/l-server_1