HP P6000 Replication Solutions Manager Job Command Reference Abstract This document describes how to use HP P6000 Replication Solutions Manager (the replication manager). It is intended for operators and administrators of storage area networks (SANs) that include HP storage arrays. It is helpful to have previous experience with SANs, LANs, and operation systems including Windows.
© Copyright 2004, 2012 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Warranty The information contained herein is subject to change without notice.
Contents 1 Jobs..........................................................................................................9 Working with jobs....................................................................................................................9 About jobs..........................................................................................................................9 Job actions summary.....................................................................................................
Assignments (variables).......................................................................................................34 Branches..........................................................................................................................35 Commands.......................................................................................................................35 Command result values...................................................................................................
CreateContainerForHostDiskDevice......................................................................................95 CreateContainersForHostVolume..........................................................................................96 CreateContainersForHostVolumeGroup.................................................................................96 CreateDiskDevice...............................................................................................................97 CreateDrGroup........
MirrorcloneStorageVolumeToContainer................................................................................135 MountEntireVolumeGroup.................................................................................................136 MountHostVolume............................................................................................................137 MountVolumeGroupComponent.........................................................................................138 Pause....................
SnapcloneStorageVolume..................................................................................................174 SnapcloneStorageVolumeToContainer.................................................................................175 SnapcloneStorageVolumesToContainers..............................................................................176 SnapshotDiskDevice.........................................................................................................
3 Support and other resources....................................................................213 Release history.....................................................................................................................213 Contacting HP......................................................................................................................215 Related information...............................................................................................................
1 Jobs Working with jobs About jobs The jobs content pane displays the jobs that you can use, their run histories and scheduled run times, if any. Views • List of all jobs. See Jobs list tab. • List of job instances. See Jobs Run History tab. • List of scheduled job events. See Jobs schedule tab. Actions • Actions in the GUI. See Jobs actions summary. • You can also interact with jobs from the CLUI. See Job actions cross reference. Properties • Properties displayed in the GUI.
• Continue. Continue a paused job instance. Procedure. • Pause. Pause a job instance. Procedure. Scheduled job event actions on the Schedule tab • View Properties. View the interval (frequency) and start time of a scheduled job event. Procedure. • Enable/Disable. Toggle a scheduled job event on or off. Procedure. • Schedule Job. Schedule a job event. Procedure. • Edit Schedule. Edit a scheduled job event. Procedure. • Remove. Delete a scheduled job event. Procedure.
Be sure to include the -1 argument. This prevents the OS from automatically performing a subsequent thaw. If omitted, the job can fail on the resume step (example, line 21). In the second Launch command (example, line 21) enter a host command or script file name to resume I/O (thaw the mount point), for example: "thawfs /mountPoint" Job actions cross reference You can work with jobs using GUI actions and CLUI commands. See Jobs and job instances and Scheduled job events.
Scheduled job events Create scheduled job event GUI action Job command or template CLUI command Jobs > Schedule > Schedule job - - GUI action Job command or template CLUI command Jobs > Schedule > Remove - - GUI action Job command or template CLUI command Jobs > Schedule > Edit - - GUI action Job command or template CLUI command Jobs > Schedule > Enable/Disable - Set Job GUI action Job command or template CLUI command Jobs > View Properties - Show Job Delete scheduled job event
Run History Schedule Aborting job instances Abort (stop) a running or paused job instance. Considerations • You can use the GUI or CLUI. See Job actions cross reference. • If using the GUI, consider using the Monitor Job window to be more selective about when (on which task) to abort the job. Procedures Aborting a job instance from the GUI 1. 2. 3. 4. In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the Run History tab.
Continuing job instances Continue a paused job or a running job that is waiting. See Pause and continue. Considerations • You can use the GUI Run History tab or Monitor Job window. You can also use the CLUI. See Job actions cross reference. Procedures Continuing a job instance from the GUI 1. 2. 3. 4. In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the Run History tab. Select the job instance to continue. Do one of the following: • Select Continue.
Considerations • You can only use the GUI to create a job. You cannot use a separate text editor or the CLUI. • If appropriate, make a copy of an existing job to use as a starting point. Procedure 1. 2. In the navigation pane, select Jobs to display the Jobs window in the content pane. Select Actions > New. The Create Job window opens. 3. 4. 5. 6. 7. Enter the job name (required). Enter the job description (optional). Enter the job commands. To use a template, click Generate and select a template.
3. 4. 5. Select the job instance you want to delete. Select Actions > Delete. Click OK to confirm the action. Deleting a job instance from the CLUI 1. 2. Open a CLUI window. Issue a Delete Job command. Include the instance switch and job instance name (or ID). Developing jobs HP recommends that you develop and thoroughly test jobs in a non-production environment before using them in production. 1. Plan the job. Determine the goals for the job and identify resources that must be identified in the job. 2.
4. 5. 6. Select Actions > Export. Enter the full path and file name. Click OK. CLUI Procedure 1. 2. Open a CLUI window. Issue a set server command with the export_job=joblist option. Job editing tips and shortcuts In this section, the word command refers to a job command (script action).
Changing all lines 1. 2. In the right pane, select any line. Press Ctrl+Alt+/. All active lines are changed to comments. Deleting lines 1. 2. In the right pane, select the lines that you want to delete. Press the Delete key. The lines are deleted. Deleting a transaction 1. In the right pane, double-click the DO { line. The transaction lines are selected. 2. Press the Delete key. The transaction lines are deleted. Editing a command 1. 2. In the right pane, select the command (line).
Selecting adjacent lines 1. 2. 3. In the right pane, select the first line. Press and hold the Shift key. Select the last line. All lines between the first and last line are selected. Selecting all lines 1. 2. Click anywhere in the right pane. Click Ctrl+A. All lines are selected. Nonadjacent lines The replication manager does not support selection of nonadjacent lines. Editing individual commands (tasks) Select or enter argument values for the command.
Importing jobs Import a saved jobs file. Considerations • You can use the GUI or the CLUI set server command to import jobs. GUI Procedure 1. 2. 3. Select File→Import RSM Job(s). Enter the full path and file name of the jobs file to import. Click OK. CLUI Procedure 1. 2. Open a CLUI window. Issue a set server command with the import path=path/filename option. Importing legacy jobs Importing overview Import an HP P6000 Business Copy legacy job into the replication manager.
Legacy BC 2.x job command equivalence The following table lists HP Business Copy EVA/MA/EMA 2.x job operations and the equivalent job commands in the replication manager. Details regarding individual command parameters are not included. Business Copy EVA/MA/EMA 2.x Job operation name and Replication Solutions Manager equivalent job command use ; indicates a comment line // CLONE UNIT Creates a mirrorset of a virtual disk. The clone operation applies to MA/EMA arrays only.
Business Copy EVA/MA/EMA 2.x Job operation name and Replication Solutions Manager equivalent job command use NORMALIZE UNIT WaitStorageVolumeNormalization Checks the state of a unit (virtual disk). When the state is WaitStorageVolumesNormalization normal or unshared, BC executes the next step in the job. MA/EMA arrays are not supported. While the state is normalizing or unsharing, BC continues to check the state. Normalization applies to EVA and MA/EMA arrays.
Business Copy EVA/MA/EMA 2.x Job operation name and Replication Solutions Manager equivalent job command use SNAP VOLUME {demand_allocated_hsv} SnapshotHostVolume (demand_allocated) Creates point-in-time copies of the virtual disks that SnapshotHostVolumeGroup (demand_allocated) comprise a host volume. The copies are demand allocated snapshots. Demand allocation applies to EVA arrays only. SNAP VOLUME {fully_allocated} Creates point-in-time copies of the virtual disks that comprise a host volume.
Business Copy EVA/MA/EMA 2.x Job operation name and Replication Solutions Manager equivalent job command use VGFREEZE This background operation is generated automatically at runtime when the job requires that a host volume group be frozen (host I/O is not allowed). None—The replication manager does not automatically freeze volume groups. If special processing is needed for the volume group, you must include a launch command that runs the appropriate command, batch file for script on the host.
5. 6. To manage the job instance, click one of the following: • Pause. Pauses the job instance at the next break in its execution. • Continue. Continues the job instance at its paused step. • Abort. Stops the job instance and sets the job status to failed. • Refresh. Refreshes the window. Click OK. Pausing job instances Pause a job instance at the next step in its execution. Considerations • You can use the GUI Run History tab or Monitor Job window. You can also use the CLUI.
not appear in a selection list. Because in this case the new disk cannot be referenced by a variable, you must manually enter the name (as specified by the command that creates it). Scheduled job events do not run Problem Scheduled job events do not run. In the events pane, one of the following messages is displayed: Internal error occurred starting job . Missed scheduled execution time of .
Running a job from the CLUI 1. 2. Open a CLUI window. Issue a Set Job command. Include the job name, mode switch, and run switch. The mode should be normal or skip validation. Selecting values for arguments Select an argument value. The argument editor allows you to select one or more values for job command arguments. (See Arguments and Argument lists.) Depending on the command, you can select from several types of resources.
Editing scheduled job events You can edit a scheduled job event to change the start time and run interval (frequency). You can also update the saved logon credentials. See also Creating scheduled job events. Considerations • You cannot save a scheduled job event without entering security credentials. Procedure 1. 2. In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the Schedule tab. The Schedule tab shows the list of scheduled job events. 3. 4.
Choosing a run interval Use the following table to help determine the type of interval to choose in the Schedule a Job wizard. Interval type Behavior Past-time adjustment Run once Runs a job one time (today) at the specified time. Example: run at 2:00 PM (today) If you enter a time of day that is in the past, the schedule wizard adjusts the start time by adding 5 minutes to the current time. Example: You enter 2:00 PM when it is already 2:05 PM. The adjusted start time becomes 2:10 PM.
Procedure 1. 2. In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the Schedule tab. The Schedule tab shows the list of scheduled job events. 3. 4. Select the scheduled job event to remove. Select Actions > Remove. The Confirm Action window opens. 5. Click OK. The scheduled event is removed from the list. Viewing scheduled job events A scheduled job event can be enabled or disabled.
Viewing job status You can view the overall job status or the status of an individual job. Considerations • You can use the GUI or CLUI. See Job actions cross reference. Procedures Viewing the overall job status from the GUI 1. In the navigation pane, locate the Jobs resources in the resources tree. The icon indicates the overall job status. For example, if just one job has run and failed, the icon indicates there is a job failure. Viewing a single job's status from the GUI 1.
Viewing job properties View a job's listing without opening it in the job editor. Considerations • You can only use the GUI to view a job's properties (listing). Procedure 1. 2. 3. 4. In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the List tab. Select the job whose properties you want to view. Select Actions > View Properties. The Job Properties window opens, displaying the job's run state and commands.
Jobs, templates, and commands You can create, save, run, schedule, and manage jobs that automate replication tasks. 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. See Job commands list.
The format of a job-instance name is the job name, plus a sequence number. For example, the job named daily_backup when run two times would have job instance names of daily_backup-1 and daily_backup-2. 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.
7 $Rep1 = SnapshotHostVolume ("\\source_host\path\source_hostvol1", FULLY_ALLOCATED, SAME) ONERROR PAUSEAT E1: ... // 13 E2: DeleteStorageVolumes ( $Rep1 ) ONERROR PAUSEATE2: ... Usage Assignments are: • Local to each job and cannot be referenced across jobs. • Not case sensitive. Format • The first two characters must be a dollar sign ($) followed by an alpha character. No special characters are allowed after the first character. • Upper and lower case, alpha and numeric are allowed.
You must edit the command and select or enter values for any required arguments. After editing, the command displays the argument value as normal text, in quotes. SnapcloneStorageVolume ( "\\Array2\Cats", "", SAME, "", WAIT ) You can also edit a command to change its default values. In the example below, the defaults for disk group name and snapclone name have been changed.
Job command Command result value (format) CreateHostVolumeGroup Host volume group name (UNC) CreateReplicaRepository Replica repository name (simple) CreateStorageVolume Storage volume name (UNC) CreateThinProvisionedStorageVolume Storage volume name (UNC) DeleteContainer - DeleteDrGroup - DeleteDrGroupMember - DeleteHostVolume - DeleteHostVolumeGroup - DeleteReplicaRepository - DeleteStorageVolume - DeleteStorageVolumes - DeleteStorageVolumesInManagedSet - DetachMirrorclones -
Jobs Job command Command result value (format) MigrateStorageVolume - MirrorcloneHostDiskDeviceToContainer - MirrorcloneHostDiskDeviceToContainerInManagedSet - MirrorcloneHostVolumeGroupToContainers - MirrorcloneHostVolumeGroupToContainersInManagedSet - MirrorcloneHostVolumeToContainers - MirrorcloneHostVolumeToContainersInManagedSet - MirrorcloneStorageVolumeToContainer - MountVolumeGroupComponent Mount point name (UNC) Pause - PrepareContainer - PrepareContainers - PrepareCo
Job command Command result value (format) SetDrGroupName - SetDrGroupSuspend - SetDrProtocolType - SetHostDiskDeviceWriteCacheMode - SetHostVolumeGroupWriteCacheMode - SetHostVolumesWriteCacheMode - SetListVariable The resources listed in the argument (UNC) SetNotificationPolicy - SetPreferredPortConfiguration - SetStorageVolumeName New name for the storage volume (UNC) SetStorageVolumeSize - SetStorageVolumeWriteCacheMode - SetStorageVolumesWriteCacheMode - SetVariable The reso
Jobs Job command Command result value (format) MigrateMirrorclones - TestJobState Boolean true-false UnmountEntireVolumeGroup - UnmountHostVolume - UnmountHostVolumes - UnpresentStorageVolume - UnpresentStorageVolumes - UnpresentThinProvisionedStorageVolume - UnpresentThinProvisionedStorageVolumes - ValidateHost - ValidateHostVolume - ValidateHostVolumeDoesNotExist - ValidateHostVolumeGroup - ValidateHostVolumeMirrorclones - ValidateSnapcloneHostVolume - ValidateSnapclon
Job command Command result value (format) WaitStorageVolumesNormalization - WaitUntil - WaitVolumeGroupNormalization - 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 and Commenting-out commands. 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.
legacy job end > 12 // [line 5] "we're done" 13 template applied > 14 // Replicate storage volumes. 15 commands start > required argument > 16 ValidateStorageSystem ( "Array2" ) 17 ValidateStorageVolume ( "\\Array2\Cats\ACTIVE" ) 18 ValidateSnapshotStorageVolume ( "\\Array2\Cats\ACTIVE" ) 19 // 20 //$BCV1 = SnapshotStorageVolume ( "\\Array2\Cats\ACTIVE", FULLY_ALLOCATED, SAME, %dest_storvol1%, WAIT ) onerror pauseat E1: ...
Job command Command category Replication type Requires host agent host disk device local, container yes CreateContainersForHostVolume host volume local, container yes CreateContainersForHostVolumeGroup host volume group local, container yes CreateDiskDevice host disk device ~ yes CreateDrGroup DR group remote ~ CreateDrGroupFromHostVolume DR group remote ~ CreateHostVolume host volume ~ yes CreateHostVolumeDiscrete host volume ~ yes CreateHostVolumeFromDiskDevices host vo
Job command Command category Replication type Requires host agent Export general ~ ~ ExportJobs general ~ ~ FailoverDrGroup DR group remote ~ FailoverDrGroups DR group remote ~ host volume ~ yes ForceFullCopyDrGroup DR group remote ~ FractureHostDiskDeviceMirrorclone host disk device local, mirrorclone yes FractureHostVolumeGroupMirrorclones host volume group local, mirrorclone yes FractureHostVolumeMirrorclones host volume local, mirrorclone yes storage volume local,
Job command Command category Replication type Requires host agent Pause script flow ~ ~ PrepareContainer storage volume local, container ~ PrepareContainers storage volume local, container ~ host disk device local, container ~ PrepareContainersForHostVolumeReplication host volume local, container ~ PrepareContainersForHostVolumeGroupReplication host volume group local, container ~ PresentStorageVolume storage volume ~ ~ PresentStorageVolumes storage volume ~ ~ PresentStora
Jobs Job command Command category Replication type Requires host agent SetDrProtocolType DR group remote ~ SetHostDiskDeviceWriteCacheMode host disk device ~ yes SetHostVolumeGroupWriteCacheMode host volume group ~ yes SetHostVolumeWriteCacheMode host volume ~ yes SetHostVolumesWriteCacheMode host volume ~ yes SetListVariable general ~ ~ SetNotificationPolicy general ~ ~ SetPreferredPortConfiguration storage volume ~ ~ SetStorageVolumeName storage volume ~ ~ SetS
Job command Command category Replication type Requires host agent SnapshotHostVolumeGroups host volume group local, snapsho yes SnapshotHostVolumeGroupToContainersInManagedSet host volume group local, snapshot yes SnapshotHostVolumeToContainers host volume local, snapshot yes SnapshotHostVolumeToContainersInManagedSet host volume local, snapshot yes SnapshotStorageVolume storage volume local, snapshot ~ SnapshotStorageVolumeToContainer storage volume local, snapshot ~ SnapshotStora
Job command Command category Replication type Requires host agent WaitDrGroupNormalization DR group remote ~ WaitDrGroupSynchronizationTransition DR group remote ~ WaitForHostDiskDeviceWriteCacheFlush host disk device ~ yes WaitForHostVolumeGroupWriteCacheFlush host volume group ~ yes WaitForHostVolumeWriteCacheFlush host volume ~ yes WaitForHostVolumesWriteCacheFlush host volume ~ yes script flow ~ ~ WaitForStorageVolumeDiscovery storage volume ~ ~ WaitForStorageVolumesDi
Template name (alphabetical order) Replication type Remarks Replicate host volumes via pre-allocated replication, mount to a host local requires host agent Replicate host volumes, mount to a host local requires host agent Replicate host volume, mount components to a host local requires host agent Replicate host volumes, mount to a host, then to a different host local requires host agent Replicate raw storage volumes, mount (raw) to a host local requires host agent Replicate storage volumes
Continue A continue action or command resumes execution of a job instance that is paused, or waiting. See Job status and states. • You can use a GUI action or CLUI command. See Continuing jobs. • When used for a waiting job instance, the wait is ended and execution continues at the next step. • When used for a paused job instance, execution typically continues at the next step. However, if the job instance was paused on an interrupt-enabled wait command, the wait condition is checked before continuing.
Enabled hosts The job editor and command validation accept these formats. Name format (other) Example Computer network name HostA6 Fully qualified network name HostA6.SiteA.corp IP address 88.15.42.101 Each example identifies an enabled host using an accepted format Host volumes Applies to standard host volumes, volume groups, logical volumes, and host volume components such as partitions and slices.
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. These states appear in the Run History tab.
In the following example, a launch command on line 9 suspends host I/O to a storage volume (virtual disk). The transaction begins at line 10 and ends on line 16. The Do consists of lines 10 through 12, and the Always consists of lines 13 through 16. Line Task ...
failure status. When the first command is encountered that is not a SetVariable or validation command, the job is stopped with a success status. • 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: • Validate-only.
1. 2. 3. 4. A launch command suspends the database I/O. A local replication command instantaneously creates a replica. The command uses the nowait option so that the next step (resuming I/O) is immediately executed. A launch command resumes the database I/O. With I/O resumed, a WaitForStorageVolumeDiscovery command causes the job to wait until the replica is detected by a forced discovery of storage volumes.
Template options • Number of volumes to replicate. Adds commands for each host volume • 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. • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy.
24 PresentStorageVolumes ($Rep1, $mount_host) onerror pauseat E2: 25 DiscoverDiskDevices ($mount_host, $Rep1) onerror continue 26 $HV1 = CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host) onerror pauseat E3: 27 $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E4: 28 // 29 // Wait for user to initiate rollback. 30 Pause () 31 // 32 // Rollback.
Template options • Number of volumes. Adds commands for each storage volume to restore from. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • This template cannot be used with some older versions of controller software.
24 SetStorageVolumeWriteCacheMode ($source_storvol_unc1, WRITE_CACHE_ENABLED, NOWAIT) onerror continue 25 // 26 } 27 // 28 Exit (SUCCESS 29 // Mount existing storage volumes (template) Template summary A. B. C. D. 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.
9 ValidateStorageVolume ($storvol_unc1) 10 // 11 // Mount the volume(s) on a host. 12 $HV1 = CreateHostVolumeDiscrete (%component%, $storvol_unc1, $mount_host) onerror pauseat E1: 13 $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E2: 14 // 15 // Wait for user to initiate rollback. 16 Pause () 17 // 18 // Rollback.
Template Options • Number of virtual disks in DR group. Adds commands for each virtual disk. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for remote replication guidelines.
Jobs 26 // 27 // Validate that resources are as expected. 28 ValidateHost ($host_name) 29 ValidateStorageSystem ($site_1_array) 30 ValidateStorageSystem ($site_2_array) 31 ValidateStorageSystem ($site_3_array) 32 ValidateStorageVolume (%site_1_array_source_storvol_unc1%) 33 ValidateStorageVolume (%site_2_array_source_storvol_unc1%) 34 // 35 // The setting of the following 2 steps may be dependent on the configuration 36 // of the DR group.
// use the name of a 'dummy' EVA host that you have set up in Command View. 64 PresentStorageVolume ($Rep1, $host_name, %LUN1%, READ_WRITE) onerror pauseat E2: 65 // 66 // Make a DR group with the Site 3 storage system. 67 $DRG1 = CreateDrGroup ($DR_group_name, $DR_source_storvol_unc1, $site_3_array, "", "", SAME, "", "", 0, FALSE) onerror pauseat E3: 68 // 69 // Check the state of the DR group before we continue.
Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for remote replication guidelines. Template options • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for remote replication guidelines.
27 // Execute any necessary commands on the remote host to get the volumes ready to mount, 28 // such as import volumegroups, fsck volumes, etc. 29 // Mount devices on the remote host. 30 // Start the application on the remote host. 31 Pause() 32 // 33 Exit (SUCCESS 34 // 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.
9 ValidateHost ($site_2_host) 10 ValidateStorageSystem ($site_2_array) 11 // 12 // Failover all DR groups to the remote site. 13 FailoverDrGroups ( %DR_group_name_list%, FALSE ) 14 // 15 // Do a bus scan for the new volumes, make sure that new devices are seen by multipath driver. 16 // Repeat the Discover for each DR group.
Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication. See Suspending I/O before replicating AdvFS volumes. Example This template was generated to replicate a host volume one time No other template options were selected. Line Task 1 // Make multiple snapclones of the same Host Volume, and mount to a host. 2 // This requires normalization between each snapclone.
31 // Failure exit - no rollback needed. 32 E1: Exit (FAILURE) Replicate host disk devices, mount to a host (template) Template summary A. B. C. D. E. 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). Pauses the job. After continuing, removes the raw host volume from the second enabled host.
17 // 18 // Wait for user to initiate rollback. 19 Pause () 20 // 21 // Rollback. 22 E3: RemoveDiskDevice ($Rep1, $mount_host) onerror pauseat E2: 23 // 24 E2: DeleteStorageVolume ($Rep1) onerror pauseat E2: 25 // 26 Exit (SUCCESS) 27 // 28 // Failure exit - no rollback needed. 29 E1: Exit (FAILURE) Replicate host volume group, mount components to a host (template) Template summary A. B. C.
Comments • Tru64 UNIX. Replication is not supported when an AdvFS domain spans partitions. • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication. See Suspending I/O before replicating AdvFS volumes. Example This template was generated to locally replicate one host volume group and mount one of its components (logical volume). No other template options were selected.
30 // 31 // Failure exit - no rollback needed. 32 E1: Exit (FAILURE) Replicate host volume group, mount entire group to a host (template) Template summary A. B. C. D. E. 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). Mounts all of the components (logical volumes) in the new host volume group on the second enabled host. Pauses the job.
9 ValidateHost ($source_host) 10 ValidateHost ($mount_host) 11 ValidateSnapshotHostVolumeGroup ($source_VolumeGroup_unc1) 12 // 13 $Rep1 = SnapshotHostVolumeGroup ($source_VolumeGroup_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror pauseat E1: 14 // 15 // Mount the replicated volume(s) on a host.
Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication. See Suspending I/O before replicating AdvFS volumes. Example This template was generated to replicate one host volume. No other template options were selected. Line Task 1 // Replicate host volume(s). 2 // 3 // Assign some variables that will be used in this job.
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. • 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.
23 // 24 // Rollback. 25 E4: UnmountHostVolume ($MP1) onerror pauseat E4: 26 E3: DeleteHostVolume ($HV1) onerror pauseat E3: 27 // 28 E2: DeleteStorageVolumes ($Rep1) onerror pauseat E2: 29 // 30 Exit (SUCCESS) 31 // 32 // Failure exit - no rollback needed. 33 E1: Exit (FAILURE) Replicate host volumes, mount to a host, then to a different host (template) Template summary Involves five enabled hosts, EH1 through EH5*. A.
Example This template was generated to replicate one host volume and mount it on two different enabled hosts. No other template options were selected. Line Task 76 Jobs 1 // Replicate host volume(s), mount to a host, then to a different host. 2 // 3 // Assign some variables that will be used in this job.
34 DiscoverDiskDevices ($mount_host2, $Rep1) onerror continue 35 $HV2 = CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host2) onerror pauseat E2: 36 $MP2 = MountHostVolume ($HV2, %mount_point2%) onerror pauseat E3: 37 // 38 // Launch a backup process on a host. 39 Launch ($launch_host_name, %command_line%, "", WAIT, "0") onerror pauseat E4: 40 // 41 // Wait for user to initiate rollback. 42 Pause ( 43 // 44 // Rollback.
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. • 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 preallocated snapclone replication. • Include e-mail notification.
20 PrepareContainerForHostDiskDeviceReplication ( %hostvol_unc_name%, %managed_set_of_containers%, %copytype% ) onerror continue 21 DO { 22 $Rep1 = SnapshotHostVolumeToContainersInManagedSet ($source_hostvol_unc1, %dest_container_set1%, FULLY_ALLOCATED, NOWAIT) onerror pauseat E1: 23 // 24 } ALWAYS { 25 // Restore the writeback cache on the host volume(s).
Replicate host volume, mount components to a host (template) Template summary A. B. C. D. E. Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host. Presents the underlying storage volume copies to a second enabled host (creates a new host volume). Mounts a component in the new host volume on the second enabled host. Pauses the job.
15 // Mount the replicated volume(s) on a host. 16 PresentStorageVolumes ($Rep1, $mount_host) onerror pauseat E2: 17 DiscoverDiskDevices ($mount_host, $Rep1) onerror continue 18 $HV1 = CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host) onerror pauseat E2: 19 $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E3: 20 // 21 // Wait for user to initiate rollback. 22 Pause () 23 // 24 // Rollback.
2 // 3 // Assign some variables that will be used in this job. 4 $source_storvol_unc1 = SetVariable(%source_storvol_unc1%) 5 $dest_storvol1 = SetVariable(%dest_storvol1%) 6 $mount_host = SetVariable(%mount_host%) 7 // 8 // Validate that resources are as expected.
• 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 virtual disks with AdvFS volumes that have heavy I/O, select the option Suspend source before replication. See Suspending I/O before replicating AdvFS volumes. Example This template was generated to replicate one storage volume.
C. D. 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. For information on controller version feature support, see the HP P6000 Enterprise Virtual Array Compatibility Reference. 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.
18 DO { 19 $Rep1 = SnapshotStorageVolumesToContainers ($source_storvol_list, $dest_container_list, FULLY_ALLOCATED, NOWAIT) onerror pauseat E2: 20 // 21 } ALWAYS { 22 // Restore the writeback cache on the storage volume(s). 23 SetStorageVolumesWriteCacheMode ($source_storvol_list, WRITE_CACHE_ENABLED, NOWAIT) onerror continue 24 // 25 } 26 // 27 // Wait for user to initiate rollback.
Template options • Include e-mail notification. Adds a command for e-mail notification of the job instance status. See SetNotificationPolicy. Comments • Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for remote replication guidelines. Example This template was generated to create one DR group pair. Line Task 86 Jobs 1 // Setup Continuous Access. 2 // 3 // Assign some variables that will be used in this job.
29 // 30 Exit (SUCCESS) 31 // 32 // Failure exit - no rollback needed. 33 E1: Exit (FAILURE) 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.
13 // Resume the non-critical DR group(s). 14 E2: SetDrGroupSuspend ($DR_Group_name_unc1, RESUMED) onerror pauseat E2: 15 // 16 Exit (SUCCESS) 17 // 18 // Failure exit - no rollback needed. 19 E1: Exit (FAILURE) Unmount and delete existing host volumes (template) Template summary Unmounts and deletes host volumes. Template options • Number of volumes to unmount and delete. Adds commands for each volume. • Include e-mail notification.
Unmount existing host volumes (template) Template summary A. B. Unmounts an existing* host volume on an enabled host. Existing refers to a host volume that is created by means other than this job. The volume must exist and be in the replication manager database when this job is run. The underlying storage volume remains presented to the host. Template options • Number of volumes to unmount. Adds commands for each volume. • Include e-mail notification.
2 Job Commands Job commands // (comment) Adds and identifies a comment line in a job. The double slash indicates a comment line. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: // Comment. Enter your comment text. Examples // This job creates daily tape backups // The next command replicates the sales database Comments • Associated validation commands. None. • Agent and license prerequisites. None. • Command result value. None.
Examples AddDrGroupMember ( "\\ArrayA2\DrGrpPets", "\\ArrayA2\Cats", "\\ArrayB7\DskGrp3", "Cats", SAME ) Comments • Associated validation commands. ValidateStorageSystem, ValidateStorageVolume. • 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.
Replica Respository Name (%replica_repository_name%). Select or enter the name of the repository to which the replicas are to be added. UNC Storage Volume Names (%storvol_unc_names%). Select or enter the UNC name of the replica be added. Examples AddReplicasToReplicaRepository ("RR-HostVol1", ("\\ArrayA2\Cats_backup", "\\ArrayA2\Dogs_backup") ) Comments • Associated validation commands. None • Agent and license prerequisites.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ConvertStorageVolumeIntoContainer ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to be converted to a container. Examples ConvertStorageVolumeIntoContainer ( "\\ArrayA2\Cats" ) Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites. None. • Command result value.
ConvertStorageVolumesIntoContainers Converts storage volumes (virtual disks) to storage containers. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ConvertStorageVolumesIntoContainers ( %storvol_unc_name% ) List of UNC Storage Volume Names (%storvol_unc_list%). Select or enter the UNC names of storage volumes to be converted. See Argument lists. Or, select a variable used in a prior step that represents the storage volumes.
Examples CreateContainer ( "\\ArrayA2\CatsContainer", 1, RAID0, "\\ArrayA2\DskGrp4", Fully_Allocated) Comments • Associated validation commands. None. • 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.
• OS specifics. Yes. See examples above. • See Resource names and UNC formats. CreateContainersForHostVolume Creates a managed set of storage containers that correspond to the virtual disks that underlie a host volume. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: CreateContainersForHostVolume ( %hostvol_unc_name%, %managed_set_name%, %allocation_pol%) UNC Host Volume Name (%hostvol_unc_name%).
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: CreateContainersForHostVolumeGroup ( %hostvolgroup_unc_name%, %managed_set_name%, %allocation_pol%) 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.
LUN Number. Select or enter a host LUN for the presented storage volume. The LUN cannot already be in use when the job is run. Access Type. Select or enter the type of host I/O to allow with the presented storage volume. Choices are none, read, and read_write. Host Type. Select or enter the host type. Choices are HOST_FC_PORT or HOST_ISCSI. Examples CreateDiskDevice ( "\\ArrayA2\Cats", "HostA2", 12, READ_WRITE, HOST_FC_PORT) Comments • Associated validation commands. ValidateHost, ValidateStorageVolume.
AutoSuspend On Link Down. Select or enter a mode. Choices are true (enabled) and false (disabled). IO Mode. Select or enter the I/O mode. Choices are synchronous and asynchronous. Async Type. Select or enter the Async Type used when IO Mode is set to asynchronous. Choices are ASYNC_TYPE_NULL, ASYNC_TYPE_BASIC and ASYNC_TYPE_ENHANCED. The ASYNC_TYPE_NULL option simulates current default behavior.
Home True False SetDrGroupHome Suspension mode Resumed Resumed SetDrGroupSuspend • After a DR group pair is created, you can add more virtual disks. See AddDrGroupMember. • When a job is run, some job arguments may specify features that are not available on the target array. • See Resource names and UNC formats. CreateDrGroupFromHostVolume Creates a DR group pair by specifying a host volume as the source.
Examples These examples show host volume mount points. Device names can also be used.
• Values for the following properties cannot be specified in the CreateDrGroupFromHostVolume command. These properties can be changed in the same job, or in another job, by using the commands shown.
Solaris $Rep1=SnapcloneHostVolume ( "\\HostA2\/usr/cats", SAME, WAIT ) ** CreateHostVolume ( "\\HostA2\/usr/cats", $Rep1, "HostA4", HOST_FC_PORT ) Tru64 UNIX $Rep1=SnapcloneHostVolume ( "\\HostA2\dom01#fset1", SAME, WAIT ) ** CreateHostVolume ( "\\HostA2\dom01#fset1", $Rep1, "HostA4", HOST_FC_PORT ) Windows $Rep1=SnapcloneHostVolume ( "\\HostA2\E:\pets\cats", SAME, WAIT ) ** Drive CreateHostVolume ( "\\HostA2\E:\", $Rep1, "HostA4", HOST_FC_PORT) Drive & folders CreateHostVolume ( "\\HostA2\E:\pets\
Linux CreateHostVolumeDiscrete ( "7", "\\ArrayA2\Cats", "HostA4", HOST_FC_PORT) OpenVMS Not supported Solaris CreateHostVolumeDiscrete ( "7", "\\ArrayA2\Cats", "HostA4", HOST_FC_PORT) Tru64 UNIX CreateHostVolumeDiscrete ( "0", "\\ArrayA2\Cats", "HostA4", HOST_FC_PORT) Windows CreateHostVolumeDiscrete ( "1", "\\ArrayA2\Cats", "HostA4", HOST_FC_PORT) Comments • Associated validation commands. ValidateHost, ValidateHostVolume, ValidateStorageVolume. • Agent and license prerequisites.
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 (**).
Storage Volume List (%storvol_snap_list%). Select the variable assigned to the previous replication in the job or enter a list. See Argument lists. 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. Host Type. Select or enter the host type. Choices are HOST_FC_PORT or HOST_ISCSI. Examples These examples show host volume mount points. Device names can also be used.
Replica Repository Source Type. Select the type of volume that is being replicated. Choices are: host_volume, host_volume_group and host_disk_device. Source UNC Name (%source_unc_name%). Select or enter the UNC name of the host volume, host volume group, or host disk device that is being replicated. Replica Repository Type. Select the usage type for the replica repository. Choices are: instant_restore and round_robin. Comment. Enter a comment about the replica repository.
UNC Disk Group Name. Select or enter the name of the disk group in which the storage volume is to be created. Examples CreateStorageVolume ( "\\ArrayA2\Cats", 1, RAID0, "\\ArrayA2\Default Disk Group" ) Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites. None. • Command result value. Storage volume (virtual disk) name (UNC). For a complete list, see Command result values. • OS specifics. None.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteContainer ( %container_unc_name% ) UNC Container Name (%container_unc_name%). Select or enter the UNC name of the storage container to be deleted. Examples DeleteContainer ( "\\ArrayA2\CatsContainer" ) Comments • Associated validation commands. None. • Agent and license prerequisites. None. • 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. • If you delete a remote copy, the data in it cannot be retrieved. • This action is disabled when one or more selected DR groups are in a suspended, logging, or failsafe-locked state. • See Resource names and UNC formats. DeleteDrGroupMember Removes a source storage volume from a source DR group.
UNC Host volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume (on an enabled host) to be deleted. Host Type. Select or enter the host type. Choices are HOST_FC_PORT or HOST_ISCSI. Examples These examples show host volume mount points. Device names can also be used.
Tru64 UNIX DeleteHostVolumeGroup ( "\\HostA2\dom01", HOST_FC_PORT) Windows Not applicable 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. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups.
Examples DeleteStorageVolume ( "\\ArrayA2\Cats" ) 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. • See Resource names and UNC formats. DeleteStorageVolumes Deletes multiple storage volumes (virtual disks).
Examples DeleteStorageVolumesInManagedSet ( "svol_cats_set" ) 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. DetachMirrorclones Detaches fractured mirrorclone virtual disks from their source virtual disks. The detached virtual disks become independent (original) virtual disks.
Virtual Disk Name (%storvol_unc_name%). Select or enter full UNC name of the presented storage volume that you want the host to discover. Examples DiscoverDiskDevice ( "HostA2", "\\ArrayA2\Cats" ) 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. • See Resource names and UNC formats.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DiscoverDiskDevicesForDrGroup ( %hostname%, %drgroup_unc_name% ) Host Name (%hostname%). Select or enter the name of the enabled host on which the DR group's raw virtual disks have been presented. DR Group UNC Name. Select or enter the UNC name of the DR group for which you want to force the bus scan to recognize its presented storage volumes as host volumes.
• Command result value. None. For a complete list, see Command result values. • OS specifics. None. • See Resource names and UNC formats. 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.
Comments • Associated validation command. None. • Agent and license prerequisites. None. • Command result value. 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. The copy is created on the same management server as the active database.
File name (%filename%). Do one of the following. • If you want to name the file yourself, enter a name, for example Copy_of_myjob. Do not include a file extension. The replication manager automatically adds the extension .xml. • If you want the replication manager to assign a file name, leave the argument empty. Overwrite. Select whether or not to overwrite the file name that you entered. Choices are true and false. Applicable only when you choose to enter a file name.
• During actual emergencies, the partner DR group may not be available to perform the role of a destination. • See Resource names and UNC formats. FailoverDrGroups Reverses the source and destination roles in multiple DR group pairs. . Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: FailoverDrGroups ( %drgroups%, FALSE ) List of DR groups ( %drgroups%). Select or enter the UNC names of the destination DR groups to failover.
Examples These examples show host volume mount points. Device names can also be used.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: FractureHostDiskDeviceMirrorclone ( %source_hoststorvol_unc_name%, WAIT ) UNC Host Disk Device Name (%source_hoststorvol_unc_name%). Select or enter the name of the host disk device whose mirrorclones of the underlying storage volumes are to be fractured. Wait Flag. Select WAIT or NOWAIT. See Wait/nowait argument.
Tru64 UNIX FractureHostVolumeGroupMirrorclones ( "\\HostA2\dom01#fset1", WAIT ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup. • Agent and license prerequisites. Requires a host agent. • Command result value. List of fractured mirrorclone names. For a complete list, see Command result values. • OS specifics. Yes. See examples above. • See Resource names and UNC formats.
• A flush of the underlying source virtual disks write caches is required before the fracture is started. See SetHostVolumesWriteCacheMode and WaitForHostVolumesWriteCacheFlush. • This command cannot be used with some older versions of controller software. For information on controller version feature support, see the HP P6000 Enterprise Virtual Array Compatibility Reference. • See Resource names and UNC formats.
Full path name. Enter the full path and file name of the RSM database copy to import. Examples Import ( "C:\colorado\RSMdb_on_server2_Mar_15_2007.xml") Import ( "C:\colorado\CADATA_20050211135232.export" ) Comments • Associated validation commands. None. • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • After import procedures.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: InstantRestoreFromMirror ( %mirror_unc_name%, %source_storvol_unc_name%, %wait_nowait% ) UNC Mirrorclone Storage Volume Name (%storvol_unc_name%). Select or enter the name of its fractured mirrorclone (to restore from). UNC Source Storage Volume Name (%storvol_unc_name%). Select or enter the name of the source storage volume to be restored. Wait Flag. Select WAIT or NOWAIT. See Wait/nowait argument.
• OS specifics. None. • The mirrorclone to restore from must be fractured. See the HP P6000 Replication Solutions Manager User Guide for mirrorclone guidelines. • See Resource names and UNC formats. Launch Executes a command, batch file, or script on an enabled host. The wait and success value arguments allow you to control how to proceed to the next step in the job. NOTE: The Launch job verb times out after six hours.
• Commands, batch file names, script file names, and command arguments must be valid and formatted appropriately for the host's operating system. The replication manager does not check or validate launch command entries for compatibility with the host OS. • If a command argument contains double quotes ("), each instance must be escaped by prefixing another double quote. For example, if the host command argument is set "big", enter set "big".
Comments • Associated validation commands. None. • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • When the job is run, the message also appears in the event window and the Job Monitor window. MigrateMirrorclone Swap Vraid level and disk groups between the mirrorclone and its source virtual disk without changing their name or roles.
Examples MigrateMirrorclones ( ( "\\Array2\Cats_copy", "\\Array2\Dogs_copy"), WAIT) Comments • Associated validation commands. None. • Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volumes are located. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for mirrorclone guidelines.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: MirrorcloneHostDiskDeviceToContainer ( %source_hoststorvol_unc_name%, %container_unc_name%, WAIT ) UNC Host Disk Device Name (%source_hoststorvol_unc_name%). Select or enter the UNC name of the host disk device for which a mirrrorclone is to be created. UNC Container Name (%container_unc_name%). Select or enter the UNC name of the storage container to be used for the mirrorclone. Wait Flag.
Examples AIX MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", WAIT ) HP-UX MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, "hvol_cats_set", WAIT ) Linux MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, "hvol_cats_set", WAIT ) OpenVMS MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, "hvol_cats_set", WAIT ) Solaris MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/
Tru64 UNIX MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\dom01#fset1", "\\ArrayA2\CatsContainer", WAIT ) Windows Not applicable 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. • See Resource names and UNC formats.
MirrorcloneHostVolumeToContainers Creates synchronized mirrorclones of the storage volumes (virtual disks) that underlie a host volume, by using containers. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: MirrorcloneHostVolumeToContainers ( %source_hostvol_unc_name%, %container_unc_names%, WAIT ) UNC Host Volume Name (%source_hostvol_unc_name%).
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: MirrorcloneHostVolumeToContainersInManagedSet ( %source_hostvol_unc_name%, %managed_set_of_containers%, WAIT ) UNC Host Volume Name (%source_hostvol_unc_name%). Select or enter the name of the host volume (on an enabled host) whose underlying storage volumes are to be replicated by the mirrorclone method. Managed Set Name (%managed_set_of_containers%).
UNC Source Storage Volume Name (%storvol_unc_name%). Select or enter the name of the source storage volume. UNC Container Name (%container_unc_name%). Select or enter the UNC name of the storage container that is to become the local mirrorclone. Wait or No Wait (%wait_nowait%). Select wait or nowait. See Wait/no wait argument. Examples MirrorcloneStorageVolumeToContainer ( "\\ArrayA2\Cats", "\\ArrayA2\CatsContainer", WAIT ) Comments • Associated validation commands. ValidateStorageVolume.
Linux MountEntireVolumeGroup ( "cats_vg", "vg02", "/backup" ) OpenVMS Not applicable Solaris MountEntireVolumeGroup ( "cats_vg", "vg02", "/backup" ) Tru64 UNIX MountEntireVolumeGroup ( "dom01_RV1", "\\HostA2\dom01", "new_" ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup. • Agent and license prerequisites. Requires a host agent. • Command result value. Destination volume group name (UNC). For a complete list, see Command result values.
Comments • Associated validation commands. ValidateHostVolume. • Agent and license prerequisites. Requires a host agent. • Command result value. Mount point name (UNC). For a complete list, see Command result values. • OS specifics. Yes. See examples above. Multiple mounts are subject to OS-specific rules. HP-UX. Multiple mount points for the same host volume are not allowed by the OS. Tru64 UNIX.
• Command result value. Mount point name (UNC). For a complete list, see Command result values. • OS specifics. Yes. See examples above. 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.
Type of Replication (%copytype%). Select or enter the type of replication for which the container is prepared. Valid options include DEMAND_ALLOCATED, FULLY_ALLOCATED, SNAP_CLONE, or MIRROR_CLONE. Examples PrepareContainer ( "\\ArrayA2\Cats", "\\ArrayA2\CatsContainer", SNAP_CLONE) Comments • Associated validation commands. Use ValidateSnapcloneStorageVolume if replication type is SNAP_CLONE. Use ValidateSnapshotStorageVolume if replication type is DEMAND_ALLOCATED or FULLY_ALLOCATED.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: PrepareContainerForHostDiskDeviceReplication ( %hoststorvol_unc_name%, %managed_set_of_containers%, %copytype% ) UNC Host Storage Volume Name (%hoststorvol_unc_name%). Select or enter the full UNC name of the host storage volume for which you are preparing a container. Managed set of containers (%managed_set_of_containers%). Select or enter the name of the managed set in which the containers are members.
Type of Replication (%copytype%). Select or enter the type of replication for which the container is prepared. Valid options include DEMAND_ALLOCATED, FULLY_ALLOCATED, or SNAP_CLONE.
Linux PrepareContainersForHostVolumeGroupReplication ( "\\HostA2\/var/cats_vg","hvol_cats_set", FULLY_ALLOCATED ) OpenVMS Not applicable Solaris PrepareContainersForHostVolumeGroupReplication ( "\\HostA2\/usr/cats_vg","hvol_cats_set", FULLY_ALLOCATED ) Tru64 UNIX PrepareContainersForHostVolumeGroupReplication ( "\\HostA2\dom01","hvol_cats_set", FULLY_ALLOCATED ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolume.
• CAUTION: Ensure that the storage volume is not already presented to the host. Multiple presentations to the same host can cause errors. • See Resource names and UNC formats. PresentStorageVolumes Begins the presentation of storage volumes to an enabled host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: PresentStorageVolumes ( %storvol_unc_list%, %host_name%, HOST_FC_PORT) Storage Volume List (%storvols_unc_list%).
Host_Name (%host_name%). Select or enter the name of the host (Guest OS) for which the storage volume (virtual disk) presentation is to begin. LUN Number. Select or enter a presentation LUN for the storage volume. The LUN cannot already be in use when the job is run. You can allow storage controller software to assign a LUN. Access Type. Select or enter the type of host I/O to allow with the storage volume. Choices are none, read, and read_write. Host Type. Select or enter the host type.
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. • CAUTION: Ensure that none of the storage volumes are already presented to the host. Multiple presentations to the same host can cause errors.
PresentThinProvisionedStorageVolumes Begins the presentation of thin provisioned storage volumes to an enabled host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: PresentThinProvisionedStorageVolume ( %storvol_unc_name%, %host_name%, 0, READ_WRITE, HOST_FC_PORT, FALSE) Storage volume list (%storvol_unc_name%). Select or enter the names of the storage volumes whose presentation is to begin. See Argument lists.
Examples RemoveDiskDevice ( “\\ArrayA2\Cats, "HostA2", HOST_FC_PORT) 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. • This command is typically used with raw disk devices. Raw disk devices are not mounted, thus they cannot be removed by using the UnmountHostVolume command.
Mirrorclone UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC names of the fractured mirrorclones to be resynchronized with their source storage volumes. Examples ResyncMirrorclones ( ("\\Array2\Cats_copy", "\\Array2\Dogs_copy", "\\Array3\Cars_copy") ) ResyncMirrorclones ( $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites.
• OS specifics. Yes. See examples. • See Resource names and UNC formats. RetainLatestRoundRobinReplicasForHostVolume Specifies the number of replicas of a host volume to use in a job for round robin replication. For example, if you specify 3, the first three times the job is run a new replica is created. When run the fourth time, the oldest replica of the three replicas is deleted and a new replica is added, and so on.
Source Host Volume Group UNC Name (%source_hostvolgroup_unc_name%). Select or enter the UNC name of the host volume group to be replicated in a round robin job. Number of Copies Enter the number of replicas to use in the round robin replication job. The maximum is seven.
• The e-mail message is sent only if the step in the job is executed. Compare with SetNotificationPolicy. • You can send e-mail (text message) to a phone number if the e-mail service supports it. SetDiskGroupForSnapclone Temporarily overrides a storage system default and specifies the disk group in which snapclones are to be created for the snapclones created by the job.
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. • OS specifics. None. • When a job is run, some job arguments may specify features that are not available on the target array. • See Resource names and UNC formats.
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. • OS specifics. None. • See Resource names and UNC formats. SetDrGroupDestinationAccess Specifies the destination host access mode of a DR group pair.
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. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • Guidelines apply. See the HP P6000 Replication Solutions Manager User Guide for remote replication guidelines.
SetDrGroupHome Specifies the home property of a DR group pair. 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 • Associated validation commands. None.
• OS specifics. None. • See Resource names and UNC formats. SetDrGroupMaxLogSize Specifies the maximum log disk size for a DR group. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetDrGroupMaxLogSize ( %drgroup_unc_name%, 0 ) UNC Disk Group Name ( %drgroup_unc_name%). Select or enter the UNC name of the DR group whose maximum log disk size is to be set. Max Size (MB). Enter the maximum size (GB).
• OS specifics. None. • See Resource names and UNC formats. SetDrGroupSuspend Suspends or resumes remote replication in a DR group pair. 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.
DR Group Routing Protocol. Select the replication protocol. Values are HPCA (HP FC Data Replication Protocol), SCSIFC (HP SCSI FC Compliant Data Replication Protocol), or EITHER. Examples SetDrProtocolType ( "ArrayA2", "SCSIFC" ) 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. • OS specifics. None.
Solaris SetHostDiskDeviceWriteCacheMode ( "\\HostA2\/dev/dsk/c0t5d0s6", WRITE_CACHE_ENABLED, NOWAIT ) Tru64 UNIX SetHostDiskDeviceWriteCacheMode ( \\HostA2\/dev/disk/dsk100c", WRITE_CACHE_ENABLED, NOWAIT ) Windows SetHostDiskDeviceWriteCacheMode ( "\\HostA2\Disk3", WRITE_CACHE_ENABLED, NOWAIT ) 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.
Tru64 UNIX SetHostVolumeGroupWriteCacheMode ( "\\HostA2\dom01", WRITE_CACHE_ENABLED, NOWAIT ) Windows Not applicable 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. • See Resource names and UNC formats.
Tru64 UNIX SetHostVolumeWriteCacheMode ( "\\HostA2\dom01#fset1", WRITE_CACHE_ENABLED, NOWAIT ) Windows Drive SetHostVolumeWriteCacheMode ( "\\HostA2\E:\", WRITE_CACHE_ENABLED, NOWAIT ) Drive & folders SetHostVolumeWriteCacheMode ( "\\HostA2\E:\pets\cats", WRITE_CACHE_ENABLED, NOWAIT ) Comments • Associated validation commands. ValidateHostVolume. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see Command result values.
Comments • Associated validation commands. ValidateHostVolume. • 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. SetListVariable Creates a variable assignment and a list of values. The variable can then be entered in arguments throughout a job rather than entering the individual values.
job_paused Job instance has been paused. Messages: Job state: executed a Pause() step. Job state: paused due to error or user action. job_started Job instance has started. job_started_or_stopped Job instance has started. Also when its A start message is issued when a job status changes to any non-executing state, instance is initially started. No message is such as completed, failed, and paused. sent when a paused instance is continued.
Examples SetPreferredPortConfiguration ( 5000-1FE1-0015-46E0, 5000-1FE1-5003-C2D0, CONTROLLER_A, CONTROLLER_A, HOSTPORT_1, PREFPORT_PRIORITY_1, TRUE, 20 ) Comments • Associated validation commands. • Agent and license prerequisites. • Command result value. See Command result values. • OS specifics. None. SetStorageVolumeName Renames a storage volume (virtual disk).
Examples SetStorageVolumeSize ( "\\ArrayA2\Cats", 10) 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. • See Resource names and UNC formats. SetStorageVolumeWriteCacheMode Specifies the write cache mode for a storage volume (virtual disk).
Write Cache Mode. Select the write cache mode for the storage volume. Choices are write_cache_enabled, and write_cache_disabled Wait Flag. Select WAIT or NOWAIT. See Wait/nowait argument. 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.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapcloneDiskDevice ( %host_storvol_unc_name%, "", SAME, %new_storvol_name%, WAIT ) Host Storage Volume UNC Name (%host_storvol_unc_name%). Select or enter the UNC name of the host disk device to be copied. Disk Group UNC Name. Select or enter the UNC name of the storage disk group in which the snapclone copy is to be created. RAID Level. Select the redundancy level for the copy.
SnapcloneHostDiskDeviceToContainerInManagedSet Creates a preallocated snapclone (point-in-time copy) of the storage volume (virtual disk) that underlies a host disk device, by using a container in a managed set. The snapclone copy is presented to the enabled host and a host bus scan is performed to identify the presented storage.
UNC Host Volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume to be copied. RAID Level. Select the storage redundancy level for the copies. Choices are RAID0, RAID1, RAID5, RAID6, and same. See virtual disks redundancy level. Wait for Discovery. Select wait or nowait. See Wait/nowait argument. Examples Host volume mount points or device names can be used.
RAID Level. Select the storage redundancy level for the copies. Choices are RAID0, RAID1, RAID5, RAID6, and same. See virtual disks redundancy level. Wait for Discovery Select wait or nowait. See Wait/nowait argument. Examples These examples show host volume mount points. Device names can also be used.
Examples AIX SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", NOWAIT ) HP-UX SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", "hvol_cats_set", NOWAIT ) Linux SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", "hvol_cats_set", NOWAIT ) OpenVMS Not applicable Solaris SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", "hvol_cats_set", NOWAIT ) Tru64 UNIX SnapcloneHostVolumeGrou
Solaris SnapcloneHostVolumeToContainers ( "\\HostA2\/usr/cats", ("\\ArrayA2\CatsContainer", WAIT ) Tru64 UNIX SnapcloneHostVolumeToContainers ( "\\HostA2\/dev/disk/dsk100c", ("\\ArrayA2\CatsContainer", WAIT ) Windows Drive SnapcloneHostVolumeToContainers ( "\\HostA2\E:\", ("\\ArrayA2\CatsContainer", WAIT ) Drive & folders SnapcloneHostVolumeToContainers ( "\\HostA2\E:\pets\cats", ("\\ArrayA2\CatsContainer", WAIT ) Comments • Associated validation commands.
Examples Host volume mount points or device names can be used.
RAID Level. Select the storage redundancy level that you want to apply to the copy. Choices are RAID0, RAID1, RAID5, RAID6, and same. See virtual disks redundancy level. Snapclone Name. Enter a name for the copy. Wait for Discovery. Select wait or nowait. See Wait/nowait argument. Examples SnapcloneStorageVolume ( "\\ArrayA2\Cats", "\\ArrayA2\DskGrp3", SAME, "Cats_copy", WAIT ) Comments • Associated validation commands. ValidateStorageVolume, ValidateSnapcloneStorageVolume.
• This command cannot be used with some older versions of controller software. For information on controller version feature support, see the HP P6000 Enterprise Virtual Array Compatibility Reference. • See Resource names and UNC formats. SnapcloneStorageVolumesToContainers Creates a preallocated snapclones (point-in-time copies) of a multiple storage volumes, by using containers.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotDiskDevice ( %host_storvol_unc_name%, DEMAND_ALLOCATED, SAME, %new_storvol_name%, WAIT ) Host Storage Volume UNC Name (%host_storvol_unc_name%). Select or enter the UNC name of the host disk device to be copied. Snapshot Type. Select demand_allocated or fully_allocated. RAID Level. Select the redundancy level for the copy. Choices are RAID0, RAID1, RAID5, RAID6, and same.
SnapshotHostDiskDeviceToContainerInManagedSet Creates preallocated snapshots (point-in-time copies) of the storage volumes (virtual disks) that underlie a host disk device, by using containers in a managed set. The snapshot copies are presented to the enabled host and a host bus scan is performed to identify the presented storage.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotHostVolume ( %hostvol_unc_name%, DEMAND_ALLOCATED, SAME, WAIT ) UNC Host Volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host disk device to be copied. Snapshot Type. Select demand_allocated or fully_allocated. RAID Level. Select the redundancy level for the copy. Choices are RAID0, RAID1, RAID5, RAID6, and same. See virtual disks redundancy level. Wait for Discovery.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotHostVolumes ( %storvol_list%, DEMAND_ALLOCATED, SAME, WAIT ) List of Storage Volumes underlying the Host Volume (%storvol_list%). Select or enter the list of the storage volumes underlying the host volume. Snapshot Type. Select demand_allocated or fully_allocated. RAID Level. Select the redundancy level for the copy. Choices are RAID0, RAID1, RAID5, RAID6, and same.
The snapclone copies are presented to the enabled host and a host bus scan is performed to identify the presented storage. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotHostVolumeGroup ( %volume_group_name%, DEMAND_ALLOCATED, SAME, WAIT ) UNC Host Volume Name (%volume_group_name%). Select or enter the UNC name of the host volume group to copy. Snapshot Type. Select demand_allocated or fully_allocated. RAID Level.
The snapclone copies are presented to the enabled host and a host bus scan is performed to identify the presented storage. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotHostVolumeGroups ( %storvol_list%, DEMAND_ALLOCATED, SAME, WAIT ) List of Storage Volumes underlying the Host Volume Group (%storvol_list%). Select or enter the list of the storage volumes underlying the host volume. Snapshot Type. Select demand_allocated or fully_allocated.
SnapshotHostVolumeGroupToContainersInManagedSet Creates preallocated snapshots (point-in-time copies) of the storage volumes (virtual disks) that underlie a host volume group, by using containers in a managed set.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotHostVolumeToContainers ( %hostvol_unc_name%, %container_unc_names%, FULLY_ALLOCATED, NOWAIT ) UNC Host Volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host disk device to be copied. Snapshot Type. Select demand_allocated or fully_allocated. Wait for Discovery. Select wait or nowait. See Wait/nowait argument. Examples These examples show host volume mount points.
SnapshotHostVolumeToContainersInManagedSet Creates preallocated snapshots (point-in-time copies) of the storage volumes (virtual disks) that underlie a host volume, by using containers in a managed set. The snapshot copies are presented to the enabled host and a host bus scan is performed to identify the presented storage.
• This command cannot be used with some older versions of controller software. For information on controller version feature support, see the HP P6000 Enterprise Virtual Array Compatibility Reference. • See Resource names and UNC formats. SnapshotStorageVolume Creates a snapshot (point-in-time copy) of a storage volume.
Snapshot Type. Select demand_allocated or fully_allocated. Wait for Discovery. Select wait or nowait. See Wait/nowait argument. Examples SnapshotStorageVolumeToContainer ( "\\ArrayA2\Cats", "\\ArrayA2\CatsContainer", DEMAND_ALLOCATED, NOWAIT ) Comments • Associated validation commands. ValidateSnapshotStorageVolume. • Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volume is located. • Command result value.
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. • Command result value. List of snapshot storage volume names (UNC). For a complete list, see Command result values. • OS specifics. None. • Some storage volumes cannot be copied using snapshot replication. See the HP P6000 Replication Solutions Manager User Guide for snapshot guidelines.
Examples AIX UnmountEntireVolumeGroup ( "\\HostA2"\cats_vg" ) HP-UX UnmountEntireVolumeGroup ( "\\HostA2"\cats_vg" ) Linux UnmountEntireVolumeGroup ( "\\HostA2"\cats_vg" ) OpenVMS Not applicable Solaris UnmountEntireVolumeGroup ( "\\HostA2"\cats_vg" ) Tru64 UNIX UnmountEntireVolumeGroup ( "\\HostA2\dom01" ) Windows Not applicable Comments • Associated validation commands. ValidateHost. • Agent and license prerequisites. Requires a host agent. • Command result value. None.
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. • See Resource names and UNC formats. UnmountHostVolumes Instructs enabled hosts to unmount host volumes. The host OS removes host volume mount points, but the underlying storage volume remains presented to the host.
UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume whose presentation is to end. Host Name (%host_name%). Select or enter the name of the host for which the presentation is to end. When specifying a guest OS-enabled host, the volume is unpresented from the VM server to which the guest OS belongs. Host Type. Select or enter the host type. Choices are HOST_FC_PORT or HOST_ISCSI.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: UnpresentThinProvisionedStorageVolume ( %storvol_unc_name%, %host_name%, HOST_FC_PORT, FALSE) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume whose presentation is to end. Host Name (%host_name%). Select or enter the name of the host for which the presentation is to end.
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. • See Resource names and UNC formats. 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.
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 • 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. • See 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. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateHostVolumeGroup ( %volume_group_unc_name% ) UNC Host Volume Group Name (%volume_group_name%).
Examples These examples show host volume mount points. Device names can also be used.
Comments • Agent and license prerequisites. Requires a host agent. Requires a local replication license for the storage system on which the underlying storage volume is located. • Command result value. None. For a complete list, see Command result values. • OS specifics. Yes. See examples. • See Resource names and UNC formats. ValidateSnapcloneHostVolumeGroup Checks if a host volume group is an available resource and that it can be replicated using the snapclone method.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateSnapcloneStorageVolume ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume to validate. Examples ValidateSnapcloneStorageVolume ( "\\ArrayA2\Cats" ) Comments • Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volume is located. • Command result value. None.
Comments • Agent and license prerequisites. Requires a host agent. Requires a local replication license for the storage system on which the underlying storage volume (presented source) is located. • Command result value. None. For a complete list, see Command result values. • OS specifics. Yes. See examples. • See Resource names and UNC formats. ValidateSnapshotHostVolumeGroup Checks if a host volume group is an available resource and that it can be replicated using the snapshot method.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateSnapshotStorageVolume ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to validate. Examples ValidateSnapshotStorageVolume ( "\\ArrayA2\Cats" ) Comments • Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volume is located. • Command result value. None.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateStorageVolume ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to validate. Examples ValidateStorageVolume ( "\\ArrayA2\Cats" ) Comments • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • See Resource names and UNC formats.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: Wait ( "0:0:10" ) Timespan. Enter the amount of time to wait. The format is hours:minutes:seconds (hh:mm:ss) Examples Wait ( "1:15:0" ) – Halts the job for a period of 1 hour, 15 minutes, and 0 seconds. Comments • Associated validation commands. None. • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None.
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%). Select or enter the UNC name of the DR group to check for an I/O mode (synchronization) change. Examples WaitDrGroupSynchronizationTransition ( "\\ArrayA2\DrGrpPets" ) Comments • Associated validation commands. None. • Agent and license prerequisites.
• OS specifics. Yes. See examples. • See Resource names and UNC formats. WaitForHostVolumeGroupWriteCacheFlush Halts a job until the write caches have been flushed for all of the storage volumes (virtual disks) that underlie a host volume group. When all of the write caches have been flushed, the job proceeds to the next step.
Examples Host volume mount points or device names can be used.
Comments • Associated validation commands. ValidateHostVolume. • Agent and license prerequisites. Requires host agent. • Command result value. None. For a complete list, see Command result values. • OS specifics. Yes. See examples above. • See Resource names and UNC formats. WaitForJob Halts this job and checks for a specific state in another job (job instance). When the state is detected, this job proceeds to the next step. See Job instances and Job states.
Comments • Associated validation commands. None. • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • This command is typically used to detect replicas that have been created within the same job using the nowait argument. See use with the Nowait argument. • See Resource names and UNC formats.
Examples WaitForStorageVolumeWriteCacheFlush ( "\\ArrayA2\Cats" ) 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. • See Resource names and UNC formats. WaitForStorageVolumesWriteCacheFlush Halts a job until the write cache of the storage volumes have been flushed.
Examples AIX WaitHostDiskDeviceNormalization ( “\\HostA2\/dev/dsk/hd1” ) HP-UX WaitHostDiskDeviceNormalization ( “\\HostA2\/dev/dsk/c2t0d2” ) Linux WaitHostDiskDeviceNormalization ( “\\HostA2\/dev/sda3” ) OpenVMS WaitHostDiskDeviceNormalization ( “\\HostA2\$1$DGA2:” ) Solaris WaitHostDiskDeviceNormalization ( “\\HostA2\/dev/dsk/c0t5d0s6” ) Tru64 UNIX WaitHostDiskDeviceNormalization ( “\\HostA2\/dev/disk/dsk100c” ) Windows WaitHostDiskDeviceNormalization ( “\HostA2\Disk3” ) Comments • Associat
Comments • Associated validation commands. ValidateHostVolume. • Agent and license prerequisites. Requires a host agent. • This command waits for the normalization of the storage volume underlying the host volume. To wait until normalization of both a storage volume and its replica are complete, also include the WaitStorageVolumesNormalization command. WaitStorageVolumeNormalization Halts a job until a specific storage volume (virtual disk) is normalized (unshared).
Examples WaitStorageVolumesNormalization ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs") ) WaitStorageVolumesNormalization ( $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolumes. • Agent and license prerequisites. None. • Command result value. None. For a complete list, see Command result values. • OS specifics. None. • See Resource names and UNC formats. WaitUntil Halts a job until a specific date and time, or time only.
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitVolumeGroupNormalization ( %volgroup_unc_name% ) UNC Host Volume Group Name (%volume_group_name%). Select or enter the UNC name of the host volume group to check for normalization. Examples These examples show host volume mount points. Device names can also be used.
3 Support and other resources Release history HP Replication Solutions Manager releases: Release Version Host agents 2012 Kit and Web update 5.6 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Red Hat Enterprise Linux 6.1 Sun Solaris Microsoft Windows VMware 2012 Kit and Web update 5.5 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Red Hat Enterprise Linux 6.1 Sun Solaris Microsoft Windows VMware 2011 Kit and Web update 5.4 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Red Hat Enterprise Linux 5.
Release February 2009 Kit and Web update Host agents 5.0 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Sun Solaris Microsoft Windows 4.0.1 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Sun Solaris Microsoft Windows February 2008 Kit and Web update 4.0 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Sun Solaris Microsoft Windows November 2007 Kit and Web update 3.1 HP-UX HP OpenVMS HP Tru64 UNIX IBM AIX Linux Sun Solaris Microsoft Windows June 2007 Kit and Web update 3.
Release Version Host agents Sun Solaris Microsoft Windows December 2004 Kit and Web update 1.0 HP-UX Linux Sun Solaris Microsoft Windows Contacting HP HP technical support Telephone numbers for worldwide technical support are listed on the HP support website: http://www.hp.
• HP P6000 Command View SW Suite DVD • HP P6000 Replication Solution Mg DVD • HP P6000 SmartStart SW for Linux CD Replication manager GUI. The replication manager GUI includes the online help. 1. Start or browse to the replication manager GUI. 2. To view the online help, select Help > Topics. 3. To download documentation from the HP website, select Help > Documentation.
Index C creating, 107 thin provisioned storage volume, 108 D documentation HP website, 216 J jobs arguments, 34 Command result values, 36 implicit, 41 imported, 41 instances, 33 templates, 48 transactions, 52 validation, 53 R related documentation, 216 T templates, job list, 48 throttling i/o template, 87 217