B.3 rcxadm config

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm config - import and export of configuration information

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm config - import and export of configuration information

Format

rcxadm config map -file resource_map_file  -dir directory
rcxadm config filter {-tenant tenant_name|-global|-type vm|-exclude vm |-exclude type -name name |-convert} -indir indir -outdir outdir
rcxadm config show -type type -name name -dir directory  -format xml
rcxadm config cleanup [-tenant tenant_name] [-deluser] [[-predr]|[-postdr]]
rcxadm config vsfilter [-tenant tenant1[,tenant2[,...]]] [-global] [-dir dir] [-vm_pool vm_pool] -outfile file.csv

Description

rcxadm config is the command to import or export configuration information, when executing DR (Disaster Recovery).

Subcommands

map: Links exported configurations of Resource Orchestrator with resources of the switchover destination site.

filter: Perform filtering in order to divide and import exported configurations of Resource Orchestrator.

show: Displays the detailed information of exported configurations of Resource Orchestrator.

cleanup: Deletes the resource management information of the manager.

vsfiler

Outputs the information of the storage in which the virtual disks for cloning images/L-Servers in the scope specified by -tenant or -global have been deployed and the information of the VM host on which such storage is mounted to a file.

The types of the storage for extraction and the virtual storage information to be extracted are as follow:

VMware

Datastore

The file which is output is used as the input for the script which mounts multiple storage units in a batch to the VM host (dsmount.pl).

When executing this command, specify all tenants and global in which cloning images/L-Servers for which the virtual storage to be extracted is specified as the disk deployment destination have been registered, at the same time. If the specification is insufficient, a command error will occur.

Options

-dir directory: Specify the folders to store configuration information for linking with resources.

-file resource_map_file: Specify XML files which describe storage links.

-tenant tenant_name: Specify the names of the tenants to performing filtering for.

-global: Specify when performing filtering of resources commonly used among tenants.

-type vm: Specify when performing filtering of resources related to virtual L-Servers.

-exclude vm: Specify when performing filtering of resources other than those related to virtual L-Servers.

-exclude type

Specify the resource types to perform filtering of. The following types can be selected:

lserver
lplatform

-name name: Specify the names of the resources to perform filtering for or display details of.

-convert: The information that links a configured physical server with an L-Server is created in outdir.

-indir indir: Specify the folders for storing the configuration information of filtering targets.

-outdir outdir: Specify the folders for storing filtered configuration information.

-type type

Specify the type of resources to display details of. The following types can be selected:

lserver
network

-format xml

Specify the xml format to use when displaying details.

Example

convert.txt

[command]
rcxadm lserver convert -with BX900_1 -name physical_lserver_1
rcxadm lserver convert -with BX900_3 -name physical_lserver_2 -to /tenant_1
rcxadm lserver convert -with BX900_6 -name physical_lserver_3 -label test_label3 -comment test_comment3 -to /folder_1
[user]
user_1, physical_lserver_1
user_1, /tenant_1/physical_lserver_2
user_2, /folder_1/physical_lserver_2
[usergroup]
usergroup_1, physical_lserver_1
usergroup_2, /folder_1/physical_lserver_3

-tenant tenant_name

For the vsfiler Subcommand
Extracts the images/L-Servers in the tenant specified for tenant_name.
For the config Subcommand
For tenant name, specify the information of the tenant which the resources to be deleted belong to (the value specified using rcxrecovery -tenant when performing failback using DR).

-deluser: Deletes the user information associated with the resource management information that was deleted from the manager, from the user management software.

-predr: Unregisters the VM guest information associated with the resource management information that was deleted from the manager, from the VM management software.

-postdr: Unregisters the VM guest information and VM image information that are associated with the resource management information that was deleted from the manager, from the VM management software.

-global

Extracts the storage information of the images registered in the global pool and L-Servers from tenants.

When this option and the -tenant option are omitted, all storage information of all cloning images/L-Servers in the configuration definitions will be extracted.

-dir dir

Specify the folder to store the information for the target of switchover due to Disaster Recovery. If omitted, the ManagerExport folder under the folder (hereinafter, import definition folder) specified for import=directory will be specified in the following folder.

[Windows Manager]
Installation_folder\SVROR\Manager\etc\custmize_data\fa_dr.rcxprop

[Linux Manager]
/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

-vm_pool vm_pool

Specify the definition file that defines the VM pool to which the VM host belongs. For details on the content to include in the file, refer to "B.2 rcxrecovery".

If omitted, the vm_pool.csv file under the folder (hereinafter, an import definition folder) specified for import=directory will be specified in the following folder.

[Windows Manager]
Installation_folder\SVROR\Manager\etc\custmize_data\fa_dr.rcxprop

[Linux Manager]
/etc/opt/FJSVrcvmr/customize_data/fa_dr.rcxprop

-outfile

Use this option to specify the name of the file to which the extracted virtual storage information is output.

For each virtual storage, the following information is stored in CSV format:

Virtual storage type (vmfs, nfs)
Device path name on the VM host
The list of the VM hosts to which the storage will be mounted

The information is extracted from the VM pool definition file. The target of extraction is the definition file of the VM pool in which the VM hosts with L-Servers deployed were registered.

Specify a relative or absolute path.

Note

When the automatic collection of switchover information is enabled, performing cleanup disables the setting.
After the switchover is completed, enable the setting referring to "3.7 Configuring Automatic Collection of Switchover Information".

Output Example

RCXVSFILTER_v1.0
[VMware]
#operation,type,vstorage_name,datastore_name,mountpath,vmhosts
mount,vmfs,storage_A,storage_A,/vmfs/volumes/UUID1,vmhost1.example.org:vmhost2.example.org
mount,vmfs,storage_B,storage_B,/vmfs/volumes/UUID2,vmhost1.example.org:vmhost2.example.org
mount,vmfs,storage_E,storage_E,/vmfs/volumes/UUID3,192.168.10.1
mount,nfs,storage_X,storage_X,/vmfs/volumes/UUID4,192.168.10.2:192.168.10.3