Inquire_detail

Edit online

Use this vmcli command to view configuration information about the backup environment that is associated with Data Protection for VMware.

Syntax

The vmcli -f inquire_detail command uses this syntax:

vmcli -f inquire_detail -d datacenternodename | organizationvDCnodename [-a] [-n vmclinodename] [-o datamovernodename] [-p tsmserverport] [-e vmdetail ] [-q dmverify | vmfs | vmsingle (-I inputfile)] [-s tsmserverhostname] [-vmrestoretype (instantrestore | instantaccess | alltype | mount)] [-w vmBackupLocation]

You must issue the vmcli -f inquire_detail command as tdpvmware user, and not as root.

Parameters

-d datacenternodename

Specify the datacenter node name.

[-a]

Specify to show only the active backups on the IBM Storage Protect server.

[-n vmclinodename]

Specify the VMCLI node name. This name is the node that connects the Data Protection for VMware command-line interface to the IBM Storage Protect server and the data mover node. If this parameter is not specified, the value in the profile is used.

[-o datamovernodename]

Specify the data mover node name.

[-p tsmserverport]

Specify the port of the IBM Storage Protect server.

If this parameter is not specified in the Data Protection for VMware command-line interface and not specified in the profile, the default port (1500) is used.
If this parameter is not specified in the Data Protection for VMware command-line interface but is specified in the profile, the value in the profile is used.

[-e vmdetail

Specify vmdetail to show more detailed information about the backed up VMs. For example, the parameter shows information about disks that are attached to the VM.

[-q dmverify | vmfs | vmsingle (-I inputfile)]

dmverify: Specify to query the status of the data mover node identified by the -o parameter. You must specify the -d and -o parameters when you specify dmverify.
vmfs: Specify to query all VMware Virtual Machine File Systems (VMFS). This parameter shows high-level information about all VMs.
vmsingle: Specify to query individual VMs that are being restored during an instant access or instant restore operation.
-I inputfile: The inputfile value defines the full path and name of the input file. This keyword is valid with the vmsingle parameter only. Specify the name of the VM to query.

When the q option is not specified, the default value is vmfs. When the inputfile entry contains spaces, enclose the entry with quotation marks. For example:

-I "/my dir/my file"

[-s tsmserverhostname]

Specify the host name or IP address of the IBM Storage Protect server. If this parameter is not specified, the value in the profile is used.

[-vmrestoretype (instantrestore | instantaccess | alltype | mount)]

Specify this option to query active instant access or restore operations. This option also queries stale or orphan artifacts after a failure. The vmrestoretype parameter uses the following keywords:

instantrestore: The query lists VMs that are active in an instant restore operation.
instantaccess: The query lists VMs that are active in an instant access process.
alltype: The query lists VMs that are active in all instant operations.
mount: The query lists all active mount operations. For each mount operation, the output lists the mounted snapshots (restore points) that were created during a restore operation for a particular VM.

Restriction: When an instant restore or instant access operation that is issued from the backup-archive client (dsmc) is followed by an instant restore or instant access operation that is issued from the Data Protection for VMware command-line interface (vmcli) or Data Protection for VMware vSphere GUI, the recovery agent service must be restarted. This situation applies only when the vmcli accesses the server with a node name different from the one used by the data mover. This restriction applies to any order of operations between the two products.

Restart the service by going to Start > Administrative Tools > Computer Management > Services and Applications > Services. Look for service name IBM Storage Protect recovery agent in the Services window. The path to the Services window might vary depending on your operating system.

The service does not have to be restarted when the VMware datacenter name is specified with the asnodename option in the dsm.opt file.

[-w vmBackupLocation]

Specify the backup location or locations to query. You can specify one of the following values:

SERVER: The query is limited to backups that are on the IBM Storage Protect server. This value is the default.
LOCAL: The query is limited to persisted snapshots that are on the hardware storage.
BOTH: The query lists information for both backups that are on the IBM Storage Protect server and snapshots on the hardware storage.

This parameter is not valid when the -vmrestoretype parameter is also specified.

Example

In this example, the vmcli -f inquire_detail command is issued to query the VM named antures for details:

vmcli -f inquire_detail -s BORODIN.MAINZ.DE.IBM.COM -p 1505 -n JF_VMCLI_HANNE
-v CHRISTO.MAINZ.DE.IBM.COM -o JF_MAINZ_DEVELOPMENT_DC_DM -d JF_MAINZ_DEVELOPMENT_DC
-q vmsingle -I .\inputfile.txt --vmrestoretype (instantrestore | instantaccess)

The inputfile contains this statement:

vmname:antures