Page 1 HP StorageWorks Replication Solutions Manager 4.0.1 job command reference Part number: T3680-96306 Fourth edition: June 2008...
Page 2 Legal and notice information © Copyright 2007-2008 Hewlett-Packard Development Company, L.P. Conﬁdential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.21 1 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S.
Page 3: Table Of Contents
Contents About this reference ......Intended audience ........Related documentation .
Page 4 Replicate host volumes, mount to a host (template) ..... Replicate host volumes, mount to a host, then to a different host (template) ... Replicate host volumes via preallocated replication, mount to a host (template) .
Page 5 DiscoveryRefresh (obsolete) ....... 1 15 Exit ......... 1 15 Export .
Page 6 SetVariable ........SetWriteCacheModesUsingRepository .
Page 7 WaitForStorageVolumeWriteCacheFlush ......WaitForStorageVolumesWriteCacheFlush ......WaitForWriteCacheFlushUsingRepository .
Page 8 Tables 1 Document conventions ......
Page 9: About This Reference
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.
Page 10: Document Conventions And Symbols
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 • Keys that are pressed • Text typed into a GUI element, such as a box Bold text •...
Page 11: Subscription Service
• Detailed questions Subscription service HP recommends that you register your product at the Subscriber’s Choice for Business website: http://www.hp.com/go/e-updates After registering, you will receive e-mail notiﬁcation of product enhancements, new driver versions, ﬁrmware updates, and other product resources. HP websites For additional information, see the following HP websites: •...
Page 12 About this reference...
Page 13: Job Concepts, Templates And Commands
1 Job concepts, templates and commands Job concepts Job language overview The job language provides a simple and structured way to automate replication and other storage related tasks. A typical job consists of commands, assignments (variables), branching instructions, labels, comments and exits. Jobs with launch commands often include transactions. See also imported jobs.
Page 14: Job Instances
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 set of specialized job commands.
Page 15: Aborted Job Instances
Aborted job instances In some cases, a job instance may not stop when it is aborted. This can happen if the instance is hung while executing a command to a low level device. When the replication manager server is stopped and restarted, all aborted job instances are cancelled. Arguments Most job commands include arguments.
Page 16: Branches
Usage Assignments are: • Local to each job and cannot be referenced across jobs. • Not case sensitive. Format • The ﬁrst two characters must be a dollar sign ($) followed by an alpha character. No special characters are allowed after the ﬁrst character. •...
Page 17: Command Result Values
R1: $Rep1 = SnapcloneStorageVolume ( "\\Array2\Cats", "", SAME, "", WAIT ) onerror pauseat E1: label ^ ^ assignment branch ^ Command result values Some commands return a result that can be assigned to a variable. The variable can then be referenced in a succeeding step in the job.
Page 18 Job command Command result value (format) DeleteContainer DeleteDrGroup DeleteDrGroupMember DeleteHostVolume DeleteHostVolumeGroup DeleteHostVolumesUsingRepository DeleteOracleRepository DeleteReplicaRepository DeleteStorageVolume DeleteStorageVolumes DeleteStorageVolumesInManagedSet DeleteStorageVolumesUsingRepository DetachMirrorclones DiscoverDiskDevice DiscoverDiskDevices DiscoverDiskDevicesForDrGroup DiscoveryRefresh (obsolete) Exit Export FailoverDrGroup FailoverDrGroups FlushCache ForceFullCopyDrGroup FractureHostDiskDeviceMirrorclone Name of the fractured mirrorclone (UNC) FractureHostVolumeGroupMirrorclones List of fractured mirrorclone names (UNC) FractureHostVolumeMirrorclones List of fractured mirrorclone names (UNC) FractureMirrorclones...
Page 19 Job command Command result value (format) MirrorcloneHostVolumeToContainers MirrorcloneHostVolumeToContainersInManagedSet MirrorcloneStorageVolumeToContainer Mount point name (UNC) MountVolumeGroupComponent Pause PresentStorageVolume PresentStorageVolumes RemoveDiskDevice ResyncMirrorclone ResyncMirrorclones RetainLatestRoundRobinReplicasForHostStorageVolume RetainLatestRoundRobinReplicasForHostVolume RetainLatestRoundRobinReplicasForHostVolumeGroup SendEmail SetDiskGroupForSnapclone SetDrGroupAutoSuspend SetDrGroupComments SetDrGroupDestinationAccess SetDrGroupFailsafe SetDrGroupFailsafeOnLinkDownPowerUp SetDrGroupHome SetDrGroupIoMode SetDrGroupMaxLogSize SetDrGroupName SetDrGroupSuspend SetHostDiskDeviceWriteCacheMode SetHostVolumeGroupWriteCacheMode SetHostVolumeWriteCacheMode SetHostVolumesWriteCacheMode The resources listed in the argument SetListVariable (UNC) SetMountPointsPreﬁxInRepository...
Page 20 Job command Command result value (format) SetVariable The resource in the argument (UNC) SetWriteCacheModesUsingRepository SnapcloneDiskDevice Snapclone storage volume name (UNC) SnapcloneHostDiskDeviceToContainerInManagedSet Snapclone storage volume name (UNC) List of snapclone storage volume names SnapcloneHostVolume (UNC) List of snapclone storage volume names SnapcloneHostVolumeGroup (UNC) List of snapclone storage volume names...
Page 21 Job command Command result value (format) UnmountHostVolumes UnmountHostVolumesUsingRepository UnpresentStorageVolume UnpresentStorageVolumes ValidateHost ValidateHostVolume ValidateHostVolumeDoesNotExist ValidateHostVolumeGroup ValidateHostVolumeMirrorclones ValidateOracleTablespaces ValidateSnapcloneHostVolume ValidateSnapcloneHostVolumeGroup ValidateSnapcloneStorageVolume ValidateSnapshotHostVolume ValidateSnapshotHostVolumeGroup ValidateSnapshotStorageVolume ValidateStorageSystem ValidateStorageVolume ValidateStorageVolumes Wait WaitDrGroupSynchronizationTransition WaitForHostDiskDeviceWriteCacheFlush WaitForHostVolumeGroupWriteCacheFlush WaitForHostVolumeWriteCacheFlush WaitForHostVolumesWriteCacheFlush WaitForJob WaitForStorageVolumeDiscovery WaitForStorageVolumesDiscovery WaitForStorageVolumeWriteCacheFlush WaitForStorageVolumesWriteCacheFlush WaitForWriteCacheFlushUsingRepository WaitHostDiskDeviceNormalization WaitHostVolumeNormalization WaitStorageVolumeNormalization WaitStorageVolumesNormalization WaitUntil WaitVolumeGroupNormalization...
Page 22: Comments
Comments The comment command can be used to add comments to a job. You can also comment-out other commands. See also job comment command. E-mail from jobs A job (each job instance) can send e-mail messages. Job instances can send e-mail messages that you write and they can also send predeﬁned job status notiﬁcation messages.
Page 23 Line Task import note > // This job was imported to RSM from an existing BC job, // which included the following operations: // [line 1] SNAP UNIT Array2 Cats\ACTIVE $BCV1 SNAPCLONE_HSV legacy job start > SAME_AS_SOURCE legacy job end > // [line 5] "we’re done"...
Page 24: Createstoragevolume Deletecontainer
Requires Job command Command Replication host agent category type storage local, ConvertStorageVolumeIntoContainer volume container storage local, ConvertStorageVolumesInManagedSetIntoContainers volume container storage local, ConvertStorageVolumesIntoContainers volume container ConvertStorageVolumesIntoContainersUsingRepository Oracle storage local, CreateContainer volume container host disk local, CreateContainerForHostDiskDevice device container local, CreateContainersForHostVolume host volume container host volume local,...
Page 25 Requires Job command Command Replication host agent category type storage DeleteStorageVolumes volume storage DeleteStorageVolumesInManagedSet volume DeleteStorageVolumesUsingRepository Oracle storage local, DetachMirrorclones volume mirrorclone host disk DiscoverDiskDevice device host disk DiscoverDiskDevices device host disk remote DiscoverDiskDevicesForDrGroup device DiscoveryRefresh< (obsolete) general Exit script ﬂow Export general remote...
Page 26 Requires Job command Command Replication host agent category type host volume local, MirrorcloneHostVolumeGroupToContainersInManagedSet group mirrorclone local, MirrorcloneHostVolumeToContainers host volume mirrorclone local, MirrorcloneHostVolumeToContainersInManagedSet host volume mirrorclone storage local, MirrorcloneStorageVolume volume mirrorclone host volume MountEntireVolumeGroup group MountHostVolume host volume MountHostVolumesUsingRepository Oracle host volume MountVolumeGroupComponent group Pause...
Page 27 Requires Job command Command Replication host agent category type DR group remote SetDrGroupSuspend host disk SetHostDiskDeviceWriteCacheMode device host volume SetHostVolumeGroupWriteCacheMode group SetHostVolumeWriteCacheMode host volume SetHostVolumesWriteCacheMode host volume SetListVariable general SetMountPointsPreﬁxInRepository Oracle SetNotiﬁcationPolicy general SetOracleModeUsingRepository Oracle storage SetStorageVolumeName volume storage SetStorageVolumeWriteCacheMode volume storage SetStorageVolumesWriteCacheMode...
Page 28 Requires Job command Command Replication host agent category type host disk local, SnapshotDiskDevice device snapshot host disk local, SnapshotHostDiskDeviceToContainerInManagedSet device snapshot local, SnapshotHostVolume host volume snapshot host volume local, SnapshotHostVolumeGroup group snapshot host volume local, SnapshotHostVolumeGroupToContainersInManagedSet group snapshot local, SnapshotHostVolumeToContainers host volume snapshot local,...
Page 29 Requires Job command Command Replication host agent category type local, ValidateSnapcloneHostVolume validation snapclone local, ValidateSnapcloneHostVolumeGroup validation snapclone local, ValidateSnapcloneStorageVolume validation snapclone local, ValidateSnapshotHostVolume validation snapshot local, ValidateSnapshotHostVolumeGroup validation snapshot local, ValidateSnapshotStorageVolume validation snapshot ValidateStorageSystem validation ValidateStorageVolume validation ValidateStorageVolumes validation Wait script ﬂow DR group remote...
Page 30: Job Templates List
Job templates list Job templates provide frameworks and guidelines for creating typical jobs. Template name (alphabetical order) Replication Remarks type Empty template Fracture host volumes, mount to a host local requires host agent Instant restore storage volumes to other storage volumes local Mount existing storage volumes requires host agent...
Page 31: Labels
Labels Labels are used in conjunction with branches. See branches. Usage Labels are: • Local to each job and cannot be referenced across jobs. • Not case sensitive. Format • Must be at least two characters and end with a colon. •...
Page 32 CreateDiskDevice ( %storvol_unc_name%, %host_name%, 0, READ_WRITE) When selecting a speciﬁc resource from an Editing Task menu, the resource names are presented in a UNC format, or other format, as appropriate for the resource. If you enter a resource name from the keyboard, you must use the appropriate format.
Page 33: Simultaneous Job Instances
Oracle Name format (UNC) Example \\HostA2\Cats_db \\enabled host\database name Identiﬁes the Oracle database named Cats_db on the enabled host named HostA2 \\HostA2\Catalog 20051218.024153 Identiﬁes the repository named Catalog \\enabled host\repository name 20051218.024153 on the enabled host named HostA2. Storage systems Name format (other) Example ArrayA2...
Page 34: Status And States
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. Job instance states A job instance may have one of the following states.
Page 35: Validation
Line Task Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1: transaction start > DO { $Rep1 = SnapshotStorageVolume ( %array_name_source_storvol_unc1%, transaction end > FULLY_ALLOCATED, SAME, %dest_storvol1%, NOWAIT ) onerror pauseat E1: } ALWAYS { // Resume the host application. Launch ( %source_host%, %resume_command_line%, "", WAIT, "0"...
Page 36: Wait/Nowait Argument
• 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 block: •...
Page 37: Empty Template
Job templates Empty template Template summary Provides a series of comments that outline the basic structure of a job. After generating this template you must add individual job commands to accomplish speciﬁc tasks. Template options • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy.
Page 38 • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy. 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 fracture and mount one host volume on an enabled host. No other template options were selected.
Page 39: Instant Restore Storage Volumes To Other Storage Volumes (Template)
// Wait for user to initiate rollback. Pause () // Rollback. E5: UnmountHostVolume ($MP1) onerror pauseat E5: E4: DeleteHostVolume ($HV1) onerror pauseat E4: E3: UnpresentStorageVolumes ($Rep1, $mount_host) onerror pauseat E3: E2: ResyncMirrorclones ($Rep1) onerror pauseat E2: // Uncomment the following line if you want the job to wait for the mirrors to resynchronize before completing //WaitHostVolumeNormalization($source_hostvol_unc1) Exit (SUCCESS)
Page 40 Example This template was generated to copy (restore) one storage volume. No other template options were selected. Line Task // Synchronize storage volume(s) to other storage volume(s) // Assign some variables that will be used in this job. $source_storvol_unc1 = SetVariable(%source_storvol_unc1%) $dest_storvol_unc1 = SetVariable(%dest_storvol_unc1%) // Validate that resources are as expected.
Page 41: Mount Existing Storage Volumes (Template)
Mount existing storage volumes (template) Template summary Creates a host volume by presenting an existing* storage volume to an enabled host. Mounts the host volume. Pauses the job until continued by a user. After continuing, unmounts and deletes the host volume. * A storage volume that is created by means other than this job.
Page 42: Perform Cascaded Replication (Template)
Line Task // Mount existing storage volume(s). // Assign some variables that will be used in this job. $storvol_unc1 = SetVariable(%storvol_unc1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateStorageVolume ($storvol_unc1) // Mount the volume(s) on a host. $HV1 = CreateHostVolumeDiscrete (%component%, $storvol_unc1, $mount_host) onerror pauseat E1: $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E2: // Wait for user to initiate rollback.
Page 43 Presents the snapclones to a host at site 2. (This is required by some controller software versions before the snapclones can be members of a DR group. Creates a new DR group pair that contains the snapclone copies at site 2. Halts the job (waits) to ensure that the snapclones are remotely replicated to new storage volumes at site 3.
Page 44 // Validate some resources needed by this job: // - The arrays at Sites 1, 2 and 3. // - The source DR group at Site 1 and it’s virtual disk member(s). // - The storage system at Site 2 with the destination DR group and it’s virtual disk member(s). // - The host name at Site 2.
Page 45 // Set the DR group at Site 1 back to asynchronous. SetDrGroupIoMode ($site_1_array_DR_Group_name_unc, ASYNCHRONOUS) onerror continue // Present the snapclone at Site 2 to a host. // NOTE: This is required only for VCS 3.x. For later versions, you may remove this step. // Typically you will NOT want to present to an Enabled Host Agent, but instead // use the name of a ’dummy’...
Page 46: Perform Planned Failover (Template)
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. Stops an application on the enabled host at site 1 (if necessary). Unmounts the host volume on the enabled host at site 1.
Page 47 Line Task // Perform a planned failover of a CA conﬁguration. // Assign some variables that will be used in this job. $site_2_array = SetVariable(%site_2_array%) $site_1_host = SetVariable(%site_1_host% $site_2_host = SetVariable(%site_2_host%) $site_1_host_hostvol_unc = SetVariable(%site_1_host_hostvol_unc%) // Validate that resources are as expected. ValidateHost ($site_1_host) ValidateHost ($site_2_host) ValidateStorageSystem ($site_2_array)
Page 48: Perform Unplanned Failover (Template)
Perform unplanned failover (template) Template summary Performs an unplanned failover of two sites in the case where the source site resources or link is no longer available. The DR group pair contains one storage volume (virtual disk) at the source and destination sites. Performs a failover from site 1 to site 2.
Page 49: Replicate (Via Snapclone) A Host Volume Multiple Times, Mount To A Host (Template)
Line Task // Perform an unplanned failover of a CA conﬁguration. // Since it is ’unplanned’, we do not quiesce or unmount the source volumes. // Assign some variables that will be used in this job. $site_2_array = SetVariable(%site_2_array% $site_2_host = SetVariable(%site_2_host%) // Validate that resources are as expected.
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 interacting with an enabled host, for example, to start a tape backup.
Page 51 Line Task // Make multiple snapclones of the same Host Volume, and mount to a host. // This requires normalization between each snapclone. // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $mount_host1 = SetVariable(%mount_host1%) // Validate that resources are as expected.
Page 52: Replicate Host Disk Devices, Mount To A Host (Template)
Replicate host disk devices, mount to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a raw host volume on an enabled host. Presents the underlying storage volume copies to a second enabled host (creates a new raw host volume).
Page 53: Replicate Host Volume Group, Mount Components To A Host (Template)
Line Task // Replicate host disk device(s), and mount to a host. // Assign some variables that will be used in this job. $source_host = SetVariable(%source_host%) $source_disk_device_unc1 = SetVariable(%source_disk_device_unc1%) $dest_storvol1 = SetVariable(%dest_storvol1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) $Rep1 = SnapshotDiskDevice ($source_disk_device_unc1, FULLY_ALLOCATED, SAME, $dest_storvol1,...
Page 54 By default, mounts the components (logical volumes) in the new host volume group on the second enabled host. Optionally, use raw disk I/O (do not mount the replicated components). Pauses the job. After continuing, unmounts the new volume group components from the second enabled host, unpresents and deletes the storage volume copies from the storage system.
Page 55 Line Task // Replicate a host volume group, and mount component(s) to a host. // Assign some variables that will be used in this job. $source_VolumeGroup_unc1 = SetVariable(%source_VolumeGroup_unc1% $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host% $source_VG_component_unc1 = SetVariable(%source_VG_component_unc1% // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateSnapshotHostVolumeGroup ($source_VolumeGroup_unc1)
Page 56: Replicate Host Volume Group, Mount Entire Group To A Host (Template)
Replicate host volume group, mount entire group to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume group on an enabled host. Presents the underlying storage volume copies to a second enabled host (creates a new host volume group).
Page 57 Line Task // Replicate host volume group(s), and mount to a host. // Assign some variables that will be used in this job. $source_VolumeGroup_unc1 = SetVariable(%source_VolumeGroup_unc1%) $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateSnapshotHostVolumeGroup ($source_VolumeGroup_unc1) $Rep1 = SnapshotHostVolumeGroup ($source_VolumeGroup_unc1, FULLY_ALLOCATED, SAME, WAIT)
Page 58: Replicate Host Volumes (Template)
Replicate host volumes (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host. Pauses the job. After continuing, deletes the storage volume copies from the storage system. Template Options • Number of volumes to replicate. Adds commands for each volume. •...
Page 59: Replicate Host Volumes, Mount To A Host (Template)
Line Task // Replicate host volume(s). // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host%) // Validate that resources are as expected. ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1) $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror pauseat E1: // Wait for user to initiate rollback.
Page 60 • Use snapclone instead of snapshot. Generates a template that uses snapclone replication. • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy. Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication.
Page 61 Line Task // Replicate host volume(s), and mount to a host. // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1) $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror...
Page 62: Replicate Host Volumes, Mount To A Host, Then To A Different Host (Template)
Replicate host volumes, mount to a host, then to a different host (template) Template summary Involves ﬁve enabled hosts, EH1 through EH5*. Locally replicates (copies) the storage volumes that underlie a host volume on an EH1. Presents the underlying storage volume copies to EH2 (creates a new host volume). Mounts the new host volume on EH2, launches a backup process on EH3, and waits for the process to complete.
Page 63 ValidateHost ($mount_host1) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1 $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror pauseat E1: // Mount the replicated volume(s) on a host. PresentStorageVolumes ($Rep1, $mount_host1) onerror pauseat E2: DiscoverDiskDevices ($mount_host1, $Rep1) onerror continue $HV1 = CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host1) onerror pauseat E2: $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E5: // Launch a backup process on a host.
Page 64: Replicate Host Volumes Via Preallocated Replication, Mount To A Host (Template)
Exit (SUCCESS // Failure exit - no rollback needed. E1: Exit (FAILURE Replicate host volumes via preallocated replication, mount to a host (template) Template summary Disables (ﬂushes) the write cache of the storage volumes that underlie a host volume on an enabled host.
Page 65 // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host% $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1 // Begin ﬂushing the cache on the host volume(s). SetHostVolumeWriteCacheMode ($source_hostvol_unc1, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache ﬂush to complete.
Page 66: Replicate Host Volume, Mount Components To A Host (Template)
// Rollback. E4: UnmountHostVolume ($MP1) onerror pauseat E4: E3: DeleteHostVolume ($HV1) onerror pauseat E3: E2: DeleteStorageVolumesInManagedSet (%dest_container_set1%) onerror pauseat E2: Exit (SUCCESS) // Failure exit - no rollback needed. E1: Exit (FAILURE) Replicate host volume, mount components to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host.
Page 67 Line Task // Replicate a host volume, and mount slices/partitions/LVs to a host. // Assign some variables that will be used in this job. $mount_host = SetVariable(%mount_host%) $source_host = SetVariable(%source_host%) $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1)
Page 68: Replicate Raw Storage Volumes Mount (Raw) To A Host (Template)
Replicate raw storage volumes mount (raw) to a host (template) Template summary Locally replicates (copies) raw storage volumes. Presents the storage volume copies to an enabled host (creates a raw host volume). Pauses the job. After continuing, removes the raw host volume from the enabled host. Unpresents and deletes the storage volume copy from the storage system.
Page 69: Replicate Storage Volumes (Template)
Line Task // Replicate raw storage volume(s), and mount to a host. // Assign some variables that will be used in this job. $source_storvol_unc1 = SetVariable(%source_storvol_unc1%) $dest_storvol1 = SetVariable(%dest_storvol1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateStorageVolume ($source_storvol_unc1) ValidateSnapshotStorageVolume ($source_storvol_unc1) $Rep1 = SnapshotStorageVolume ($source_storvol_unc1, FULLY_ALLOCATED, SAME, $dest_storvol1,...
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 uses snapclone replication. •...
Page 71: Replicate Storage Volumes Via Preallocated Replication (Template)
Replicate storage volumes via preallocated replication (template) Template summary Disables (ﬂushes) the write cache of a storage volume. Locally replicates (copies) the storage volume to a container. Re-enables the write cache of the storage volume. NOTE: This template cannot be used with some older versions of controller software. Template options •...
Page 72 Line Task // Replicate storage volume(s) via pre-allocated replication. // Assign some variables that will be used in this job. $source_storvol_list = SetListVariable(%source_storvol_list%) $dest_container_list = SetListVariable(%dest_container_list%) // Validate that resources are as expected. ValidateStorageVolumes ($source_storvol_list) // Begin ﬂushing the cache on the storage volume(s). SetStorageVolumesWriteCacheMode ($source_storvol_list, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache ﬂush to complete.
Page 73: Replicate Oracle Tablespaces (Template)
Replicate Oracle tablespaces (template) Template summary Create a repository that contains the desired database components. Quiesce the Oracle database by putting it in ‘hot backup’ mode. Replicate the tablespace(s). Put the database back into normal operating mode. Pause. Delete the storage volume(s). Delete the repository.
Page 74: Replicate Oracle Tablespaces, Mount To A Host (Template)
SetOracleModeUsingRepository ($repository, TSONLINE) // NOTE: Please remove the archive log ﬁle Switch, Add, and Snap commands below if this job is not backing up archive log ﬁles // Force a log switch to get the most current archive logs. SwitchOracleArchiveLogFilesUsingRepository ( $repository ) onerror pauseat E3: // OPTION: Add the archive logs AddOracleArchiveLogFilesToRepository($repository) onerror pauseat E3: // Replicate the items in the repository.
Page 75 Template options • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. • Use snapclone instead of snapshot. Generates a template that uses snapclone replication. • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy.
Page 76: Replicate Oracle Tablespaces Via Preallocatted Replication, Mount To A Host (Template)
// OPTION: Add the archive logs AddOracleArchiveLogFilesToRepository($repository) onerror pauseat E3: // Replicate the items in the repository. SnapshotOracleUsingRepository ($repository, FULLY_ALLOCATED, SAME, ORA- CLE_ARCHIVE_LOG_FILE, NOWAIT) onerror pauseat E3: // Mount the replicated volume(s) on a host. CreateHostVolumesUsingRepository ($repository, $mount_host) onerror pauseat E3: SetMountPointsPreﬁxInRepository ($repository, %preﬁx%) onerror pauseat E4: $MountedHVs = MountHostVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E4: // Wait for user to initiate rollback.
Page 77 Delete the repository. NOTE: This template cannot be used with some older versions of controller software. Template options • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. •...
Page 78 } ALWAYS { // Put the database back into normal mode. SetOracleModeUsingRepository ($repository, TSONLINE) // Restore the writeback cache on the host volume(s). SetWriteCacheModesUsingRepository ($repository, ORIGINAL, ORACLE_TABLESPACE, WRITE_CACHE_ENABLED) // NOTE: Please remove the archive log ﬁle Switch, Add, and Snap commands below if this job is not backing up archive log ﬁles.
Page 79: Restore Oracle Tablespaces (Template)
E3: DeleteStorageVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E3: // Delete the repository. E2: DeleteOracleRepository ($repository) onerror pauseat E2: Exit (SUCCESS // Failure exit - no rollback needed. E1: Exit (FAILURE) Restore Oracle tablespaces (template) Template Summary Restores Oracle tablespaces to an enabled host. Use existing repository from previous backup.
Page 80: Setup Continuous Access (Remote Replication Template)
Line Task // Restore Oracle tablespace(s) using repository. // Assign some variables that will be used in this job. $repository = SetVariable(%repository_name%) $mount_host = SetVariable(%mount_host%) // Mount the replicated volume(s) on a host. CreateHostVolumesUsingRepository ($repository, $mount_host) onerror pauseat E1: SetMountPointsPreﬁxInRepository ($repository, %preﬁx%) onerror pauseat E2: $MountedHVs = MountHostVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E2: // Keep the items created by this job.
Page 81 Example This template was generated to create one DR group pair. Line Task // Setup Continuous Access. // Assign some variables that will be used in this job. $DR_source_array = SetVariable(%DR_source_array%) $DR_dest_array = SetVariable(%DR_dest_array%) $DR_group_name = SetVariable(%DR_group_name%) $DR_source_storvol_unc1 = SetVariable(%DR_source_storvol_unc1%) $dest_host_name = SetVariable(%dest_host_name%) // Validate that resources are as expected.
Page 82: Throttle Replication I/O (Remote Replication Template)
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 group pairs have normalized across the two sites.
Page 83: Unmount And Delete Existing Host Volumes (Template)
Line Task // Throttle replication I/O on non-critical DR groups, // so that critical DR groups will have the best performance. // Assign some variables that will be used in this job. $DR_Group_name_unc1 = SetVariable(%DR_Group_name_unc1%) // Suspend the non-critical DR group(s). SetDrGroupSuspend ($DR_Group_name_unc1, SUSPENDED) onerror pauseat E1: // Wait for the critical DR group(s) to normalize.
Page 84: Unmount Existing Host Volumes (Template)
Line Task // Unmount and delete the host volume(s). // Assign some variables that will be used in this job. $hostvol_unc1 = SetVariable(%hostvol_unc1%) $host_name = SetVariable(%host_name%) // Validate that resources are as expected. ValidateHost ($host_name) ValidateHostVolume ($hostvol_unc1) E1: UnmountHostVolume ($hostvol_unc1) E2: DeleteHostVolume ($hostvol_unc1) Exit (SUCCESS) Unmount existing host volumes (template)
Page 85: Job Commands
Line Task // Unmount existing host volume(s). // Assign some variables that will be used in this job. $hostvol_unc1 = SetVariable(%hostvol_unc1%) $host_name = SetVariable(%host_name%) // Validate that resources are as expected. ValidateHost ($host_name) ValidateHostVolume ($hostvol_unc1) // Unmount the volume(s). E1: UnmountHostVolume ($hostvol_unc1) Exit (SUCCESS) Job commands // (comment)
Page 86: Adddrgroupmember
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 tablespaces are to be added. Examples AddAllOracleTablespacesToRepository ( "\\HostA2\Catalog 20051214.021405"...
Page 87: Addoraclearchivelogfilestorepository
• Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • The maximum number of virtual disks per DR group is controller software dependent. •...
Page 88: Addreplicatoreplicarepository
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 speciﬁcs. None • The repository must already exist or be created by a previous step in the same job. •...
Page 89: Combinelists
Examples AddReplicasToReplicaRepository ( “RR-20070223.015320.588”, ("\\Array2\Cats1", "\\Array2\Cats2", "\\Array3\Cats3") ) AddReplicasToReplicaRepository ( “RR-20070223.015320.588”, $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolume, ValidateStorageVolumes. • Agent and license prerequisites. Requires a host agent. • Command result value. None . For a complete list, see command result values.
Page 90: Convertstoragevolumesinmanagedsetintocontainers
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 speciﬁcs. None • This command cannot be used with some older versions of controller software. •...
Page 91: Convertstoragevolumesintocontainersusingrepository
Examples ConvertStorageVolumesIntoContainers ( ("\\Array2\Cats", "\\Array2\Dogs") ) ConvertStorageVolumesIntoContainers ( $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. List of container names (UNC). For a complete list, see command result values. • Command result value.
Page 92: Createcontainerforhostdiskdevice
CreateContainer ( %storvol_name%, %size%, RAID0, %diskgroup_unc_name% ) Container Name (%storvol_name%). Enter a name for the container that is to be created. Size (GB). Enter a size (GB) for the container. Raid Level. Select a redundancy level for the container. UNC Disk Group Name. Select or enter the UNC name of the disk group in which the container is to be created.
Page 93: Createcontainersforhostvolume
• Command result value. Name of managed set of containers. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats. CreateContainersForHostVolume Creates a managed set of storage containers that correspond to the virtual disks that underlie a host volume.
Page 94 CreateContainersForHostVolumeGroup ( %hostvolgroup_unc_name%, %managed_set_name% ) UNC Host Volume Group Name (%hostvolgroup_unc_name%). Select or enter the UNC name of the host volume group for which the storage containers are to be created. Managed Set Name (%managed_set_name%). Select or enter a name for the managed set in which the storage containers are to be added.
Page 95: Createdrgroup
Comments • Associated validation commands. ValidateHost, ValidateStorageVolume • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • resource names and UNC formats. • This command may also cause other devices to appear on the host when its bus is scanned.
Page 96: Createdrgroupfromhostvolume
• 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 speciﬁed in the CreateDrGroup command. These properties can be changed later, in another job, by using the commands shown. Default values Property Source...
Page 97 Destination Storage System Name (%dest_storsys_name%). Select or enter the name of destination storage system on which the destination DR group will be created. Destination Disk Group. Select or enter the name of the disk group on the destination storage system in which the destination storage volume (remote copy) will be created.
Page 98: Createhostvolume
• Values for the following properties can be speciﬁed 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 False (disabled) False (disabled) SetDrGroupAutoSuspend down mode...
Page 99: Createhostvolumediscrete
Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**). $Rep1=SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) ** CreateHostVolume ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) ** HP-UX CreateHostVolume ( "\\HostA2\/users/cats", $Rep1, "HostA4"...
Page 100: Createhostvolumefromdiskdevices
Storage Volume UNC Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume that underlies the host volume. Target Host (%target_host%). Select or enter the name of the enabled host to which the storage volume is to be presented. Examples CreateHostVolumeDiscrete ( "1", "\\ArrayA2\Cats", "HostA4"...
Page 101: Createhostvolumegroup
Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**). $Rep1=SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) ** CreateHostVolumeFromDiskDevices ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) ** HP-UX CreateHostVolumeFromDiskDevices ( "\\HostA2\/users/cats", $Rep1, "HostA4"...
Page 102: Createhostvolumesusingrepository
Target Host (%target_host%). Select or enter the name or IP address of the enabled host on which the host volume is to be created. Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**).
Page 103: Createoraclerepository
Target Host (%target_host%). Select or enter the name or IP address of the enabled host on which the host volumes are to be created. Examples CreateHostVolumesUsingRepository ( "\\HostA2\Catalog 20051214.021405", "HostA2" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 104: Createreplicarepository
UNC Oracle Repository Name (%oraclerepository_unc_name% ). Select or enter the UNC name of the repository whose ﬁles are to be restored. Examples CreateRestoredHostVolumesUsingRepository ( "\\HostA2\Catalog 20051214.021405" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 105: Createstoragevolume
CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/home/cats”, INSTANT_RESTORE, "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/users/cats”, INSTANT_RESTORE, HP-UX "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/var/cats”, INSTANT_RESTORE, Linux "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\CATS:”, INSTANT_RESTORE, OpenVMS "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/usr/cats”, INSTANT_RESTORE, Solaris "Replica of Cats"...
Page 106: Deletecontainer
• Command result value. Storage volume (virtual disk) name (UNC). For a complete list, see command result values. • OS speciﬁcs. None. • Virtual disks can only be created at the root level of the array. • resource names and UNC formats.
Page 107: Deletedrgroupmember
Comments • Associated validation commands. ValidateStorageSystem • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • 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.
Page 108: Deletehostvolumegroup
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteHostVolume ( %hostvol_unc_name% ) UNC Host volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume (on an enabled host) to be deleted. Examples These examples show host volume mount points.
Page 109: Deletehostvolumesusingrepository
DeleteHostVolumeGroup ( "\\HostA2\/home/vg02" ) HP-UX DeleteHostVolumeGroup ( "\\HostA2\/users/vg02" ) Linux DeleteHostVolumeGroup ( "\\HostA2\/var/vg02" ) OpenVMS Not applicable Solaris DeleteHostVolumeGroup ( "\\HostA2\/usr/vg02" ) Tru64 UNIX DeleteHostVolumeGroup ( "\\HostA2\dom01" ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup • Agent and license prerequisites. Requires a host agent. •...
Page 110: Deleteoraclerepository
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 of the Oracle repository to delete. Examples DeleteOracleRepository ( "\\HostA2\Catalog 20051214.021405"...
Page 111: Deletestoragevolumes
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteStorageVolume ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume to be deleted. Examples DeleteStorageVolume ( "\\ArrayA2\Cats" ) Comments Associated validation commands.
Page 112: Deletestoragevolumesusingrepository
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. ValidateStorageVolume • Agent and license prerequisites. None •...
Page 113: Discoverdiskdevice
Mirrorclone UNC Storage Volume Names (%mirrorclone_unc_names%). Select or enter the UNC names of the mirrorclone storage volumes (not the source storage volumes) to be fractured. See argument list. Or, select a variable used in a prior step that represents the mirrorclones. Examples DetachMirrorclones ( ("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars") ) DetachMirrorclones ( $my_svol_list )
Page 114: Discoverdiskdevicesfordrgroup
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 discovered.
Page 115: Discoveryrefresh (Obsolete)
DiscoveryRefresh (obsolete) NOTE: This command is obsolete. See comments below for details. The command causes the replication manager to check its database for available resources. The command was previously used to ensure that resource properties from the database are used in conjunction with job commands, rather than using properties from the server cache memory, which might not have been up to date.
Page 116: Export
Comments • Associated validation command. None • Agent and license prerequisites. None • Command result values. None. For a complete list, see command result values. • OS speciﬁcs. None Export Exports the RSM database. This feature allows administrators to create a copy of the active RSM database.
Page 117: Flushcache
Examples FailoverDrGroup ( "\\ArrayB2\DrGrpPets", FALSE ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values.
Page 118: Forcefullcopydrgroup
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: FlushCache ( %hostvol_unc_names% ) Host Volume UNC Names (%hostvol_unc_names%). Select or enter the UNC names of the host volumes (on an enabled host) whose caches are to be ﬂushed. Examples These examples show host volume mount points.
Page 119: Fracturehostdiskdevicemirrorclone
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • resource names and UNC formats. FractureHostDiskDeviceMirrorclone Fractures the mirrorclone of storage volumes that underlie a host disk device. The host disk device must consist of storage volumes that have mirrorclones.
Page 120: Fracturehostvolumemirrorclones
Examples FractureHostVolumeGroupMirrorclones ( "\\HostA2\/home/cats_vg", WAIT ) HP-UX FractureHostVolumeGroupMirrorclones ( "\\HostA2\/users/cats_vg", WAIT ) Linux FractureHostVolumeGroupMirrorclones ("\\HostA2\/var/cats_vg", WAIT ) OpenVMS Not applicable Solaris FractureHostVolumeGroupMirrorclones ( "\\HostA2\/usr/cats_vg", WAIT ) Tru64 UNIX FractureHostVolumeGroupMirrorclones ( "\\HostA2\dom01#fset1", WAIT ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup. •...
Page 121: Fracturemirrorclones
Comments • Associated validation commands. ValidateHostVolumeMirrorclones. • Agent and license prerequisites. Requires a host agent. Requires a local replication license for the storage systems on which the underlying storage volumes are located. • Command result value. List of fractured mirrorclone names. For a complete list, see command result values.
Page 122: Instantrestorefrommirror
Import ( %full_ﬁle_name% ) Full path name. Enter the full path and ﬁle name of the RSM database copy to import. Examples Import ( "C:\colorado\RSMdb_on_server2_Mar_15_2007.xml") Import ( "C:\colorado\CADATA_2005021 1 135232.export" ) Comments • Associated validation commands. None • Agent and license prerequisites. None •...
Page 123: Instantrestorefromsnapshot
InstantRestoreFromSnapshot Replaces the data on a storage volume by copying data from one of its snapshots. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: InstantRestoreFromSnapshot ( %snapshot_unc_name%, %source_storvol_unc_name%, %wait_nowait% ) UNC Snapshot Storage Volume Name (%storvol_unc_name%). Select or enter the name of one of its snapshots to restore from.
Page 124: Launchjob
Examples Launch ( "HostA2", "/home/zap_application.sh", "", WAIT, "0" ) HP-UX Launch ( "HostA2", "/users/zap_application.sh", "", WAIT, "0" ) Linux Launch ( "HostA2", "/var/zap_application.sh", "", WAIT, "0" ) OpenVMS Launch ( "HostA2", "CATS.ZAP_APPLICATION.COM", "", WAIT, "0" ) Solaris Launch ( "HostA2", "/usr/zap_application.sh", "", WAIT, "0" ) Tru64 UNIX Launch ( "HostA2", "/var/zap_application.sh", "", WAIT, "0"...
Page 125: Log
• OS speciﬁcs. None. Sends a message from the job to the job event log. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: Log ( %message% ) Message ( %message% ). Enter the message that you want to send to the job log. Examples Log ( "Snapshot of sales database has ﬁnished"...
Page 126: Mirrorclonehostdiskdevicetocontainerinmanagedset
Examples MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/dsk/hd1”, "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer (“\\HostA2\/dev/dsk/c2t0d2”, HP-UX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/sda3”, "\\ArrayA2\CatsCon- Linux tainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\$1$DGA2:”, "\\ArrayA2\CatsCon- OpenVMS tainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\Disk3”, "\\ArrayA2\CatsCon- Windows...
Page 127: Mirrorclonehostvolumegrouptocontainers
Examples MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\HostA2\Disk3”, "hvol_cats_set", Windows...
Page 128: Mirrorclonehostvolumegrouptocontainersinmanagedset
Examples MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/home/cats_vg", "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/users/cats_vg", HP-UX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/var/cats_vg", Linux "\\ArrayA2\CatsContainer", WAIT ) OpenVMS Not applicable MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/usr/cats_vg", Solaris "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\dom01#fset1", Tru64 UNIX "\\ArrayA2\CatsContainer", WAIT ) Windows Not applicable Comments •...
Page 129: Mirrorclonehostvolumetocontainers
Examples MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", WAIT ) OpenVMS Not applicable MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\dom01#fset1", Tru64 UNIX "hvol_cats_set", WAIT ) Windows Not applicable Comments •...
Page 130: Mirrorclonehostvolumetocontainersinmanagedset
MirrorcloneHostVolumeToContainers ( "\\HostA2\/home/cats", ("\\ArrayA2\CatsCon- tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- HP-UX tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/var/cats", ("\\ArrayA2\CatsCon- Linux tainer", WAIT ) OpenVMS MirrorcloneHostVolumeToContainers ( "\\HostA2\CATS", "\\Array2\Cats", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/usr/cats", ("\\ArrayA2\CatsCon- Solaris tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- Tru64 UNIX tainer", WAIT ) Windows...
Page 131: Mirrorclonestoragevolumetocontainer
MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", Tru64 UNIX "hvol_cats_set", WAIT ) Windows MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\E:\", "hvol_cats_set", Drive...
Page 132: Mountentirevolumegroup
• Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volume is located. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None. MountEntireVolumeGroup Instructs an enabled host to mount all of the replica logical volumes in a replica volume group, as appropriate.
Page 133: Mounthostvolume
Linux. You cannot mount a volume 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 a volume group replica on the same host as the source volume group. Tru64 UNIX.
Page 134: Mountvolumegroupcomponent
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: MountHostVolumesUsingRepository ( %oraclerepository_unc_name%, %original_replicated% ) UNC Oracle repository (%oraclerepository_unc_name% ). Select or enter the UNC name of the repository whose host volumes are to be mounted. Original or Replicated (%original_replicated% ).
Page 135: Pause
Examples MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/home/pets" ) HP-UX MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/users/pets" ) Linux MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/var/pets" ) OpenVMS Not applicable Solaris MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/usr/pets" ) MountVolumeGroupComponent ( "dom01_RV1", "\\HostA2\dom01", Tru64 UNIX "\\HostA2\dom01#fset1", "/usr/pets"...
Page 136: Presentstoragevolumes
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 presentation you want to begin. Host_Name (%host_name%).
Page 137: Removediskdevice
Comments • Associated validation commands. ValidateHost, ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • Each storage volume is automatically assigned the next available LUN on the host. The access type defaults to read_write.
Page 138: Resyncmirrorclones
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 source storage volume. Examples ResyncMirrorclone ( "\\Array2\Cats_copy"...
Page 139: Retainlatestroundrobinreplicasforhostvolume
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: RetainLatestRoundRobinReplicasForHostStorageVolume ( %source_hoststoragevol_unc_name%, 7 ) Source Host Storage Volume UNC Name (%source_hoststoragevol_unc_name%). Select or enter the UNC name of the host disk device to be replicated in a round robin job. Number of Copies.
Page 140: Retainlatestroundrobinreplicasforhostvolumegroup
Examples RetainLatestRoundRobinReplicasForHostVolume ( "\\HostA2\/home/cats_vg", 3 ) HP-UX RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/users/cats”, 3 ) Linux RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/var/cats”, 3 ) OpenVMS RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\CATS:”, 3 ) Solaris RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/usr/cats”, 3 ) Tru64 UNIX RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/dom01#set1”, 3 ) Windows Drive RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\E:\”, 3 ) Drive &...
Page 141: Sendemail
Comments • Associated validation commands. ValidateHostVolumeGroup. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 142: Setdrgroupautosuspend
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 speciﬁcs.
Page 143: Setdrgroupdestinationaccess
Comments. Enter your comment text. Examples SetDrGroupComments ( "\\ArrayA2\DrGroupPets","Replicates between SiteA and SiteB" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values.
Page 144: Setdrgroupfailsafeonlinkdownpowerup
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 on the source and destination storage systems.
Page 145: Setdrgroupiomode
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetDrGroupHome ( %drgroup_unc_name%, FALSE ) UNC DR Group Name (%drgroup_unc_name%). Select or enter the UNC name of the DR group to be changed. Is Home. Select or enter the home ﬂag. Choices are true and false. Examples SetDrGroupHome ( "\\ArrayA2\DrGrpPets", TRUE ) Comments...
Page 146: Setdrgroupname
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).
Page 147: Sethostdiskdevicewritecachemode
When the job is run, remote replication is suspended or resumed as speciﬁed. If remote replication is already as speciﬁed, no change in operation occurs. State found when the Resulting action Action speciﬁed job is run Resume Resumed No change in remote replication Resume Suspended Remote replication is resumed (started)
Page 148: Sethostvolumegroupwritecachemode
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetHostDiskDeviceWriteCacheMode ( %hoststorvol_unc_name%, WRITE_CACHE_ENABLED, NOWAIT ) UNC Host Disk Device Name (%hoststorvol_unc_name%). Select or enter the name of the host disk device whose write cache mode is to be set. Write Cache Mode.
Page 149: Sethostvolumewritecachemode
Action speciﬁed Mode found when the job is run Resulting action No change in write cache Disable Disabled operation Write caching is stopped and the Disable Enabled cache memory is written to disk (ﬂushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...
Page 150 Action speciﬁed Mode found when the job is run Resulting action No change in write cache Disable Disabled operation Write caching is stopped and the Disable Enabled cache memory is written to disk (ﬂushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...
Page 151: Sethostvolumeswritecachemode
SetHostVolumesWriteCacheMode Enables or disables (stops and ﬂushes) the write cache of the storage volumes (virtual disks) that underlie host volumes. When the job is run, the virtual disk write cache mode is enabled or disabled as speciﬁed. If the write cache mode is already as speciﬁed, no change in operation occurs.
Page 152: Setmountpointspreﬁxinrepository
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetListVariable ( %value% ) Value. Enter or select a values to store in a variable assignment. Examples $disklist = SetListVariable ( ("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars") ) Comments •...
Page 153: Setnotiﬁcationpolicy
Comments • Associated validation commands. None • 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 speciﬁcs. The format of mount point preﬁxes is OS-dependent. •...
Page 154: Setoraclemodeusingrepository
SetOracleModeUsingRepository Speciﬁes the Oracle resources mode. The resources are identiﬁed 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% ) UNC Oracle Repository Name(%oraclerepository_unc_name% ). Select or enter the UNC name of the repository.
Page 155: Setstoragevolumewritecachemode
Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites. None. • Command result value. New name for the storage volume. For a complete list, see command result values. • OS speciﬁcs. None. • resource names and UNC formats. SetStorageVolumeWriteCacheMode Speciﬁes the write cache mode for a storage volume (virtual disk).
Page 156: Setvariable
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 speciﬁcs. None • resource names and UNC formats.
Page 157: Snapclonediskdevice
Write Cache Mode. Select the write cache mode for the storage volume. Choices are write_cache_enabled, and write_cache_disabled. Examples SetWriteCacheModesUsingRepository ( "\\HostA2\Catalog 20051214.021405", REPLICATED, WRITE_CACHE_ENABLED ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 158: Snapclonehostdiskdevicetocontainerinmanagedset
SnapcloneDiskDevice ( "\\HostA2\/home/cats", "\\ArrayA2\DskGrp3", 12, READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/users/cats", "\\ArrayA2\DskGrp3", 12, HP-UX READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/var/cats", "\\ArrayA2\DskGrp3", 12, Linux READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\CATS", "\\ArrayA2\DskGrp3", 12, READ_WRITE, OpenVMS "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/usr/cats", "\\ArrayA2\DskGrp3", 12, SAME, Solaris READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/dev/disk/dskdsk100c", "\\ArrayA2\DskGrp3",...
Page 159: Snapclonehostvolume
Examples SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\HostA2\Disk3”, "hvol_cats_set", Windows...
Page 160: Snapclonehostvolumegroup
SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) HP-UX SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) OpenVMS SnapcloneHostVolume ( "\\HostA2\CATS", SAME, WAIT ) Solaris SnapcloneHostVolume ( "\\HostA2\/usr/cats", SAME, WAIT ) Tru64 UNIX SnapcloneHostVolume ( "\\HostA2\/dev/disk/dsk100c", SAME, WAIT ) Windows Drive SnapcloneHostVolume ( "\\HostA2\E:\", SAME, WAIT ) Drive &...
Page 161: Snapclonehostvolumegrouptocontainersinmanagedset
SnapcloneHostVolumeGroup ( "\\HostA2\/home/cats_vg", SAME, WAIT ) HP-UX SnapcloneHostVolumeGroup ( "\\HostA2\/users/cats_vg", SAME, WAIT ) Linux SnapcloneHostVolumeGroup ( "\\HostA2\/var/cats_vg", SAME, WAIT ) OpenVMS Not applicable Solaris SnapcloneHostVolumeGroup ( "\\HostA2\/usr/cats_vg", SAME, WAIT ) Tru64 UNIX SnapcloneHostVolumeGroup ( "\\HostA2\dom01", SAME, WAIT ) Windows Not applicable Comments •...
Page 162: Snapclonehostvolumetocontainers
Examples SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", NOWAIT ) OpenVMS Not applicable SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\dom01", Tru64 UNIX "hvol_cats_set", NOWAIT ) Windows Not applicable Comments •...
Page 163: Snapclonehostvolumetocontainersinmanagedset
SnapcloneHostVolumeToContainers ( "\\HostA2\/home/cats", ("\\ArrayA2\CatsCon- tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- HP-UX tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/var/cats", ("\\ArrayA2\CatsCon- Linux tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\CATS", ("\\ArrayA2\CatsContainer", OpenVMS WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/usr/cats", ("\\ArrayA2\CatsCon- Solaris tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/dev/disk/dsk100c", Tru64 UNIX ("\\ArrayA2\CatsContainer", WAIT ) Windows...
Page 164: Snapcloneoracletocontainersusingrepository
Examples Host volume mount points or device names can be used. SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/dev/disk/dsk100c",...
Page 165: Snapcloneoracleusingrepository
Managed Set Name (%managedset_of_containers%). Select or enter the name of the managed set of containers (virtual disks) to be used for the preallocated snapclones. Tablespaces or Archived Logs. Select the resources to replicate. Choices are: Value Remarks Replicate tablespaces and archived redo logs in the repository oracle_archive_log_ﬁle Replicate archived redo log ﬁles in the repository oracle_tablespace...
Page 166: Snapclonestoragevolume
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. • Command result value. List of snapclone storage volume names (UNC). For a complete list, command result values.
Page 167: Snapclonestoragevolumetocontainer
SnapcloneStorageVolumeToContainer Creates a preallocated snapclone (point-in-time copy, using a container) of a storage volume. Syntax and arguments SnapcloneStorageVolumeToContainer ( %storvol_unc_name%, %container_unc_name%, NOWAIT ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to copy. UNC Container Name (%container_unc_name%).
Page 168: Snapshotdiskdevice
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 list, command result values.
Page 169: Snapshothostdiskdevicetocontainerinmanagedset
SnapshotDiskDevice ( "\\HostA2\/home/cats", DEMAND_ALLOCATED, SAME, "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/users/cats", DEMAND_ALLOCATED, SAME, HP-UX "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/var/cats", DEMAND_ALLOCATED, SAME, Linux "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\CATS:", DEMAND_ALLOCATED, SAME, "Cats_copy", OpenVMS WAIT ) SnapshotDiskDevice ( "\\HostA2\/usr/cats", DEMAND_ALLOCATED, SAME, Solaris "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/dev/disk/dsk100c", DEMAND_ALLOCATED, SAME,...
Page 170: Snapshothostvolume
Examples SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT )
Page 171: Snapshothostvolumegroup
SnapshotHostVolume ( "\\HostA2\/home/Cats", DEMAND_ALLOCATED, SAME, "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\/users/Cats", DEMAND_ALLOCATED, SAME, HP-UX "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\/var/Cats", DEMAND_ALLOCATED, SAME, Linux "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\CATS", DEMAND_ALLOCATED, SAME, "Cats_copy", OpenVMS WAIT ) SnapshotHostVolume ( "\\HostA2\/usr/Cats", DEMAND_ALLOCATED, SAME, Solaris "Cats_copy", WAIT) Tru64 UNIX...
Page 172: Snapshothostvolumegrouptocontainersinmanagedset
Examples These examples show host volume mount points. Device names can also be used. SnapshotHostVolumeGroup ( "\\HostA2\/home/cats_vg", DEMAND_ALLOCATED, SAME, WAIT ) SnapshotHostVolumeGroup ( "\\HostA2\/users/cats_vg", DEMAND_ALLOCATED, HP-UX SAME, WAIT ) SnapshotHostVolumeGroup ( "\\HostA2\/var/cats_vg", DEMAND_ALLOCATED, SAME, Linux WAIT ) OpenVMS Not applicable SnapshotHostVolumeGroup ( "\\HostA2\/usr/cats_vg", DEMAND_ALLOCATED, SAME, Solaris WAIT )
Page 173: Snapshothostvolumetocontainers
Examples SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) OpenVMS Not applicable SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( Tru64 UNIX "\\HostA2\dom01","hvol_cats_set", FULLY_ALLOCATED, NOWAIT Windows Not applicable Comments...
Page 174: Snapshothostvolumetocontainersinmanagedset
SnapshotHostVolumeToContainers ( "\\HostA2\/home/Cats", "\\Array2\Cats", DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/users/Cats", "\\Array2\Cats", HP-UX DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/var/Cats", "\\Array2\Cats", Linux DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\CATS", "\\Array2\Cats", OpenVMS DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/usr/Cats", "\\Array2\Cats", Solaris DEMAND_ALLOCATED, WAIT SnapshotHostVolumeToContainers ( "\\HostA2\dom01#fset1", "\\Array2\Cats", Tru64 UNIX DEMAND_ALLOCATED, WAIT ) Windows...
Page 175: Snapshotoracletocontainersusingrepository
Examples Host volume mount points or device names can be used. SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\dom01#fset1",...
Page 176: Snapshotoracleusingrepository
Tablespaces or Archived Logs. Select the resources to replicate. Choices are: Value Remarks Replicate tablespaces and archived redo logs in the repository oracle_archive_log_ﬁle Replicate archived redo logs in the repository oracle_tablespace Replicate tablespaces in the repository Wait Flag. Select wait or nowait. See jobs wait/nowait argument.
Page 177: Snapshotstoragevolume
Examples SnapshotOracleUsingRepository ( "\\HostA2\Catalog 20051214.021405", FULLY_ALLOCATED, SAME, NOWAIT ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. List of snapshot storage volume names (UNC). For a complete list, see command result values.
Page 178: Snapshotstoragevolumestocontainers
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 volume to copy. UNC Container Name (%container_unc_name%).
Page 179: Switchoraclearchivelogfilesusingrepository
Examples SnapshotStorageVolumesToContainers ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs"), ("\\ArrayA2\CatsCon- tainer", "\\ArrayA2\DogsContainer"), FULLY_ALLOCATED, NOWAIT ) SnapshotStorageVolumesToContainers ($my_svol_list, $cont_list, FULLY_ALLOCATED, NOWAIT ) Comments • Associated validation commands. ValidateSnapshotStorageVolume • Agent and license prerequisites. Requires a local replication license for the storage systems on which the storage volumes are located. •...
Page 180: Unmountentirevolumegroup
cancelled failed stopped success executing paused Examples TestJobState ( "daily_backup-1", EXECUTING ) Comments • Associated validation commands. None. • Agent and license prerequisitesNone. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None. UnmountEntireVolumeGroup Instructs an enabled host to unmount all of the logical volumes in a host volume group.
Page 181: Unmounthostvolume
UnmountHostVolume Instructs an enabled host to unmount a host volume. The host OS removes host volume mount point, but the underlying storage volume remains presented to the host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: UnmountHostVolume ( %mount_point_unc% ) UNC Mount Point Name (%mount_point_unc%).
Page 182: Unmounthostvolumesusingrepository
Examples UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) HP-UX UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) Linux UnmountHostVolumes ( ( "\\HostA2\/var", "\\HostA5\/var/cats" ) ) OpenVMS UnmountHostVolumes ( ( "\\HostA2\CATS", "\\HostA5\DOGS" ) ) Solaris UnmountHostVolumes ( ( "\\HostA2\/usr", "\\HostA5"\/usr/cats" ) ) Tru64 UNIX UnmountHostVolumes ( %mount_point_list% ) Windows...
Page 183: Unpresentstoragevolume
UnpresentStorageVolume Ends the presentation of a storage volume to a host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: UnpresentStorageVolume ( %storvol_unc_name%, %host_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume whose presentation is to end.
Page 184: Validatehost
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: ValidateHost ( %host_name% ) Host Name (%host_name%).
Page 185: Validatehostvolumedoesnotexist
ValidateHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateHostVolume ( "\\HostA2\CATS" ) Solaris ValidateHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 186: Validatehostvolumegroup
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats. ValidateHostVolumeGroup Checks if a host volume group 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.
Page 187: Validateoracledatabase
UNC Host Volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume to validate. Examples These examples show host volume mount points. Device names can also be used. ValidateHostVolumeMirrorclones ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolumeMirrorclones ( "\\HostA2\/users/cats" ) Linux ValidateHostVolumeMirrorclones ( "\\HostA2\/var/cats"...
Page 188: Validateoracletablespaces
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 default arguments are: ValidateOracleTablespaces ( %oracletablespace_unc_names% ) UNC Oracle Tablespace Names ( %oracletablespace_unc_names% ).
Page 189: Validatesnapclonehostvolumegroup
ValidateSnapcloneHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateSnapcloneHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateSnapcloneHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateSnapcloneHostVolume ( "\\HostA2\CATS" ) Solaris ValidateSnapcloneHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateSnapcloneHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateSnapcloneHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateSnapcloneHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 190: Validatesnapclonestoragevolume
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. •...
Page 191: Validatesnapshothostvolumegroup
ValidateSnapshotHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateSnapshotHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateSnapshotHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateSnapshotHostVolume ( "\\HostA2\CATS" ) Solaris ValidateSnapshotHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateSnapshotHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateSnapshotHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateSnapshotHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 192: Validatesnapshotstoragevolume
• OS speciﬁcs. Yes. See examples above. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • resource names and UNC formats. ValidateSnapshotStorageVolume Checks if a storage volume is an available resource and that it can be replicated using the snapshot method.
Page 193: Validatestoragevolume
• OS speciﬁcs. None • resource names and UNC formats. ValidateStorageVolume Checks if a storage volume 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: ValidateStorageVolume ( %storvol_unc_name% )
Page 194: Wait
• 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"...
Page 195: Waitdrgroupsynchronizationtransition
WaitDrGroupSynchronizationTransition Halts a job until the I/O mode of a DR group changes. When the I/O mode changes, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitDrGroupSynchronizationTransition ( %drgroup_unc_name% ) UNC DR Group Name (%drgroup_unc_name%).
Page 196: Waitforhostvolumegroupwritecacheflush
Comments • Associated validation commands. ValidateHost. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 197: Waitforhostvolumeswritecacheflush
Examples Host volume mount points or device names can be used. WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/home/cats" ) HP-UX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/users/cats" ) Linux WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/var/cats" ) OpenVMS WaitForHostVolumeWriteCacheFlush ( "\\HostA2\CATS" ) Solaris WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/usr/cats" ) Tru64 UNIX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\dom01#fset1" ) Windows Drive WaitForHostVolumeWriteCacheFlush ( "\\HostA2\E:\"...
Page 198: Waitforjob
WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) HP-UX WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) Linux WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/var", "\\HostA5\/var/cats") ) OpenVMS WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\[users]", "\\HostA5\CATS") ) Solaris WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/usr", "\\HostA5"\/usr/cats") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\dom01#fset1", Tru64 UNIX "\\HostA5\dom02#fset1") ) Windows Drive WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\E:\", "HostA5\K:\") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\E:\pets\cats", Drive &...
Page 199: Waitforstoragevolumediscovery
WaitForStorageVolumeDiscovery Halts a job until a speciﬁc storage volume (virtual disk) is found in the replication manager database. When found, the next step in the job is executed. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForStorageVolumeDiscovery ( %storvol_unc_name% ) UNC Storage Volume Name ( %storvol_unc_name%).
Page 200: Waitforstoragevolumewritecacheflush
WaitForStorageVolumeWriteCacheFlush Halts a job until the write cache of the storage volume has been ﬂushed. When the write cache has been ﬂushed, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForStorageVolumeWriteCacheFlush ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%).
Page 201: Waitforwritecacheflushusingrepository
WaitForWriteCacheFlushUsingRepository Halts a job until the write cache of the storage volumes that underlie an Oracle database has been ﬂushed. The appropriate storage volumes are automatically selected by reference to the enabled host and database speciﬁed by the repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForWriteCacheFlushUsingRepository ( %oraclerepository_unc_name%, %original_replicated% ) UNC Oracle Repository Name (%oraclerepository_unc_name% ).
Page 202: Waithostvolumenormalization
Comments • Associated validation commands. ValidateHost. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 203: Waitstoragevolumesnormalization
Examples WaitStorageVolumeNormalization ( "\\Region-1\Sales" ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • The storage volume is checked at regular intervals. When the volume is normal or unshared, the job proceeds to the next step.
Page 204: Waitvolumegroupnormalization
Examples WaitUntil ( "15:30:00" ) – Halts the job until 15:30 hours (3:30 PM). WaitUntil ( "2007/10/14 15:30:00" ) – Halts the job until 14 October 2007, 15:30 hours (3:30 PM). Comments • Associated validation commands. None • Agent and license prerequisites. None •...
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. • resource names and UNC formats. HP StorageWorks Replication Solutions Manager 4.0.1...
Page 206 Job concepts, templates and commands...
Page 207: Index
Index audience, 9 products providing feedback, 1 1 conventions document, 10 resource names and UNC formats, 201 creating, 105 Subscriber’s Choice, HP, 1 1 document conventions, 10 documentation HP web site, 9 technical support providing feedback, 1 1 HP, 10 service locator website, 1 1 templates, job...

This manual is also suitable for:

Storageworks 8100 - enterprise virtual array Storageworks replication solutions manager 4.0.1

HP 418800-B21 - StorageWorks Modular Smart Array 70 Storage Enclosure Command Reference Manual

About this Reference

Job Concepts, Templates and Commands

Index

Quick Links

Related Manuals for HP 418800-B21 - StorageWorks Modular Smart Array 70 Storage Enclosure

Summary of Contents for HP 418800-B21 - StorageWorks Modular Smart Array 70 Storage Enclosure