Reference Guide › Command Line Scripting › General Shell Commands › dpmix export|import|verify Command--Migrate System Data

dpmix export|import|verify Command--Migrate System Data

The dpmix command line utility provides a means for saving specific CA Virtual Assurance data objects for subsequent redeployment into a newly installed or an additional CA Virtual Assurance system. You can import or export actions, rules, jobs, for example, to new or existing systems. Management DB information must be available in the registry and the Microsoft SQL client must be installed for the utility to work. You must have a user name with administrator privileges to access dpmix. If you input invalid arguments or no arguments, an error message appears with syntax information and the list of data types that you can migrate.

This command has the following format:

dpmix {-export|-import|-verify} -f filename [-clean] [-replace] [-noprompt] [-nohelpdesk] [-verbose] -user adminusername -password adminpassword [-auth_file authorizationfilename] -cohesion_server {none|default_cohesion|preserve|name} [-port ccaportnumber] [-default {all|none}] [-service {all|none}] [-server {all|none}] [-action {all|none}] [-rule {all|none}] [-job {all|none}] [-resource {all|none}] [-dpm_ibm_hmc {all|none}] [-serviceprocessor {all|none}] [-vCenter {all|none}] [-networkdevice {all|none}]

-export

Saves and exports selected (or default) data types and associated data from the local CA Virtual Assurance system to the data file specified.

-import

Saves and imports selected (or default) data types and associated data from the data file specified to the local CA Virtual Assurance system.

-verify

Examines the syntax of the data in the data file and lists any problems found, but does not update the CA Virtual Assurance server. The following types of data are verified:

• Data such as ServerName is not empty.
• Data such as PollInterval is a number.
• The format of data such as conditionName.
• The lower and upper thresholds.
• The number sequence of a data section to verify that the sequence starts at 1 and is consecutive.

The version and build number are present in the data file.

-f filename

Defines the full path name of the file to which data is imported to or exported from.

Note: If you specify a file name only and not a fully qualified file path, the current directory is used, by default.

-clean

(Optional) Specifies to delete target objects before importing data or to delete existing data file before exporting data. This option is used with import or export. For import, this option may be useful in environments where data has accumulated over time and you want to restore the system to the image from an earlier point in time (when data was saved using export). For export, this option may be useful when the name of the data file you specified with export already exists and you want to delete the existing data file and export to a new file with the same name.

Important! This option has the potential for data destruction, so a warning prompt is issued requiring you to confirm the operation. You will not receive this warning prompt if you have -noprompt specified.

-replace

(Optional) Specifies to update existing target objects with imported data objects sharing the same name, when importing data. This option is used with the import parameter. If you do not specify this option, the original objects are preserved, by default, and only new objects are imported.

-noprompt

(Optional) Specifies to suppress confirmation prompts typically issued by the program.

-nohelpdesk

(Optional) Used with the -import argument to prevent the help desk related data of an action from being imported into a CA Virtual Assurance system. This prevents failures if there is no help desk configured on the CA Virtual Assurance system.

-verbose

(Optional) Used with the -verify argument to display additional information about the data.

-user adminusername

Defines the CA Virtual Assurance administrator user name.

-password adminpassword

Defines the CA Virtual Assurance administrator password specified in -user. You can avoid entering this sensitive value at the command line by omitting this argument. Instead, you will be prompted to enter the password without it being echoed back to the console in clear text. For non-interactive situations, such as scripts, you can substitute –password with –auth_file.

-auth_file authorizationfilename

(Optional) Specifies the full path name of the authorization file to use to retrieve the encrypted password. This file contains the CA Virtual Assurance administrator credentials that were generated using the dpmutil set auth command. When this option is not specified, the default authorization file is used.

-cohesion_server {none|default_cohesion|preserve|name}

Specifies which CCA server to use during discovery of servers. This parameter is used with the import parameter. Options include the following:

none

Specifies not to use [assign the value for acm in your book] for discovery. This is the default.

default_cohesion

Specifies to use the default CCA server that is configured in CA Virtual Assurance for discovery.

preserve

Specifies to use the CCA servers defined for each server in the data file for discovery. This option preserves the original associations between the CA Virtual Assurance systems and the CCA servers.

Note: If any of the CCA servers are not available to the target system where the import is being performed, then you should modify these names in the data file to reference valid CCA server names.

name

Specifies to use the specified CCA server for discovery.

-port ccaportnumber

Defines the communication port for the CCA source server. This option is only used if you specify a CCA server name for –acm_server.

-default={all|none}

(Optional) Specifies the data type selection default.

all

Specifies that all data type arguments are included. This is the default.

none

Specifies that all data type arguments are excluded.

-service={all|none}

(Optional) Specifies whether to include or exclude services from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all services are included.

none

Specifies that all services are excluded.

-server={all|none}

(Optional) Specifies whether to include or exclude servers and their enabled metrics from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all servers are included.

none

Specifies that all servers are excluded.

-action {all|none}

(Optional) Specifies whether to include or exclude actions from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all actions are included.

none

Specifies that all actions are excluded.

-rule={all|none}

(Optional) Specifies whether to include or exclude rules from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all rules are included.

none

Specifies that all rules are excluded.

-job={all|none}

(Optional) Specifies whether to include or exclude jobs from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all jobs are included.

none

Specifies that all jobs are excluded.

-resource={all|none}

(Optional) Specifies whether to include or exclude resource groups and templates from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all resource groups and templates are included.

none

Specifies that all resource groups and templates are excluded.

-dpm_ibm_hmc={all|none}

(Optional) Specifies whether to include or exclude IBM Hardware Management Consoles (HMCs) from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all HMCs are included.

none

Specifies that all HMCs are excluded.

-serviceprocessor={all|none}

(Optional) Specifies whether to include or exclude system service processors (SSPs) from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all SSPs are included.

none

Specifies that all SSPs are excluded.

-vCenter={all|none}

(Optional) Specifies whether to include or exclude vCenter servers from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all vCenter servers are included.

none

Specifies that all vCenter servers are excluded.

-networkdevice={all|none}

(Optional) Specifies whether to include or exclude network devices from importing or exporting. The default value is determined by the -default option setting that is in effect. Options include the following:

all

Specifies that all network devices are included.

none

Specifies that all network devices are excluded.

Example: Export Actions Only

This example exports only action data from the CA Virtual Assurance system.

dpmix export -f c:\data.ini -default none -action all

Example: Import in Replace Mode

This example uses the -replace option to import all data items, both new and those already defined to the CA Virtual Assurance system.

dpmix import -f c:\data.ini -replace

Example: Import in Clean Mode Without Prompt

This example imports all types of data and deletes existing objects first, without issuing a warning prompt.

dpmix import -f c:\data.ini -clean -noprompt