1.7.11 rcxadm config

Name

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

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

Format

rcxadm config import -dir directory
rcxadm config export -dir directory [[-noretry]|[-timeout value]]
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 cleanup -alluser
rcxadm config reserve -dir directory
rcxadm config show -type type -name name -dir directory  -format xml

Description

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

Subcommands

import

Imports the configuration information.

In dir, specify the storage folder for the configuration information of the resource to be imported.

export

Exports the configuration information.

After executing the command, the following XML files are created in the folder specified using dir.

For details on XML files, refer to "Chapter 2 Resource Configuration Information and User Definition Information (XML Files)".

dir\l_server_templates.xml
dir\l_servers.xml
dir\image.xml
dir\network_resources.xml
dir\address_resource.xml
dir\resource_folders.xml
dir\users.xml
dir\user_groups.xml
dir\pools.xml
dir\lnetdev.xml

map: Configures the exported Resource Orchestrator, and associate resources of the backup site.

filter: Filters the configuration information to divide and import the exported settings for Resource Orchestrator.

cleanup: Initialize the settings of this product when failback is performed after Disaster Recovery.

reserve: Reserve the resource ID so that the resource ID used in the settings for this product that are exported do not conflict with the resources in the destination for Disaster Recovery failback.

show: Displays the details of the settings for this product that were exported.

Options

-dir directory: Specify the directory in which the configuration information for associating resources is stored.

-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 to 172800(2days).

Use this option to return with 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 backup after the specified number of seconds has elapsed.

The following messages are output by the spacing for 600 seconds while it meets the operation.
INFO:Manager operation is still running

-file resource_map_file: Specify the XML file that describes the association of storage.

-tenant tenant_name: Specify the tenant name to filter.

-global: Specify to filter the resources shared with other tenants.

-type vm: Specify to filter the resources related to the virtual L-Server.

-exclude vm: Specify to filter the resources other than those related to the virtual L-Server.

-exclude type

Specify the resource type to be filtered. The following types can be selected.

lserver
lplatform

-name name: Specify the name of the resource to be filtered or whose details are to be displayed.

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

-indir indir: Specify the directory to store the configuration information of the filtering target.

-outdir outdir: Specify the directory in which to store the configuration information that was filtered.

-alluser: Specify when the user information is also to be initialized when the definitions for this product are initialized in Disaster Recovery.

-type type

Specify the type of resource to display the details for. The following types can be selected.

lserver
network

-format xml

Specify xml for the format when the details are to be displayed.

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