HP StorageWorks SAN Virtualization Services Platform Manager command line interface user guide Part number: AG781–96016 Second edition: March 2009
Legal and notice information © Copyright 2008-2009 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents About this guide ................................................................................... 9 Intended audience ...................................................................................................................... 9 Related documentation ................................................................................................................ 9 Document conventions and symbols ...........................................................................................
ChangePresentation command ...................................................................................... 27 CreateVirtualDisk command .......................................................................................... 28 CreateVirtualDiskWithLun command ............................................................................... 28 DeleteVirtualDisk command ........................................................................................... 29 ExpandPartition command ..............
ListVDGroups command ................................................................................................ ListVDGroupSnapshots command ................................................................................... PurgeVDGroupPiTs command ........................................................................................ PurgeVDGroupSnapshots command ............................................................................... RemoveVirtualDisksFromVDGroup command ...................
SetUDHVirtualDiskLun command .................................................................................... Operating system related commands .................................................................................... FlushCache command .................................................................................................. MountVirtualDisk command .......................................................................................... Run command .................................
Tables 1 Document conventions ............................................................................................. 10 2 Special symbols ...................................................................................................... 20 3 VSM CLI error code list ............................................................................................
About this guide This guide describes the use of the HP StorageWorks SAN Virtualization Services Platform Manager command line interface (CLI) with approved storage systems.
Document conventions and symbols Table 1 Document conventions Convention Element Blue text: Table 1 Cross-reference links and email addresses Blue, underlined text: http://www.hp.
HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
About this guide
1 Overview The HP StorageWorks SAN Virtualization Services Platform (SVSP) solution enables virtualization for Enterprise Virtual Arrays (EVAs) and other approved storage systems using hardware and software. This guide provides information on the Virtualization Services Manger (VSM) commands entered at the command line interface (CLI) of a server running an SVSP supported operating system and connected to the SVSP domain through the special CLI interface device.
• When expanding a dynamic volume (file system) with the CLI commands, the command will always expand the VSM virtual disk associated with the first dynamic disk added to the dynamic volume (file system). For example, if the dynamic volume P: was originally created spanning three disks (#7, #8, and #9), the CLI command will expand the VSM virtual disk associated with disk #7 (which is presumably the first disk to be added to that partition).
The successful completion of a command in this context means that: • If the API or CLI successfully creates a VSM object (virtual disk, PiT, snapshot, snapclone group, and so on), this newly created object is ready to be used when the API/CLI returns. For example, if you create a PiT, you can immediately proceed to create a snapshot on this PiT.
Overview
2 Using the VSM command line interface A command line interface (CLI) was created for the Virtualization Services Manager (VSM) application to make the management of some tasks easier. This CLI utility allows you to create and run script files to perform virtualization tasks. Any SAN Virtualization Services Platform (SVSP) domain requires a login operation. Due to security issues, you want to define who can run CLI commands. Users can be defined with the VSM GUI.
-C CliCommand This option executes the command specified in the command line. The command is specified by a command name and a list of arguments separated by commas. For example: CliCommand -ARG1_NAME arg1_val1, ~ -ARG2_NAME arg2_val1 arg2_val2 where CliCommand is the name of the command, ARG_NAME is the name of the argument, arg_value is the value of the argument. -I input_file This option specifies that input commands are to be read from the input file.
For example: AddSnapcloneTaskEx -group Group1, ~ -task Task1 _priority 1 _StoragePool Pool1 _host Myhost ~ _permission RW, -timeout 900 • The order of arguments is insignificant. Arguments may be entered in any order. However, the order of values and keywords for each argument must be the same as in the examples. • If an input file is specified, the # character, followed by a white-space separator at the beginning of a line in the file, marks a comment line that is not processed by the CLI.
ListVirtualDisks ** End of listing ** The ? wildcard can also be used to perform more complex searches. For example, typing get?info produces a list of all commands that start with the “get” token, and have the “info” token after it. The output would be: . . . GetDpmInfo GetMigrationInfo GetMyHostInfo GetSnapcloneGroupInfo GetSnapcloneTaskInfo GetSyncMirrorGroupInfo GetVDGroupInfo ** End of listing ** NOTE: The search is not case sensitive.
CLI file location The path to the VSM CLI files is set in the system path on all Windows platforms, so you can run the CLI from any folder. In other operating systems, the CLI is installed in the following paths: • HP-UX: /opt/vsmcli/bin/VSMCli • Linux: /sbin/VSMCLI Automating storage-related tasks The following are examples of scripts written to perform some common storage-related tasks. The explanations of each CLI command are included in the following sections.
# cleanup after last run. # (May also be set in a post-backup script.
• The expression [TEMPLATE] marks an optional value. Either the word TEMPLATE (not case sensitive) appears in its place to mark that the preceding name is a root name and that the VSM CLI must create a unique full name from it, or nothing appears in its place (meaning that the preceding name is the full name to be used). • The expression [LastInstance | LastAsyncMirror | LastSyncMirror] marks an optional value.
General CLI control commands AllowExecErrors and DisallowExecErrors commands Syntax AllowExecErrors DisallowExecErrors Description The AllowExecErrors (allow or ignore execution errors) and DisallowExecErrors (do not allow or do not ignore execution errors) CLI commands can only be used in script files (that is, when the -I argument is used). The AllowExecErrors CLI command is used to ignore errors during the execution of CLI commands.
kind. For example, when using an input command file with multiple OnErrorGoTo commands, include a Quit command with a message that is appropriate for the error condition. OnErrorGoTo command Syntax OnErrorGoTo Label Description The OnErrorGoTo CLI command can be used only in script files (that is, when the -I argument is used). This command is used to change the sequence of executed CLI commands when one of the commands returns with an error.
Description Pauses for n seconds. Quit command Syntax Quit Message string Description The Quit command may be followed by a string on the same line. This string (up to 120 characters) is printed, without any processing, at the end of the output file (or console) if the VSM CLI is invoked from an input file. Otherwise, the string is ignored. The Quit command exits the current VSM CLI session. • If running from an input command file: • All remaining commands are ignored and the CLI application is terminated.
SelectVSMDomain command Syntax SelectVSMDomain -Domain DomainName, -User UserName, ~ -Password Password Description Selects the current SVSP domain for all subsequent CLI operations. This command must be the first command in every script or CLI execution, or there is no valid SVSP domain for which to connect. The Username and Password arguments are not for operating system users, but for the SVSP-domain defined users. To run the command, you must define users as part of the SVSP-domain configuration.
• To remove permissions to a bootable virtual disk, the host must be in an absent status in the VSM. NOTE: If a failure occurs for any host on the list, the command stops executing (it does not process the remainder of the list).
NOTE: • This command is similar to CreateVirtualDisk, but enables you to associate the created virtual disk to a specific LUN number on each host. • The command is designed for a UDH (user defined host), under the intelligent design framework. • If the LUN number for UDH is set to -1, a LUN is associated automatically to that virtual disk under the relevant host. • Granularity is fixed at 1024 KB and is the default.
NOTE: You can use the By to directly define the expansion size. Alternatively, the Size (in MB) determines, with the Extend (in percent) , by how much to expand the partition. In this case, the expansion size is determined by the multiplication of the Size and Extend arguments. • This command is currently valid only for primary partitions on Windows 2003/2008. • Do not run this command with Windows Disk Manager open. • The total extended size is in 1 GB increments.
Description Expands the capacity of an existing VSM virtual disk mounted on this computer. For each storage pool, supply the amount of capacity (in MB) to allocate from this storage pool (MbfromPool). The amount in MB should be a positive value. NOTE: A virtual disk with PiTs on it, or is in a synchronous mirror group, cannot be expanded. • For Windows 2003/2008: Command waits for the local driver to recognize the change. • On other platforms: Command works the same as ExpandVirtualDisk.
GetVirtualDiskName command Syntax GetVirtualDiskName -Device DeviceName Description Gets the VSM snapshot (or virtual disk) name from a device name (number). For example, in order to determine the virtual disk connected to Disk 5, use: GetVirtualDiskName -Device 5 NOTE: This command is currently valid only for Windows 2003/2008. GetVirtualDiskNames command Syntax GetVirtualDiskNames -Drive H: Description Gets the VSM virtual disk names for the file system or partition. In Windows, use a drive letter.
Description The default command (without arguments) lists all hosts. Adding -Template (optional) returns only objects whose names start with the specified RootName. ListStoragePools command Syntax ListStoragePools [-Template RootName] Description The default command (without arguments) lists all storage pools. Adding -Template (optional) returns only objects whose names start with the specified RootName.
Description Creates a point-in-time of the virtual disk or snapshot. NOTE: If [Template] is used, the name of the object must be less than 16 characters long. Limitation • See the HP StorageWorks SAN Virtualization Services Platform release notes for the limit of existing PiTs on a virtual disk. • Creating a PiT for any virtual disk that has one or more hosts with read-only permissions is not allowed.
CreateSnapshotOnLastPiT command Syntax CreateSnapshotOnLastPiT -VirtualDisk VirtualDiskName, ~ [-Type Any | MV | UserPiT | SyncPiT ,] ~ -snapshot SnapshotName [TEMPLATE], ~ -host HostName1 RW|OFF, ~ [-host HostName2 RW|OFF, ] -StoragePool PoolName, ~ -cluster 0|1, -timeout 900 Description Creates a snapshot on the virtual disk's most recently created PiT. The PiT name is not specified, but the PiT type can be specified.
If the LastInstance flag is used, the preceding PiT name is the root name, and the most recently created snapshot PiT (with a template name) is used. If the LastAsyncMirror/LastSyncMirror flag is used, the preceding PiT name is the root name, and the most recently created asynchronous/synchronous mirror PiT on the specific virtual disk is used. This root name is different from the asynchronous/synchronous mirror template name.
Description Deletes PiT or snapshot. If the LastInstance flag is used, the preceding snapshot or PiT name is the root name, and the most recently created snapshot or PiT (with a template name) is the subject of the command. GetCreationTime command Syntax GetCreationTime -Template FullNameWithSuffix Description Returns PiT or snapshot creation time from its full name (name must have been created using the CLI with the template flag).
Description • The default command (without arguments) lists all PiTs and snapshots. • Adding the -PiT argument to the command line lists PiTs only. • Adding the -snapshot argument to the command line lists snapshots only • Adding the -SyncPiT argument to the command line lists PiTs created on synchronous mirror groups. • Adding the -Template argument (optional) returns only objects whose names start with the specified root name.
PurgePiTsOrSnapshots -SyncPiT, -Template SyncMirror_PiT AnySuffix, ~ -Group SyncMirrorGroupName, ] -Keep 1 WaitForObjectCreation command Syntax WaitForObjectCreation -Name Name [LastInstance], ~ -VirtualDisk | -PiT | -Snapshot | -VDGroupPiT | -VDGroupSnapshot | -UserPiT | -SyncPiT | -SnapcloneVirtualDisk | -Migration, ~ [-task TaskName1, [task TaskName2, ] ] ~ -timeout 900 Description Waits for a newly created VSM object to become ready for use.
Snapclone commands AddSnapcloneTaskEx command Syntax AddSnapcloneTaskEx -SCGroup SnapcloneGroupName, ~ -Task SnapcloneTaskName, ~ -Domain DestinationVSMDomainName, -Priority 1|2|3, ~ -VirtualDisk SourceVirtualDiskName, ~ -Destination DestinationVirtualDisk, -StoragePool PoolName, ~ [-Thin 0|1,] [-host HostName1 RW|OFF,] ~ -timeout 900 Description Adds snapclone task to a group (extended command). The Priority argument has no significance, and should be treated as optional.
CreateRemoteSnapcloneGroup command Syntax CreateRemoteSnapcloneGroup -SCGroup SCGroupName, ~ -task SnapcloneTaskName, ~ -Domain DestinationVSMDomainName, -Priority 1|2|3, ~ -VirtualDisk SourceVirtualDiskName, ~ -Destination DestinationVirtualDisk, -StoragePool PoolName, ~ -Thin 0|1, -timeout 900 Description Creates a remote snapclone group with one task over a single virtual disk. This command creates a remote SVSP domain snapclone group.
_StoragePool PoolName _thin 0|1, ~ [-VirtualDisk SourceVirtualDisk _Destination DestinationVirtualDisk ~ _StoragePool PoolName _thin 0|1,] ~ -timeout 900 Description Creates a remote snapclone group with one task over a single virtual disk that is built over a snapclone. For any virtual disk included in the source snapclone group, you need to create a destination virtual disk and a storage pool from which the destination virtual disk is created.
ListSnapcloneTasks command Syntax ListSnapcloneTasks -Group GroupName Description Lists snapclone tasks per group. ManageSnapcloneGroup command Syntax ManageSnapcloneGroup -Group GroupName 1|2|3|4 Description Manages the snapclone group (receives group name and Opcode). NOTE: Allow up to 120 seconds for the command to fully take effect.
Virtual disk group commands AddVirtualDiskToVDGroup command Syntax AddVirtualDiskToVDGroup -Group VDGName, [-Drive H:,] ~ -VirtualDisk VirtualDiskName Description Adds a virtual disk to a virtual disk group. This command cannot be used for a virtual disk group with AsyncMirror defined on it (use the AddVirtualDiskToVDGWithAsyncMirror command instead). The optional -Drive is valid only for Windows 2003/2008. If specified, the file system defined on the virtual disk is expanded at the end of the operation.
NOTE: • This operation is allowed, even if PiTs are defined on the virtual disk group. • All the virtual disks of the virtual disk group must have RW permissions to exactly the same hosts. • If any member of the group is clustered, then all members of the group must have the cluster bit set. If any member is presented to two or more hosts, then all members of the group must set the cluster bit.
CreateVDGroupSnapshot command Syntax CreateVDGroupSnapshot -Group VDGroupName, ~ -snapshot SnapshotName [TEMPLATE], ~ -Pit NameOfPiT [LastInstance | LastAsyncMirror], ~ -host HostName1 RW|OFF, [-host HostName2 RW|OFF, ...] ~ -StoragePool PoolName, -cluster 0|1, -timeout 900 Description Creates a snapshot on the virtual disk group's PiT. NOTE: • The -host argument is considered optional by the VSM API, but is required by the VSM (returns an error).
CreateVDGroupSnapshotOnLastPiT command Syntax CreateVDGroupSnapshotOnLastPiT -Group VDGroupName, ~ [ -Type Any | MV | UserPiT ,] ~ -snapshot SnapshotName [TEMPLATE], ~ -host HostName1 RW|OFF, [-host HostName2 RW|OFF, ...] ~ -StoragePool PoolName, -cluster 0|1, -timeout 900 Description Creates a snapshot on the virtual disk group's most recently created PiT. The PiT name is not specified, but the PiT type can be specified.
DeleteVDGroupSnapshot command Syntax DeleteVDGroupSnapshot -Group VDGroupName, ~ -snapshot SnapshotName [LastInstance], ~ -timeout 900 Description Deletes the virtual disk group's snapshots. If the LastInstance flag is used, the preceding snapshot name is the root name, and the most recently created snapshot (with a template name) is the subject of this command.
ListVDGroupSnapshots command Syntax ListVDGroupSnapshots -Group VDGroupName ~ [, -Template RootSnapshotName] Description Requests a list of virtual disk group snapshots, according to the root (template) name. If the root name is not specified, all the virtual disk group's snapshots are returned.
Asynchronous mirror commands AddAsyncMirrorTaskToGroup command Syntax AddAsyncMirrorTaskToGroup -Group AsyncMirrorGroupName, ~ -Task AsyncMirrorTaskName, ~ -Domain DestinationVSMDomainName, -Priority 1|2|3, ~ -Destination DestinationVirtualDisk ~ -StoragePool DestPoolName, [-Thin 0|1,] -timeout 900 Description Adds an asynchronous mirror task to the group. The Priority argument has no significance, and should be treated as optional.
BreakAllLocalAsyncMirrorGroups command Syntax BreakAllLocalAsyncMirrorGroups -Timeout 900 Description Breaks (or detaches) all local asynchronous mirror groups, in that it removes the tasks from the group. The command pauses the group's tasks before removing them (all tasks of each group are removed, but the groups remain active). Local means the source virtual disk is in the local (current) SVSP domain.
NOTE: This command tries to process all qualified groups (disk groups whose source is in the local domain), ignoring failures in some groups (if any). BreakAllRemoteAsyncMirrorTasks command Syntax BreakAllRemoteAsyncMirrorTasks -Group AsyncMirrorGroupName, -timeout 900 Description Breaks (or detaches) all the tasks of a remote asynchronous mirror group (the remote group is deleted). Using this command is the same as calling the BreakRemoteAsyncMirrorGroup command.
BreakLocalAsyncMirrorTask command Syntax BreakLocalAsyncMirrorTask -Group AsyncMirrorGroupName, ~ -task AsyncMirrorTaskName_1, ~ [-task AsyncMirrorTaskName_2, . . . , ] ~ -timeout 900 Description Breaks (or detaches) the tasks of a local asynchronous mirror group. The command pauses all tasks before breaking them. Local means the source virtual disk is in the local (current) SVSP domain. NOTE: If a failure occurs for any task on the list, the command stops executing and does not process the remaining list.
NOTE: If a failure occurs for any task on the list, the command stops executing and does not process the remaining list.
NOTE: If a failure occurs for any group on the list, the command stops executing and does not process the remaining list. CreateAsyncMirrorUserPiTEx command Syntax CreateAsyncMirrorUserPiTEx -Group AsyncMirrorGroup_1_Name PiTRootName_1, [ -Group AsyncMirrorGroup_2_Name PiTRootName_2, ... ] ~ -timeout 900 ~ Description Creates user PiTs for asynchronous mirror groups.
The Interval argument is optional, and represents the time between the creation of PiTs in minutes. If omitted, the default value is 30 minutes. The maximum interval is 24 hours or 1440 minutes. The Keep argument is optional and represents the number of PiTs to be tracked. If omitted, the default value keeps 1 as the last PiT. User PiTs are automatically deleted by the system, and cannot be purged by a script command.
GetAllAsyncMirrorGroupsInfo command Syntax GetAllAsyncMirrorGroupsInfo [ -Locality L|R ] Description Gets data of all asynchronous mirror groups. Locality of the returned groups are: L—Return all local asynchronous mirror groups. Source virtual disk is in the local (current) SVSP domain. R—Return all remote asynchronous mirror groups. Source virtual disk is in a remote SVSP domain. Not defined—Return all local and remote asynchronous mirror groups.
GetAsyncMirrorTaskInfo command Syntax GetAsyncMirrorTaskInfo -Group AsyncMirrorGroupName, ~ -Locality L|R, -task AsyncMirrorTaskName Description Gets data of an asynchronous mirror task belonging to a specified asynchronous mirror group. The -Group argument specifies the group to which the specified task belongs. The locality of the returned group is: L—Local asynchronous mirror group. Source virtual disk is in the local (current) SVSP domain. R—Remote asynchronous mirror group.
NOTE: This command tries to process all qualified groups (disk groups whose source is in the local domain), ignoring failures in some groups (if any). PauseLocalAsyncMirrorGroup command Syntax PauseLocalAsyncMirrorGroup -Group AsyncMirrorGroupName_1 ~ [-Group AsyncMirrorGroupName_2, . . . , ] ~ -timeout 900 Description Pause the local AsyncMirror groups (all tasks of each group). Local means the source virtual disk is in the local (current) SVSP domain.
Description Resumes all local asynchronous mirror groups that were previously paused. Local means the source virtual disk is in the local (current) SVSP domain. NOTE: This command tries to process all qualified groups (disk groups whose source is in the local domain), ignoring failures in some groups (if any).
ResumeLocalAsyncMirrorTask command Syntax ResumeLocalAsyncMirrorTask -Group AsyncMirrorGroupName, ~ -task AsyncMirrorTaskName_1, ~ [-task AsyncMirrorTaskName_2, . . . , ] ~ -timeout 900 Description Resumes the tasks of a local asynchronous mirror group that were previously paused. Local means the source virtual disk is in the local (current) SVSP domain. NOTE: • If a failure occurs for any task on the list, the command stops executing and does not process the remaining list.
NOTE: The task name must be entered as it appears in the GUI (in the format of VSMDomainName:TaskName). ChangeSyncMirrorGroupMode command Syntax ChangeSyncMirrorGroupMode -Group SyncMirrorGroupName, -Mode 1|2 Description Changes the mode of operation of a synchronous mirror group.
2. CreateSyncMirrorGroup -Name SyncGrpName, ~ -VirtualDisk testDyn, -QuickRestore 2, ~ -Mode 2, -timeout 900 3. CreateSyncMirrorGroup -Name SyncGrpName, -VirtualDisk SourceName, ~ -Mode 2, -timeout 900 CreateSyncMirrorPiT command Syntax CreateSyncMirrorPiT -Group SyncMirrorGroupName, ~ -PiT NameOfPiT [TEMPLATE], -timeout 900 Description Creates a PiT on a synchronous mirror group. NOTE: If TEMPLATE is used, the name of the object must be less than 16 characters long.
Description Gets the information of a specified (by full name) synchronous mirror group. ListSyncMirrorGroups command Syntax ListSyncMirrorGroups [ -Template StartOfGroupName ] Description Requests a list of synchronous mirror groups according to the specified root (template) name. If the root name is not specified, all groups are returned.
Migration commands GetMigrationInfo command Syntax GetMigrationInfo -Group MigrationGroupName Description Gets migration task information. ListMigrations command Syntax ListMigrations [ -Template StartOfGroupName ] Description Requests a list of migration groups according to the specified root (template) name. If the root name is not specified, all groups are returned. ManageMigration command Syntax ManageMigration -Group GroupName 1|2|3|4 Description Manages a migration.
Description Migrates a virtual disk. The default priority is high, and the command always uses the default priority, regardless of the priority value. The auxilaryVirtualDiskName is the temporary volume that will become the backup volume after the migration. The Priority argument has no significance, and should be treated as optional.
VirtualDisk: Virtual disk or snapshot name. Host: Host (UDH) name with R/W permissions for this virtual disk. Lun: LUN number attached to this virtual disk. It should be a decimal (0–254) or hexadecimal (0x prefix) value.
• If the -Partition argument is omitted, or equal to a -1, the first partition on the disk is mounted. A limitation with Windows 2003/2008 is if the VSM virtual disk or snapshot is a dynamic disk, only one partition is allowed (for example, the partition number can be dropped, or it must always be equal to 1 or -1). For dynamic disks, the CLI can mount disks with one partition or file system only.
The -Partition argument is optional, and has the following guidelines: • • • • • If If If If If used in Windows, the specific partition is mounted as a partition number (as a string). used in UNIX, the specific partition is mounted as a logical virtual disk name. the argument is omitted, the first partition on the disk is unmounted. the argument equals -1, the first partition is unmounted. the argument equals -2, all partitions on the disk are unmounted.
Using the VSM command line interface
3 Using the VSM API to traverse the snapshot tree This chapter explains how to traverse the snapshot tree using the VSM API (CLI commands or APIs). The snapshot tree used to explain the following examples is shown below. VirtualDisk1 snapshot5 PiT1 PiT2 PiT3 PiT9 snapshot1 PiT10 PiT4 snapshot6 PiT5 snapshot2 snapshot3 PiT11 PiT6 snapshot4 PiT12 PiT7 PiT6 15956 In the figure above, a black line represents a parent-child (or source-child) relationship between the two objects.
3. Find all PiTs of the whole SAN. Run the ListSnapshots command, and select all objects that have their master flag set to TRUE. The output is an unordered list of “PiT1 . . . PiT12.” 4. Find all snapshots of the whole SAN. Run the ListSnapshots command, and select all objects that have their master flag set to FALSE. The output is an unordered list of “snapshot1 . . . snapshot6.” 5. Find the branch of PiTs for VirtualDisk1. Run the ListPiTsChain command with the input “VirtualDisk1.
11. Find the tree root, traversing the hierarchy upwards There are three alternatives: • To find the source virtual disk of a PiT or snapshot, run the GetSnapshotData command (step 10). The name of its source virtual disk is one of the returned arguments. • Recursively run the GetSnapshotData command (step 10) until the iSourceIsVirtualDisk flag is set (!=0). For example, source node is a virtual disk.
Using the VSM API to traverse the snapshot tree
4 Error code list Table 3 shows a list of error codes that the Virtualization Services Manager (VSM) CLI can return and their description. If the CLI returns a 0, the command has run successfully without an error. Table 3 VSM CLI error code list General error 1 – Memory allocation error. 7 – Unexpected program failure. 9 – OS error (like reading input file error) 122 – Log file can not be opened. Argument parsing error 113 – Bad argument at CLI command. 114 – Input or output file could not be opened.
2 – No VSM found or selected. 3 – Execution Error (VSM failed the command). 5 – Buffer supplied to VSM for the command is too short. 6 – Synchronization timeout on operation. 8 – Operation not supported on current platform or VSM. 10 – Driver couldn't find a View with the required name. 11 – No partition (file system) found on Virtual Volume/View. 12 – Invalid device name. 13 – No object with specified name found. 14 – VSM is not logged into a valid Domain.
A Advanced CLI commands The commands in this section are not routinely used, except in a test environment.
ExpandPartitionEx command Syntax ExpandPartionEx -Drive Letter:, -By ExtendByNumberOfBytes, ~ -StoragePool PoolName or ExpandPartionEx -Drive Letter:, -Size CurrentSizeInBytes, ~ -Extend ExtendByPercent, -StoragePool PoolName Description This is a modified version of the ExpandPartition command (the -Size is the number of bytes—not megabytes). This command expands both a VSM virtual disk and its corresponding partition (file system).
Description Purges (deletes) old virtual disks, provided they all have the same root name (all start with the same prefix, and the suffix was automatically created by the VSM API through the Template argument). NOTE: Virtual disks with R/W permissions set are not purged. This command can be used for virtual disks created by snapclones. If GroupTemplateName exists and is not empty, snapclone groups are purged based on the group root name and their creation time.
rolled back) becomes the last one in the PiT sequence or chain. This operation is allowed only if there are no snapshots created on any of the deleted PiTs.
Glossary This glossary defines acronyms and terms used with the SVSP solution. access path A specific series of physical connections through which a device is recognized by another device. active boot set The boot set used to supply system software in a running system. Applies to the DPM. See also boot set. active path A path that is currently available for use. See also passive path, and in use path.
Business Copy SVSP An HP StorageWorks product that works with SAN storage systems to provide local replication capabilities within the SVSP domain, providing local point-in-time (PiT) copies of data, using snapshots of data, based on changes to virtual disks. CLI Command line interface. The Data Path Module provides a CLI through the local administrative console (serial port console), telnet, or SSH.
HBA See host bus adapter. host In VSM, every server that uses VSM virtual disks. Servers that run as VSM servers are also considered hosts. host bus adapter A device that provides input/output (I/O) processing and physical connectivity between a server and a storage system. In order to minimize the impact on host processor performance, the host bus adapter performs many low-level interface functions automatically or with minimal processor involvement. I/O Input/Output.
passive path A path that must have some operation (for example, a SCSI start unit command that is issued by the server) performed on it to make it active. See also active/active RAID, active/passive RAID, and secondary path. patch file Incremental update to an existing system image. personality The way in which a DPM exposes LUNs to the hosts that use them.
purposes such as data recovery, backup and testing, while the original virtual disk stays online and continues to be updated. • A read-write entity that makes PiT data available to any host as a logical drive. SNMP Simple Network Management Protocol. The protocol used by the Data Path Module to report exception conditions to third-party network management applications. SSH Secure Shell. A protocol and application for communicating with a remote computer system.
virtual disk In VSM, a unit of storage allocated to one or more hosts from a storage pool. A virtual disk can range in size from 1 GB to 2 TB. DPMs present allocated virtual disks to hosts as logical drives. Volume Shadow Copy Service A backup infrastructure for the Microsoft Windows Server 2003/2008 operating systems, as well as a mechanism for creating consistent point-in-time copies of data known as shadow copies. VSM Virtualization Services Manager.
Index A AddAsyncMirrorTaskToGroup command, 50 AddSnapcloneTaskEx command, 18, 40 AddSyncMirrorTaskToGroup command, 61 ADDVDGAsyncMirrorTaskToGroup command, 50 AddVDGSnapcloneTaskEx command, 40 AddVirtualDiskToVDGroup command, 44 AddVirtualDiskToVDGWithAsyncMirror command, 44 advanced CLI commands, 77 AllowExecErrors command, 24 Asynchronous mirror commands, 50 asynchronous operations, 14 audience, 9 automating storage-related tasks, 21 B backup script, 21 BackupSetup command, 27 BreakAllLocalAsyncMirrorGro
E error code list, 75 expanding a partition, 14 ExpandPartition command, 14, 29 ExpandPartitionEx command, 14, 78 ExpandVirtualDisk command, 30 ExpandVirtualDiskOnThisComputer command, 30 F FlushCache command, 67 G GetAllAsyncMirrorGroupsInfo command, 57 GetAllAsyncMirrorTasksInfo command, 57 GetAsyncMirrorGroupInfo command, 57 GetAsyncMirrorTaskInfo command, 58 GetBackEndLuName command, 31 GetCreationTime command, 37 GetDpmInfo command, 66 GetMigrationInfo command, 65 GetMyHostInfo command, 31 GetSnapclo
ResumeAllLocalAsyncMirrorTasks command, 60 ResumeLocalAsyncMirrorGroup command, 60 ResumeLocalAsyncMirrorTask command, 61 ResumeSyncMirrorGroup command, 64 ResyncMirrorGroup command, 64 returned execution status, 20 RollBack command, 79 RollBackVDGroupPiT command, 79 Run command, 68 S SelectVSMDomain command, 27 SetUDHVirtualDiskLun command, 66 Snapclone commands, 40 Snapshot commands, 33 snapshot tree, 71 special symbols, summary, 20 Subscriber's Choice, HP, 11 summary of special symbols, 20 symbols in te
