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

Advertising

   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

  • 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. Confidential 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: Table Of Contents

    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: Table Of Contents

    DiscoveryRefresh (obsolete) ....... 1 15 Exit ......... 1 15 Export .

  • Page 6: Table Of Contents

    SetVariable ........SetWriteCacheModesUsingRepository .

  • Page 7: Table Of Contents

    WaitForStorageVolumeWriteCacheFlush ......WaitForStorageVolumesWriteCacheFlush ......WaitForWriteCacheFlushUsingRepository .

  • Page 8

    Tables 1 Document conventions ......

  • Page 9: Intended Audience, Related Documentation

    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: Product Feedback 1

    • 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 notification of product enhancements, new driver versions, firmware updates, and other product resources. HP websites For additional information, see the following HP websites: •...

  • Page 12

    About this reference...

  • Page 13

    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 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: Argument Lists

    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

    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. •...

  • 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) SetMountPointsPrefixInRepository...

  • 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 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 predefined job status notification 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 flow 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 SetMountPointsPrefixInRepository Oracle SetNotificationPolicy 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 flow DR group remote...

  • Page 30

    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: Pause And Continue

    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 specific 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: Storage Systems

    Oracle Name format (UNC) Example \\HostA2\Cats_db \\enabled host\database name Identifies the Oracle database named Cats_db on the enabled host named HostA2 \\HostA2\Catalog 20051218.024153 Identifies 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, Transactions

    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

    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

    • 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: Fracture Host Volumes, Mount To A Host (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 specific tasks. Template options • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy.

  • 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 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 configuration. // 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 configuration. // 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

    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 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.

  • 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 five 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 (flushes) 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 flushing the cache on the host volume(s). SetHostVolumeWriteCacheMode ($source_hostvol_unc1, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache flush 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 (flushes) 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 flushing the cache on the storage volume(s). SetStorageVolumesWriteCacheMode ($source_storvol_list, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache flush 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 file Switch, Add, and Snap commands below if this job is not backing up archive log files // 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 notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy.

  • 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: SetMountPointsPrefixInRepository ($repository, %prefix%) 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 file Switch, Add, and Snap commands below if this job is not backing up archive log files.

  • Page 79

    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

    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: SetMountPointsPrefixInRepository ($repository, %prefix%) 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) 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

    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

    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 // (comment), Addalloracletablespacestorepository

    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 specifics. None • The maximum number of virtual disks per DR group is controller software dependent. •...

  • 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 or be created by a previous step in the same job. •...

  • Page 89

    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, Convertstoragevolumesintocontainers

    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 cannot be used with some older versions of controller software. •...

  • Page 91

    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

    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

    • Command result value. Name of managed set of containers. For a complete list, see command result values. • OS specifics. 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 specifics. 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

    • 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. 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

    • 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 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

    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

    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

    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 prerequisites. Requires a host agent. Requires an Oracle-integration license. •...

  • Page 105

    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

    • 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. • resource names and UNC formats.

  • Page 107

    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 specifics. 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

    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

    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 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

    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

    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

    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

    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) 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

    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.

  • Page 117

    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

    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 flushed. Examples These examples show host volume mount points.

  • Page 119

    • Command result value. None. For a complete list, see command result values. • OS specifics. 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

    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: Import

    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

    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_2005021 1 135232.export" ) Comments • Associated validation commands. None • Agent and license prerequisites. None •...

  • Page 123

    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

    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

    • OS specifics. 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 finished"...

  • Page 126

    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

    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

    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

    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

    • 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 specifics. None. MountEntireVolumeGroup Instructs an enabled host to mount all of the replica logical volumes in a replica volume group, as appropriate.

  • Page 133: Mounthostvolumesusingrepository

    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

    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

    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

    Comments • Associated validation commands. ValidateHost, ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS specifics. None • Each storage volume is automatically assigned the next available LUN on the host. The access type defaults to read_write.

  • Page 138: Retainlatestroundrobinreplicasforhoststoragevolume

    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

    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: Setdiskgroupforsnapclone

    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 specifics. Yes. See examples above. • resource names and UNC formats.

  • 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.

  • 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: Setdrgrouphome

    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

    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 flag. Choices are true and false. Examples SetDrGroupHome ( "\\ArrayA2\DrGrpPets", TRUE ) Comments...

  • 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).

  • Page 147

    When the job is run, remote replication is suspended or resumed as specified. If remote replication is already as specified, no change in operation occurs. State found when the Resulting action Action specified job is run Resume Resumed No change in remote replication Resume Suspended Remote replication is resumed (started)

  • Page 148

    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

    Action specified 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 (flushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...

  • Page 150

    Action specified 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 (flushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...

  • Page 151

    SetHostVolumesWriteCacheMode Enables or disables (stops and flushes) 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 specified. If the write cache mode is already as specified, no change in operation occurs.

  • Page 152

    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

    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 specifics. The format of mount point prefixes is OS-dependent. •...

  • Page 154: Setoraclemodeusingrepository, Setstoragevolumename

    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% ) UNC Oracle Repository Name(%oraclerepository_unc_name% ). Select or enter the UNC name of the repository.

  • Page 155: Setstoragevolumeswritecachemode

    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 specifics. None. • resource names and UNC formats. SetStorageVolumeWriteCacheMode Specifies the write cache mode for a storage volume (virtual disk).

  • Page 156: Setwritecachemodesusingrepository

    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 specifics. 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

    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

    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

    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

    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_file Replicate archived redo log files in the repository oracle_tablespace...

  • 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. • Command result value. List of snapclone storage volume names (UNC). For a complete list, command result values.

  • Page 167

    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

    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

    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

    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

    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_file 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, Snapshotstoragevolumetocontainer

    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

    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 specifics. None. UnmountEntireVolumeGroup Instructs an enabled host to unmount all of the logical volumes in a host volume group.

  • Page 181: Unmounthostvolume, Unmounthostvolumes

    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 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 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

    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

    • Command result value. None. For a complete list, see command result values. • OS specifics. 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

    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 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, Validatesnapshothostvolume

    • Command result value. None. For a complete list, see command result values. • OS specifics. 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

    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

    • OS specifics. 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

    • OS specifics. 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

    • 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 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

    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 specifics. Yes. See examples above. • resource names and UNC formats.

  • Page 197

    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

    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: Waitforstoragevolumesdiscovery

    WaitForStorageVolumeDiscovery Halts a job until a specific 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: Waitforstoragevolumeswritecacheflush

    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: WaitForStorageVolumeWriteCacheFlush ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%).

  • Page 201

    WaitForWriteCacheFlushUsingRepository Halts a job until the write cache of the storage volumes that underlie an Oracle database has been flushed. The appropriate storage volumes are automatically selected by reference to the enabled host and database specified 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

    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 specifics. Yes. See examples above. • resource names and UNC formats.

  • Page 203

    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 specifics. 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

    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...

Comments to this Manuals

Symbols: 0
Latest comments: