HP 418800-B21 HP StorageWorks Replication Solutions Manager 4.0.1 job command
HP 418800-B21 - StorageWorks Modular Smart Array 70 Storage Enclosure Manual
UPC - 882780564640
View all HP 418800-B21 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP 418800-B21 manual content summary:
- HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 1
HP StorageWorks Replication Solutions Manager 4.0.1 job command reference Part number: T3680-96306 Fourth edition: June 2008 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 2
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent 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 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 3
Contents About this reference 9 Intended audience 9 Related documentation 9 Document conventions and symbols 10 HP technical support 10 Subscription service 11 HP websites 11 Documentation feedback 11 Product feedback 11 1 Job concepts, templates and commands 13 Job concepts 13 Job - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 4
Replicate host volumes, mount to a host (template 59 Replicate host volumes, mount to a host, then to a different host (template 62 Replicate host volumes via preallocated replication, mount to a host (template 64 Replicate host volume, mount components to a host (template 66 Replicate raw - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 5
151 SetListVariable 151 SetMountPointsPrefixInRepository 152 SetNotificationPolicy 153 SetOracleModeUsingRepository 154 SetStorageVolumeName 154 SetStorageVolumeWriteCacheMode 155 SetStorageVolumesWriteCacheMode 155 HP StorageWorks Replication Solutions Manager 4.0.1 5 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 6
SetVariable 156 SetWriteCacheModesUsingRepository 156 SnapcloneDiskDevice 157 SnapcloneHostDiskDeviceToContainerInManagedSet 158 SnapcloneHostVolume 159 SnapcloneHostVolumeGroup 160 SnapcloneHostVolumeGroupToContainersInManagedSet 161 SnapcloneHostVolumeToContainers 162 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 7
201 WaitHostDiskDeviceNormalization 201 WaitHostVolumeNormalization 202 WaitStorageVolumeNormalization 202 WaitStorageVolumesNormalization 203 WaitUntil 203 WaitVolumeGroupNormalization 204 Index 207 HP StorageWorks Replication Solutions Manager 4.0.1 7 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 8
Tables 1 Document conventions 10 8 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 9
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 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 10
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 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 11
websites For additional information, see the following HP websites: • http://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 your feedback. To make comments and - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 12
12 About this reference - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 13
tasks. A typical job consists of commands, assignments (variables), branching instructions, labels, comments and exits. Jobs with launch commands often include transactions save, run, schedule, and manage jobs that automate replication tasks. HP StorageWorks Replication Solutions Manager 4.0.1 13 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 14
Job editor Use the replication 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 can also create custom jobs from the - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 15
is referenced to delete the snapshot. Line Task ... 7 $Rep1 = SnapshotHostVolume ("\\source_host\path\source_hostvol1", FULLY_ALLOCATED, SAME) ONERROR PAUSEAT E1: ... // 13 E2: DeleteStorageVolumes ( $Rep1 ) ONERROR PAUSEATE2: ... HP StorageWorks Replication Solutions Manager 4.0.1 15 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 16
Usage Assignments are: • Local to each job and cannot be referenced across jobs. • Not case sensitive. Format • The first two characters must be a dollar sign ($) followed by an alpha character. No special characters are allowed after the first character. • Upper and lower case, alpha and numeric - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 17
(UNC) CreateOracleRepository Oracle repository name (UNC) CreateReplicaRepository Replica repository name (simple) CreateRestoredHostVolumesUsingRepository List of host volume names (UNC) CreateStorageVolume Storage volume name (UNC) HP StorageWorks Replication Solutions Manager 4.0.1 17 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 18
Job command DeleteContainer DeleteDrGroup DeleteDrGroupMember DeleteHostVolume DeleteHostVolumeGroup DeleteHostVolumesUsingRepository DeleteOracleRepository DeleteReplicaRepository DeleteStorageVolume DeleteStorageVolumes DeleteStorageVolumesInManagedSet DeleteStorageVolumesUsingRepository - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 19
SetStorageVolumeName SetStorageVolumeWriteCacheMode SetStorageVolumesWriteCacheMode Command result value (format) Mount point name (UNC) The resources listed in the argument (UNC) New name for the storage volume (UNC) - HP StorageWorks Replication Solutions Manager 4.0.1 19 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 20
Job command SetVariable SetWriteCacheModesUsingRepository SnapcloneDiskDevice SnapcloneHostDiskDeviceToContainerInManagedSet SnapcloneHostVolume SnapcloneHostVolumeGroup SnapcloneHostVolumeGroupToContainersInManagedSet SnapcloneHostVolumeToContainers SnapcloneHostVolumeToContainersInManagedSet - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 21
WaitForWriteCacheFlushUsingRepository WaitHostDiskDeviceNormalization WaitHostVolumeNormalization WaitStorageVolumeNormalization WaitStorageVolumesNormalization WaitUntil WaitVolumeGroupNormalization Command result value (format) - HP StorageWorks Replication Solutions Manager 4.0.1 21 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 22
open. If you close the window, the implicit job 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: 22 Job concepts, templates and commands - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 23
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. local yes CombineLists general ~ ~ HP StorageWorks Replication Solutions Manager 4.0.1 23 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 24
Job command ConvertStorageVolumeIntoContainer ConvertStorageVolumesInManagedSetIntoContainers ConvertStorageVolumesIntoContainers ConvertStorageVolumesIntoContainersUsingRepository CreateContainer CreateContainerForHostDiskDevice CreateContainersForHostVolume CreateContainersForHostVolumeGroup - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 25
~ local, mirrorclone local, snapshot ~ ~ ~ local, mirrorclone local, mirrorclone local, mirrorclone Requires host agent ~ ~ yes ~ yes yes yes ~ ~ ~ ~ ~ yes ~ yes yes yes ~ ~ ~ ~ yes ~ ~ yes yes yes HP StorageWorks Replication Solutions Manager 4.0.1 25 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 26
Job command MirrorcloneHostVolumeGroupToContainersInManagedSet MirrorcloneHostVolumeToContainers MirrorcloneHostVolumeToContainersInManagedSet MirrorcloneStorageVolume MountEntireVolumeGroup MountHostVolume MountHostVolumesUsingRepository MountVolumeGroupComponent Pause PresentStorageVolume - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 27
local, snapclone local, snapclone local, snapclone Requires host agent ~ yes yes yes yes ~ yes ~ yes ~ ~ ~ ~ yes yes yes yes yes yes yes yes yes yes ~ ~ ~ HP StorageWorks Replication Solutions Manager 4.0.1 27 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 28
Job command SnapshotDiskDevice SnapshotHostDiskDeviceToContainerInManagedSet SnapshotHostVolume SnapshotHostVolumeGroup SnapshotHostVolumeGroupToContainersInManagedSet SnapshotHostVolumeToContainers SnapshotHostVolumeToContainersInManagedSet SnapshotOracleToContainersUsingRepository - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 29
local, snapclone local, snapshot local, snapshot local, snapshot ~ ~ ~ ~ remote remote ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ Requires host agent yes yes ~ yes yes yes yes yes yes ~ ~ ~ ~ ~ yes yes yes ~ ~ ~ yes HP StorageWorks Replication Solutions Manager 4.0.1 29 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 30
Job templates list Job templates provide frameworks and guidelines for creating typical jobs. Template name (alphabetical order) Empty template Replication type - Remarks Fracture host volumes, mount to a host local requires host agent Instant restore storage volumes to other storage volumes - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 31
(storage volumes) Resource names in job commands When you initially enter a command in a job, the command's resource arguments are displayed as %variable% names, for example: HP StorageWorks Replication Solutions Manager 4.0.1 31 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 32
such as partitions and slices. Name format (UNC) OS specific example \\host name\path\host volume name AIX \\HostA2\/home/cats HP-UX \\HostA2\/users/cats Linux \\HostA2\/var/cats OpenVMS \\HostA2\CATS Solaris \\HostA2\/usr/cats Tru64 UNIX \\HostA2\/users/cats Windows \\HostA2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 33
Any number of job instances can 8 be started. Additional instances are queued and run as others are completed. Per specific enabled host AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows 8 The replication manager does not 8 actively limit the number of job instances per specific enabled host - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 34
Status and states Job status The collection of all jobs may have one of the following status conditions. These status conditions appear in the resources pane. Icon Status When last checked, new information on jobs was not available. When last checked, new information on jobs was available. - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 35
fic storage system, while ValidateSnapcloneStorageVolume checks whether the storage volume is available and if it can be copied using snapclone replication. IMPORTANT: HP recommends placing resource validation commands together, in the first lines of a job. They can be preceded by comments, but not by - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 36
• Skip validation. If the line is a validation command it is ignored. In the validate-only and skip validation cases, job transactions and branches within validation commands are ignored. Resource validation processing in transactions Special cases exist for validation commands in a transaction - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 37
to suspend and resume host application I/O. • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. HP StorageWorks Replication Solutions Manager 4.0.1 37 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 38
• Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication. Example This template was generated to - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 39
for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • This template cannot be used with some older versions of controller software. • HP recommends that you perform restores of host volumes using the GUI - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 40
Example This template was generated to copy (restore) one storage volume. No other template options were selected. Line Task 1 // Synchronize storage volume(s) to other storage volume(s) 2 // 3 // Assign some variables that will be used in this job. 4 $source_storvol_unc1 = SetVariable(% - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 41
e-mail notification of the job instance status. See SetNotificationPolicy. Comments • This template cannot be used with HP-UX host volumes. • When used with Tru64 UNIX hosts, this template supports only UFS file systems. Example This template was generated to mount one existing storage volume on a host - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 42
Line Task 1 // Mount existing storage volume(s). 2 // 3 // Assign some variables that will be used in this job. 4 $storvol_unc1 = SetVariable(%storvol_unc1%) 5 $mount_host = SetVariable(%mount_host%) 6 // 7 // Validate that resources are as expected. 8 ValidateHost ($mount_host) 9 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 43
= SetVariable(%site_2_array%) 15 $host_name = SetVariable(%host_name% 16 $site_3_array = SetVariable(%site_3_array%) 17 $DR_group_name = SetVariable(%DR_group_name%) 18 $DR_source_storvol_unc1 = SetVariable(%DR_source_storvol_unc1%) HP StorageWorks Replication Solutions Manager 4.0.1 43 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 44
19 // 20 // Validate some resources needed by this job: 21 // - The arrays at Sites 1, 2 and 3. 22 // - The source DR group at Site 1 and it's virtual disk member(s). 23 // - The storage system at Site 2 with the destination DR group and it's virtual disk member(s). 24 // - The host name at - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 45
group was using. 83 E2: DeleteStorageVolume ($Rep1) onerror pauseat E2: 84 // 85 Exit (SUCCESS) 86 // 87 // Failure exit - no rollback needed. 88 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 45 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 46
Perform planned failover (template) Template summary Performs a failover of two sites in the case where the source site resources and link remain available.he DR group pair contains one storage volume (virtual disk) at the source and destination sites. A. Stops an application on the enabled host at - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 47
, fsck volumes, etc. 29 // Mount devices on the remote host. 30 // Start the application on the remote host. 31 Pause() 32 // 33 Exit (SUCCESS 34 // HP StorageWorks Replication Solutions Manager 4.0.1 47 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 48
for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Guidelines apply. IMPORTANT: During actual emergencies, HP recommends that you manually perform a failover by using the Failover action in the GUI. Example This template was generated to perform one iteration of - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 49
. B. Between each snapclone, wait for the previous one to normalize. C. Mount the replicas on a host. D. Pause. E. Delete the mounted host volumes. F. Delete the storage volumes. HP StorageWorks Replication Solutions Manager 4.0.1 49 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 50
Template options • Number of times to snapclone. Adds commands for each snapclone. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Launch backup after replication. Adds a launch command for - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 51
pauseat E3: 26 // 27 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 28 // 29 Exit (SUCCESS) 30 // 31 // Failure exit - no rollback needed. 32 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 51 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 52
Replicate host disk devices, mount to a host (template) Template summary A. Locally replicates (copies) the storage volumes that underlie a raw host volume on an enabled host. B. Presents the underlying storage volume copies to a second enabled host (creates a new raw host volume). C. Pauses the job - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 53
volumes that underlie a host volume group on an enabled host. B. Presents the underlying storage volume copies to a second enabled host (creates a new host volume group). HP StorageWorks Replication Solutions Manager 4.0.1 53 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 54
fication. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Tru64 UNIX. Replication is not supported when an AdvFS domain spans partitions. • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 55
pauseat E3: 26 // 27 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2 28 // 29 Exit (SUCCESS) 30 // 31 // Failure exit - no rollback needed. 32 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 55 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 56
fication. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Tru64 UNIX. Replication is not supported when an AdvFS domain spans partitions. • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 57
pauseat E3: 25 // 26 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 27 // 28 Exit (SUCCESS) 29 // 30 // Failure exit - no rollback needed. 31 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 57 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 58
Replicate host volumes (template) Template summary A. Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host. B. Pauses the job. C. After continuing, deletes the storage volume copies from the storage system. Template Options • Number of volumes to replicate. - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 59
to suspend and resume host application I/O. • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. HP StorageWorks Replication Solutions Manager 4.0.1 59 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 60
• Use snapclone instead of snapshot. Generates a template that uses snapclone replication. • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 61
pauseat E3: 27 // 28 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 29 // 30 Exit (SUCCESS) 31 // 32 // Failure exit - no rollback needed. 33 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 61 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 62
Replicate host volumes, mount to a host, then to a different host (template) Template summary Involves five enabled hosts, EH1 through EH5*. A. Locally replicates (copies) the storage volumes that underlie a host volume on an EH1. B. Presents the underlying storage volume copies to EH2 (creates a new - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 63
( 43 // 44 // Rollback. 45 E4: UnmountHostVolume ($MP2) onerror pauseat E4: 46 E3: DeleteHostVolume ($HV2) onerror pauseat E3: 47 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 48 // HP StorageWorks Replication Solutions Manager 4.0.1 63 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 64
49 Exit (SUCCESS 50 // 51 // Failure exit - no rollback needed. 52 E1: Exit (FAILURE Replicate host volumes via preallocated replication, mount to a host (template) Template summary A. Disables (flushes) the write cache of the storage volumes that underlie a host volume on an enabled host. B. Locally - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 65
= CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host) onerror pauseat E2: 35 $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E3: 36 // 37 // Wait for user to initiate rollback. 38 Pause () HP StorageWorks Replication Solutions Manager 4.0.1 65 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 66
39 // 40 // Rollback. 41 E4: UnmountHostVolume ($MP1) onerror pauseat E4: 42 E3: DeleteHostVolume ($HV1) onerror pauseat E3: 43 // 44 E2: DeleteStorageVolumesInManagedSet (%dest_container_set1%) onerror pauseat E2: 45 // 46 Exit (SUCCESS) 47 // 48 // Failure exit - no rollback needed. 49 E1: Exit ( - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 67
pauseat E3: 27 // 28 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 29 // 30 Exit (SUCCESS) 31 // 32 // Failure exit - no rollback needed. 33 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 67 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 68
Replicate raw storage volumes mount (raw) to a host (template) Template summary A. Locally replicates (copies) raw storage volumes. B. Presents the storage volume copies to an enabled host (creates a raw host volume). C. Pauses the job. D. After continuing, removes the raw host volume from the - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 69
) Replicate storage volumes (template) Template summary A. Locally replicates (copies) storage volumes. B. Pauses the job. C. After continuing, deletes the storage volume copies from the storage system. HP StorageWorks Replication Solutions Manager 4.0.1 69 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 70
Template options • Number of volumes to replicate. Adds commands for each volume. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Use snapclone instead of snapshot. Generates a template that - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 71
have heavy I/O, select the option Suspend source before replication. Example This template was generated to replicate one storage volume. No other template options were selected. HP StorageWorks Replication Solutions Manager 4.0.1 71 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 72
Line Task 1 // Replicate storage volume(s) via pre-allocated replication. 2 // 3 // Assign some variables that will be used in this job. 4 $source_storvol_list = SetListVariable(%source_storvol_list%) 5 $dest_container_list = SetListVariable(%dest_container_list%) 6 // 7 // Validate that - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 73
items in the repository. 16 SnapshotOracleUsingRepository ($repository, FULLY_ALLOCATED, SAME, ORACLE_TABLESPACE, NOWAIT) onerror pauseat E2: 17 // 18 } ALWAYS { 19 // Put the database back into normal mode. HP StorageWorks Replication Solutions Manager 4.0.1 73 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 74
20 SetOracleModeUsingRepository ($repository, TSONLINE) 21 } 22 // 23 // NOTE: Please remove the archive log file Switch, Add, and Snap commands below if this job is not backing up archive log files 24 // 25 // Force a log switch to get the most current archive logs. 26 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 75
is not backing up archive log files. 25 // 26 // Force a log switch to get the most current archive logs. 27 SwitchOracleArchiveLogFilesUsingRepository ( $repository ) onerror pauseat E3: HP StorageWorks Replication Solutions Manager 4.0.1 75 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 76
28 // OPTION: Add the archive logs 29 AddOracleArchiveLogFilesToRepository($repository) onerror pauseat E3: 30 // Replicate the items in the repository. 31 SnapshotOracleUsingRepository ($repository, FULLY_ALLOCATED, SAME, ORACLE_ARCHIVE_LOG_FILE, NOWAIT) onerror pauseat E3: 32 // 33 // Mount - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 77
, ORACLE_TABLESPACE, WRITE_CACHE_DISABLED) onerror pauseat E2: 17 // 18 DO { 19 SnapshotOracleToContainersUsingRepository ($repository, %managed_set_of_containers%, FULLY_ALLOCATED, ORACLE_TABLESPACE, NOWAIT) onerror pauseat E2: 20 // HP StorageWorks Replication Solutions Manager 4.0.1 77 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 78
21 } ALWAYS { 22 // Put the database back into normal mode. 23 SetOracleModeUsingRepository ($repository, TSONLINE) 24 // Restore the writeback cache on the host volume(s). 25 SetWriteCacheModesUsingRepository ($repository, ORIGINAL, ORACLE_TABLESPACE, WRITE_CACHE_ENABLED) 26 } 27 // 28 // - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 79
job instance status. See SetNotificationPolicy. Example This template was generated to restore tablespaces to a different server than the original. No template options were selected. HP StorageWorks Replication Solutions Manager 4.0.1 79 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 80
Line Task 1 // Restore Oracle tablespace(s) using repository. 2 // 3 // Assign some variables that will be used in this job. 4 $repository = SetVariable(%repository_name%) 5 $mount_host = SetVariable(%mount_host%) 6 // 7 // Mount the replicated volume(s) on a host. 8 CreateHostVolumesUsingRepository - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 81
created AFTER the job, 26 // so enter the name of the storage volume manually. 27 // Default name is the same as the source storage volume. 28 SUCCESS) 31 // 32 // Failure exit - no rollback needed. 33 E1: Exit (FAILURE) HP StorageWorks Replication Solutions Manager 4.0.1 81 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 82
Throttle replication I/O (remote replication template) IMPORTANT: Jobs generated by this template are intended to be run only in conjunction with a log merge or full-copy events on a single storage system. Template summary Suspends remote replication in non-critical DR group pairs until critical DR - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 83
the job instance status. See SetNotificationPolicy. Example This template was generated to unmount and delete one host volume. No other template options were selected. HP StorageWorks Replication Solutions Manager 4.0.1 83 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 84
Line Task 1 // Unmount and delete the host volume(s). 2 // 3 // Assign some variables that will be used in this job. 4 $hostvol_unc1 = SetVariable(%hostvol_unc1%) 5 $host_name = SetVariable(%host_name%) 6 // 7 // Validate that resources are as expected. 8 ValidateHost ($host_name) 9 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 85
tablespaces in a database to a specific repository. The appropriate tablespaces are automatically added by reference to the enabled host and database specified by the repository. HP StorageWorks Replication Solutions Manager 4.0.1 85 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 86
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: AddAllOracleTablespacesToRepository ( %oraclerepository_unc_name% ) UNC Oracle repository Name (%oraclerepository_unc_name%). Select or enter the UNC name of the repository to which the Oracle - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 87
(%oracletablespace_unc_names% ). Select or enter the UNC names of the Oracle tablespaces to be added to the repository. Examples AddOracleTablespacesToRepository ( "\\HostA2\Catalog 20051214.021405", "\\HostA2\SYSTEM" ) HP StorageWorks Replication Solutions Manager 4.0.1 87 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 88
Comments • Associated validation commands.ValidateOracleTablespaces. • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. None. For a complete list, see command result values. • OS specifics. None • The repository must already exist - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 89
default arguments are: ConvertStorageVolumeIntoContainer ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to be converted to a container. HP StorageWorks Replication Solutions Manager 4.0.1 89 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 90
Examples ConvertStorageVolumeIntoContainer ( "\\ArrayA2\Cats" ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. Container name (UNC). For a complete list, see command result values. • OS specifics. None • This command - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 91
and UNC formats. CreateContainer Creates a storage container on a storage system. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: HP StorageWorks Replication Solutions Manager 4.0.1 91 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 92
%). Select or enter a name for the managed set in which the storage containers are to be added. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows CreateContainerForHostDiskDevice ( "\\HostA2\/dev/dsk/hd1", "hvol_cats" ) CreateContainerForHostDiskDevice ( "\\HostA2\/dev/dsk/c2t0d2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 93
show host volume mount points. Device names can also be used. AIX CreateContainersForHostVolume ( "\\HostA2\/home/cats", "hvol_cats" ) HP-UX CreateContainersForHostVolume ( "\\HostA2\/users/cats", "hvol_cats" ) Linux CreateContainersForHostVolume ( "\\HostA2\/var/cats", "hvol_cats" ) OpenVMS - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 94
storage containers are to be added. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows CreateContainersForHostVolumeGroup cs. Yes. See examples above. • See resource names and UNC formats. CreateDiskDevice Instructs an enabled host to create a raw host volume (disk device) from a storage - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 95
on the source and destination storage systems. • Command result value. DR group name (simple). For a complete list, see command result values. • OS specifics. None HP StorageWorks Replication Solutions Manager 4.0.1 95 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 96
• Guidelines apply. • The maximum number of virtual disks per DR group and other properties are controller software dependent. • Values for the following properties can be specified in the CreateDrGroup command. These properties can be changed later, in another job, by using the commands shown. - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 97
also be used. AIX CreateDrGroupFromHostVolume ( "DrGrpPets", "\\HostA2\/home/cats", "ArrayB7", "", "", SAME, "", "", 10, FALSE ) HP-UX CreateDrGroupFromHostVolume ( "DrGrpPets", "\\HostA2\/users/cats", "ArrayB7", "", "", SAME, "", "", 10, FALSE ) Linux CreateDrGroupFromHostVolume ( "DrGrpPets - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 98
• Values for the following properties can be specified in the CreateDrGroupFromHostVolume command. These properties can be changed later, in another job, by using the commands shown. Default values Property Source Destination Job command Auto suspend on links down mode False (disabled) False - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 99
** CreateHostVolume ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) HP-UX $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) result values. • OS specifics. Yes. See examples above. HP-UX. If the source host volume uses HP-UX PVLinks for multiple paths, the replica will have only one path - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 100
name (UNC). For a complete list, see command result values. • OS specifics. Yes. See examples above. HP-UX. This command is not supported with HP-UX hosts. OpenVMS. This command is not supported with OpenVMS hosts. Tru64 UNIX • The Partition/Slice (%component%) value must be 0 (zero). • The command - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 101
AIX $Rep1=SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) ** CreateHostVolumeFromDiskDevices ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) HP-UX $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) ** CreateHostVolumeFromDiskDevices ( "\\HostA2\/users/cats", $Rep1, "HostA4 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 102
command result values. • OS specifics. Yes. See examples above. HP-UX. If the source host volume group uses HP-UX PVLinks for multiple paths, the replica will have only one path to OpenVMS volume sets. Windows. Windows does not support volume groups. • See also CreateHostVolumeDiscrete. • See - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 103
host and database specified by the repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: CreateRestoredHostVolumesUsingRepository ( %oraclerepository_unc_name% ) HP StorageWorks Replication Solutions Manager 4.0.1 103 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 104
UNC Oracle Repository Name (%oraclerepository_unc_name% ). Select or enter the UNC name of the repository whose files are to be restored. Examples CreateRestoredHostVolumesUsingRepository ( "\\HostA2\Catalog 20051214.021405" ) Comments • Associated validation commands. None • Agent and license - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 105
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders CreateReplicaRepository ( HOST_VOLUME, "\\HostA2\/ Group" ) Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites. None. HP StorageWorks Replication Solutions Manager 4.0.1 105 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 106
• Command result value. Storage volume (virtual disk) name (UNC). For a complete list, see command result values. • OS specifics. None. • Virtual disks can only be created at the root level of the array. • See resource names and UNC formats. DeleteContainer Deletes a storage container from a storage - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 107
If the source-destination connection is not operational, DR groups are still deleted but you must manually delete the destination virtual disks when the connection is reestablished. • If you delete a remote the storage is no longer available. HP StorageWorks Replication Solutions Manager 4.0.1 107 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 108
be used. AIX DeteleHostVolume ( "\\HostA2\/home/cats" ) HP-UX DeteleHostVolume ( "\\HostA2\/users/cats" ) Linux DeleteHostVolume command is supported when the host volume is on a physical enabled host in a cluster. • See resource names and UNC formats. DeleteHostVolumeGroup Instructs an enabled - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 109
command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • See resource names and UNC formats. DeleteHostVolumesUsingRepository Deletes the step in the same job. • See resource names and UNC formats. HP StorageWorks Replication Solutions Manager 4.0.1 109 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 110
DeleteOracleRepository Deletes an Oracle repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteOracleRepository ( %oraclerepository_unc_name% ) UNC Oracle Repository Name (%oraclerepository_unc_name% ). Select or enter the UNC name - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 111
Deletes the storage volumes that are members of a managed set. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: HP StorageWorks Replication Solutions Manager 4.0.1 111 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 112
DeleteStorageVolumesInManagedSet ( %managed_set_name% ) Managed set of containers. Select or enter the name of the managed set whose storage volumes (virtual disks) are to be deleted. Examples DeleteStorageVolumesInManagedSet ( "svol_cats_set" ) Comments • Associated validation commands. - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 113
layers recognize the presented storage volumes as a host disk devices. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: HP StorageWorks Replication Solutions Manager 4.0.1 113 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 114
DiscoverDiskDevices ( %hostname%, %storvol_unc_list% ) Host Name (%hostname%). Select or enter the name of the enabled host that you want to discover the presented storage volume. List of UNC Storage Volume Names (%storvol_unc_list%). Select or enter the names of presented storage volumes to be - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 115
command is obsolete as of version 2.0; however, the command can appear in jobs that were created with prior versions of the replication manager. • HP recommends that you remove the command from previously created jobs. Exit Adds an exit point to the job and defines the resulting job return - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 116
Comments • Associated validation command. None • Agent and license prerequisites. None • Command result values. None. For a complete list, see command result values. • OS specifics. None Export Exports the RSM database. This feature allows administrators to create a copy of the active RSM database. - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 117
• Command result value. None. For a complete list, see command result values. • OS specifics. None • Guidelines apply. • During actual emergencies, HP recommends that you manually perform a failover by using the Failover action in the GUI. • During actual emergencies, the partner DR group may not be - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 118
Examples These examples show host volume mount points. Device names can also be used. AIX JFS, VFS FlushCache ( "\\HostA2\/home/cats" ) HP-UX HFS, VxFS FlushCache ( "\\HostA2\/users/cats" ) Linux Ext2, Ext3 FlushCache ( "\\HostA2\/var/cats" ) OpenVMS ~ Not required Solaris UFS, VxFS - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 119
storage volumes are to be fractured. Wait Flag. Select wait or nowait. See jobs wait/nowait argument. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows FractureHostDiskDeviceMirrorclone ( "\\HostA2\/dev/dsk/hd1", WAIT ) FractureHostDiskDeviceMirrorclone ( "\\HostA2\/dev/dsk/c2t0d2", WAIT - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 120
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows FractureHostVolumeGroupMirrorclones ( "\\HostA2\/home/cats_vg", used. AIX FractureHostVolumeMirrorclones ( "\\HostA2\/home/cats" ) HP-UX FractureHostVolumeMirrorclones ( "\\HostA2\/users/cats" ) Linux FractureHostVolumeMirrorclones - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 121
administrators to import a previously exported copy of the RSM database. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: HP StorageWorks Replication Solutions Manager 4.0.1 121 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 122
Import ( %full_file_name% ) Full path name. Enter the full path and file name of the RSM database copy to import. Examples Import ( "C:\colorado\RSMdb_on_server2_Mar_15_2007.xml") Import ( "C:\colorado\CADATA_20050211135232.export" ) Comments • Associated validation commands. None • Agent and license - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 123
host command returns a zero for success, enter a zero (0). Do not enclose a value in quotes. This is done automatically. An empty value appears as two quotes (""). HP StorageWorks Replication Solutions Manager 4.0.1 123 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 124
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders Launch ( "HostA2", "/home/zap_application.sh", "", WAIT, "0" ) Launch ( "HostA2", "/users/zap_application.sh", "", WAIT, "0" ) Launch ( "HostA2", "/var/ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 125
the UNC name of the storage container to be used for the mirrorclone. Wait Flag. Select wait or nowait. See jobs wait/no wait argument. HP StorageWorks Replication Solutions Manager 4.0.1 125 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 126
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows MirrorcloneHostDiskDeviceToContainer ( "\\HostA2\/dev/dsk/hd1", "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ("\\HostA2\/dev/dsk/c2t0d2", "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 127
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows MirrorcloneHostDiskDeviceToContainerInManagedSet ( "\\HostA2\/dev/dsk/hd1", "hvol_cats_set", WAIT the mirrorclones. Wait Flag. Select wait or nowait. See jobs wait/no wait argument. HP StorageWorks Replication Solutions Manager 4.0.1 127 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 128
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/home/cats_vg", "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/users/cats_vg", "\\ArrayA2\CatsContainer", WAIT ) - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 129
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set . Examples These examples show host volume mount points. Device names can also be used. HP StorageWorks Replication Solutions Manager 4.0.1 129 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 130
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders MirrorcloneHostVolumeToContainers ( "\\HostA2\/home/cats", ("\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeToContainers ( - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 131
Wait (%wait_nowait%). Select wait or nowait. See jobs wait/no wait argument. Examples MirrorcloneStorageVolumeToContainer ( "\\ArrayA2\Cats", "\\ArrayA2\CatsContainer", WAIT ) Comments • Associated validation commands. ValidateStorageVolume. HP StorageWorks Replication Solutions Manager 4.0.1 131 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 132
list, see command result values. • OS specifics. None. MountEntireVolumeGroup Instructs an enabled host to mount all of the replica logical volumes in a a unique mount point prefix for each replica. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows MountEntireVolumeGroup ( "cats_vg", - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 133
UNIX. Windows. Windows does not support volume groups. • See resource names and UNC formats. MountHostVolume Instructs an enabled host to mount point should not be in use when the job is run. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders MountHostVolume ( "\\ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 134
• The repository must already exist or be created by a previous step in the same job. • See resource names and UNC formats. MountVolumeGroupComponent Instructs an enabled host to mount a specific component (logical volume) in a host volume group replica. The host volume group replica must have been - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 135
group replica on the same host as the source volume group. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Solaris. You cannot mount presentation of a storage volume to an enabled host. HP StorageWorks Replication Solutions Manager 4.0.1 135 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 136
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: PresentStorageVolume ( %storvol_unc_name%, %host_name%, 0, READ_WRITE ) UNC Storage Volume Name ( %storvol_unc_name%). Select or enter the full UNC name of the storage volume (virtual disk) whose - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 137
resource names and UNC formats. ResyncMirrorclone Restarts the local replication from a source virtual disk to its fractured mirrorclone. The fractured mirrorclone becomes a synchronized mirrorclone again. HP StorageWorks Replication Solutions Manager 4.0.1 137 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 138
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ResyncMirrorclone ( %mirrorclone_unc_name% ) Mirrorclone UNC Storage Volume Name (%mirrorclone_unc_name%). Select or enter the UNC name of the fractured mirrorclone to be resynchronized with its - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 139
Select or enter the number of replicas to use in the round robin replication job. Examples RetainLatestRoundRobinReplicasForHostStorageVolume ( "\\HostA2\/home/cats", 3 ) AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows RetainLatestRoundRobinReplicasForHostStorageVolume ( "\\HostA2\/dev/dsk/hd1 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 140
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders RetainLatestRoundRobinReplicasForHostVolume ( "\\HostA2 robin replication job. The maximum is seven. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows RetainLatestRoundRobinReplicasForHostVolumeGroup ( "\\ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 141
• You can send e-mail (text message) to a phone number if the e-mail service supports it. SetDiskGroupForSnapclone Temporarily overrides a storage system default and specifies the disk group in which in which the snapclones are to be created. HP StorageWorks Replication Solutions Manager 4.0.1 141 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 142
Examples SetDiskGroupForSnapclone ( "ArrayA2", "DskGrp3" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a local replication license for the storage system. • Command result value. None. For a complete list, see command result values. • OS specifics. None - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 143
and default arguments are: SetDrGroupFailsafe ( %drgroup_unc_name%, DISABLED ) UNC DR Group Name (%drgroup_unc_name%). Select or enter the UNC name of the DR group to be changed. HP StorageWorks Replication Solutions Manager 4.0.1 143 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 144
Failsafe Mode. Select or enter the failsafe mode (failsafe on unavailable member). Choices are enabled and disabled. Examples SetDrGroupFailsafe ( "\\ArrayA2\DrGrpPets", ENABLED ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 145
, see command result values. • OS specifics. None • See resource names and UNC formats. SetDrGroupMaxLogSize Specifies the maximum log disk size for a DR group. HP StorageWorks Replication Solutions Manager 4.0.1 145 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 146
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetDrGroupMaxLogSize ( %drgroup_unc_name%, 0 ) UNC Disk Group Name ( %drgroup_unc_name%). Select or enter the UNC name of the DR group whose maximum log disk size is to be set. Max Size (MB). Enter - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 147
is stopped and the cache memory is written to disk (flushed) Enable Disabled Write caching is started Enable Enabled No change in write cache operation HP StorageWorks Replication Solutions Manager 4.0.1 147 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 148
, and write_cache_disabled. Wait Flag. Select wait or nowait. See jobs wait/no wait argument. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SetHostDiskDeviceWriteCacheMode ( "\\HostA2\/dev/dsk/hd1", WRITE_CACHE_ENABLED, NOWAIT ) SetHostDiskDeviceWriteCacheMode ( "\\HostA2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 149
, and write_cache_disabled. Wait Flag. Select wait or nowait. See jobs wait/no wait argument. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SetHostVolumeGroupWriteCacheMode ( "\\HostA2\/home/vg02", WRITE_CACHE_ENABLED, NOWAIT ) SetHostVolumeGroupWriteCacheMode ( "\\HostA2\/users - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 150
points. Device names can also be used. AIX SetHostVolumeWriteCacheMode ( "\\HostA2\/home/cats", WRITE_CACHE_ENABLED, NOWAIT ) HP-UX SetHostVolumeWriteCacheMode ( "\\HostA2\/users/cats", WRITE_CACHE_ENABLED, NOWAIT ) Linux SetHostVolumeWriteCacheMode ( "\\HostA2\/var/cats", WRITE_CACHE_ENABLED - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 151
also be used. AIX SetHostVolumesWriteCacheMode ( ("\\HostA2\/home/cats", "\\HostA2\/home/ dogs"), WRITE_CACHE_ENABLED, NOWAIT ) HP-UX SetHostVolumesWriteCacheMode ( ("\\HostA2\/users/cats", "\\HostA2\/users/dogs"), WRITE_CACHE_ENABLED, NOWAIT ) Linux SetHostVolumesWriteCacheMode ( ("\\HostA2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 152
assigns mount points on this path. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders Not supported Not supported Not supported Not supported Not supported Not supported SetMountPointsPrefixInRepository ( "\\HostA2\Catalog 20051214.021405", "E:\" ) SetMountPointsPre - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 153
values. • OS specifics. None • An e-mail server is required. • The e-mail message is sent only if the specified condition occurs. Compare with SendEmail HP StorageWorks Replication Solutions Manager 4.0.1 153 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 154
SetOracleModeUsingRepository Specifies the Oracle resources mode. The resources are identified by reference to the repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetOracleModeUsingRepository ( %oraclerepository_unc_name%, %mode% ) - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 155
the write cache mode for the storage volume. Choices are write_cache_enabled, and write_cache_disabled Wait Flag. Select wait or nowait. See jobs wait/no wait argument. HP StorageWorks Replication Solutions Manager 4.0.1 155 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 156
Examples SetStorageVolumesWriteCacheMode ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs"), WRITE_CACHE_ENABLED, NOWAIT ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 157
for Discovery. Select wait or nowait. See jobs wait/nowait argument. Examples These examples show host volume mount points. Device names can also be used. HP StorageWorks Replication Solutions Manager 4.0.1 157 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 158
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders SnapcloneDiskDevice ( "\\HostA2\/home/cats", "\\ArrayA2\DskGrp3", 12, READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/users/cats", "\\ArrayA2\ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 159
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SnapcloneHostDiskDeviceToContainerInManagedSet ( "\\HostA2\/dev/dsk/hd1", "hvol_cats_set", wait/nowait argument. Examples Host volume mount points or device names can be used. HP StorageWorks Replication Solutions Manager 4.0.1 159 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 160
AIX HP-UX OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders SnapcloneHostVolume ( "\\HostA2\/home/cats above. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • Some storage volumes that undelie - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 161
is not applicable to OpenVMS volume sets. Tru64 UNIX. Replication is not supported when an AdvFS domain spans partitions. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. Windows. Windows does not - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 162
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", "hvol_cats_set", NOWAIT ) - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 163
result values. • OS specifics. Yes. See examples above. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • Some storage volumes that underlie a host volume cannot be copied using snapclone replication - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 164
home/cats", "hvol_cats_set", WAIT ) HP-UX SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats above. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • The command initially treats the - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 165
Replicate tablespaces and archived redo logs in the repository oracle_archive_log_file Replicate archived redo log files in the repository oracle_tablespace Replicate tablespaces in the repository HP StorageWorks Replication Solutions Manager 4.0.1 165 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 166
Wait Flag. Select wait or nowait. See jobs wait/nowait argument. Examples SnapcloneOracleUsingRepository ( "\\HostA2\Catalog 20051214.021405", SAME, WAIT ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 167
/nowait argument. Examples SnapcloneStorageVolumesToContainers ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs"), ("\\ArrayA2\CatsContainer", "\\ArrayA2\DogsContainer"), NOWAIT ) SnapcloneStorageVolumesToContainers ( $my_svol_list, $cont_list, NOWAIT ) HP StorageWorks Replication Solutions Manager 4.0.1 167 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 168
Comments • Associated validation commands. ValidateSnapcloneStorageVolume • Agent and license prerequisites. Requires a local replication license for the storage systems on which the storage volumes are located. • Command result value. List of snapclone storage volume names (UNC). For a complete - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 169
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders SnapshotDiskDevice ( "\\HostA2\/home/cats", DEMAND_ALLOCATED, SAME, "Cats_copy type is fully_allocated. Wait Flag. Select wait or nowait. See jobs wait/nowait argument. HP StorageWorks Replication Solutions Manager 4.0.1 169 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 170
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SnapshotHostDiskDeviceToContainerInManagedSet ( "\\HostA2\/dev/dsk/hd1", "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( "\\HostA2\/dev/dsk/c2t0d2", "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 171
result values. • OS specifics. Yes. See examples above. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • Some storage volumes that underlie a host volume cannot be copied using snapshot replication - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 172
is not applicable to OpenVMS volume sets. Tru64 UNIX. Replication is not supported when an AdvFS domain spans partitions. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. Windows. Windows does not - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 173
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", FULLY_ALLOCATED examples show host volume mount points. Device names can also be used. HP StorageWorks Replication Solutions Manager 4.0.1 173 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 174
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders SnapshotHostVolumeToContainers ( "\\ above. Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • Some storage volumes that underlie - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 175
\/home/cats", "hvol_cats_set", WAIT ) HP-UX SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", . Tru64 UNIX. When this command is used with AdvFS volumes that have heavy I/O, HP recommends briefly suspending the I/O before the replication step. • Some storage volumes that underlie - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 176
Tablespaces or Archived Logs. Select the resources to replicate. Choices are: Value Remarks all Replicate tablespaces and archived redo logs in the repository oracle_archive_log_file Replicate archived redo logs in the repository oracle_tablespace Replicate tablespaces in the repository Wait - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 177
cannot be copied using snapshot replication. • See resource names and UNC formats. SnapshotStorageVolumeToContainer Creates a preallocated snapshot (point-in-time copy, using a container) of a storage volume. HP StorageWorks Replication Solutions Manager 4.0.1 177 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 178
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotStorageVolumeToContainer ( %storvol_unc_name%, %container_unc_name%, DEMAND_ALLOCATED, NOWAIT ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 179
% ) Name of Job History (%jobhistory_name%). Select the job instance to be checked. Desired State (%desired_state%). Select the job instance state to check for. States are: HP StorageWorks Replication Solutions Manager 4.0.1 179 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 180
result values. • OS specifics. None. UnmountEntireVolumeGroup Instructs an enabled host to unmount all of the logical to be unmounted. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 181
of the mount point or driver letter to unmount. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders Yes. See examples above. • See resource names and UNC formats. UnmountHostVolumes Instructs enabled hosts to unmount host volumes. The host OS removes host volume mount - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 182
Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) UnmountHostVolumes ( ( "\\HostA2\/var", "\\ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 183
and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS specifics. None • See resource names and UNC formats. HP StorageWorks Replication Solutions Manager 4.0.1 183 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 184
ValidateHost Checks if an enabled host is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 185
used. AIX ValidateHostVolumeDoesNotExist ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolumeDoesNotExist ( "\\HostA2\/users/cats" ) Linux pets\cats" ) Comments • Agent and license prerequisites. Requires a host agent. HP StorageWorks Replication Solutions Manager 4.0.1 185 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 186
. AIX ValidateHostVolumeGroup ( "\\HostA2\/home/cats_vg" ) HP-UX ValidateHostVolumeGroup ( "\\HostA2\/users/cats_vg" ) Linux OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • See resource - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 187
volume mount points. Device names can also be used. AIX ValidateHostVolumeMirrorclones ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolumeMirrorclones ( "\\HostA2\/users/cats" ) Linux ValidateHostVolumeMirrorclones ( "\\HostA2\/var/cats" ) OpenVMS ValidateHostVolumeMirrorclones ( "\\HostA2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 188
ValidateOracleTablespaces Checks if an Oracle tablespace is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops. Syntax and arguments When initially inserted into a job, the command syntax and - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 189
be used. AIX ValidateSnapcloneHostVolumeGroup ( "\\HostA2\/home/vg02" ) HP-UX ValidateSnapcloneHostVolumeGroup ( "\\HostA2\/users/vg02" ) Linux ValidateSnapcloneHostVolumeGroup • Agent and license prerequisites. Requires a host agent. HP StorageWorks Replication Solutions Manager 4.0.1 189 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 190
volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • See resource names and UNC formats. ValidateSnapcloneStorageVolume Checks if a storage volume is an available resource and that it can be replicated using the - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 191
%). Select or enter the UNC name of the host volume group to be validated. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows ValidateSnapshotHostVolumeGroup ( "\\HostA2\/home/vg02" ) ValidateSnapshotHostVolumeGroup ( "\\HostA2\/users/vg02" ) ValidateSnapshotHostVolumeGroup - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 192
volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • See resource names and UNC formats. ValidateSnapshotStorageVolume Checks if a storage volume is an available resource and that it can be replicated using the - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 193
", "\\Array2\Dogs") ) ValidateStorageVolumes ( $my_svol_list ) Comments • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS specifics. None HP StorageWorks Replication Solutions Manager 4.0.1 193 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 194
• See resource names and UNC formats. Wait Halts a job for a period of time. When the time has elapsed, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: Wait ( "0:0:10" ) Timespan. Enter the amount of time to - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 195
device to check for completion of a write-cache flush. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows WaitForHostDiskDeviceWriteCacheFlush ( "\\HostA2\/dev/dsk/hd1 " ) WaitForHostDiskDeviceWriteCacheFlush ( "\HostA2\Disk3" ) HP StorageWorks Replication Solutions Manager 4.0.1 195 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 196
%). Select or enter the UNC name of the host volume group to check for completion of a write-cache flush. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows WaitForHostVolumeGroupWriteCacheFlush ( "\\HostA2\/home/cats_vg" ) WaitForHostVolumeGroupWriteCacheFlush ( "\\HostA2\/users/cats_vg - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 197
mount points or device names can be used. AIX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/home/cats" ) HP-UX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/users/cats" ) Linux WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/var/cats" ) OpenVMS WaitForHostVolumeWriteCacheFlush ( "\\HostA2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 198
AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows Drive Drive & folders WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/var", "\\ - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 199
replicas that have been created within the same job using the nowait argument. See use with the nowait argument. • See resource names and UNC formats. HP StorageWorks Replication Solutions Manager 4.0.1 199 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 200
WaitForStorageVolumeWriteCacheFlush Halts a job until the write cache of the storage volume has been flushed. When the write cache has been flushed, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 201
Device Name (%hoststorvol_unc_name%). Select or enter the UNC name of the host disk device to check for normalization. Examples AIX HP-UX Linux OpenVMS Solaris Tru64 UNIX Windows WaitHostDiskDeviceNormalization ( "\\HostA2\/dev/dsk/hd1" ) WaitHostDiskDeviceNormalization ( "\\HostA2\/dev/dsk/c2t0d2 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 202
show host volume mount points. Device names can also be used. AIX WaitHostVolumeNormalization ( "\\HostA2\/home/cats" ) HP-UX WaitHostVolumeNormalization ( "\\HostA2\/users/cats" ) Linux WaitHostVolumeNormalization ( "\\HostA2\/var/cats" ) OpenVMS WaitHostVolumeNormalization ( "\\HostA2\CATS - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 203
format is year/month/day and hour:minute:second ( [yyyy/MM/dd] HH:mm:ss ). You can omit a date and specify a time of day only. HP StorageWorks Replication Solutions Manager 4.0.1 203 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 204
can result in job failures due to timing issues. For example, HP does not recommend using WaitUntil before replication steps because storage resources that replication operations are performed, resulting in a job failure. • HP recommends using WaitUntil after replication steps and preferably at or - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 205
OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • See resource names and UNC formats. HP StorageWorks Replication Solutions Manager 4.0.1 205 - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 206
206 Job concepts, templates and commands - HP 418800-B21 | HP StorageWorks Replication Solutions Manager 4.0.1 job command - Page 207
UNC formats, 201 S Subscriber's Choice, HP, 11 T technical support HP, 10 service locator website, 11 templates, job list, 30 throttling i/o template, 82 W web sites product manuals, 9 websites HP , 11 HP Subscriber's Choice for Business, 11 HP StorageWorks Replication Solutions Manager 4.0.1 207
HP StorageWorks Replication Solutions
Manager 4.0.1
job command reference
Part number: T3680-96306
Fourth edition: June 2008