HP 418800-B21 - StorageWorks Modular Smart Array 70 Storage... Installation manual

HP StorageWorks Replication Solutions
Manager 4.0.1
job command reference
Part number: T3680-96306
Fourth edition: June 2008

Legal and notice information
© Copyright 2007-2008 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. 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 3

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
4

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
SetMountPointsPrefixInRepository............................. 152
SetNotificationPolicy.................................. 153
SetOracleModeUsingRepository............................. 154
SetStorageVolumeName ................................ 154
SetStorageVolumeWriteCacheMode ........................... 155
SetStorageVolumesWriteCacheMode........................... 155
HP StorageWorks Replication Solutions Manager 4.0.1 5

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
6

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 7

Tables
1Documentconventions.............................. 10
8

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
administrators.
Related documentation
To find the following documents, browse to the Manuals page of the HP Business Support Center web site:
http://www.hp.com/support/manuals. In the Storage section, click Storage software and then select
the product.
Replication Solutions Manager
•HP StorageWorks Replication Solutions Manager online help
•HP StorageWorks Replication Solutions Manager user guide
•HP StorageWorks Replication Solutions Manager job command reference
•HP StorageWorks Replication Solutions Manager command line user interface reference
•HP StorageWorks Replication Solutions Manager administrator guide
•HP StorageWorks Replication Solutions Manager installation guide
Other
•HP StorageWorks EVA replication software consolidated release notes
•HP StorageWorks EVA software compatibility reference
•HP StorageWorks Command View EVA license key installation instructions
•HP StorageWorks Business Copy EVA administrator guide
•HP StorageWorks Continuous Access EVA administrator guide
HP StorageWorks Replication Solutions Manager 4.0.1 9

Document conventions and symbols
Table 1 Document conventions
Convention Element
Blue text: Table 1 Cross-reference links and e-mail addresses
Blue, underlined text: http://www.hp.com website addresses
Bold text
•Keys that are pressed
•Text typed into a GUI element, such as a box
•GUI elements that are clicked or selected, such as
menu and list items, buttons, tabs, and check boxes
Italic text Text emphasis
Monospace text
•File and directory names
•System output
•Code
•Commands, their arguments, and argument values
Monospace, italic text •Code variables
•Command variables
Monospace, bold text Emphasized monospace text
CAUTION:
Indicates that failure to follow directions could result in damage to equipment or data.
IMPORTANT:
Provides clarifying information or specific instructions.
NOTE:
Provides additional information.
TIP:
Provides helpful hints and shortcuts.
HP technical support
For worldwide technical support information, see the HP support website:
http://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 type and revision level
10 About this reference