HP StorageWorks Replication Solutions Manager 4.0.1 job command reference

HP StorageWorks Replication Solutions Manager 4.0.1

job command reference

Part number: T3680-96306

ourth edition: June 2008

Legal and notice information

Conﬁdential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and

12.212, Commercial Computer Soft ware, 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. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Microsoft, Windows, Windows XP, and Windows NT are U.S. registered trademarks of Microsoft Corporation.

Oracle is a registered US trademark of Oracle Corporation, Redwood City, California.

Linux is a U.S. registered trademark of Linus Torvalds.

UNIX is a registered trademark of The Open Group.

04.10.2008

Contents

About this reference ......................... 9

Intendedaudience...................................... 9

Relateddocumentation.................................... 9

Documentconventionsandsymbols ............................. 10

HPtechnicalsupport.................................... 10

Subscriptionservice ..................................... 11

HPwebsites......................................... 11

Documentationfeedback ................................... 11

Productfeedback ...................................... 11

1Jobconcepts,templatesandcommands ............... 13

Jobconcepts ....................................... 13

Joblanguageoverview................................. 13

Jobs,templates,andcommands............................. 13

Jobinstances ..................................... 14

Abortedjobinstances ................................. 15

Arguments ...................................... 15

Argumentlists..................................... 15

Assignments(variables)................................. 15

Branches....................................... 16

Commands...................................... 16

Commandresultvalues................................. 17

Comments ...................................... 22

E-mailfromjobs.................................... 22

Exits......................................... 22

Implicitjobs...................................... 22

Implicitjobstartup................................... 22

Importedjobs..................................... 22

Jobcommandslist................................... 23

Jobtemplateslist ................................... 30

Labels ........................................ 31

Pauseandcontinue .................................. 31

ResourcenamesandUNCformats............................ 31

Simultaneousjobinstances ............................... 33

Statusandstates.................................... 34

Transactions ..................................... 34

Validation ...................................... 35

Wait/nowaitargument................................. 36

Jobtemplates....................................... 37

Emptytemplate .................................... 37

Fracturehostvolumes,mounttoahost(template)...................... 37

Instantrestorestoragevolumestootherstoragevolumes(template) .............. 39

Mountexistingstoragevolumes(template)......................... 41

Performcascadedreplication(template).......................... 42

Performplannedfailover(template)............................ 46

Performunplannedfailover(template)........................... 48

Replicate (via snapclone) a host volume multiple times, mount to a host (template) . . . . . . . . 49

Replicatehostdiskdevices,mounttoahost(template).................... 52

Replicatehostvolumegroup,mountcomponentstoahost(template) ............. 53

Replicatehostvolumegroup,mountentiregrouptoahost(template) ............. 56

Replicatehostvolumes(template)............................. 58

HP StorageWorks Replication Solutions Manager 4 .0.1

Replicatehostvolumes,mounttoahost(template) ..................... 59

Replicatehostvolumes,mounttoahost,thentoadifferenthost(template) ........... 62

Replicate host volumes via preallocated replication, mount to a host (template) . . . . . . . . . 64

Replicatehostvolume,mountcomponentstoahost(template) ................ 66

Replicaterawstoragevolumesmount(raw)toahost(template)................ 68

Replicatestoragevolumes(template) ........................... 69

Replicatestoragevolumesviapreallocatedreplication(template)............... 71

ReplicateOracletablespaces(template).......................... 73

ReplicateOracletablespaces,mounttoahost(template) .................. 74

Replicate Oracle tablespaces via preallocatted replication, mount to a host (template) . . . . . . 76

RestoreOracletablespaces(template)........................... 79

SetupContinuousAccess(remotereplicationtemplate) ................... 80

ThrottlereplicationI/O(remotereplicationtemplate) .................... 82

Unmountanddeleteexistinghostvolumes(template) .................... 83

Unmountexistinghostvolumes(template) ......................... 84

Jobcommands ...................................... 85

//(comment)..................................... 85

AddAllOracleTablespacesToRepository .......................... 85

AddDrGroupMember ................................. 86

AddOracleArchiveLogFilesToRepository .......................... 87

AddOracleTablespacesToRepository ........................... 87

AddReplicaToReplicaRepository ............................. 88

AddReplicasToReplicaRepository............................. 88

CombineLists ..................................... 89

ConvertStorageVolumeIntoContainer ........................... 89

ConvertStorageVolumesInManagedSetIntoContainers .................... 90

ConvertStorageVolumesIntoContainers .......................... 90

ConvertStorageVolumesIntoContainersUsingRepository.................... 91

CreateContainer.................................... 91

CreateContainerForHostDiskDevice............................ 92

CreateContainersForHostVolume............................. 93

CreateContainersForHostVolumeGroup .......................... 93

CreateDiskDevice ................................... 94

CreateDrGroup .................................... 95

CreateDrGroupFromHostVolume............................. 96

CreateHostVolume................................... 98

CreateHostVolumeDiscrete ............................... 99

CreateHostVolumeFromDiskDevices............................ 100

CreateHostVolumeGroup ................................ 101

CreateHostVolumesUsingRepository ........................... 102

CreateOracleRepository ................................ 103

CreateRestoredHostVolumesUsingRepository........................ 103

CreateReplicaRepository ................................ 104

CreateStorageVolume ................................. 105

DeleteContainer.................................... 106

DeleteDrGroup .................................... 106

DeleteDrGroupMember................................. 107

DeleteHostVolume ................................... 107

DeleteHostVolumeGroup ................................ 108

DeleteHostVolumesUsingRepository............................ 109

DeleteOracleRepository................................. 110

DeleteReplicaRepository ................................ 110

DeleteStorageVolume.................................. 110

DeleteStorageVolumes ................................. 111

DeleteStorageVolumesInManagedSet........................... 111

DeleteStorageVolumesUsingRepository .......................... 112

DetachMirrorclones .................................. 112

DiscoverDiskDevice .................................. 113

DiscoverDiskDevices .................................. 113

DiscoverDiskDevicesForDrGroup............................. 114

DiscoveryRefresh(obsolete) ............................... 115

Exit ......................................... 115

Export........................................ 116

FailoverDrGroup.................................... 116

FailoverDrGroups ................................... 117

FlushCache...................................... 117

ForceFullCopyDrGroup................................. 118

FractureHostDiskDeviceMirrorclone............................ 119

FractureHostVolumeGroupMirrorclones .......................... 119

FractureHostVolumeMirrorclones............................. 120

FractureMirrorclones .................................. 121

Import........................................ 121

InstantRestoreFromMirror ................................ 122

InstantRestoreFromSnapshot............................... 123

Launch........................................ 123

LaunchJob ...................................... 124

Log ......................................... 125

MirrorcloneHostDiskDeviceToContainer .......................... 125

MirrorcloneHostDiskDeviceToContainerInManagedSet.................... 126

MirrorcloneHostVolumeGroupToContainers ........................ 127

MirrorcloneHostVolumeGroupToContainersInManagedSet .................. 128

MirrorcloneHostVolumeToContainers ........................... 129

MirrorcloneHostVolumeToContainersInManagedSet..................... 130

MirrorcloneStorageVolumeToContainer .......................... 131

MountEntireVolumeGroup................................ 132

MountHostVolume................................... 133

MountHostVolumesUsingRepository............................ 133

MountVolumeGroupComponent ............................. 134

Pause ........................................ 135

PresentStorageVolume ................................. 135

PresentStorageVolumes................................. 136

RemoveDiskDevice................................... 137

ResyncMirrorclone................................... 137

ResyncMirrorclones................................... 138

RetainLatestRoundRobinReplicasForHostStorageVolume ................... 138

RetainLatestRoundRobinReplicasForHostVolume....................... 139

RetainLatestRoundRobinReplicasForHostVolumeGroup.................... 140

SendEmail ...................................... 141

SetDiskGroupForSnapclone ............................... 141

SetDrGroupAutoSuspend................................ 142

SetDrGroupComments ................................. 142

SetDrGroupDestinationAccess.............................. 143

SetDrGroupFailsafe .................................. 143

SetDrGroupFailsafeOnLinkDownPowerUp ......................... 144

SetDrGroupHome ................................... 144

SetDrGroupIoMode .................................. 145

SetDrGroupMaxLogSize ................................ 145

SetDrGroupName................................... 146

SetDrGroupSuspend.................................. 146

SetHostDiskDeviceWriteCacheMode ........................... 147

SetHostVolumeGroupWriteCacheMode.......................... 148

SetHostVolumeWriteCacheMode............................. 149

SetHostVolumesWriteCacheMode ............................ 151

SetListVariable..................................... 151

SetMountPointsPreﬁxInRepository............................. 152

SetNotiﬁcationPolicy.................................. 153

SetOracleModeUsingRepository............................. 154

SetStorageVolumeName ................................ 154

SetStorageVolumeWriteCacheMode ........................... 155

SetStorageVolumesWriteCacheMode ........................... 155

HP StorageWorks Replication Solutions Manager 4 .0.1

SetVariable...................................... 156

SetWriteCacheModesUsingRepository .......................... 156

SnapcloneDiskDevice.................................. 157

SnapcloneHostDiskDeviceToContainerInManagedSet .................... 158

SnapcloneHostVolume ................................. 159

SnapcloneHostVolumeGroup .............................. 160

SnapcloneHostVolumeGroupToContainersInManagedSet................... 161

SnapcloneHostVolumeToContainers............................ 162

SnapcloneHostVolumeToContainersInManagedSet ..................... 163

SnapcloneOracleToContainersUsingRepository....................... 164

SnapcloneOracleUsingRepository ............................ 165

SnapcloneStorageVolume................................ 166

SnapcloneStorageVolumeToContainer........................... 167

SnapcloneStorageVolumesToContainers.......................... 167

SnapshotDiskDevice .................................. 168

SnapshotHostDiskDeviceToContainerInManagedSet..................... 169

SnapshotHostVolume.................................. 170

SnapshotHostVolumeGroup............................... 171

SnapshotHostVolumeGroupToContainersInManagedSet ................... 172

SnapshotHostVolumeToContainers ............................ 173

SnapshotHostVolumeToContainersInManagedSet...................... 174

SnapshotOracleToContainersUsingRepository ....................... 175

SnapshotOracleUsingRepository............................. 176

SnapshotStorageVolume ................................ 177

SnapshotStorageVolumeToContainer ........................... 177

SnapshotStorageVolumesToContainers .......................... 178

SwitchOracleArchiveLogFilesUsingRepository........................ 179

TestJobState...................................... 179

UnmountEntireVolumeGroup............................... 180

UnmountHostVolume.................................. 181

UnmountHostVolumes ................................. 181

UnmountHostVolumesUsingRepository........................... 182

UnpresentStorageVolume ................................ 183

UnpresentStorageVolumes................................ 183

ValidateHost ..................................... 184

ValidateHostVolume .................................. 184

ValidateHostVolumeDoesNotExist ............................ 185

ValidateHostVolumeGroup ............................... 186

ValidateHostVolumeMirrorclones............................. 186

ValidateOracleDatabase ................................ 187

ValidateOracleTablespaces ............................... 188

ValidateSnapcloneHostVolume.............................. 188

ValidateSnapcloneHostVolumeGroup........................... 189

ValidateSnapcloneStorageVolume ............................ 190

ValidateSnapshotHostVolume .............................. 190

ValidateSnapshotHostVolumeGroup ........................... 191

ValidateSnapshotStorageVolume............................. 192

ValidateStorageSystem ................................. 192

ValidateStorageVolume................................. 193

ValidateStorageVolumes ................................ 193

Wait......................................... 194

WaitDrGroupNormalization............................... 194

WaitDrGroupSynchronizationTransition .......................... 195

WaitForHostDiskDeviceWriteCacheFlush.......................... 195

WaitForHostVolumeGroupWriteCacheFlush ........................ 196

WaitForHostVolumeWriteCacheFlush ........................... 196

WaitForHostVolumesWriteCacheFlush........................... 197

WaitForJob...................................... 198

WaitForStorageVolumeDiscovery............................. 199

WaitForStorageVolumesDiscovery ............................ 199

WaitForStorageVolumeWriteCacheFlush.......................... 200

WaitForStorageVolumesWriteCacheFlush ......................... 200

WaitForWriteCacheFlushUsingRepository ......................... 201

WaitHostDiskDeviceNormalization............................ 201

WaitHostVolumeNormalization ............................. 202

WaitStorageVolumeNormalization ............................ 202

WaitStorageVolumesNormalization............................ 203

WaitUntil....................................... 203

WaitVolumeGroupNormalization............................. 204

Index .............................. 207

HP StorageWorks Replication Solutions Manager 4 .0.1

Tables

Documentconventions.............................. 10

About this reference

This document is a quick reference for job commands and job templates that are provided with HP StorageWorks Replication Solutions Manager (the replication manager). For additional information regarding replication manager concepts and troubleshooting, see the HP StorageWorks Replication Solutions Manager online help and HP StorageWorks Replication Solutions Manager user guide.

Intended audience

This reference is intended for HP StorageWorks Replication Solutions Manager operators and administrato

Related documentation

To ﬁnd the following documents, browse to the Manuals page of the HP Business Support Center web site:

ttp://www.hp.com/support/manuals. In the Storage section, click Storage soft ware and then select

the product.

rs.

Replication

• HP StorageWorks Replication Solutions Manager online h elp

• HP StorageW

• HP StorageWorks Replication Solutions Manager job command reference

• HP StorageWorks Replication Solutions Manager command line user interface reference

• HP Storage

• HP StorageWorks Replication Solutions Manager installation guide

Other

• HP StorageWorks EVA replication software consolidated release notes

• HP StorageWorks EVA software compatibility reference

• HP StorageWorks Comma nd View EVA license key installation instructions

• HP StorageWorks Business Copy EVA administrator guide

• H P StorageWorks Continuous Access EVA administrator guide

Solutions Manager

orks Replication Solutions Manager user guide

Works Replication Solutions Manager administrator guide

HP StorageWorks Replication Solutions Manager 4 .0.1

Document conven

Table 1 Document conventions

tions and symbols

Convention

Blue text: Table 1

Blue, underlined text: http://www.hp.com

Bold text

Italic text Text emphasis

Monospace text

Monospa

Monospace, bold text

ce, italic text

Element

Cross-reference links and e-mail addresses

website addresses

• Keys th at are p

• Text typed in

• GUI elements

menu and lis

• File and directory names

• System output

• Code

• Commands, their arguments, and argument values

• Code variables

• Command variables

Emphasized monospace text

ressed

to a GUI element, such as a box

that are clicked or selected, such as

t items, buttons, tabs, and check boxes

CAUTION:

Indicates that failure to follow directions could result in damage to equipment or data.

IMPORTANT:

Provides clarifying information or speciﬁc instructions.

NOTE:

Provides additional information.

TIP:

Provides helpful hints and shortcuts.

HP technical support

For worldwide technical support information, see the HP support website:

ttp://www.hp.com/support

Before contacting HP, collect the following information:

• Product model names and numbers

• Technical support registration number (if applicable)

• Product serial numbers

• Error messages

• Operating system t ype and revision level

About this reference

• Detailed questions

Subscription s

HP recommends t

ttp://www.hp

After register ﬁrmware updat

ervice

hat you register your product at the Subscriber’s Choice for Business website:

.com/go/e-updates

ing, you will receive e-mail notiﬁcation of product enhancements, new driver versions,

es, and other product resources.

HP websites

For additional information, see the following HP websites:

•h

ttp://www.hp.com

•http://www.hp.com/go/storage

•http://www.hp.com/service_locator

•http://www.hp.com/support/manuals

•http://www.hp.com/support/downloads

Documentation feedback

HP welcomes

To make comments and suggestions about product documentation, please send a message to

storagedocsFeedback@hp.com. All submissions become the property of HP.

your feedback.

Product feedback

To make comments and suggestions about HP Replication Solutions Manager, HP Business Copy EVA, or HP Continuous Access EVA, please send a message to EVAReplication@hp.com.

HP StorageWorks Replication Solutions Manager 4 .0.1

About this reference

1 Job concepts, templates and commands

Job concepts

Job language overview

The job language provides a simple and structured way to automate replication and other storage related tasks. A typical job consists of commands, assignments (variables), branching instructions, labels, comments and exits. Jobs with launch commands often include transactions. See also imported jobs.

Click the lin

ks below for information.

Line

Task

comment >

// Replicate storage volumes.

command >

branch >

transaction start >

assignme

transaction end >

nt >

exit >

label >

ValidateStorageSystem (%array_name%)

...

Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" )

onerror pauseat E1:

10 DO {

$Rep1 = SnapshotStorageVolume ( %array_name_source_storvol_unc1%,

FULLY_ALLOCATED,SAME,%dest_storvol1%,NOWAIT)onerrorpauseatE1:

13 } A LW AYS {

// Resume the host ap plication.

Launch ( %source_host%, %resume_command_line%, "", WAIT, "0" )

}

...

27 Exit (SUCCESS)

// Failure exit - no rollback needed.

E1:Exit(FAILURE)

...

Jobs, templates, and commands

You can create, save, run, schedule, and manage jobs that automate replication tasks.

HP StorageWorks Replication Solutions Manager 4 .0.1

Job editor

Use the repl

ication manager’s specialized job editor to create and edit jobs.

Job templates

Job templates allow you to quickly create typical jobs, for example, making local or remote copies of virtual disks. See job templates list.

Job commands

You ca

nalsocreatecustomjobsfromthesetofspecializedjobcommands.Seejob commands list.

Job instances

When a job is running or has been run, it is called a job instance. Job instances are displayed in the Jobs Run History tab.

The format of a job-instance name is the job name, plus a sequence number. For example, the job named daily_backup when run two times would have job instance names of daily_backup-1 and daily_backup-2.

Job concepts, templates and commands

Aborted job instances

In some cases, a job instance may not stop when it is aborted. This can happen if the instance is hung while executing a command to a low level device.

When the replic

ation manager server is stopped and restarted, all aborted job instances are cancelled.

Arguments

Most job commands include arguments. When a command is initially entered in a job, default values may appear in command arguments. In some cases, there are no defaults and you must specify a value. Required arguments are denoted by % characters. In the following example,%stor_unc_name% indicates that a value must be entered for the UNC name of the storage volume.

SnapcloneStorageVolume ( %storvol_unc_name%,"",SAME,"",WAIT)

See resource names and UNC format.

Argument lists

In some commands an argument list can be speciﬁed.Anargumentlistconsistsofindividualresource names, sepa

For example, a list of storage volumes (virtual disks):

("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars")

rated by commas, and enclosed in parenthesis.

^ required argument

Assignments (variables)

The Editing Task window allows you to create assignments (variables) that refer to speciﬁc resources or that reference the results of a command.

In the following example, a lengthy UNC-formatted name is stored in a variable on line 5. When the job is run, a snapclone is created by the command on line 10, which refers to the variable.

Line

Task

...

$disk = SetVariable ("\\ArrayA2\Pets\Cats\Vdisk66")

...

SnapcloneStorageVolume ($disk, "", SAME, "", WAIT)

...

In the next example, the results of a command are saved in a variable when the job is run. On line 7, the UNC name of the snapshot is stored in the variable $Rep1. Then on line 13 the variable is referenced to delete the snapshot.

Line

Task

...

$Rep1 = SnapshotHostVolume ("\\ source_host\path\source_hostvol1", FULLY_ALLOCATED, SAME)

ONERROR PAUSEAT E1:

...

E2: DeleteStorageVolumes ( $Rep1 ) ONERROR PAUSEATE2:

...

HP StorageWorks Replication Solutions Manager 4 .0.1

Usage

Assignments are:

• Local to each job and cannot be referenced across jobs.

• Notcasesensitive.

Format

• The ﬁrst two characters must be a dollar sign ($) followed by an alpha character. No special

• Upper and lower c ase, alpha and numeric are allowed.

• Underscores

Branches

Branches and labels are typically used to hand le errors and to create jobs that can be looped repeatedly. In line 9 of the following example, the command branches to label E1 on line 30 if there is an error when the command is executed.

characters are allowed after the ﬁrst character.

are allowed; spaces are not allowed.

Line

Task

...

Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1:

...

30 E1:Exit(FAILURE)

Branchin

gtypes

• Default. If the command fails, abort the job at this task (line).

• None.Us

• Onerror Goto. If the command fails, go to the label. Execute the command at the label.

• Onerror Pauseat. If the command fails, go to the label and pause the job. When the job is

• Onsucc

Commands

When you include a command in a job, the command’s arguments and default values are displayed in the job editor window. Argument names that appear with red % markers indicate that speciﬁcvalues arerequired. Seejobarguments. For example:

Snapc

You must edit the command and select or enter values for any required arguments. After editing, the command displays the argument value as normal text, in quotes.

SnapcloneStorageVolume ( "\\Array2\Cats", "", SAME, "", WAIT )

You can also edit a command to change its default values. In the example below, the defaults for disk group name and snapclone name have been changed.

ethedefaultbehavior.

continued from the GUI or CLUI, resume the job by executing the command at the label.

ess Goto. If the command is successful, go to the label. Execute the command at the label.

loneStorageVolume ( %storvol_unc_name%, "", SAME, "", WAIT )

^ command ^ arguments ... ^^ ^ ^

SnapcloneStorageVolume ( "\\Array2\Cats", "DskGrp3", SAME, "CatsCopy", WAIT )

You can also edit a command to add job ﬂow controls and assignments. See job labels, branches and assignments.

Job concepts, templates and commands

R1: $ Rep1 = SnapcloneStorageVolume ( "\\Array2\Cats", "", SAME, "", WAIT ) onerror pauseat E1:

label ^ ^ assignm

Command result values

Some commands return a result that can be assigned to a variable. The variable can then be referenced inasucceedingstepinthejob. Seealsojobassignments.

The following table lists command result values and formats. See also resource names and UNC formats.

Job command

AddAllOracleTablespacesToRepository

AddDrGroupMember

AddOracleAr

AddOracleTablespacesToRepository

AddReplicaToReplicaRepository

AddReplicasToReplicaRepository

CombineLists

ConvertStorageVolumeIntoContainer Combined list of resources (UNC)

ConvertStorageVolumesInManagedSetIntoContainers

chiveLogFilesToRepository

ent branch ^

Command result value (format)

Combined list of resources (UNC)

List of container names (UNC)

ConvertStorageVolumesIntoContainers

ConvertStorageVolumesIntoContainersUsingRepository List of container names (UNC)

CreateContainer

CreateContainerForHostDiskDevice

CreateContainersForHostVolume

CreateContainersForHostVolumeGroup

CreateDiskDevice

CreateDrGroup

CreateDrGroupFromHostVolume

CreateHostVolume Host volume name (UNC)

CreateHostVolumeDiscrete Host volume name (UNC)

CreateH

CreateHostVolumeGroup Host volume group name (UNC)

CreateHostVolumesUsingRepository List of host volume names (UNC)

CreateO

ostVolumeFromDiskDevices

racleRepository

List of container names (UNC)

Container name (UNC)

Managed set name of virtual disk containers (simple)

DR group name (UNC)

Host vol

Oracle r

ume name (UNC)

epository name (UNC)

CreateReplicaRepository Replica repository name (simple)

CreateRestoredHostVolumesUsingRepository List of host volume names (UNC)

StorageVolume

Create

evolumename(UNC)

Storag

HP StorageWorks Replication Solutions Manager 4 .0.1

Job command

DeleteContaine

DeleteDrGroup

DeleteDrGroupMember

DeleteHostVolume

DeleteHostVolumeGroup

DeleteHostVolumesUsingRepository

DeleteOracl

DeleteReplicaRepository

DeleteStorageVolume

DeleteStorageVolumes

DeleteStorageVolumesInManagedSet

DeleteStorageVolumesUsingRepository

DetachMirr

DiscoverDiskDevice

DiscoverDiskDevices

DiscoverDiskDevicesForDrGroup

DiscoveryRefresh (obsolete)

Exit

Export

FailoverDrGroup

FailoverDrGroups

FlushCac

ForceFullCopyDrGroup

eRepository

orclones

Command result value (format)

FractureHostDiskDeviceMirrorclone Name of the fractured mirrorclone (UNC)

FractureHostVolumeGroupMirrorclones

FractureHostVolumeMirrorclones

FractureMirrorclones

Import

InstantRestoreFromMirror

InstantRestoreFromSnapshot

Launch

LaunchJob

Log

MirrorcloneHostDiskDeviceToContainer

MirrorcloneHostDiskDeviceToContainerInManagedSet

MirrorcloneHostVolumeGroupToContainers

cloneHostVolumeGroupToContainersInManagedSet

Mirror

Job concepts, templates and commands

List of fractured mirrorclone names (UNC)

rom enabled host

Result f

Job command

MirrorcloneHos

MirrorcloneHostVolumeToContainersInManagedSet

MirrorcloneStorageVolumeToContainer

tVolumeToContainers

Command result value (format)

MountVolumeGroupComponent

Pause

PresentStorageVolume

PresentStora

RemoveDiskDevice

ResyncMirrorclone

ResyncMirrorclones

RetainLatestRoundRobinReplicasForHostStorageVolume

RetainLatestRoundRobinReplicasForHostVolume

RetainLate

SendEmail

SetDiskGroupForSnapclone

SetDrGroupAutoSuspend

SetDrGroupComments

SetDrGroupDestinationAccess

SetDrGrou

SetDrGroupFailsafeOnLinkDownPowerUp

SetDrGroupHome

SetDrGro

SetDrGroupMaxLogSize

SetDrGroupName

SetDrGroupSuspend

SetHostDiskDeviceWriteCacheMode

SetHostVolumeGroupWriteCacheMode

SetHost

SetHostVolumesWriteCacheMode

geVolumes

stRoundRobinReplicasForHostVolumeGroup

pFailsafe

upIoMode

VolumeWriteCacheMode

Mount point name (UNC)

SetListVariable

ntPointsPreﬁxInRepository

SetMou

SetNotiﬁcationPolicy

SetOracleModeUsingRepository

SetStorageVolumeName

SetStorageVolumeWriteCacheMode

SetStorageVolumesWriteCacheMode

The resources listed in the argument (UNC)

Newnameforthestoragevolume(UNC)

HP StorageWorks Replication Solutions Manager 4 .0.1

Job command

Command result value (format)

SetVariable The resource in t

SetWriteCacheModesUsingRepository

SnapcloneDiskDevice Snapclone storage volume name (UN C)

SnapcloneHostDiskDeviceToContainerInManagedSet Snapclone storage volume name (UN C)

SnapcloneHostVolume

SnapcloneHostVolumeGroup

SnapcloneHostVolumeGroupToContainersInManagedSet

SnapcloneHostVolumeToContainers

SnapcloneHostVolumeToContainersInManagedSet

SnapcloneO

SnapcloneOracleUsingRepository

SnapcloneStorageVolume Snapclone storage volume name (UN C)

SnapcloneStorageVolumeToContainer Snapclone storage volume name (UN C)

SnapcloneStorageVolumesToContainers

racleToContainersUsingRepository

List of snapclone storage volume names (UNC)

List of snapclone storage volume names (UNC

he argument (UNC)

SnapshotDiskDevice Snapshotstoragevolumename(UNC)

SnapshotHostDiskDeviceToContainerInManagedSet Snapshot name (UNC)

SnapshotHostVolume

SnapshotHostVolumeGroup

SnapshotHostVolumeGroupToContainersInManagedSet

SnapshotHostVolumeToContainers

SnapshotHostVolumeToContainersInManagedSet

SnapshotOracleToContainersUsingRepository

SnapshotOracleUsingRepository

SnapshotStorageVolume Snapshotstoragevolumename(UNC)

SnapshotStorageVolumeToContainer Snapshotstoragevolumename(UNC)

SnapshotStorageVolumesToContainers

TestJobState Boolean true-false

ntEntireVolumeGroup

Unmou

UnmountHostVolume

List of snapshot storage volume names (UNC)

Job concepts, templates and commands

Job command

UnmountHostVol

UnmountHostVolumesUsingRepository

UnpresentStorageVolume

UnpresentStorageVolumes

ValidateHost

ValidateHostVolume

ValidateHos

ValidateHostVolumeGroup

ValidateHostVolumeMirrorclones

ValidateOracleTablespaces

ValidateSnapcloneHostVolume

ValidateSnapcloneHostVolumeGroup

ValidateSn

ValidateSnapshotHostVolume

ValidateSnapshotHostVolumeGroup

ValidateSnapshotStorageVolume

ValidateStorageSystem

ValidateStorageVolume

Validate

Wait

WaitDrGroupSynchronizationTransition

WaitFor

WaitForHostVolumeGroupWriteCacheFlush

WaitForHostVolumeWriteCacheFlush

WaitForHostVolumesWriteCacheFlush

WaitForJob

WaitForStorageVolumeDiscovery

WaitF

WaitForStorageVolumeWriteCacheFlush

WaitForStorageVolumesWriteCacheFlush

WaitForWriteCacheFlushUsingRepository

WaitHostDiskDeviceNormalization

WaitHostVolumeNormalization

Wait

WaitStorageVolumesNormalization

WaitUntil

WaitVolumeGroupNormalization

StorageVolumes

HostDiskDeviceWriteCacheFlush

orStorageVolumesDiscovery

StorageVolumeNormalization

umes

tVolumeDoesNotExist

apcloneStorageVolume

Command result value (format)

HP StorageWorks Replication Solutions Manager 4 .0.1

Comments

The comment command can be used to add comments to a job. You can also comment-out other commands. See also job comment command.

E-mail from jobs

A job (each job instance) can send e-mail messages.

Job instances can send e-mail messages that you write and they can also send predeﬁned job status notiﬁcation messages. See SendEmail and SetNotiﬁcationPolicy, respectively.

Exits

Exit command failure. HP recommends the following best practices for using exit commands:

• Include at least one successful exit command in a job.

• Include a su

termination.

• If you create branches in a job to handle failures, conclude each with a failure exit command.

See job exit

Implicit jobs

When responding to certain requests, the replication manager may create and immediately run a job. Such jobs are called implicit jobs. Implicit jobs are not saved and cannot be edited.

s identify termination points in a job and can help provide conﬁrmation of success or

ccessful exit command for each branch of the job that can result in successful

command.

When an implicit job runs, it appears in the Monitor Job window and the Events pane. See also job

implicit job startup.

Implicit

job startup

When clicking OK or Finish to perform an action on a resource, the window or wizard immediately closes and the Monitor Job window appears. This is normal operation. To p erform your requested action, the replicat

It is not n continues to run.

Imported jobs

Replication manager jobs that have been imported from legacy HP Business Copy 2.X jobs include special comments to help resolve potential command conversion issues. For example:

ion manager creates and starts an implicit job.

ecessary to leave the Monitor Job window open. If you close the window, the implicit job

Job concepts, templates and commands

import note >

legacy job start >

Line

Task

// This job was im

// which included the following operations:

// [line 1] SNAP UNIT Array2 Cats\ACTIVE $BCV1 SNAPCLONE_HSV

SAME_AS_SOURCE

...

portedtoRSMfromanexistingBCjob,

legacy job end >

template applied >

commands start >

required argument >

commands end >

//[line5]"we’redone"

// Replicate storage volumes.

ValidateStorageSystem ( "Array2" )

ValidateStorageVolume ( "\\Array2\Cats\ACTIVE" )

ValidateSnapshotStorageVolume ( "\\Array2\Cats\ACTIVE" )

//$BCV1 = SnapshotStorageVolume ( "\\Array2\Cats\ACTIVE",

FULLY_ALLOCATED, SAME, %dest_storvol1%,WAIT)onerrorpauseatE1:

...

33 E1 : Exit ( FAILURE )

In the example:

• Lines 1 and 2

indicate the job was created by importing a legacy job.

• Line 3 shows (as a comment) the ﬁrst legacy job command that was encountered. All legacy

commands are displayed in this manner.

• Line 12 ind

icates that all legacy job commands have been listed.

• Line 15 indicates the start of the replication manager template that has been applied to create an

equivalent job.

• Line 20 ind

icatesarequiredargument. Seejob arguments.

Job commands list

The following commands can be included in jobs. The replication type indicates if the command is speciﬁcally for use with the local or remote replication features of a storage system. Storage family indicates the storage system family that the command supports. Some commands cannot be used unless a host agent is running on the target host.

Job command Command

// general

AddAllO

AddDrGroupMember >

AddOracleArchiveLogFilesToRepository Oracle

AddOracleTablespacesToRepository Oracle

AddReplicaToReplicaRepository host volume local

AddReplicasToReplicaRepository host volume local

Combi

racleTablespacesToRepository

neLists

Replication

category

Oracle

DR group

gener

HP StorageWorks Replication Solutions Manager 4 .0.1

type

~yes

remote

~yes

Requires

host agent

yes

Job command Command

category

ConvertStorageVolumeIntoContainer

ConvertStorageVolumesInManagedSetIntoContainers

ConvertStorageVolumesIntoContainers

ConvertStorageVolumesIntoContainersUsingRepository Oracle

CreateContainer

storage volume

Replication

type

local,

container

local,

container

local,

container

~yes

local,

container

Requires

host agent

CreateCont

CreateContainersForHostVolume host volume

CreateContainersForHostVolumeGroup

CreateDiskDevice

CreateDrGroup

CreateDrGroupFromHostVolume

CreateHostVolume host volume

CreateHostVolumeDiscrete host volume

CreateHostVolumeFromDiskDevices host volume

CreateHostVolumeGroup

CreateHostVolumesUsingRepository Oracle

CreateOracleRepository Oracle

CreateReplicaRepository host volume local

CreateRestoredHostVolumesUsingRepository Oracle

CreateStorageVolume

Dele

DeleteDrGroup

DeleteDrGroupMember

eteHostVolume

Del

ainerForHostDiskDevice

teContainer

host disk

device

host volume

group

host disk

device

DR group

lume

host vo

group

storage volume

DR group

tvolume

hos

local,

container

local,

container

local,

container

~yes

remote

~yes

local,

container

remote

~yes

yes

DeleteHostVolumeGroup

DeleteHostVolumesUsingRepository Oracle

DeleteOracleRepository Oracle

DeleteReplicaRepository host volume local

DeleteStorageVolume

Job concepts, templates and commands

host volume

group

storage volume

~yes

yes

Job command Command

category

DeleteStorageVolumes

DeleteStorageVolumesInManagedSet

DeleteStorag

DetachMirrorclones

eVolumesUsingRepository

storage

volume

storage

volume

Oracle

storage

volume

Replication

type

~yes

local,

mirrorclone

Requires

host agent

DiscoverDiskDevice

DiscoverDi

DiscoverDiskDevicesForDrGroup

DiscoveryRefresh< (obsolete)

Exit

Export

FailoverDrGroup

FailoverDrGroups

FlushCache host volume

ForceFullCopyDrGroup

FractureHostDiskDeviceMirrorclone

FractureHostVolumeGroupMirrorclones

FractureHostVolumeMirrorclones host volume

Fract

Import

InstantRestoreFromMirror

InstantRestoreFromSnapshot

Launch host

LaunchJob script ﬂow

Log

skDevices

ureMirrorclones

host disk

device

host disk

device

host disk

device

general

script ﬂow

general

DR group

device

group

storage

volume

general

storage

volume

storage

volume

eral

gen

host dis

host volume

~yes

remote

~yes

remote

local,

lone

mirrorc

local,

mirrorclone

local,

mirrorclone

local,

mirrorclon

local,

mirrorclone

loca

shot

snap

~yes

yes

MirrorcloneHostDiskDeviceToContainer

MirrorcloneHostDiskDeviceToContainerInManagedSet

rrorcloneHostVolumeGroupToContainers

host disk

device

host disk

device

host volume

group

HP StorageWorks Replication Solutions Manager 4 .0.1

local,

mirrorclone

local,

mirrorclone

local,

mirrorclone

yes

Job command Command

category

Replication

type

Requires

host agent

MirrorcloneHostVolumeGroupToContainersInManagedSet

MirrorcloneHostVolumeToContainers host volume

MirrorcloneHostVolumeToContainersInManagedSet host volume

MirrorcloneStorageVolume

MountEntireVolumeGroup

MountHostVolume host volume

MountHostVolumesUsingRepository Oracle

MountVolumeGroupComponent

Pause

PresentStor ageVolume

PresentStor ageVolumes

RemoveDiskDevice

ResyncMirrorclone

ResyncMirrorclones

host volume

group

storage volume

host volume

group

host volume

group

script ﬂow

storage volume

host dis

device

storage volume

local,

mirrorclone

local,

mirrorclone

local,

mirrorclone

local,

mirrorclone

~yes

local,

mirrorclone

local,

mirrorclone

yes

nLatestRoundRobinReplicasForHostStorageVolume

Retai

RetainLatestRoundRobinReplicasForHostVolume host volume local

RetainLatestRoundRobinReplicasForHostVolumeGroup

Send

SetDiskGroupForSnapclone host volume

SetDrGroupAutoSuspend

SetDrGroupComments

SetDrGroupDestinationAccess

SetDrGroupFailsafe

SetDrGroupFailsafeOnLinkDownPowerUp

SetDrGroupHome

SetDrGroupIoMode

SetDrGroupMaxLogSize

SetDrGroupName

host disk

device

host volume

group

ral

gene

DR group

roup

DR g

DR group

local

local,

snapclone

remote

ote

rem

remote

yes

Job concepts, templates and commands

Job command Command

category

SetDrGroupSuspend

DR group

Replication

type

remote

Requires

host agent

SetHostDiskDeviceWriteCacheMode

SetHostVolumeGroupWriteCacheMode

SetHostVolumeWriteCacheMode host volume

SetHostVolumesWriteCacheMode host volume

SetListVariable general

SetMountPointsPreﬁxInRepository

SetNotiﬁcationPolicy general

SetOracleM

SetStorageVolumeName

SetStorageVolumeWriteCacheMode

SetStorageVolumesWriteCacheMode

SetVariable general

SetWriteCacheModesUsingRepository Oracle

Snapclon

odeUsingRepository

eDiskDevice

host disk

device

host volume

group

Oracle

storage

volume

storage

volume

storage

volume

host disk

device

~yes

local,

snapclone

yes

SnapcloneHostDiskDeviceToContainerInManagedSet

SnapcloneHostVolume host volume

SnapcloneHostVolumeGroup

SnapcloneHostVolumeGroupToContainersInManagedSet

SnapcloneHostVolumeToContainers host volume

cloneHostVolumeToContainersInManagedSet

Snap

SnapcloneOracleToContainersUsingRepository Oracle

SnapcloneOracleUsingRepository Oracle

SnapcloneStorageVolume

SnapcloneStorageVolumeToContainer

SnapcloneStorageVolumesToContainers

host disk

device

lume

host vo

group

host volume

group

volume

host

storage

volume

storage

volume

storage

volume

local,

snapclone

local,

snapclone

local,

one

snapcl

local,

snapclone

local,

snapclone

local,

snapclone

local,

snapclone

local,

snapclone

al,

loc

apclone

local,

snapclone

local,

snapclone

yes

HP StorageWorks Replication Solutions Manager 4 .0.1

Job command Command

category

Replication

type

Requires

host agent

SnapshotDiskDevice

SnapshotHostDiskDeviceToContainerInManagedSet

SnapshotHostVolume host volume

SnapshotHostVolumeGroup

SnapshotHostVolumeGroupToContainersInManagedSet

SnapshotHo

SnapshotHostVolumeToContainersInManagedSet host volume

SnapshotOracleToContainersUsingRepository Oracle

SnapshotOracleUsingRepository Oracle

SnapshotStorageVolume

SnapshotStorageVolumeToContainer

Snapsh

SwitchOracleArchiveLogFilesUsingRepository Oracle

TestJobState

stVolumeToContainers

otStorageVolumesToContainers

host disk

device

host disk

device

host volume

group

host volume

group

host volume

storage volume

script ﬂow

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapshot

local,

snapsho

snapshot

local,

~yes

yes

ntEntireVolumeGroup

Unmou

UnmountHostVolume host volume

UnmountHostVolumes host volume

untHostVolumesUsingRepository

Unmo

UnpresentStorageVolume

UnpresentStorageVolumes

ValidateHost validation

ValidateHostVolume validation

ValidateHostVolumeDoesNotExist validation

lidateHostVolumeGroup

ValidateHostVolumeMirrorclones validation

ValidateOracleDatabase Oracle

ValidateOracleTablespaces Oracle

host volume

group

Orac

storage volume

lidation

~yes

local,

mirrorclone

~yes

yes

Job concepts, templates and commands

Job command Command

category

Replication

type

Requires

host agent

ValidateSnapcloneHostVolume validation

ValidateSnapcloneHostVolumeGroup validation

ValidateSnapcloneStorageVolume validation

ValidateSnapshotHostVolume validation

ValidateSnapshotHostVolumeGroup validation

ValidateSn

ValidateStorageSystem validation

ValidateStorageVolume validation

Validate

Wait

WaitDrGroupNormalization

WaitDrGr

WaitForHostDiskDeviceWriteCacheFlush

apshotStorageVolume

StorageVolumes

oupSynchronizationTransition

validation

validati

script ﬂow

DR group

host disk

device

local,

snapclone

local,

snapclone

local,

snapclone

local,

snapshot

local,

snapshot

local,

snapshot

remote

~yes

yes

WaitForHostVolumeGroupWriteCacheFlush

WaitForHostVolumeWriteCacheFlush host volume

WaitForHostVolumesWriteCacheFlush host volume

WaitForJob

WaitForStorageVolumeDiscovery

WaitForStorageVolumesDiscovery

WaitForStorageVolumeWriteCacheFlush

WaitForStorageVolumesWriteCacheFlush

WaitForWriteCacheFlushUsingRepository Oracle

WaitHostDiskDeviceNormalization

WaitHostVolumeNormalization host volume

WaitStorageVolumeNormalization

WaitStorageVolumesNormalization

WaitUntil

host volume

group

script ﬂow

storag

volum

storage

volume

storage

volume

age

stor

volu

host disk

device

storage

volume

storage

volume

script ﬂow

~yes

WaitVolumeGroupNormalization

host volume

group

HP StorageWorks Replication Solutions Manager 4 .0.1

~yes

Job templates l

Job templates provide frameworks and guidelines for creating typical jobs.

ist

Template name (alphabetical order) Replication

Remarks

type

Empty template

Fracture host

Instant restore storage volumes to other storage volumes local

Mount existing storage volumes

Perform cascaded replication

Perform planned failover

Perform unplanned failover

Replicate (

Replicate host disk devices, mount to a host local requires host agent

Replicate host volume group, mount components to a host local requires host agent

Replicate host volume group, mount entire group to a host local requires host agent

Replicate host volumes local requires host agent

Replicate host volumes via pre-allocated replication, mount to a host local requires host agent

Replicat

Replicate host volume, mount components to a host local requires host agent

volumes, mount to a host

via snapclone) a host volume multiple times, mount to a host

e host volumes, mount to a h ost

local requires host

remote and

local

remote

local requires ho

local requires

requires host agent

agent

st agent

host agent

Replicate host volumes, mount to a host, then to a different host local requires host agent

Replicat

Replicate storage volumes local

Replicate storage volumes via pre-allocated replication local

Replica

Replicate tablespaces via pre-allocated replication, mount to a host local

Replicate tablespaces, mount to a host local

Restore Oracle tablespaces local

Setup Continuous Access

Throttle replication I/O

Unmount and delete existing host volumes

Unmount existing host volumes

* Template can be modiﬁed for use without a host agent.

e raw storage volumes, mount (raw) to a host

te tablespaces

local requires

local

remote

requires host agent, Oracle

requi agent

requires host agent

host agent

res host

,Oracle

Job concepts, templates and commands

+ 177 hidden pages

HP StorageWorks Replication Solutions Manager 4.0.1 job command reference

Specifications and Main Features

Frequently Asked Questions

User Manual