Hp SAN Virtualization Services Platform Manual de usuario

HP StorageWorks SAN VirtualizationServices Platform Manager Command LineInterface User GuideAbstractThis guide describes the use of the HP StorageWork

Constraints on name stringsName strings are limited to 31 characters, followed by a zero-terminating character. Name stringsof VSM objects (virtual di

specific DPM group. If a host is assigned to more than one DPM group, then use the VSM GUIand not the CLI to make virtual disk presentations.General c

There is an additional API or CLI function that is used to wait for the completion of such operations:WaitForObjectCreation.The list of the above ment

NYNNYYYNOn VdiskWhileasyncmirrorYNNNYYYNOnsnapshotYNNNYYYN/AOn VDG1 A thick virtual disk is a virtual disk that is fully allocated or not thin proviso

2 Using the VSM command line interfaceA command line interface (CLI) was created for the Virtualization Services Manager (VSM)application to make the

-I input_file This option specifies that input commands are to be read from the input file.The format of the command is the same as the commands for t

as an argument separator. Consequently, enclose numbers with a decimal symbol betweenquotation marks to avoid this problem.NOTE: When using the -C opt

NOTE: The search is not case sensitive.Summary of special symbolsTable 1 Special symbolsWhere usedPurposeSymbolAt the beginning of a line in the input

Creating multiple copiesBelow is a script that can be periodically invoked to:• Create a snapclone (task) of a virtual disk vol1.• Always keep the las

results in a need for only one pre-backup script in most cases, that is invoked by the backupapplication before it starts.Alternatively, a CLI script

© Copyright 2008, 2009, 2010, 2011 Hewlett-Packard Development Company, L.P.Confidential computer software. Valid license from HP required for possess

• The timeout in CLI commands defines the maximum time in seconds that the CLI will wait forthe completion of the command.If the command is completed

This command instructs the CLI executor to go to Label. Note that the line with the label in thescript file must always come after the line of the GoT

. . .MyLabel:# label is not case sensitivePause commandSyntaxpause -delay 10DescriptionPauses for n seconds.Quit commandSyntaxQuit Message stringDescr

SelectVSMDomain commandSyntaxSelectVSMDomain -Domain DomainName, -User UserName, ~ -Password PasswordDescriptionSelects the current SVS

NOTE: If a failure occurs for any host on the list, the command stops executing (it does not processthe remainder of the list).CreateVirtualDisk comma

DeleteVirtualDisk commandSyntaxDeleteVirtualDisk -VirtualDisk VirtualDiskName [LastInstance]DescriptionDeletes the virtual disk. If the LastInstance f

NOTE: A virtual disk with PiTs on it, or one which is in a synchronous mirror group, cannot beexpanded.ExpandVirtualDiskOnThisComputer commandSyntaxEx

GetVirtualDiskName commandSyntaxGetVirtualDiskName -Device DeviceNameDescriptionGets the VSM snapshot (or virtual disk) name from a device name (numbe

ListVirtualDisks commandSyntaxListVirtualDisks [-Template RootName]DescriptionThe default command (without arguments) lists all virtual disks. Adding

NOTE:• The -host argument is considered optional by the VSM API, but is required by the VSM(returns an error).• If [Template] is used, the name of the

Contents1 Overview...7Modes of command execution...

NOTE:• The -host argument is considered optional by the VSM API, but is required by the VSM(returns an error).• If [Template] is used, the name of the

DescriptionDeletes PiT or snapshot. If the LastInstance flag is used, the preceding snapshot or PiT nameis the root name, and the most recently create

ExamplesListSnapshots -PiTListSnapshots -snapshotListSnapshots -Template RootName, -PiTListSnapshots -Template RootName, -SyncPiTListSnapshots -snapsh

The following object types are handled, and the associated input names to wait for are:• Simple virtual disk: Provide name of the virtual disk.• Simpl

_StoragePool PoolName _thin [0|1],] ~ -timeout 900DescriptionAdds a snapclone task to a group that is built over a virtual disk group. T

-DestinationVDG DestinationVDGroupName, ~ -Domain DestinationDomainName, -Priority 1|2|3, ~ [-host HostName1 RW|OFF,] ~ -VirtualDisk

ManageSnapcloneGroup commandSyntaxManageSnapcloneGroup -Group GroupName 1|2|3|4DescriptionManages the snapclone group (receives group name and Opcode)

AddVirtualDiskToVDGWithAsyncMirror commandSyntaxAddVirtualDiskToVDGWithAsyncMirror -Group VDGName, ~ -MirrorGroup AsyncMirrorGroupName

NOTE:• All the virtual disks of the virtual disk group must have RW permissions to exactly the samehosts.• If any member of the group is clustered, th

NOTE: If you need to know the name of the individual snapshots on every virtual disk in thevirtual disk group in advance (for example, for subsequentl

GetVirtualDiskName command...27GetVirtualDiskNames command...

DeleteVDGroupPiT commandSyntaxDeleteVDGroupPiT -Group VDGName, ~ -Pit NameOfPiT [LastInstance], -timeout 900DescriptionDeletes the vir

ListVDGroupSnapshots commandSyntaxListVDGroupSnapshots -Group VDGroupName ~ [, -Template RootSnapshotName]DescriptionRequests a li

-Domain DestinationVSMDomainName, -Priority 1|2|3, ~ -Destination DestinationVirtualDisk ~ -StoragePool DestPoolNam

DescriptionBreaks all the tasks of a local asynchronous mirror group. The command pauses all tasks beforebreaking them. Local means the source virtual

NOTE: If a failure occurs for any group on the list, the command stops executing and does notprocess the remaining list.BreakLocalAsyncMirrorTask comm

-task AsyncMirrorTaskName, -Domain DestinationVSMDomainName ~ -Priority 1|2|3, -Destination DestinationVirtualDisk, ~ -StoragePool Poo

NOTE: If a failure occurs for any group on the list, the command stops executing and does notprocess the remaining list.CreateVDGAsyncMirrorGroupEx co

DeleteRemoteAsyncMirrorGroup commandSyntaxDeleteRemoteAsyncMirrorGroup -Group AsyncMirrorGroupName_1 ~ [-Group AsyncMirror

Locality of the specified group is:L—Local asynchronous mirror group. Source virtual disk is in the local (current) SVSP domain.R—Remote asynchronous

DescriptionPause the local AsyncMirror groups (all tasks of each group). Local means the source virtual diskis in the local (current) SVSP domain.NOTE

BreakAllRemoteAsyncMirrorGroups command...43BreakAllRemoteAsyncMirrorTasks command...

NOTE: This command tries to process all qualified tasks, ignoring failures in some tasks (if any).ResumeLocalAsyncMirrorGroup commandSyntaxResumeLocal

BreakSyncMirrorTask commandSyntaxBreakSyncMirrorTask -Group SyncMirrorGroupName, ~ -Task Task_1_Name [, -Task Task_2_Name, . . . ]D

CreateSyncMirrorPiT commandSyntaxCreateSyncMirrorPiT -Group SyncMirrorGroupName, ~ -PiT NameOfPiT [TEMPLATE], -timeout 900Descripti

DescriptionRequests a list of synchronous mirror PiTs on a specified synchronous mirror group. You may providethe root (start) of the synchronous mirr

ListMigrations commandSyntaxListMigrations [ -Template StartOfGroupName ]DescriptionRequests a list of migration groups according to the specified roo

GetDpmInfo commandSyntaxGetDpmInfo -VDGroup | -VirtualDisk | -Snapshot | -SyncGroup objectNameDescriptionFor each object under the DPM configuration,

DescriptionMounts a virtual disk or snapshot. The virtual disk or snapshot must have at least one file system(partition) on it.The following are rules

UnmountVirtualDisk -VirtualDisk VirtualDiskName, -MountPoint H:\DescriptionUnmounts a virtual disk or snapshot. The virtual disk or snapshot must have

3 Server-free backup with the VSM CLIOne of the most commonly performed tasks is running backups. When running backups, arequirement is to minimize, o

3. Unassign the snapshot from the backup server, and delete the snapshot by using a script thatruns the following command:UnmountVirtualDisk –VirtualD

3 Server-free backup with the VSM CLI...58Typical server-free backup process...

4 Creating a PiT and snapshot with Microsoft VSSMicrosoft VSS (Volume Shadow Copy Service), also known as Virtual Shadow Copy, is a unifiedstorage man

To do so, a VSS requestor needs to initiate the request for the PiT and snapshot from a specificserver. Microsoft has developed a requestor called VSH

5 Using the VSM API to traverse the snapshot treeThis chapter explains how to traverse the snapshot tree using the VSM API (CLI commands or APIs).The

6. Find branch of PiTs of snapshot “PiT1.”Run the ListPiTsChain command with the input “snapshot1.”The output is an ordered list “PiT4, PiT5, PiT11.”7

6 Error code listTable 3 (page 64) shows a list of error codes that the Virtualization Services Manager (VSM) CLIcan return and their description. If

7 Support and other resourcesContacting HPBefore you contact HPBe sure to have the following information available before you contact HP:http://www.hp

• HP StorageWorks SAN Virtualization Services Platform Best Practices Guide• HP StorageWorks SAN Virtualization Services Platform Release NotesYou can

Documentation feedbackHP welcomes your feedback.To make comments and suggestions about product documentation, please send a message tostoragedocsFeedb

A Advanced CLI commandsThe commands in this section are not routinely used, except in a test environment.Advanced CLI commandsCreateSnapcloneGroupEx c

DescriptionThis is a modified version of the ExpandPartition command (the -Size is the number ofbytes—not megabytes). This command expands both a VSM

1 OverviewThe VSM application programming interface (API) and command line interface (CLI) allows storagearrays to perform sophisticated virtualizatio

• The designated snapshot is defined on the last and only PiT of the source virtual disk orsnapshot.• There are no other snapshots/PiTs defined on the

GlossaryThis glossary defines acronyms and terms used with the SVSP solution.Aaccess path A specific series of physical connections through which a de

DData Path Module A SAN-based device, separate from the core Fibre Channel switching infrastructure, that providesstorage virtualization services acro

initiator device A device, such as an HBA installed into a server, that contains one or more initiator ports.initiator port A Fibre Channel port capab

physical disk A disk device that can be discovered and managed by VSM.PiT Point-in-Time. A VSM term denoting an entity created by a snapshot that repr

stripe set In VSM, a set of back-end LUs across which VSM stripes data, optionally used to build storagepools.SVSP domain Consists of all SVSP compone

VSM GUI Graphical user interface used to manage the HP StorageWorks SAN Virtualization ServicesPlatform environment.VSM server VSM software that runs

IndexAAddAsyncMirrorTaskToGroup command, 41AddSnapcloneTaskEx command, 15, 33AddSyncMirrorTaskToGroup command, 50ADDVDGAsyncMirrorTaskToGroup command,

GoTo command, 20Hhelpobtaining, 65HPtechnical support, 65Iinstallation, 7interactive mode, 8Llimitationsknown, 10ListHosts command, 27ListMigrations c

WWaitForObjectCreation command, 12, 32websitesHP , 66HP Subscriber's Choice for Business, 6579

NOTE: To pass command line comments from the server to the SVSP it is necessary to create aCLI virtual disk. This disk behaves like a "mailbox&qu

Figure 1 Example of script execution outputThe following are examples of creating a batch/shell file to execute a script:VSM_CLI [-SD DomainName UserN