Page 1: Write Mode (Async/Sync Replication)
HP StorageWorks Replication Solutions Manager 4.0.1 user guide Part number: T3680-96308 Fourth edition: June 2008...
Page 2 Legal and notice information © Copyright 2004-2008 Hewlett-Packard Development Company, L.P. Conﬁdential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.21 1 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S.
Page 3: Table Of Contents
Contents About this guide ......17 Intended audience ........Prerequisites .
Page 4 Jobs e-mail server conﬁguration ......Jobs run history conﬁguration ......Licenses conﬁguration (applications) .
Page 5 Copying properties ........Copying properties - tips ....... . Filtering displayed resources .
Page 6 Resuming a DR group pair ....... Reverting a DR group pair to home ......Suspending a DR group pair .
Page 7 5 Host volumes ......Working with host volumes ....... . . About host volume resources .
Page 8 Dynamic capacity management ......Dynamic capacity management overview ..... . . DC-Management operation .
Page 9 Assignments (variables) ....... . . Branches ........Commands .
Page 10: Suspend On Failover
ConvertStorageVolumesIntoContainersUsingRepository ....CreateContainer ........CreateContainerForHostDiskDevice .
Page 11 MountVolumeGroupComponent ......Pause ........PresentStorageVolume .
Page 12: Write Mode Transitions
TestJobState ........UnmountEntireVolumeGroup ....... UnmountHostVolume .
Page 13: Working With Enabled Hosts
Managed sets of virtual disks (or containers) ......8 Oracle ......Working with Oracle resources .
Page 14: Enabled Hosts Properties Summary
Storage system concepts ........Replication licenses overview .
Page 15: Adding Enabled Hosts
Low-level refresh of virtual disks ......LUN ......... Preferred controller .
Page 16: Deleting Enabled Hosts
Tables 1 Document conventions ......
Page 17: About This Guide
About this guide This guide describes how to use HP StorageWorks Replication Solutions Manager (the replication manager). For the latest information about this product, see HP StorageWorks Replication Solutions Manager release notes. The location of this and other documents and web sites mentioned in this guide is provided in “Related documentation”...
Page 18: Document Conventions And Symbols
Other • HP StorageWorks Replication Solutions Manager release notes • HP StorageWorks Enterprise Virtual Array compatibility reference • HP StorageWorks Enterprise Virtual Array license key installation instructions • HP StorageWorks Business Copy EVA administrator guide • HP StorageWorks Continuous Access EVA administrator guide Document conventions and symbols Table 1 Document conventions Convention...
Page 19: Subscription Service
Collect the following information before calling: • Technical support registration number (if applicable) • Product serial numbers • Product model names and numbers • Error messages • Operating system type and revision level • Detailed questions For continuous quality improvement, calls may be recorded or monitored. Subscription service HP recommends that you register your product at the Subscriber’s Choice for Business web site: http://www.hp.com/go/e-updates.
Page 20 About this guide...
Page 21: Replication Solutions Manager
1 Replication Solutions Manager Finding replication documents Replication software kits. If you have a replication kit, the Documentation CD includes PDF ﬁles of several print-based documents. Replication manager GUI. The replication manager GUI includes the online help and user guide and PDF ﬁles of several print-based documents.
Page 22: What's New
What’s new New support Version 4.0.1 includes the following new or updated support compared to version 4.0. See the HP StorageWorks Enterprise Virtual Array compatibility reference for support and version details. • Storage systems. Updated. Version support is added for HP Enterprise Virtual Arrays controller software (XCS controller software).
Page 23: Release History
CLUI commands Replication Remarks type New parameter allows setting of failsafe on link-down/power-up support Set DR_Group property in certain versions of change controller software. See failsafe on link-down/power-up. Release History HP StorageWorks Replications Solutions Manager releases: HP StorageWorks Replication Solutions Manager 4.0.1...
Page 24 Host agents Arrays Release Version HP-UX HP OpenVMS HP Tru64 UNIX June 2008 4.0.1 IBM AIX HP EVA Web update Linux Sun Solaris Microsoft Windows HP-UX HP OpenVMS HP Tru64 UNIX February 2008 IBM AIX HP EVA Kit and Web update Linux Sun Solaris Microsoft Windows...
Page 25: Overview
Overview Capabilities HP StorageWorks Replication Solutions Manager is a centralized tool that simpliﬁes and automates local and remote replication features of HP arrays. The replication manager allows you to perform tasks by using its graphical user interface (GUI), jobs, and a command line user interface (CLUI). General replication management •...
Page 26: Remote Replication
• To use the local replication features on a given array, the replication manager veriﬁes that a valid HP Business Copy EVA replication license-to-use (LTU) exists for the array. For information on acquiring and installing local replication licenses, see the HP StorageWorks Business Copy EVA administrator guide.
Page 27: Host Agent Software
Host agent software A replication manager host agent is OS-speciﬁc software that enables interactions between a host and the replication manager server. A host that has a replication manager host agent installed is called an enabled host. See enabled and standard hosts.
Page 28: Simulation Mode
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.
Page 29: Replication Kits And Downloads
• True simulation – not a set of predeﬁned scenarios. Simulates GUI actions, jobs, and CLUI commands. • Allows you to create your own: • Simulated storage arrays. Select features such as array capacity, controller software versions and number of virtual disks. •...
Page 30: Conﬁguration Window
Conﬁguration window The conﬁguration window provides access to the replication manager conﬁguration settings. See also accessing the conﬁguration window. 1. Navigation pane 2. Status bar 3. Settings pane (jobs example) Replication Solutions Manager...
Page 31: Clui Window (In The Gui)
Content pane Information about available replication resources is displayed in the content pane. See replication resources. The following features are available in the pane. Item Description Actions > Print Prints the content pane. Refreshes the content pane, using data from the Actions >Refresh database.
Page 32: Keyboard And Right-Click Shortcuts
1. Command line 2. Response pane 3. Command history Keyboard and right-click shortcuts Right-click actions Right-click a resource to open its Actions menu. General shortcuts Action Key combination Copy selection Ctrl+C Cut selection Ctrl+X Extend selection left or right Shift+Left arrow or Shift+Right arrow Extend selection left or right Ctrl+Shift+Left or Ctrl+Shift+Right Extend selection to start or end...
Page 33: Menu Bar
List view shortcuts Action Key combination Extend selection up Shift+Up arrow Extend selection down Shift+Down arrow Move to next cell Tab or right arrow Move to previous cell Shift+tab or left arrow Move to ﬁrst cell in row Home Move to last cell in row Move to ﬁrst row in table Ctrl+Home Move to last row in table...
Page 34: Navigation Pane
Navigation pane The navigation pane alphabetically lists the data replication resources you can manage, organizing them by group in the hierarchical tree. Icons identify the state of the resources. (States other than normal are displayed in the navigation pane. In the tree, the resource group displays the most critical state of all its resources.) To view a resource in the content pane, click its group, or right-click its group and select View.
Page 35: View History
< tooltip View history The View History shows a list recently displayed resource views. See about replication resources. • The view that is currently displayed in the content pane is indicated with a checkmark. Selecting (checking) another view changes the contents pane to that view. •...
Page 36: Clui Ports Conﬁguration
In the Conﬁguration navigation pane, select the item to conﬁgure. CLUI ports conﬁguration You can conﬁgure the ports that are used by CLUI clients to access the CLUI server. • Default: Unsecure port: enabled, port 9000, 10 simultaneous sessions Secure SSL port: enabled, port 9001, 10 simultaneous sessions •...
Page 37: Jobs E-Mail Server Conﬁguration
• IPv4 IP address are generally shown in decimal notation, separated by dots (periods), for example: 192.0.2.235 . • IPv6 IP addresses with port numbers are enclosed in brackets to avoid confusion with port numbers, for example: https://[2001:0db8:85a3:08d3:1319:8a2e:0370:7344]:443/ • IPv4 addresses with port number do not use brackets. Jobs e-mail server conﬁguration You can conﬁgure the replication manager to use an e-mail server to send messages from jobs.
Page 38: Oracle Security Credentials Conﬁguration
Trace log conﬁguration You can enable and disable the replication manager trace log. • Default: enabled. The log ﬁle has a maximum size of 60 MB. As the log gets full, the oldest events are discarded. • You can disable the trace log by using the conﬁguration window. •...
Page 39: Security Credentials Vs. Tasks
• HP Host Agent Admins. To interact with the replication manager server, each Windows enabled host must have this security group and at least one member (user account). • hphaadm. To interact with the replication manager server, each Linux, UNIX, and OpenVMS enabled host must have this security group and at least one member (user account).
Page 40: Simulation Mode
Item or Task Credential Remarks resource Oracle Add, change, delete and Users can only partial integration view Oracle resources view. Back up and restore Oracle databases Add, change, delete and Storage systems view resources Users can only Manage replication licenses partial view.
Page 41: Single Sign-On (Sso) With Hp Command View Eva
Single sign-on (SSO) with HP Command View EVA Administrators can establish a single sign-on (SSO) trust relationship in HP Command View EVA that allows the replication manager to connect without sending the Storage Agent user name and password. The on/off status of SSO is displayed in the replication manager GUI but cannot be conﬁgured from there. To conﬁgure SSO, access HP Command View EVA and select Server Options >...
Page 42: About Imports
the ﬁle CADATA_20050211135232.export.xml was created on February 1 1, 2005, at 13:52:32 hours. • Stored security credentials for resources and scheduled job events are not included in the exported copies. • All scheduled job events are exported with a status of a run status of disabled. See Enabling and disabling scheduled job events.
Page 43: Importing An Rsm Database
The replication manager creates and XML copy of the RSM database in the location that you speciﬁed. See about exports. Importing an RSM database This feature allows administrators to import a previously exported copy of the RSM database. See database. See also Importing a remote RSM database.
Page 44: Completing Imports
Enter the network name or IP address of the remote management server. Enter the user name and password to access the remote instance of the replication manager. Click OK. An implicit job is started. The results and number of processed resources appear in the Monitor job window.
Page 45: Browser Window Is Blank
Click OK. Browser window is blank Problem The replication manager GUI is blank (gray) in the browser window. Explanation / resolution This can be caused by browsing away from, and back to, the replication manager. To display the GUI: While viewing the blank browser window, press and hold the CTRL key then click the browser refresh button.
Page 46: Illegal Characters
Explanation / resolution This can occur when the managed set in a GUI action or CLUI command contains one or more DR groups whose remote replication I/O mode is set to asynchronous. Enabling the failsafe on unavailable member would result in an invalid DR group conﬁguration, so the action is failed. See also invalid DR group pair conﬁguration.
Page 47: Invalid Dr Group Settings - Failsafe On Unavailable Member With Synchronous Replication
Use HP Command View EVA to resume the suspended DR group pair. After resuming the DR group pair, perform a manual refresh of the DR groups. See low-level refreshing DR groups. The source and destination DR groups are correctly identiﬁed. NOTE: While the incorrect source-source identiﬁcation exists: •...
Page 48: Job With Host Volume Remount Fails After An Unclean Unmount
Job with host volume remount fails after an unclean unmount Problem A job with host volume remount fails and the replication manager logs the error message: The filename, directory name, or volume label syntax is incorrect for the operating system associated with this mount point. Explanation / resolution If a host volume is uncleanly unmounted, such as during an unplanned failover, the host OS or ﬁle system may retain information about the host volume.
Page 49: Maximum Dr Group Log Size Error
GUI action CLUI command and switch See also Tru64 UNIX host volumes. DR Groups > Actions > Low-Level Refresh Managed Sets > Actions > Low-Level Refresh Set DR_Group refresh (for virtual disk and DR group managed sets) Set Vdisk refresh Virtual Disks >...
Page 50: Resource Is Not Selectable
Press and release the Tab key until the pop-up window is selected. Release the Alt key. The selected pop-up window is displayed. Resource is not selectable When a command’s argument is not selectable (does not appear in a selection list), you must manually enter the resource name or a enter variable that represents the resource.
Page 51: Second Snapclone Of The Same Storage Volume Or Host Volume Fails
To correct this problem, perform the following procedure. You must be a member of the server’s Administrators group. CAUTION: Performing this procedure requires a reboot. Coordinate reboot activities to avoid disruption of services to others. Ensure that no replication manager jobs are running or are scheduled to run during the reboot. On the Window-based storage management server, select Start >...
Page 52: Troubleshooting - Hp-Ux
When attempting to resume a DR group, the replication manager logs the message: Unable to resume DR group <GroupName> because of current state of group for job <JobName> Explanation / resolution You cannot use the replication manager to resume remote replication if the status of a DR group pair is failed.
Page 53: Job With Mountentirevolumegroup Command Fails - Hp-Ux
IMPORTANT: Before proceeding, coordinate the reboot activities to avoid disruption of host services to others. Ensure that no replication manager jobs involving the host are running or scheduled to run during the reboot. On the enabled host, close applications, as appropriate. Reboot the host.
Page 54: Job With Volume Group Remount Fails - Linux
First, check the job to see if it contains one of the following commands: CreateHostVolume CreateHostVolumeDiscrete CreateHostVolumeGroup If so, one of the following conditions may apply. Host QLogic HBA driver LUN setting is exceeded The default support for QLogic HBA drivers is 32 LUNs (virtual disks). If there are more than 32 LUNs (which is typical with EVA storage systems) the create host volume style commands can execute for an extended period of time because the LUN is not found on the host.
Page 55: Troubleshooting - Tru64 Unix
After the job completes successfully, Windows Explorer on the host does not show the disk (drive letter F). The disk does appear in the host Disk Management window, but Open and Explore operations on the disk fail. Explanation / resolution The dynamic remounting (mount without a reboot) step in the job causes the host OS to loose track of some drive information.
Page 56 Replication Solutions Manager...
Page 57: Replication Resources
2 Replication resources Working with resources Best practices for automatic refresh The refresh of storage systems information during an automatic refresh can take a signiﬁcant amount of time and place heavy demands on the management server and storage systems. See refreshing resources (automatic).
Page 58: Filtering Displayed Resources
Selecting adjacent property cells In a properties window, do one of the following: Click the ﬁrst property cell to copy then press and hold the mouse button. Drag the selection to the adjacent property cells. On the last property cell to copy, release the mouse button.
Page 59: Organizing Displayed Resources
1. Refresh button. 3. Progress bar for enabled hosts 5. Progress bar for Oracle and host volumes refresh. resources refresh. (restarts the refresh) 6. Progress bar for storage systems 2. Progress bar for dynamic refresh. 4. Progress bar for HP licences capacity volumes and policies refresh.
Page 60: Refreshing Display Panes
Sorting a list view Click the heading of the column on which to sort the list. The list is sorted and a sort indicator appears. To reverse the sort order, click the column heading again. Refreshing display panes Update the information that is displayed in the content and event panes. Considerations •...
Page 61: Refreshing Resources (Global)
IMPORTANT: New enabled hosts are not automatically discovered or added to the database. To be visible to the replication manager, an administrator must manually add them after installing replication manager host agents. • You can change the automatic storage refresh interval. See conﬁguring the replication manager.
Page 62: Selection Of Multiple Resources
• You can use the GUI or CLUI. Procedures • DR groups. See low-level refreshing DR groups. • Enabled hosts. See low-level refreshing enabled hosts. • Virtual disks. See low-level refreshing virtual disks. Selection of multiple resources When performing an action from the GUI, HP recommends selecting only a few resources at one time. Selecting a large number of resources at once can cause slow response times.
Page 63: Resource States
1. Resource types 2. Individual resources Resource types The following resources types are supported. For more information on each type, click the link. DR groups About About DR groups groups Enabled hosts About enabled hosts Host volumes About host volumes Jobs About jobs Managed sets...
Page 64: Resource Names And Unc Formats
Resource names and UNC formats Resources in a SAN are identiﬁed in several ways, including UNC format. UNC (Universal or Uniform Naming Convention) identiﬁes a resource in terms of its hierarchical location in a network. See the following for name and UNC formats: groups, enabled hosts,...
Page 65: Simulation Mode
Name format (UNC) OS speciﬁc Example \\host name\path\host volume name \\HostA2\/home/cats HP-UX \\HostA2\/users/cats Linux \\HostA2\/var/cats OpenVMS \\HostA2\[pets.cats] Solaris \\HostA2\/usr/cats Windows \\HostA2\E:\pets\cats For each OS, identiﬁes the path and ﬁle named Cats on the enabled host named HostA2 Oracle Name format (UNC) Example \\HostA2\Cats_db \\enabled host\database name...
Page 66: Licenses
CAUTION: HP strongly recommends that you do not run simulation mode on a production machine (that is, on the same machine as Command View EVA). If you disconnect the replication manager from Command View EVA, you lose control of the storage resources that were being managed by the replication manager.
Page 67: License States
License display Remarks License summary. A license status summary appears • The status includes replication licenses and on the right side of the status bar at the bottom of the Oracle-integration licenses. replication manager window. • Status messages indicate if all discovered licenses are valid or if there is an issue.
Page 68: Replication Licenses Overview
• Expiration date (if any) • Capacity range (amount of storage) • Multi-array resources. If an Oracle resource such as a database or tablespace is comprised of virtual disks on two or more arrays, each array must have an HP Oracle-integration license. •...
Page 69: Dynamic Capacity Management License Policy
For example, if a SnapcloneStorageVolume command in a job did not execute when the job was run, it may be because the storage system that contains the disk did not have a local replication license. IMPORTANT: HP recommends that you include validation commands in jobs and perform validation tests to prevent or minimize the effect of license-related issues at run time.
Page 70: Security Credentials For Oracle Databases
Solutions Manager installation guide and HP StorageWorks Replication Solutions Manager administrator guide. For an enabled host to interact with the server, a valid host agent security credential must be present in the replication manager database. See setting security credentials for enabled hosts adding a new enabled host.
Page 71: Security Credentials Vs. Tasks
Password change considerations Administrators should carefully plan and coordinate Oracle database security credential changes with replication manager operations. For example, if the security policy in your environment is to reset passwords every six months, consider that such changes can result in the replication manager server not interacting with an Oracle database.
Page 72: Topology Views
Item or Task Credential Remarks resource Add, change, delete and Users can only Managed sets partial view view. Oracle Add, change, delete and Users can only partial integration view Oracle resources view. Back up and restore Oracle databases Add, change, delete and Storage systems view resources Users can only...
Page 73 Views The View menu allows you to select the resources to display. Each of the predeﬁned views shows the logical relationships among resources. See DR groups topology view, host volumes topology view, and virtual disks topology view. Menu of actions You can right-click a resource to display a menu of actions or to navigate (jump) from the topology tab to the appropriate content pane.
Page 74: Displaying The Topology Tab
Filters By default all appropriate objects for a view are displayed. You can use the Filter menu to select and apply a custom ﬁlter to the view. See ﬁlters for views. Displaying the topology tab In the GUI navigation pane, select Replication. The Replication content pane is displayed.
Page 75 Item Description Actions > Toggle Labels Displays or hides resource labels in all views. Unpins (unlocks ) the locations of all resources in all views. See clear all Actions > Clear all pins pins tips Filter Filters the resources that are displayed. See ﬁlters for views View Selects the resource type (and related resources) to view.
Page 76: Host Volumes Topology View
Icon Description Storage system is normal Storage system is initializing or in an unknown state Storage system is disabled, degraded, or unmanaged Storage system is failed or there is a bad connection to the storage manager DR group is normal DR group is disabled, degraded, unknown, copying, constructing or deleting DR group is failed Remote replication is in a steady state...
Page 77 Sample default layout Typical resources in a view 1. Enabled host 2. Host volume 3. Virtual disk For more information, see about host volumes. Features The following features are available in the pane: Item Description Actions > Toggle Labels Displays or hides resource labels in all views. Unpins (unlocks ) the locations of all resources in all views.
Page 78: Virtual Disks Topology View
Icons The following icons may appear in the view: Icon Description Enabled host is normal Enabled host is in an unknown state Host volume Virtual disk is normal Virtual disk is in an unknown state Virtual disk degraded, disabled, deleting, copying, or constructing Virtual disk is failed Snapshot of a virtual disk More help...
Page 79 Item Description Actions > Toggle Labels Displays or hides resource labels in all views. Unpins (unlocks ) the locations of all resources in all views. See clear all Actions > Clear all pins pins tips Filter Filters the resources that are displayed. See ﬁlters for views View Selects the resource type (and related resources) to view.
Page 80: Filters For Topology Views
Icon Description Storage system is normal Storage system is initializing or in an unknown state Storage system is disabled, degraded, or unmanaged Storage system is failed or there is a bad connection to the storage manage Virtual disk is normal Virtual disk is in an unknown state Virtual disk degraded, disabled, deleting, copying, or constructing Virtual disk is failed...
Page 81: Tips (Topology Views)
Applicable managed set ﬁlter Host Storage Enabled Virtual groups volumes systems View hosts disks DR groups view storage systems > DR groups > virtual disk Host volumes view enabled hosts > host volumes > virtual disks Virtual disks view storage systems > virtual disks More help •...
Page 82 Clear all pins action • The Clear all pins action unpins all views and resets all views to their defaults. The displayed view is immediately redrawn to ﬁt the tab. IMPORTANT: You cannot undo a Clear all pins action. Toggle labels action •...
Page 83: Dr Groups
3 DR Groups Working with DR groups About DR group resources The DR Groups content pane displays storage resources for remote replication. See GUI window content pane. The properties of DR groups, and the remote replication actions that you can perform, depend on the controller software version of the storage systems.
Page 84: Dr Group Actions Cross Reference
• Enable Failsafe On Unavailable Member. Enable remote replication failsafe on unavailable member for a DR group pair. See DR groups failsafe on unavailable member. Procedure. • Disable Failsafe On Unavailable Member. Disable remote replication failsafe on unavailable member for a DR group pair. See DR groups failsafe on unavailable member.
Page 85 Conﬁgure DR group GUI action Job template or command CLUI command Set DR_Group DR Groups > Add Members AddDrGroupMember DR Groups > Remove Members Set DR_Group DR Groups > Failover Set DR_Group FailoverDrGroup (with or without suspend) (with or without suspend) (with or without suspend) Perform planned failover (template)
Page 86: Dr Group Properties Summary
Other DR group tasks GUI action Job template or command CLUI command Set DR_Group DR groups > Low-Level Refresh DiscoverDiskDevicesForDrGroup Throttle replication I/O (template) WaitDrGroupNormalization View DR groups GUI action Job template or command CLUI command DR groups > Low-Level Refresh Set DR_Group DR groups >...
Page 87: Adding Dr Groups To A Managed Set
DR Grp Source/Destination tree view System/DR Grp/Virtual Disk tree view Adding DR groups to a managed set Add DR groups to a managed set. Considerations • You can use the GUI or the CLUI. See DR groups actions cross reference. •...
Page 88: Creating A Dr Group Pair
When you add virtual disks to a source DR group, the remote copies (virtual disks) are automatically added to the destination DR group. Considerations • You can use the GUI, jobs, or the CLUI. See DR groups actions cross reference. •...
Page 89: Editing Dr Group Properties
Procedure This procedure uses the GUI. In the navigation pane, select DR Groups. On the List tab, select the source or destination DR group in the DR group pair to delete. Select Actions > Delete. The Discard Remote Copies window opens. Select the remote copy you want to discard, and then click OK.
Page 90: Disabling The Failsafe On Unavailable Member
Click OK. Disabling the failsafe on unavailable member Disable failsafe on unavailable member of a DR group pair. See DR groups failsafe on unavailable member. Considerations • You can use the GUI, jobs, or the CLUI. See DR groups actions cross reference. •...
Page 91: Forcing A Full Copy
On the List tab, select the destination group in the DR group pair to failover. Select Actions > Failover. The Conﬁrm Failover window appears. If supported by controller software, an option to suspend remote replication is enabled. Select Suspend on failover to suspend remote replication immediately after the failover is executed. IMPORTANT: Do not perform this action when the links are down , especially during an unplanned failover.
Page 92: Low-Level Refreshing Dr Groups
Considerations • You can only use the GUI. • Applies to only to individual DR groups, storage systems, and virtual disks. Procedure In the navigation pane, select resource type. On the List tab, select the speciﬁc resource whose events are to be displayed. Select Actions >...
Page 93: Resuming A Dr Group Pair
• To remove virtual disks from a DR group pair, you must specify the source DR group. See DR group pair. • You cannot directly remove virtual disks from a destination DR group. • If you choose to discard the remote copies when the remote link is not operational, the remote virtual disks are not deleted.
Page 94: Suspending A Dr Group Pair
• If the DR group pair is not already in its home conﬁguration, reverting to home causes a failover. See DR groups failover. IMPORTANT: Failing over a DR group pair impacts host I/O. Ensure that you understand the potential impacts of performing a failover.
Page 95 Controlling Task Result on source Result on Remarks group DR group destination DR group specify Fail over a DR group Destina- The source becomes The destination Procedure. See also tion pair (do not suspend). destination. becomes source. DR group failover The destination The source becomes becomes the...
Page 96 Adding and deleting virtual disks Task Result on source Result on Remarks group DR group destination DR group specify Adds a corresponding Adds a source virtual Add virtual disks to a DR remote copy to Source disk to the source DR Procedure.
Page 97: Viewing Dr Groups
Viewing DR groups Display DR group list and tree views. See DR groups views. Considerations • You can use the GUI or CLUI to display lists. See DR groups actions cross reference. • Tree views are available only in the GUI. Procedure This procedure uses the GUI.
Page 98 2. A destination virtual disk 1. A source virtual disk (remote copy) 3. The source DR group log disk (1 of 3 in the source DR group) (1 of 3 in the destination DR group) Site 1 < remote link > Site 2 A DR group log is a designated virtual disk in a source DR group that is used under certain circumstances to temporarily store host writes to source virtual disks.
Page 99: Auto Suspend
IMPORTANT: After creation, HP recommends that you edit partner DR groups and change the names. After creation, you can change the names to something logical for your environment. For example, rename them based on their physical locations, Boston and London, or their home roles SiteA_Srce and SiteB_Dest.
Page 100: Copy State
Site 1 Site 2 Site 3 >>> source (a) remote copy (b) snapclone >>> snapclone (c) remote copy (d) The result is that a point-in-time replica of the source exists at two different sites. Copy state Copy state identiﬁes the state of remote replication between a source and destination virtual disk. Values are: •...
Page 101: Failover
Failover To fail over means to reverse the direction of remote replication in a DR group pair. A failover event is an event in which the remote replication direction was reversed. When a failover event occurs, the roles of source and destination in a DR group pair are reversed. For example, in a planned failover, if DRgroupA was originally the source and DRgroupB was the destination, those roles are reversed when DRgroupB is failed over.
Page 102: Failsafe States
• When any virtual disk in the DR group pair becomes unavailable, host writes, logging, and remote replication are stopped. • Disabled • While all components in the DR group pair function normally, host writes, logging, and remote replication continue normally. •...
Page 103: I/O Throttling
• True/Yes. The DR group is the preferred source. • False/No. The DR group is the preferred destination. Home group is a property that is maintained only by the replication manager. Home conﬁguration When the replication manager creates a DR group pair, the home property for the source and destination groups is set to true and false, respectively.
Page 104: Log Overview And States
Job commands Remarks These arguments are ignored if the feature is not available. AutoSuspend On Link Down CreateDrGroup Destination RAID level CreateDrGroupFromHostVolume Source Log Disk Group Destination Log Disk Group Maximum Log Disk Size ForceFullCopyDrGroup This job command is ignored if the feature is not available. SetDrGroupAutoSuspend This job command is ignored if the feature is not available.
Page 105: Log And Disk Group Planning
Log contents A small portion of log space is reserved for array commands. The largest portion stores host data that is written to all of the virtual disks in the disk group. Log and disk group planning When you create a DR group pair, a log disk is automatically created for the source and destination DR group.
Page 106: Logging
Default maximum size The default maximum size depends on the controller software version and equals the DR group size multiplied by a factor. For example, if a DR group contains virtual disks with a total of 10 GB and the factor is 1x then the default maximum size is 10 GB. For speciﬁc factors, see controller software features - remote replication.
Page 107: Log Disk And States
Log disk and states The DR group log is a designated virtual disk that stores a source DR group’s host writes while remote replication to the destination DR group is stopped. When replication is re-established, the contents of the log are written to the destination virtual disks within the destination DR group to synchronize the destinations with their sources.
Page 108: Normalization
• HP recommends that you create separate managed sets for source and destination DR groups. When you conduct failover operations, you can perform the actions that correspond to the new roles of the managed set. • Source and destination DR groups (from different DR group pairs) can be members of the same managed set.
Page 109: Remote Replication Guidelines
• The destination DR group was unavailable after power was cycled off and on in the source array. • Remote replication was not suspended after power was cycled off and on in the source array. • The Destination mode was other than Read Only after power was cycled off and on in the source array.
Page 110 Virtual disks • All virtual disks that contain the data for an application must be in the same DR group. • When in enhanced asynchronous write mode, virtual disks cannot be added to or deleted from a DR group. This restriction is controller software version dependent. See controller software features - remote replication.
Page 111 IMPORTANT: You cannot remove virtual disks from a DR group pair when remote replication is suspended. Write mode (async/sync replication) The replication write mode of each DR group pair can be asynchronous or synchronous. The choice is generally a business decision based on your goals and the bandwidth of the intersite link. For details, see the HP Continuous Access EVA Performance Estimator user guide.
Page 112 Synchronous operation Host data written to the virtual disks in a source DR group is stored in a write-pending cache on the source array. The source array replicates the data in the write-pending cache to the destination array. The destination array writes the data to the virtual disks in the destination DR group and acknowledges completion back to the source array.
Page 113: Enabled Hosts
4 Enabled hosts Working with enabled hosts About enabled host resources The Enabled Hosts content pane displays hosts that you can interact with. See GUI window content pane. These are standard storage hosts that also are running the replication manager host agent. See enabled and standard hosts.
Page 114 Create enabled hosts GUI action Job template or command CLUI command – Enabled Hosts > New Add Host_Agent Delete enabled hosts GUI action Job template or command CLUI command – Enabled Hosts > Delete Delete Host_Agent Manage sets of enabled hosts GUI action Job template or command CLUI command...
Page 115 List view Host/Host Vol/Mt Point tree view Adding enabled hosts Add and enabled host to the replication manager database. After an enabled host is added, the host can interact with the replication manager. Considerations • You can use the GUI or the CLUI. See enabled hosts actions cross reference.
Page 116 Considerations • You can use the GUI or the CLUI. See enabled hosts actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Enabled Hosts. On the List tab, select the enabled hosts to add to a managed set. Select Actions >...
Page 117: Removing Enabled Hosts From A Managed Set 1
CAUTION: Because commands are executed using root or administrator permissions on the host, it is possible to severely impact the host and host storage operations. • Commands are not validated before sending them to the host. Ensure that commands fully comply with the host OS or application software rules and syntax.
Page 118 Setting security credentials for enabled hosts To add or update a security credential for accessing one or more enabled hosts. See security credentials for enabled hosts. Considerations • You can only use the GUI to update security credentials. • When setting security credentials for multiple enabled hosts in a single action, the selected enabled hosts must have the same security credentials.
Page 119 Select Actions > View Properties. The Enabled Host Properties window opens. Click the properties tabs. Enabled host concepts Enabled and standard hosts Enabled and standard hosts An enabled host is a computer in a SAN that is capable of performing I/O with connected storage arrays and that has been conﬁgured to interact with the replication manager server.
Page 120 For an enabled host to interact with the server, a valid host agent security credential must be present in the replication manager database. See setting security credentials for enabled hosts adding a new enabled host. IMPORTANT: If a valid security credential is not entered or if the credential expires or is changed, the replication manager (GUI, jobs, and CLUI) will not be able to interact with the enabled host.
Page 121: Host Volumes
5 Host volumes Working with host volumes About host volume resources The Host Volumes content pane displays host volumes that have been discovered by the replication manager. See GUI window content pane. Host volumes are an enabled host’s identiﬁcation of a storage device. See host volumes overview. Views •...
Page 122: Host Volume Actions Cross Reference
• Edit Dynamic Capacity Policy. Change an existing a dynamic capacity policy. Procedure. • Remove Dynamic Capacity Policy. Remove an existing a dynamic capacity policy. Procedure. • Flush Cache. Flush the ﬁle system cache of a host volume. Procedure. Host volume groups •...
Page 123 NOTE: There are no jobs or CLUI commands for DC-Management tasks. Create host volume resources GUI action Job template or command CLUI command Host Volumes > Host Volumes > New CreateContainersForHostVolume Container Host Volumes > Host Volume Groups > CreateContainersForHostVolumeGroup New Container Virtual Disks >...
Page 124 Manage sets of resources GUI action Job template or command CLUI command Host Volumes > Host Volumes > Add To Set Managed_Set Managed Set Host Volumes > Host Volumes > Remove Set Managed_Set From Managed Set Mount host volume resources GUI action Job template or command CLUI command...
Page 125 GUI action Job template or command CLUI command FractureHostDiskDeviceMirrorclone FractureHostVolumeGroupMirrorclones MirrorcloneHostDiskDeviceToContainer MirrorcloneHostDiskDeviceToContainer- InManagedSet Command RetainLatestRoundRobinReplicasForHost- StorageVolume Command RetainLatestRoundRobinReplicas- ForHostVolume Command RetainLatestRoundRobinReplicas- ForHostVolumeGroup Command SnapcloneHostDiskDeviceToContainerIn- ManagedSet Command SnapshotHostDiskDeviceToContainerIn- ManagedSet Command SnapcloneHostVolume SnapcloneHostVolumeGroup SnapshotHostVolumeGroupToContain- ersInManagedSet Command SnapshotHostVolume SnapshotHostVolumeGroup SnapcloneDiskDevice (raw disks) SnapshotDiskDevice (raw disks) Replicate host volumes (template)
Page 126: Host Volume Properties Summary
Validate host volume resources GUI action Job template or command CLUI command ValidateHostVolume ValidateHostVolumeGroup ValidateSnapcloneHostVolume ValidateSnapcloneHostVolumeGroup ValidateSnapshotHostVolume ValidateSnapshotHostVolumeGroup View host volume resources GUI action Job template or command CLUI command Host Volumes > Host Disk Devices > View Properties Host Volumes > Host Volumes > View Show Host_Volume Properties Host Volumes >...
Page 127 Host/Replicable Components tree view Host/Host Volume/Component tree view HP StorageWorks Replication Solutions Manager 4.0.1...
Page 128: Adding Host Volumes To A Managed Set
Host/Devices/Partitions tree view Adding host volumes to a managed set Add host volumes to a managed set. Considerations • You can use the GUI or the CLUI. See host volumes actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Host Volumes. The content pane displays host volumes. Click the List tab.
Page 129: Creating A Managed Set For A Host Disk Device Container
Procedures The following procedure uses the GUI. DR group procedure In the navigation pane, select Host Volumes. On the List tab, select Actions > New DR Group. The Replicate wizard opens. Follow the instructions in the wizard. Creating a managed set for a host disk device container Create a storage container corresponding to the virtual disk that underlies a host disk device, and add it to the speciﬁed managed set.
Page 130: Creating A Managed Set Of Containers For Host Volume Groups
Creating a managed set of containers for host volume groups Create a managed set of storage containers that correspond to the virtual disks that underlie a host volume group. See containers managed sets. Considerations • You can use the GUI or jobs to create the containers. See host volume, host volume groups actions cross reference.
Page 131: Creating Local Replicas
Creating local replicas Create local replicas (snapclones, snapshots or mirrorclone copies) of the virtual disks that underlie a host volume, a host volume group or a host disk device. See snapclones , snapshots, and mirrorclones. Considerations • You can use the GUI or jobs to create the copies. See host volume actions cross reference.
Page 132: Deleting Host Volumes, Host Volume Groups, And Host Disk Devices
On the Replica Repository tab, select the replica to delete. Select Actions > Delete. The Delete Replica Repository window opens. Follow the instructions in the window. Deleting host volumes, host volume groups, and host disk devices Delete a host volume, host volume group or host disk device on an enabled host. Considerations •...
Page 133: Mounting Host Volumes (Assigning A Drive Letter)
Considerations • You can use the GUI or jobs to ﬂush a host’s ﬁle system cache. • Flushing a host cache does not ﬂush the underlying virtual disks write caches on the storage array. Procedure This procedure uses the GUI. In the navigation pane, select Host Volumes.
Page 134: Unmounting Host Volumes (Removing A Drive Letter)
Considerations • You can use the GUI or jobs to restore a host resource. See host volume actions cross reference. • The host volume to restore must already have a replica (fractured mirrorclone, snapclone, or snapshot) that was created by the replication manager. Only those replicas can be selected in the Instant Restore wizard.
Page 135: Using Snapshots
Job commands for snapclones of host volumes SnapcloneHostVolume SnapcloneHostVolumeToContainers SnapcloneHostVolumeToContainersInManagedSet SnapcloneHostVolumeGroup ValidateSnapcloneHostVolume ValidateSnapcloneHostVolumeGroup Using snapshots The following job commands are available when using snapshots with host volumes. Job commands for snapshots of host volumes SnapshotHostVolume SnapshotHostVolumeGroup ValidateSnapshotHostVolume SnapshotHostVolumeToContainers SnapshotHostVolumeToContainersInManagedSet ValidateSnapshotHostVolumeGroup Using logical volumes and volume groups You can present storage volumes (virtual disks) to enabled hosts and subsequently use a host’s logical volume manager to create and manage host volume groups and logical volumes.
Page 136: Viewing Host Volume Resources
Raw disks are listed in the Host Disk Devices tab along with disk devices that contain ﬁle systems. Raw disks are not displayed as host volumes. Raw disks can be replicated from the Host Disk Devices tab by creating a container for the disk device. Job templates and commands for raw disks The following job templates can be used with raw host volumes and storage volumes.
Page 137: Extending Host Volume Capacity
Considerations • You can use the GUI or the CLUI. See host volumes actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Host Volumes. The content pane displays host volumes resources. Click the appropriate List tab. Select the resource to view.
Page 138: Setting A Dynamic Capacity Policy
Setting a dynamic capacity policy Set a policy to automatically extend or shrink a host volume. Considerations • You can only use the GUI to set a dynamic capacity policy. • A dynamic capacity policy can be applied simultaneously to multiple host volumes. •...
Page 139: Host Volume Concepts
Considerations • You can only use the GUI to remove a dynamic capacity policy. • If a dynamic capacity policy has been applied to multiple host volumes, it can be removed simultaneously from all of them. Procedure In the navigation pane, select Host Volumes. On the Host Volumes tab, select the host volume for which you want to remove a dynamic capacity policy.
Page 140: Host Volumes Faq
Underlying storage volume Host volume Mount point <=> Array + Virtual disk + presentation Enabled Host + OS host volume name (or raw) Examples Examples <=> ArrayA2 + Cats + presentation HostA1 + AIX /dev/hd1 /home/cats <=> ArrayA2 + Cats + presentation HostA2 + HP-UX /dev/dsk/c2t0d2 /users/cats...
Page 141: Disk Devices
Disk Devices The replication manager uses the term host disk device to refer a host’s identiﬁcation of storage devices. With SAN-based storage resources, for each virtual disk that is presented to a host, there is a corresponding entry (identiﬁcation) in a host’s low-level devices table. The replication manager discovers these devices on enabled hosts and displays them in the Disk Devices tab on the Host Volumes content host volume views viewing host...
Page 142: Mirrorclones - Fractured
Each logical volume in a volume group is considered to be a component with which hosts can perform I/O. Logical volumes can contain ﬁle systems or be raw storage. See disks. In each storage system, logical unit numbers (LUNs) are assigned to its virtual disks. When a virtual disk is presented to hosts, the storage system and the hosts perform I/O by referencing the LUN.
Page 143: Mirrorclones - Synchronized
IMPORTANT: When using jobs you must explicitly ensure that write caches are ﬂushed. Method Flush implementation Write cache setting after replication The replication manager automatically sets the source disk to write-though GUI action When the fracture is completed, the controller mode and ensures the ﬂush is completed software automatically sets the source disk and before starting the fracture.
Page 144: Mirrorclone Faq
• Hardware protection. Compared to a snapshot, a mirrorclone is more hardware protected. (A snapshot must be in the same disk group as its source.) • Redundancy levels (Vraid). Compared to a snapshot, a mirrorclone can have higher redundancy levels. (A snapshot can only have the same or lower redundancy level as its source.) •...
Page 145: Mirrorclone States
• A snapshot or has any snapshots. • Has any snapclones that are in the process of being normalized. • Is a member of a DR group. Synchronized mirrorclone guidelines Synchronized mirrorclones Deleting No. The disk must ﬁrst be fractured and detached, then deleted. Detaching No.
Page 146: Mounting All Logical Volumes In A Replicated Volume Group
Mounting all logical volumes in a replicated volume group The local replication wizard mounts all of the logical volumes in a replicated volume group, as appropriate: • If a logical volume is mounted when the volume group is replicated, then the logical volume replica will be mounted.
Page 147: Partitions And Slices
Windows mount points and device names Examples Host OS Device name Mount point Windows Drive Disk3 Drive & folders Disk3 E:\pets\cats In a Windows OS, mount points are typically called drive letters. In the drive example the host volume is mounted as drive letter E:\.
Page 148 Red Hat Linux partition examples Partition ID Partition Remarks /boot boot, Linux native root, Linux native Linux swap 7 and up United Linux partition examples Partition ID Partition Remarks root /dev/sda1 swap /dev/sda2 /dev/sda3 /var /dev/sda4 extended partition /dev/sda5 /home /dev/sda6 /export Solaris slices...
Page 149: Raw Disks
Tru64 UNIX partition examples Partition ID Partition Remarks root (OS directories and ﬁles) swap entire disk swap unused unused /usr user programs and libraries unused UNIX partitions If you are a superuser for a UNIX host, you can identify host volume partitions by viewing the /etc/fstab ﬁle.
Page 150: Round Robin Replicas (Wizard)
the instant restore wizard is used, the wizard checks the repository to ﬁnd relevant replicas to restore from. At a low level, the replica repository contains a large amount of technical information. Summary information is displayed in the Replica Repository tab and in the Replica Repository Properties window. Use of the replica repository Generally, you do not need to directly perform actions on replicas.
Page 151: Snapshots (Host Volume)
• Yes. All virtual disks that underlie the host volume comply with snapclone guidelines. Snapclone replication can be performed. • No. One or more virtual disks that underlie the host volume do not comply with snapclone guidelines. Snapclone replication cannot be performed. See also virtual disks snapclones, snapclone FAQ snapclone...
Page 152: Types (Components)
Snapshot Estimated changes Recommended lifetime in source data snapshot type Short Less than 25% Demand allocated Long 25% or more Fully allocated Demand-allocated snapshots When a snapshot is demand allocated, the storage system allocates only enough space to store metadata and pointers to the source data.
Page 153: Dc-Management Operation
NOTE: The policy threshold is checked against the current size of the host volume during each automatic storage refresh cycle (default 30 minutes). Therefore, even if the current size of the host volume exceeds the set threshold, the earliest the policy will be triggered is at the next refresh cycle. You can also manually invoke a global refresh, which may trigger a policy as well.
Page 154: Dc-Management Support
Resize option Comments Operations available Provides full resizing capability and integration with the operating system. Extend or shrink a host volume or the With a single step you can resize DC-Management underlying virtual disk. the ﬁle system and the underlying virtual disk simultaneously, simplifying capacity management.
Page 155 Item Requirement An RSM host agent must be installed on a host to enable resizing of host volumes. See Host agent below for host agents that support DC-Management. A DC-Management license must be purchased for each array on which you want Licensing to use this feature.
Page 156: Selecting The Proper Dynamic Capacity Policy Thresholds
Host volume conﬁguration Extend support? Shrink support? HP-UX 1 1.31 LVM and Veritas online JFS None Manual (ofﬂine only) Non-LVM and Veritas online JFS Policy and manual (online) Policy and manual (online) LVM and VxFS without online JFS. Manual (ofﬂine only) None Non-LVM and VxFS without...
Page 157: Using Dc-Management With Replication
example, assume you manually extend a host volume on which a shrink policy has been set. The manual extend will be implemented, but the larger size of the host volume may cause the shrink policy to be triggered at the next refresh cycle, causing the size of the host volume to be reduced. Using DC-Management with replication Guidelines for using DC-Management with HP Business Copy EVA •...
Page 158: Dc-Management Best Practices
• Can I use DC-Management with HP Business Copy EVA? You cannot use DC-Management with snapshots or mirrorclones created using HP Business Copy EVA. See Using DC-Management with replication for more information. • Can I create a snapshot or mirrorclone on a virtual disk that has a DC-Management policy set on it? No.
Page 159 The administrator uses the e-mail notiﬁcation feature to be alerted when either policy triggers. HP StorageWorks Replication Solutions Manager 4.0.1...
Page 160 Host volumes...
Page 161: Jobs
6 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. See GUI window content pane. Views • List of all jobs. See Jobs list tab.
Page 162: Job Planning - Tru64 Unix
• 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.
Page 163: Job Actions Cross Reference
In the second Launch command (example, line 21) enter a host command or script ﬁle 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 the following for jobs and job instances scheduled job events.
Page 164: Job Properties Summary
Scheduled job events Create scheduled job event GUI action Job command or template CLUI command Jobs > Schedule > Schedule job Delete scheduled job event GUI action Job command or template CLUI command Jobs > Schedule > Remove Edit scheduled job event GUI action Job command or template CLUI command...
Page 165: Aborting Job Instances
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.
Page 166: Continuing Job Instances
Aborting a job instance from the CLUI Open a CLUI window Issue a Show Job command. Include the job name and the instances switch. Review the output and note the instance name or instance ID of the speciﬁc instance you want to manage, for example, daily_backup-4 or ID: 55ed822a-0afb-48ad-95bd-d362389344ad.
Page 167: Creating Jobs
Creating jobs Create a job. When you create a job you deﬁne which tasks (commands) a job will perform, the order in which the commands will be executed, and the parameters for each command. See Job commands list Job templates list.
Page 168: Developing Jobs
Delete a job instance. Considerations • You can only use the use the GUI or CLUI to delete a job instance. Procedures Deleting a job instance from the GUI In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the Run History tab.
Page 169: Job Editing Tips And Shortcuts
Job editing tips and shortcuts In the following, the word command refers to a job command (script action). Adding a command Job editing shortcuts Copying lines Moving a line Commenting-out lines Nonadjacent lines Deleting lines Selecting all lines Deleting a transaction Selecting adjacent lines Editing a command Adding a command...
Page 170: Editing Individual Commands (Tasks)
Deleting a transaction In the right pane, double-click the DO { line. The transaction lines are selected. Press the Delete key. The transaction lines are deleted. Editing a command In the right pane, select the command (line). Double-click the command. The Editing Task window appears. The entries in the window vary with the type of command.
Page 171: Generating Job Templates
Procedure In the Create Job or Edit Job window, double-click the command (task) to edit. The Editing Task window opens. Enter values for the command arguments. If applicable, enter a label for this command (task). See job command labels. If applicable, enter an assignment (variable name) for this command (task). See job command assignment (variables).
Page 172: Preparing To Import
Preparing to import Determine the management servers in your environment on which HP Business Copy EVA 2.X is installed. For each of these servers, perform the following procedure. Procedure Log on to the management server. Navigate to the directory: C:\Program Files\Compaq\SANworks\Enterprise Volume Manager\bin\Jobs Select ﬁles with the extension .evm.
Page 173 Business Copy EVA/MA/EMA 2.x Job operation Replication Solutions Manager equivalent job name and use command MOUNT VOLUME_ALL There is no equivalent single command. The following can apply: Presents the virtual disks that underlie a host volume replica (or pre-existing host volume) to a host OS CreateHostVolumeGroup and requests mounting of all components using the CreateHostVolumeDiscrete...
Page 174 Business Copy EVA/MA/EMA 2.x Job operation Replication Solutions Manager equivalent job name and use command SET CA_SUBSYSTEM Stores the name of an EVA array in a $BCV variable. None — Identiﬁcation is handled automatically. This identiﬁes the storage system in Continuous Access environment on which to select the source virtual disk and create the snapshot or snapclone BCV.
Page 175: Logical Volumes And Volume Groups In Job Commands
Business Copy EVA/MA/EMA 2.x Job operation Replication Solutions Manager equivalent job name and use command SPLIT_FINISH UNIT None — MA/EMA arrays are not supported. Completes the split of a clone virtual disk (mirrorset). Clone split operations apply to MA/EMA arrays only. SPLIT_FINISH VOLUME Completes the split of the clone virtual disks None —...
Page 176: Monitoring And Managing Job Instances
See also, host volumes logical volumes and volume groups. Monitoring and managing job instances Monitor the start date and time, elapsed time, and status of each task in a job instance, as well as job events and progress using the Monitor Job window. You can also pause, continue, and abort job instances from this window.
Page 177: Resource Is Not Selectable
Procedures Pausing a job instance from the GUI 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 pause. Do one of the following: • Select Pause. A conﬁrmation window opens. •...
Page 178: Running Jobs
In some cases, subject to your security policies, consider changing the security credentials of the replication manager server (one change) to match those saved with the job events (potentially many changes). Running jobs Run a job. Whenever you run a job, HP recommends that you validate it. Validation helps prevent job failures by checking resource availability before the job begins executing commands.
Page 179: Scheduling Job Events
Select an appropriate resource type (if appropriate) and click OK. A list of available resources appears. In some cases, you can ﬁlter the list or narrow the choices. Select a resource (or several if appropriate) to include in the argument and click OK. The selected resources are added to the command argument and the Argument Editor window closes.
Page 180: Choosing A Run Interval
A scheduled job event can be enabled or disabled. When enabled, the job is automatically run at the scheduled interval and start time. When disabled, the job event remains in the list of scheduled events but is not automatically run. Procedure In the navigation pane, select Jobs to display the Jobs window in the content pane.
Page 181: Removing Scheduled Job Events
Hourly interval equivalents Typical hourly interval equivalents are shown below. A value of 999 hours is the maximum that can be entered. Hourly interval equivalents 24 hrs every day 48 hrs every other day 168 hrs every week 336 hrs every other week 720 hrs every 30 days...
Page 182: Viewing Job Status
Procedures Validating a job from the GUI In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the List tab. Select the job to validate. Select Actions > Run. The Conﬁrm Run Job window opens. Select Validate.
Page 183: Viewing Job Properties
Considerations • You can use the GUI or CLUI. See job actions cross reference. Procedures Viewing the jobs list from the GUI In the navigation pane, select Jobs to display the Jobs window in the content pane. Click the List tab. A list of available jobs is displayed. Viewing job instances In the navigation pane, select Jobs to display the Jobs window in the content pane.
Page 184: Jobs, Templates, And Commands
Line Task comment > // Replicate storage volumes. command > ValidateStorageSystem ( %array_name% ) Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) branch > onerror pauseat E1: transaction start > DO { $Rep1 = SnapshotStorageVolume ( %array_name_source_storvol_unc1%, assignment > FULLY_ALLOCATED, SAME, %dest_storvol1%, NOWAIT ) onerror pauseat E1: } ALWAYS { // Resume the host application.
Page 185: Job Instances
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.
Page 186: Argument Lists
Argument lists In some commands an argument list can be speciﬁed. An argument list consists of individual resource names, separated by commas, and enclosed in parenthesis. For example, a list of storage volumes (virtual disks): ("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars") Assignments (variables) The Editing Task window allows you to create assignments (variables) that refer to speciﬁc resources or that reference the results of a command.
Page 187: Command Result Values
Line Task Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1: E1: Exit (FAILURE) Branching types • Default. If the command fails, abort the job at this task (line). • None. Use the default behavior. • Onerror Goto. If the command fails, go to the label. Execute the command at the label. •...
Page 188 Job command Command result value (format) AddReplicaToReplicaRepository AddReplicasToReplicaRepository CombineLists Combined list of resources (UNC) ConvertStorageVolumeIntoContainer Combined list of resources (UNC) ConvertStorageVolumesInManagedSetIntoContainers List of container names (UNC) ConvertStorageVolumesIntoContainers List of container names (UNC) ConvertStorageVolumesIntoContainersUsingRepository List of container names (UNC) CreateContainer Container name (UNC) Managed set name of virtual disk CreateContainerForHostDiskDevice containers (simple)
Page 189 Job command Command result value (format) DetachMirrorclones DiscoverDiskDevice DiscoverDiskDevices DiscoverDiskDevicesForDrGroup DiscoveryRefresh (obsolete) Exit Export FailoverDrGroup FailoverDrGroups FlushCache ForceFullCopyDrGroup FractureHostDiskDeviceMirrorclone Name of the fractured mirrorclone (UNC) FractureHostVolumeGroupMirrorclones List of fractured mirrorclone names (UNC) FractureHostVolumeMirrorclones List of fractured mirrorclone names (UNC) FractureMirrorclones Import InstantRestoreFromMirror InstantRestoreFromSnapshot...
Page 190 Job command Command result value (format) RetainLatestRoundRobinReplicasForHostVolumeGroup SendEmail SetDiskGroupForSnapclone SetDrGroupAutoSuspend SetDrGroupComments SetDrGroupDestinationAccess SetDrGroupFailsafe SetDrGroupFailsafeOnLinkDownPowerUp SetDrGroupHome SetDrGroupIoMode SetDrGroupMaxLogSize SetDrGroupName SetDrGroupSuspend SetHostDiskDeviceWriteCacheMode SetHostVolumeGroupWriteCacheMode SetHostVolumeWriteCacheMode SetHostVolumesWriteCacheMode The resources listed in the argument SetListVariable (UNC) SetMountPointsPreﬁxInRepository SetNotiﬁcationPolicy SetOracleModeUsingRepository SetStorageVolumeName New name for the storage volume (UNC) SetStorageVolumeWriteCacheMode SetStorageVolumesWriteCacheMode SetVariable...
Page 191 Job command Command result value (format) SnapcloneOracleToContainersUsingRepository SnapcloneOracleUsingRepository SnapcloneStorageVolume Snapclone storage volume name (UNC) SnapcloneStorageVolumeToContainer Snapclone storage volume name (UNC) List of snapclone storage volume names SnapcloneStorageVolumesToContainers (UNC SnapshotDiskDevice Snapshot storage volume name (UNC) SnapshotHostDiskDeviceToContainerInManagedSet Snapshot name (UNC) List of snapshot storage volume names SnapshotHostVolume (UNC) List of snapshot storage volume names...
Page 192: Comments
Job command Command result value (format) ValidateSnapcloneStorageVolume ValidateSnapshotHostVolume ValidateSnapshotHostVolumeGroup ValidateSnapshotStorageVolume ValidateStorageSystem ValidateStorageVolume ValidateStorageVolumes Wait WaitDrGroupSynchronizationTransition WaitForHostDiskDeviceWriteCacheFlush WaitForHostVolumeGroupWriteCacheFlush WaitForHostVolumeWriteCacheFlush WaitForHostVolumesWriteCacheFlush WaitForJob WaitForStorageVolumeDiscovery WaitForStorageVolumesDiscovery WaitForStorageVolumeWriteCacheFlush WaitForStorageVolumesWriteCacheFlush WaitForWriteCacheFlushUsingRepository WaitHostDiskDeviceNormalization WaitHostVolumeNormalization WaitStorageVolumeNormalization WaitStorageVolumesNormalization WaitUntil WaitVolumeGroupNormalization Comments The comment command can be used to add comments to a job. You can also comment-out other commands.
Page 193: Implicit Job Startup
• Include a successful exit command for each branch of the job that can result in successful termination. • If you create branches in a job to handle failures, conclude each with a failure exit command. See job exit command. Implicit jobs When responding to certain requests, the replication manager may create and immediately run a job.
Page 194: Job Commands List
• Line 12 indicates that all legacy job commands have been listed. • Line 15 indicates the start of the replication manager template that has been applied to create an equivalent job. • Line 20 indicates a required argument. See arguments.
Page 195 Requires Job command Command Replication host agent category type CreateHostVolumesUsingRepository Oracle CreateOracleRepository Oracle CreateReplicaRepository host volume local CreateRestoredHostVolumesUsingRepository Oracle storage CreateStorageVolume volume storage local, DeleteContainer volume container remote DeleteDrGroup DR group remote DeleteDrGroupMember DR group DeleteHostVolume host volume host volume DeleteHostVolumeGroup group DeleteHostVolumesUsingRepository...
Page 196 Requires Job command Command Replication host agent category type local, FractureHostVolumeMirrorclones host volume mirrorclone storage local, FractureMirrorclones volume mirrorclon Import general storage local, InstantRestoreFromMirror volume mirrorclone storage local, InstantRestoreFromSnapshot volume snapshot Launch host LaunchJob script ﬂow general host disk local, MirrorcloneHostDiskDeviceToContainer device mirrorclone...
Page 197 Requires Job command Command Replication host agent category type host disk RetainLatestRoundRobinReplicasForHostStorageVolume local device RetainLatestRoundRobinReplicasForHostVolume host volume local host volume RetainLatestRoundRobinReplicasForHostVolumeGroup local group SendEmail general local, SetDiskGroupForSnapclone host volume snapclone DR group remote SetDrGroupAutoSuspend remote SetDrGroupComments DR group SetDrGroupDestinationAccess DR group remote remote DR group...
Page 198 Requires Job command Command Replication host agent category type local, SnapcloneHostVolume host volume snapclone host volume local, SnapcloneHostVolumeGroup group snapclone host volume local, SnapcloneHostVolumeGroupToContainersInManagedSet group snapclone local, SnapcloneHostVolumeToContainers host volume snapclone local, SnapcloneHostVolumeToContainersInManagedSet host volume snapclone local, SnapcloneOracleToContainersUsingRepository Oracle snapclone local, SnapcloneOracleUsingRepository Oracle...
Page 199 Requires Job command Command Replication host agent category type host volume UnmountEntireVolumeGroup group UnmountHostVolume host volume UnmountHostVolumes host volume UnmountHostVolumesUsingRepository Oracle storage UnpresentStorageVolume volume storage UnpresentStorageVolumes volume ValidateHost validation ValidateHostVolume validation ValidateHostVolumeDoesNotExist validation ValidateHostVolumeGroup validation local, ValidateHostVolumeMirrorclones validation mirrorclone ValidateOracleDatabase Oracle ValidateOracleTablespaces Oracle...
Page 200: Job Templates List
Requires Job command Command Replication host agent category type WaitForJob script ﬂow storage WaitForStorageVolumeDiscovery volume storage WaitForStorageVolumesDiscovery volume storage WaitForStorageVolumeWriteCacheFlush volume storage WaitForStorageVolumesWriteCacheFlush volume WaitForWriteCacheFlushUsingRepository Oracle host disk WaitHostDiskDeviceNormalization device WaitHostVolumeNormalization host volume storage WaitStorageVolumeNormalization volume storage WaitStorageVolumesNormalization volume WaitUntil script ﬂow host volume WaitVolumeGroupNormalization...
Page 201 Template name (alphabetical order) Replication Remarks type Empty template Fracture host volumes, mount to a host local requires host agent Instant restore storage volumes to other storage volumes local Mount existing storage volumes requires host agent remote and Perform cascaded replication local remote Perform planned failover...
Page 202: Pause And Continue
Usage Labels are: • Local to each job and cannot be referenced across jobs. • Not case sensitive. Format • Must be at least two characters and end with a colon. • Upper and lower case, alpha and numeric are allowed. •...
Page 203 IMPORTANT: UNC names in job commands are case sensitive. After selection or entry of arguments, the command is displayed with resource names in quotes, for example: CreateDiskDevice ( "\\ArrayA2\Cats", "HostA6", 12, READ_WRITE ) Name formats and examples for resource types follow. DR groups Name format (UNC) Example...
Page 204: Simultaneous Job Instances
Oracle Name format (UNC) Example \\HostA2\Cats_db \\enabled host\database name Identiﬁes the Oracle database named Cats_db on the enabled host named HostA2 \\HostA2\Catalog 20051218.024153 Identiﬁes the repository named Catalog \\enabled host\repository name 20051218.024153 on the enabled host named HostA2. Storage systems Name format (other) Example ArrayA2...
Page 205: Status And States
Status and states Job status The collection of all jobs may have one of the following status conditions. These status conditions appear in the resources pane. Icon Status When last checked, new information on jobs was not available. When last checked, new information on jobs was available. Job instance states A job instance may have one of the following states.
Page 206: Validation
Line Task Launch ( %source_host%, %suspend_command_line%, "", WAIT, "0" ) onerror pauseat E1: transaction start > DO { $Rep1 = SnapshotStorageVolume ( %array_name_source_storvol_unc1%, transaction end > FULLY_ALLOCATED, SAME, %dest_storvol1%, NOWAIT ) onerror pauseat E1: } ALWAYS { // Resume the host application. Launch ( %source_host%, %resume_command_line%, "", WAIT, "0"...
Page 207 • Skip validation. If the line is a validation command it is ignored. In the validate-only and skip validation cases, job transactions and branches within validation commands are ignored. Resource validation processing in transactions Special cases exist for validation commands in a transaction block: •...
Page 208: Job Templates
Job templates Empty template Template summary Provides a series of comments that outline the basic structure of a job. After generating this template you must add individual job commands to accomplish speciﬁc tasks. Template options • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy.
Page 209 • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy. Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication. Example This template was generated to fracture and mount one host volume on an enabled host. No other template options were selected.
Page 210: Instant Restore Storage Volumes To Other Storage Volumes (Template)
// Wait for user to initiate rollback. Pause () // Rollback. E5: UnmountHostVolume ($MP1) onerror pauseat E5: E4: DeleteHostVolume ($HV1) onerror pauseat E4: E3: UnpresentStorageVolumes ($Rep1, $mount_host) onerror pauseat E3: E2: ResyncMirrorclones ($Rep1) onerror pauseat E2: // Uncomment the following line if you want the job to wait for the mirrors to resynchronize before completing //WaitHostVolumeNormalization($source_hostvol_unc1) Exit (SUCCESS)
Page 211 Example This template was generated to copy (restore) one storage volume. No other template options were selected. Line Task // Synchronize storage volume(s) to other storage volume(s) // Assign some variables that will be used in this job. $source_storvol_unc1 = SetVariable(%source_storvol_unc1%) $dest_storvol_unc1 = SetVariable(%dest_storvol_unc1%) // Validate that resources are as expected.
Page 212: Mount Existing Storage Volumes (Template)
Mount existing storage volumes (template) Template summary Creates a host volume by presenting an existing* storage volume to an enabled host. Mounts the host volume. Pauses the job until continued by a user. After continuing, unmounts and deletes the host volume. * A storage volume that is created by means other than this job.
Page 213: Perform Cascaded Replication (Template)
Line Task // Mount existing storage volume(s). // Assign some variables that will be used in this job. $storvol_unc1 = SetVariable(%storvol_unc1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateStorageVolume ($storvol_unc1) // Mount the volume(s) on a host. $HV1 = CreateHostVolumeDiscrete (%component%, $storvol_unc1, $mount_host) onerror pauseat E1: $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E2: // Wait for user to initiate rollback.
Page 214 Presents the snapclones to a host at site 2. (This is required by some controller software versions before the snapclones can be members of a DR group. Creates a new DR group pair that contains the snapclone copies at site 2. Halts the job (waits) to ensure that the snapclones are remotely replicated to new storage volumes at site 3.
Page 215 // Validate some resources needed by this job: // - The arrays at Sites 1, 2 and 3. // - The source DR group at Site 1 and it’s virtual disk member(s). // - The storage system at Site 2 with the destination DR group and it’s virtual disk member(s). // - The host name at Site 2.
Page 216 // Set the DR group at Site 1 back to asynchronous. SetDrGroupIoMode ($site_1_array_DR_Group_name_unc, ASYNCHRONOUS) onerror continue // Present the snapclone at Site 2 to a host. // NOTE: This is required only for VCS 3.x. For later versions, you may remove this step. // Typically you will NOT want to present to an Enabled Host Agent, but instead // use the name of a ’dummy’...
Page 217: Perform Planned Failover (Template)
Perform planned failover (template) Template summary Performs a failover of two sites in the case where the source site resources and link remain available.he DR group pair contains one storage volume (virtual disk) at the source and destination sites. Stops an application on the enabled host at site 1 (if necessary). Unmounts the host volume on the enabled host at site 1.
Page 218 Line Task // Perform a planned failover of a CA conﬁguration. // Assign some variables that will be used in this job. $site_2_array = SetVariable(%site_2_array%) $site_1_host = SetVariable(%site_1_host% $site_2_host = SetVariable(%site_2_host%) $site_1_host_hostvol_unc = SetVariable(%site_1_host_hostvol_unc%) // Validate that resources are as expected. ValidateHost ($site_1_host) ValidateHost ($site_2_host) ValidateStorageSystem ($site_2_array)
Page 219: Perform Unplanned Failover (Template)
Perform unplanned failover (template) Template summary Performs an unplanned failover of two sites in the case where the source site resources or link is no longer available. The DR group pair contains one storage volume (virtual disk) at the source and destination sites. Performs a failover from site 1 to site 2.
Page 220: Replicate (Via Snapclone) A Host Volume Multiple Times, Mount To A Host (Template)
Line Task // Perform an unplanned failover of a CA conﬁguration. // Since it is ’unplanned’, we do not quiesce or unmount the source volumes. // Assign some variables that will be used in this job. $site_2_array = SetVariable(%site_2_array% $site_2_host = SetVariable(%site_2_host%) // Validate that resources are as expected.
Page 221 Template options • Number of times to snapclone. Adds commands for each snapclone. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup.
Page 222 Line Task // Make multiple snapclones of the same Host Volume, and mount to a host. // This requires normalization between each snapclone. // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $mount_host1 = SetVariable(%mount_host1%) // Validate that resources are as expected.
Page 223: Replicate Host Disk Devices, Mount To A Host (Template)
Replicate host disk devices, mount to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a raw host volume on an enabled host. Presents the underlying storage volume copies to a second enabled host (creates a new raw host volume).
Page 224: Replicate Host Volume Group, Mount Components To A Host (Template)
Line Task // Replicate host disk device(s), and mount to a host. // Assign some variables that will be used in this job. $source_host = SetVariable(%source_host%) $source_disk_device_unc1 = SetVariable(%source_disk_device_unc1%) $dest_storvol1 = SetVariable(%dest_storvol1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) $Rep1 = SnapshotDiskDevice ($source_disk_device_unc1, FULLY_ALLOCATED, SAME, $dest_storvol1,...
Page 225 By default, mounts the components (logical volumes) in the new host volume group on the second enabled host. Optionally, use raw disk I/O (do not mount the replicated components). Pauses the job. After continuing, unmounts the new volume group components from the second enabled host, unpresents and deletes the storage volume copies from the storage system.
Page 226 Line Task // Replicate a host volume group, and mount component(s) to a host. // Assign some variables that will be used in this job. $source_VolumeGroup_unc1 = SetVariable(%source_VolumeGroup_unc1% $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host% $source_VG_component_unc1 = SetVariable(%source_VG_component_unc1% // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateSnapshotHostVolumeGroup ($source_VolumeGroup_unc1)
Page 227: Replicate Host Volume Group, Mount Entire Group To A Host (Template)
Replicate host volume group, mount entire group to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume group on an enabled host. Presents the underlying storage volume copies to a second enabled host (creates a new host volume group).
Page 228 Line Task // Replicate host volume group(s), and mount to a host. // Assign some variables that will be used in this job. $source_VolumeGroup_unc1 = SetVariable(%source_VolumeGroup_unc1%) $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateSnapshotHostVolumeGroup ($source_VolumeGroup_unc1) $Rep1 = SnapshotHostVolumeGroup ($source_VolumeGroup_unc1, FULLY_ALLOCATED, SAME, WAIT)
Page 229: Replicate Host Volumes (Template)
Replicate host volumes (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host. Pauses the job. After continuing, deletes the storage volume copies from the storage system. Template Options • Number of volumes to replicate. Adds commands for each volume. •...
Page 230: Replicate Host Volumes, Mount To A Host (Template)
Line Task // Replicate host volume(s). // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host%) // Validate that resources are as expected. ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1) $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror pauseat E1: // Wait for user to initiate rollback.
Page 231 • Use snapclone instead of snapshot. Generates a template that uses snapclone replication. • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy. Considerations • Tru64 UNIX. When replicating AdvFS volumes that have heavy I/O, select the option Suspend source before replication.
Page 232 Line Task // Replicate host volume(s), and mount to a host. // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1) $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror...
Page 233: Replicate Host Volumes, Mount To A Host, Then To A Different Host (Template)
Replicate host volumes, mount to a host, then to a different host (template) Template summary Involves ﬁve enabled hosts, EH1 through EH5*. Locally replicates (copies) the storage volumes that underlie a host volume on an EH1. Presents the underlying storage volume copies to EH2 (creates a new host volume). Mounts the new host volume on EH2, launches a backup process on EH3, and waits for the process to complete.
Page 234 ValidateHost ($mount_host1) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1 $Rep1 = SnapshotHostVolume ($source_hostvol_unc1, FULLY_ALLOCATED, SAME, WAIT) onerror pauseat E1: // Mount the replicated volume(s) on a host. PresentStorageVolumes ($Rep1, $mount_host1) onerror pauseat E2: DiscoverDiskDevices ($mount_host1, $Rep1) onerror continue $HV1 = CreateHostVolumeFromDiskDevices ($source_hostvol_unc1, $Rep1, $mount_host1) onerror pauseat E2: $MP1 = MountHostVolume ($HV1, %mount_point1%) onerror pauseat E5: // Launch a backup process on a host.
Page 235: Replicate Host Volumes Via Preallocated Replication, Mount To A Host (Template)
Exit (SUCCESS // Failure exit - no rollback needed. E1: Exit (FAILURE Replicate host volumes via preallocated replication, mount to a host (template) Template summary Disables (ﬂushes) the write cache of the storage volumes that underlie a host volume on an enabled host.
Page 236 // Assign some variables that will be used in this job. $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) $source_host = SetVariable(%source_host% $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($source_host) ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1 // Begin ﬂushing the cache on the host volume(s). SetHostVolumeWriteCacheMode ($source_hostvol_unc1, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache ﬂush to complete.
Page 237: Replicate Host Volume, Mount Components To A Host (Template)
// Rollback. E4: UnmountHostVolume ($MP1) onerror pauseat E4: E3: DeleteHostVolume ($HV1) onerror pauseat E3: E2: DeleteStorageVolumesInManagedSet (%dest_container_set1%) onerror pauseat E2: Exit (SUCCESS) // Failure exit - no rollback needed. E1: Exit (FAILURE) Replicate host volume, mount components to a host (template) Template summary Locally replicates (copies) the storage volumes that underlie a host volume on an enabled host.
Page 238 Line Task // Replicate a host volume, and mount slices/partitions/LVs to a host. // Assign some variables that will be used in this job. $mount_host = SetVariable(%mount_host%) $source_host = SetVariable(%source_host%) $source_hostvol_unc1 = SetVariable(%source_hostvol_unc1%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateHostVolume ($source_hostvol_unc1) ValidateSnapshotHostVolume ($source_hostvol_unc1)
Page 239: Replicate Raw Storage Volumes Mount (Raw) To A Host (Template)
Replicate raw storage volumes mount (raw) to a host (template) Template summary Locally replicates (copies) raw storage volumes. Presents the storage volume copies to an enabled host (creates a raw host volume). Pauses the job. After continuing, removes the raw host volume from the enabled host. Unpresents and deletes the storage volume copy from the storage system.
Page 240: Replicate Storage Volumes (Template)
Line Task // Replicate raw storage volume(s), and mount to a host. // Assign some variables that will be used in this job. $source_storvol_unc1 = SetVariable(%source_storvol_unc1%) $dest_storvol1 = SetVariable(%dest_storvol1%) $mount_host = SetVariable(%mount_host%) // Validate that resources are as expected. ValidateHost ($mount_host) ValidateStorageVolume ($source_storvol_unc1) ValidateSnapshotStorageVolume ($source_storvol_unc1) $Rep1 = SnapshotStorageVolume ($source_storvol_unc1, FULLY_ALLOCATED, SAME, $dest_storvol1,...
Page 241 Template options • Number of volumes to replicate. Adds commands for each volume. • Suspend source before replication. Adds launch commands for interacting with an enabled host, for example to suspend and resume host application I/O. • Use snapclone instead of snapshot. Generates a template that uses snapclone replication. •...
Page 242: Replicate Storage Volumes Via Preallocated Replication (Template)
Replicate storage volumes via preallocated replication (template) Template summary Disables (ﬂushes) the write cache of a storage volume. Locally replicates (copies) the storage volume to a container. Re-enables the write cache of the storage volume. NOTE: This template cannot be used with some older versions of controller software. Template options •...
Page 243 Line Task // Replicate storage volume(s) via pre-allocated replication. // Assign some variables that will be used in this job. $source_storvol_list = SetListVariable(%source_storvol_list%) $dest_container_list = SetListVariable(%dest_container_list%) // Validate that resources are as expected. ValidateStorageVolumes ($source_storvol_list) // Begin ﬂushing the cache on the storage volume(s). SetStorageVolumesWriteCacheMode ($source_storvol_list, WRITE_CACHE_DISABLED, NOWAIT) onerror pauseat E1: // Wait for the cache ﬂush to complete.
Page 244: Replicate Oracle Tablespaces (Template)
Replicate Oracle tablespaces (template) Template summary Create a repository that contains the desired database components. Quiesce the Oracle database by putting it in ‘hot backup’ mode. Replicate the tablespace(s). Put the database back into normal operating mode. Pause. Delete the storage volume(s). Delete the repository.
Page 245: Replicate Oracle Tablespaces, Mount To A Host (Template)
SetOracleModeUsingRepository ($repository, TSONLINE) // NOTE: Please remove the archive log ﬁle Switch, Add, and Snap commands below if this job is not backing up archive log ﬁles // Force a log switch to get the most current archive logs. SwitchOracleArchiveLogFilesUsingRepository ( $repository ) onerror pauseat E3: // OPTION: Add the archive logs AddOracleArchiveLogFilesToRepository($repository) onerror pauseat E3: // Replicate the items in the repository.
Page 246 Template options • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. • Use snapclone instead of snapshot. Generates a template that uses snapclone replication. • Include e-mail notiﬁcation. Adds a command for e-mail notiﬁcation of the job instance status. See SetNotiﬁcationPolicy.
Page 247: Replicate Oracle Tablespaces Via Preallocatted Replication, Mount To A Host (Template)
// OPTION: Add the archive logs AddOracleArchiveLogFilesToRepository($repository) onerror pauseat E3: // Replicate the items in the repository. SnapshotOracleUsingRepository ($repository, FULLY_ALLOCATED, SAME, ORA- CLE_ARCHIVE_LOG_FILE, NOWAIT) onerror pauseat E3: // Mount the replicated volume(s) on a host. CreateHostVolumesUsingRepository ($repository, $mount_host) onerror pauseat E3: SetMountPointsPreﬁxInRepository ($repository, %preﬁx%) onerror pauseat E4: $MountedHVs = MountHostVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E4: // Wait for user to initiate rollback.
Page 248 Delete the repository. NOTE: This template cannot be used with some older versions of controller software. Template options • Launch backup after replication. Adds a launch command for interacting with an enabled host, for example, to start a tape backup. •...
Page 249 } ALWAYS { // Put the database back into normal mode. SetOracleModeUsingRepository ($repository, TSONLINE) // Restore the writeback cache on the host volume(s). SetWriteCacheModesUsingRepository ($repository, ORIGINAL, ORACLE_TABLESPACE, WRITE_CACHE_ENABLED) // NOTE: Please remove the archive log ﬁle Switch, Add, and Snap commands below if this job is not backing up archive log ﬁles.
Page 250: Restore Oracle Tablespaces (Template)
E3: DeleteStorageVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E3: // Delete the repository. E2: DeleteOracleRepository ($repository) onerror pauseat E2: Exit (SUCCESS // Failure exit - no rollback needed. E1: Exit (FAILURE) Restore Oracle tablespaces (template) Template Summary Restores Oracle tablespaces to an enabled host. Use existing repository from previous backup.
Page 251: Setup Continuous Access (Remote Replication Template)
Line Task // Restore Oracle tablespace(s) using repository. // Assign some variables that will be used in this job. $repository = SetVariable(%repository_name%) $mount_host = SetVariable(%mount_host%) // Mount the replicated volume(s) on a host. CreateHostVolumesUsingRepository ($repository, $mount_host) onerror pauseat E1: SetMountPointsPreﬁxInRepository ($repository, %preﬁx%) onerror pauseat E2: $MountedHVs = MountHostVolumesUsingRepository ($repository, REPLICATED) onerror pauseat E2: // Keep the items created by this job.
Page 252 Example This template was generated to create one DR group pair. Line Task // Setup Continuous Access. // Assign some variables that will be used in this job. $DR_source_array = SetVariable(%DR_source_array%) $DR_dest_array = SetVariable(%DR_dest_array%) $DR_group_name = SetVariable(%DR_group_name%) $DR_source_storvol_unc1 = SetVariable(%DR_source_storvol_unc1%) $dest_host_name = SetVariable(%dest_host_name%) // Validate that resources are as expected.
Page 253: Throttle Replication I/O (Remote Replication Template)
Throttle replication I/O (remote replication template) IMPORTANT: Jobs generated by this template are intended to be run only in conjunction with a log merge or full-copy events on a single storage system. Template summary Suspends remote replication in non-critical DR group pairs until critical DR group pairs have normalized across the two sites.
Page 254: Unmount And Delete Existing Host Volumes (Template)
Line Task // Throttle replication I/O on non-critical DR groups, // so that critical DR groups will have the best performance. // Assign some variables that will be used in this job. $DR_Group_name_unc1 = SetVariable(%DR_Group_name_unc1%) // Suspend the non-critical DR group(s). SetDrGroupSuspend ($DR_Group_name_unc1, SUSPENDED) onerror pauseat E1: // Wait for the critical DR group(s) to normalize.
Page 255: Unmount Existing Host Volumes (Template)
Line Task // Unmount and delete the host volume(s). // Assign some variables that will be used in this job. $hostvol_unc1 = SetVariable(%hostvol_unc1%) $host_name = SetVariable(%host_name%) // Validate that resources are as expected. ValidateHost ($host_name) ValidateHostVolume ($hostvol_unc1) E1: UnmountHostVolume ($hostvol_unc1) E2: DeleteHostVolume ($hostvol_unc1) Exit (SUCCESS) Unmount existing host volumes (template)
Page 256: Job Commands
Line Task // Unmount existing host volume(s). // Assign some variables that will be used in this job. $hostvol_unc1 = SetVariable(%hostvol_unc1%) $host_name = SetVariable(%host_name%) // Validate that resources are as expected. ValidateHost ($host_name) ValidateHostVolume ($hostvol_unc1) // Unmount the volume(s). E1: UnmountHostVolume ($hostvol_unc1) Exit (SUCCESS) Job commands // (comment)
Page 257: Adddrgroupmember
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: AddAllOracleTablespacesToRepository ( %oraclerepository_unc_name% ) UNC Oracle repository Name (%oraclerepository_unc_name%). Select or enter the UNC name of the repository to which the Oracle tablespaces are to be added. Examples AddAllOracleTablespacesToRepository ( "\\HostA2\Catalog 20051214.021405"...
Page 258: Addoraclearchivelogfilestorepository
• Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • The maximum number of virtual disks per DR group is controller software dependent. •...
Page 259: Addreplicatoreplicarepository
Comments • Associated validation commands.ValidateOracleTablespaces. • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • The repository must already exist or be created by a previous step in the same job. •...
Page 260 Examples AddReplicasToReplicaRepository ( “RR-20070223.015320.588”, ("\\Array2\Cats1", "\\Array2\Cats2", "\\Array3\Cats3") ) AddReplicasToReplicaRepository ( “RR-20070223.015320.588”, $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolume, ValidateStorageVolumes. • Agent and license prerequisites. Requires a host agent. • Command result value. None . For a complete list, see command result values.
Page 261: Convertstoragevolumesinmanagedsetintocontainers
Examples ConvertStorageVolumeIntoContainer ( "\\ArrayA2\Cats" ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. Container name (UNC). For a complete list, see command result values. • OS speciﬁcs. None • This command cannot be used with some older versions of controller software. •...
Page 262: Convertstoragevolumesintocontainersusingrepository
Examples ConvertStorageVolumesIntoContainers ( ("\\Array2\Cats", "\\Array2\Dogs") ) ConvertStorageVolumesIntoContainers ( $my_svol_list ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. List of container names (UNC). For a complete list, see command result values. • Command result value.
Page 263: Createcontainerforhostdiskdevice
CreateContainer ( %storvol_name%, %size%, RAID0, %diskgroup_unc_name% ) Container Name (%storvol_name%). Enter a name for the container that is to be created. Size (GB). Enter a size (GB) for the container. Raid Level. Select a redundancy level for the container. UNC Disk Group Name. Select or enter the UNC name of the disk group in which the container is to be created.
Page 264: Createcontainersforhostvolume
• Command result value. Name of managed set of containers. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats. CreateContainersForHostVolume Creates a managed set of storage containers that correspond to the virtual disks that underlie a host volume.
Page 265 CreateContainersForHostVolumeGroup ( %hostvolgroup_unc_name%, %managed_set_name% ) UNC Host Volume Group Name (%hostvolgroup_unc_name%). Select or enter the UNC name of the host volume group for which the storage containers are to be created. Managed Set Name (%managed_set_name%). Select or enter a name for the managed set in which the storage containers are to be added.
Page 266: Createdrgroup
Comments • Associated validation commands. ValidateHost, ValidateStorageVolume • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • resource names and UNC formats. • This command may also cause other devices to appear on the host when its bus is scanned.
Page 267: Createdrgroupfromhostvolume
• Guidelines apply. • The maximum number of virtual disks per DR group and other properties are controller software dependent. • Values for the following properties can be speciﬁed in the CreateDrGroup command. These properties can be changed later, in another job, by using the commands shown. Default values Property Source...
Page 268 Destination Storage System Name (%dest_storsys_name%). Select or enter the name of destination storage system on which the destination DR group will be created. Destination Disk Group. Select or enter the name of the disk group on the destination storage system in which the destination storage volume (remote copy) will be created.
Page 269: Createhostvolume
• Values for the following properties can be speciﬁed in the CreateDrGroupFromHostVolume command. These properties can be changed later, in another job, by using the commands shown. Default values Property Source Destination Job command Auto suspend on links False (disabled) False (disabled) SetDrGroupAutoSuspend down mode...
Page 270: Createhostvolumediscrete
Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**). $Rep1=SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) ** CreateHostVolume ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) ** HP-UX CreateHostVolume ( "\\HostA2\/users/cats", $Rep1, "HostA4"...
Page 271: Createhostvolumefromdiskdevices
Storage Volume UNC Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume that underlies the host volume. Target Host (%target_host%). Select or enter the name of the enabled host to which the storage volume is to be presented. Examples CreateHostVolumeDiscrete ( "1", "\\ArrayA2\Cats", "HostA4"...
Page 272: Createhostvolumegroup
Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**). $Rep1=SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) ** CreateHostVolumeFromDiskDevices ( "\\HostA2\/home/cats", $Rep1, "HostA4" ) $Rep1=SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) ** HP-UX CreateHostVolumeFromDiskDevices ( "\\HostA2\/users/cats", $Rep1, "HostA4"...
Page 273: Createhostvolumesusingrepository
Target Host (%target_host%). Select or enter the name or IP address of the enabled host on which the host volume is to be created. Examples These examples show host volume mount points. Device names can also be used. The required replication step that precedes the host volume creation step is marked with asterisks (**).
Page 274: Createoraclerepository
Target Host (%target_host%). Select or enter the name or IP address of the enabled host on which the host volumes are to be created. Examples CreateHostVolumesUsingRepository ( "\\HostA2\Catalog 20051214.021405", "HostA2" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 275: Createreplicarepository
UNC Oracle Repository Name (%oraclerepository_unc_name% ). Select or enter the UNC name of the repository whose ﬁles are to be restored. Examples CreateRestoredHostVolumesUsingRepository ( "\\HostA2\Catalog 20051214.021405" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 276: Createstoragevolume
CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/home/cats”, INSTANT_RESTORE, "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/users/cats”, INSTANT_RESTORE, HP-UX "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/var/cats”, INSTANT_RESTORE, Linux "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\CATS:”, INSTANT_RESTORE, OpenVMS "Replica of cats" ) CreateReplicaRepository ( HOST_VOLUME, “\\HostA2\/usr/cats”, INSTANT_RESTORE, Solaris "Replica of Cats"...
Page 277 • Command result value. Storage volume (virtual disk) name (UNC). For a complete list, see command result values. • OS speciﬁcs. None. • Virtual disks can only be created at the root level of the array. • resource names and UNC formats.
Page 278: Deletedrgroupmember
Comments • Associated validation commands. ValidateStorageSystem • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • If the source-destination connection is not operational, DR groups are still deleted but you must manually delete the destination virtual disks when the connection is reestablished.
Page 279: Deletehostvolumegroup
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteHostVolume ( %hostvol_unc_name% ) UNC Host volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume (on an enabled host) to be deleted. Examples These examples show host volume mount points.
Page 280: Deletehostvolumesusingrepository
DeleteHostVolumeGroup ( "\\HostA2\/home/vg02" ) HP-UX DeleteHostVolumeGroup ( "\\HostA2\/users/vg02" ) Linux DeleteHostVolumeGroup ( "\\HostA2\/var/vg02" ) OpenVMS Not applicable Solaris DeleteHostVolumeGroup ( "\\HostA2\/usr/vg02" ) Tru64 UNIX DeleteHostVolumeGroup ( "\\HostA2\dom01" ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup • Agent and license prerequisites. Requires a host agent. •...
Page 281: Deleteoraclerepository
DeleteOracleRepository Deletes an Oracle repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteOracleRepository ( %oraclerepository_unc_name% ) UNC Oracle Repository Name (%oraclerepository_unc_name% ). Select or enter the UNC name of the Oracle repository to delete. Examples DeleteOracleRepository ( "\\HostA2\Catalog 20051214.021405"...
Page 282: Deletestoragevolumes
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: DeleteStorageVolume ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume to be deleted. Examples DeleteStorageVolume ( "\\ArrayA2\Cats" ) Comments •...
Page 283: Deletestoragevolumesusingrepository
DeleteStorageVolumesInManagedSet ( %managed_set_name% ) Managed set of containers. Select or enter the name of the managed set whose storage volumes (virtual disks) are to be deleted. Examples DeleteStorageVolumesInManagedSet ( "svol_cats_set" ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None •...
Page 284: Discoverdiskdevice
Mirrorclone UNC Storage Volume Names (%mirrorclone_unc_names%). Select or enter the UNC names of the mirrorclone storage volumes (not the source storage volumes) to be fractured. See argument list. Or, select a variable used in a prior step that represents the mirrorclones. Examples DetachMirrorclones ( ("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars") ) DetachMirrorclones ( $my_svol_list )
Page 285: Discoverdiskdevicesfordrgroup
DiscoverDiskDevices ( %hostname%, %storvol_unc_list% ) Host Name (%hostname%). Select or enter the name of the enabled host that you want to discover the presented storage volume. List of UNC Storage Volume Names (%storvol_unc_list%). Select or enter the names of presented storage volumes to be discovered.
Page 286: Discoveryrefresh (Obsolete)
DiscoveryRefresh (obsolete) NOTE: This command is obsolete. See comments below for details. The command causes the replication manager to check its database for available resources. The command was previously used to ensure that resource properties from the database are used in conjunction with job commands, rather than using properties from the server cache memory, which might not have been up to date.
Page 287 Comments • Associated validation command. None • Agent and license prerequisites. None • Command result values. None. For a complete list, see command result values. • OS speciﬁcs. None Export Exports the RSM database. This feature allows administrators to create a copy of the active RSM database.
Page 288: Flushcache
Examples FailoverDrGroup ( "\\ArrayB2\DrGrpPets", FALSE ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values.
Page 289: Forcefullcopydrgroup
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: FlushCache ( %hostvol_unc_names% ) Host Volume UNC Names (%hostvol_unc_names%). Select or enter the UNC names of the host volumes (on an enabled host) whose caches are to be ﬂushed. Examples These examples show host volume mount points.
Page 290: Fracturehostdiskdevicemirrorclone
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • resource names and UNC formats. FractureHostDiskDeviceMirrorclone Fractures the mirrorclone of storage volumes that underlie a host disk device. The host disk device must consist of storage volumes that have mirrorclones.
Page 291: Fracturehostvolumemirrorclones
Examples FractureHostVolumeGroupMirrorclones ( "\\HostA2\/home/cats_vg", WAIT ) HP-UX FractureHostVolumeGroupMirrorclones ( "\\HostA2\/users/cats_vg", WAIT ) Linux FractureHostVolumeGroupMirrorclones ("\\HostA2\/var/cats_vg", WAIT ) OpenVMS Not applicable Solaris FractureHostVolumeGroupMirrorclones ( "\\HostA2\/usr/cats_vg", WAIT ) Tru64 UNIX FractureHostVolumeGroupMirrorclones ( "\\HostA2\dom01#fset1", WAIT ) Windows Not applicable Comments • Associated validation commands. ValidateHostVolumeGroup. •...
Page 292: Fracturemirrorclones
Comments • Associated validation commands. ValidateHostVolumeMirrorclones. • Agent and license prerequisites. Requires a host agent. Requires a local replication license for the storage systems on which the underlying storage volumes are located. • Command result value. List of fractured mirrorclone names. For a complete list, see command result values.
Page 293 Import ( %full_ﬁle_name% ) Full path name. Enter the full path and ﬁle name of the RSM database copy to import. Examples Import ( "C:\colorado\RSMdb_on_server2_Mar_15_2007.xml") Import ( "C:\colorado\CADATA_2005021 1 135232.export" ) Comments • Associated validation commands. None • Agent and license prerequisites. None •...
Page 294: Instantrestorefromsnapshot
InstantRestoreFromSnapshot Replaces the data on a storage volume by copying data from one of its snapshots. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: InstantRestoreFromSnapshot ( %snapshot_unc_name%, %source_storvol_unc_name%, %wait_nowait% ) UNC Snapshot Storage Volume Name (%storvol_unc_name%). Select or enter the name of one of its snapshots to restore from.
Page 295: Launchjob
Examples Launch ( "HostA2", "/home/zap_application.sh", "", WAIT, "0" ) HP-UX Launch ( "HostA2", "/users/zap_application.sh", "", WAIT, "0" ) Linux Launch ( "HostA2", "/var/zap_application.sh", "", WAIT, "0" ) OpenVMS Launch ( "HostA2", "CATS.ZAP_APPLICATION.COM", "", WAIT, "0" ) Solaris Launch ( "HostA2", "/usr/zap_application.sh", "", WAIT, "0" ) Tru64 UNIX Launch ( "HostA2", "/var/zap_application.sh", "", WAIT, "0"...
Page 296: Mirrorclonehostdiskdevicetocontainer
• OS speciﬁcs. None. Sends a message from the job to the job event log. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: Log ( %message% ) Message ( %message% ). Enter the message that you want to send to the job log. Examples Log ( "Snapshot of sales database has ﬁnished"...
Page 297: Mirrorclonehostdiskdevicetocontainerinmanagedset
Examples MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/dsk/hd1”, "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer (“\\HostA2\/dev/dsk/c2t0d2”, HP-UX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/sda3”, "\\ArrayA2\CatsCon- Linux tainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\$1$DGA2:”, "\\ArrayA2\CatsCon- OpenVMS tainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostDiskDeviceToContainer ( “\\HostA2\Disk3”, "\\ArrayA2\CatsCon- Windows...
Page 298: Mirrorclonehostvolumegrouptocontainers
Examples MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", WAIT ) MirrorcloneHostDiskDeviceToContainerInManagedSet ( “\HostA2\Disk3”, "hvol_cats_set", Windows...
Page 299: Mirrorclonehostvolumegrouptocontainersinmanagedset
Examples MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/home/cats_vg", "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/users/cats_vg", HP-UX "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/var/cats_vg", Linux "\\ArrayA2\CatsContainer", WAIT ) OpenVMS Not applicable MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\/usr/cats_vg", Solaris "\\ArrayA2\CatsContainer", WAIT ) MirrorcloneHostVolumeGroupToContainers ( "\\HostA2\dom01#fset1", Tru64 UNIX "\\ArrayA2\CatsContainer", WAIT ) Windows Not applicable Comments •...
Page 300: Mirrorclonehostvolumetocontainers
Examples MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", WAIT ) OpenVMS Not applicable MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", WAIT ) MirrorcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\dom01#fset1", Tru64 UNIX "hvol_cats_set", WAIT ) Windows Not applicable Comments •...
Page 301: Mirrorclonehostvolumetocontainersinmanagedset
MirrorcloneHostVolumeToContainers ( "\\HostA2\/home/cats", ("\\ArrayA2\CatsCon- tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- HP-UX tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/var/cats", ("\\ArrayA2\CatsCon- Linux tainer", WAIT ) OpenVMS MirrorcloneHostVolumeToContainers ( "\\HostA2\CATS", "\\Array2\Cats", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/usr/cats", ("\\ArrayA2\CatsCon- Solaris tainer", WAIT ) MirrorcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- Tru64 UNIX tainer", WAIT ) Windows...
Page 302: Mirrorclonestoragevolumetocontainer
MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", Tru64 UNIX "hvol_cats_set", WAIT ) Windows MirrorcloneHostVolumeToContainersInManagedSet ( "\\HostA2\E:\", "hvol_cats_set", Drive...
Page 303: Mountentirevolumegroup
• Agent and license prerequisites. Requires a local replication license for the storage system on which the storage volume is located. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None. MountEntireVolumeGroup Instructs an enabled host to mount all of the replica logical volumes in a replica volume group, as appropriate.
Page 304: Mounthostvolume
Linux. You cannot mount a volume group replica on the same host as the source volume group. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Solaris. You cannot mount a volume group replica on the same host as the source volume group. Tru64 UNIX.
Page 305: Mountvolumegroupcomponent
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: MountHostVolumesUsingRepository ( %oraclerepository_unc_name%, %original_replicated% ) UNC Oracle repository (%oraclerepository_unc_name% ). Select or enter the UNC name of the repository whose host volumes are to be mounted. Original or Replicated (%original_replicated% ).
Page 306: Pause
Examples MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/home/pets" ) HP-UX MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/users/pets" ) Linux MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/var/pets" ) OpenVMS Not applicable Solaris MountVolumeGroupComponent ( "VG02Copy", "VG02", "/dev/lv01", "/usr/pets" ) MountVolumeGroupComponent ( "dom01_RV1", "\\HostA2\dom01", Tru64 UNIX "\\HostA2\dom01#fset1", "/usr/pets"...
Page 307: Presentstoragevolumes
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: PresentStorageVolume ( %storvol_unc_name%, %host_name%, 0, READ_WRITE ) UNC Storage Volume Name ( %storvol_unc_name%). Select or enter the full UNC name of the storage volume (virtual disk) whose presentation you want to begin. Host_Name (%host_name%).
Page 308: Removediskdevice
Comments • Associated validation commands. ValidateHost, ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • Each storage volume is automatically assigned the next available LUN on the host. The access type defaults to read_write.
Page 309: Retainlatestroundrobinreplicasforhoststoragevolume
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ResyncMirrorclone ( %mirrorclone_unc_name% ) Mirrorclone UNC Storage Volume Name (%mirrorclone_unc_name%). Select or enter the UNC name of the fractured mirrorclone to be resynchronized with its source storage volume. Examples ResyncMirrorclone ( "\\Array2\Cats_copy"...
Page 310: Retainlatestroundrobinreplicasforhostvolume
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: RetainLatestRoundRobinReplicasForHostStorageVolume ( %source_hoststoragevol_unc_name%, 7 ) Source Host Storage Volume UNC Name (%source_hoststoragevol_unc_name%). Select or enter the UNC name of the host disk device to be replicated in a round robin job. Number of Copies.
Page 311 Examples RetainLatestRoundRobinReplicasForHostVolume ( "\\HostA2\/home/cats_vg", 3 ) HP-UX RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/users/cats”, 3 ) Linux RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/var/cats”, 3 ) OpenVMS RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\CATS:”, 3 ) Solaris RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/usr/cats”, 3 ) Tru64 UNIX RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\/dom01#set1”, 3 ) Windows Drive RetainLatestRoundRobinReplicasForHostVolume ( “\\HostA2\E:\”, 3 ) Drive &...
Page 312 Comments • Associated validation commands. ValidateHostVolumeGroup. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 313: Setdrgroupautosuspend
Examples SetDiskGroupForSnapclone ( "ArrayA2", "DskGrp3" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a local replication license for the storage system. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs.
Page 314: Setdrgroupdestinationaccess
Comments. Enter your comment text. Examples SetDrGroupComments ( "\\ArrayA2\DrGroupPets","Replicates between SiteA and SiteB" ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems. • Command result value. None. For a complete list, see command result values.
Page 315: Setdrgroupfailsafeonlinkdownpowerup
Failsafe Mode. Select or enter the failsafe mode (failsafe on unavailable member). Choices are enabled and disabled. Examples SetDrGroupFailsafe ( "\\ArrayA2\DrGrpPets", ENABLED ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires remote replication licenses on the source and destination storage systems.
Page 316: Setdrgroupmaxlogsize
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetDrGroupHome ( %drgroup_unc_name%, FALSE ) UNC DR Group Name (%drgroup_unc_name%). Select or enter the UNC name of the DR group to be changed. Is Home. Select or enter the home ﬂag. Choices are true and false. Examples SetDrGroupHome ( "\\ArrayA2\DrGrpPets", TRUE ) Comments...
Page 317: Setdrgroupsuspend
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetDrGroupMaxLogSize ( %drgroup_unc_name%, 0 ) UNC Disk Group Name ( %drgroup_unc_name%). Select or enter the UNC name of the DR group whose maximum log disk size is to be set. Max Size (MB).
Page 318: Sethostdiskdevicewritecachemode
When the job is run, remote replication is suspended or resumed as speciﬁed. If remote replication is already as speciﬁed, no change in operation occurs. State found when the Action speciﬁed Resulting action job is run Resume Resumed No change in remote replication Resume Suspended Remote replication is resumed (started)
Page 319: Sethostvolumegroupwritecachemode
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetHostDiskDeviceWriteCacheMode ( %hoststorvol_unc_name%, WRITE_CACHE_ENABLED, NOWAIT ) UNC Host Disk Device Name (%hoststorvol_unc_name%). Select or enter the name of the host disk device whose write cache mode is to be set. Write Cache Mode.
Page 320: Sethostvolumewritecachemode
Action speciﬁed Mode found when the job is run Resulting action No change in write cache Disable Disabled operation Write caching is stopped and the Disable Enabled cache memory is written to disk (ﬂushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...
Page 321 Action speciﬁed Mode found when the job is run Resulting action No change in write cache Disable Disabled operation Write caching is stopped and the Disable Enabled cache memory is written to disk (ﬂushed) Enable Disabled Write caching is started No change in write cache Enable Enabled...
Page 322: Sethostvolumeswritecachemode
SetHostVolumesWriteCacheMode Enables or disables (stops and ﬂushes) the write cache of the storage volumes (virtual disks) that underlie host volumes. When the job is run, the virtual disk write cache mode is enabled or disabled as speciﬁed. If the write cache mode is already as speciﬁed, no change in operation occurs.
Page 323: Setmountpointspreﬁxinrepository
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetListVariable ( %value% ) Value. Enter or select a values to store in a variable assignment. Examples $disklist = SetListVariable ( ("\\Array2\Cats", "\\Array2\Dogs", "\\Array3\Cars") ) Comments •...
Page 324 Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. The format of mount point preﬁxes is OS-dependent. •...
Page 325: Setoraclemodeusingrepository
SetOracleModeUsingRepository Speciﬁes the Oracle resources mode. The resources are identiﬁed by reference to the repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SetOracleModeUsingRepository ( %oraclerepository_unc_name%, %mode% ) UNC Oracle Repository Name(%oraclerepository_unc_name% ). Select or enter the UNC name of the repository.
Page 326: Setstoragevolumewritecachemode
Comments • Associated validation commands. ValidateStorageVolume. • Agent and license prerequisites. None. • Command result value. New name for the storage volume. For a complete list, see command result values. • OS speciﬁcs. None. • resource names and UNC formats. SetStorageVolumeWriteCacheMode Speciﬁes the write cache mode for a storage volume (virtual disk).
Page 327: Setvariable
Examples SetStorageVolumesWriteCacheMode ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs"), WRITE_CACHE_ENABLED, NOWAIT ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • resource names and UNC formats.
Page 328: Snapclonediskdevice
Write Cache Mode. Select the write cache mode for the storage volume. Choices are write_cache_enabled, and write_cache_disabled. Examples SetWriteCacheModesUsingRepository ( "\\HostA2\Catalog 20051214.021405", REPLICATED, WRITE_CACHE_ENABLED ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. •...
Page 329: Snapclonehostdiskdevicetocontainerinmanagedset
SnapcloneDiskDevice ( "\\HostA2\/home/cats", "\\ArrayA2\DskGrp3", 12, READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/users/cats", "\\ArrayA2\DskGrp3", 12, HP-UX READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/var/cats", "\\ArrayA2\DskGrp3", 12, Linux READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\CATS", "\\ArrayA2\DskGrp3", 12, READ_WRITE, OpenVMS "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/usr/cats", "\\ArrayA2\DskGrp3", 12, SAME, Solaris READ_WRITE, "Cats_copy", WAIT ) SnapcloneDiskDevice ( "\\HostA2\/dev/disk/dskdsk100c", "\\ArrayA2\DskGrp3",...
Page 330: Snapclonehostvolume
Examples SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", NOWAIT ) SnapcloneHostDiskDeviceToContainerInManagedSet ( “\HostA2\Disk3”, "hvol_cats_set", Windows...
Page 331: Snapclonehostvolumegroup
SnapcloneHostVolume ( "\\HostA2\/home/cats", SAME, WAIT ) HP-UX SnapcloneHostVolume ( "\\HostA2\/users/cats", SAME, WAIT ) OpenVMS SnapcloneHostVolume ( "\\HostA2\CATS", SAME, WAIT ) Solaris SnapcloneHostVolume ( "\\HostA2\/usr/cats", SAME, WAIT ) Tru64 UNIX SnapcloneHostVolume ( "\\HostA2\/dev/disk/dsk100c", SAME, WAIT ) Windows Drive SnapcloneHostVolume ( "\\HostA2\E:\", SAME, WAIT ) Drive &...
Page 332: Snapclonehostvolumegrouptocontainersinmanagedset
SnapcloneHostVolumeGroup ( "\\HostA2\/home/cats_vg", SAME, WAIT ) HP-UX SnapcloneHostVolumeGroup ( "\\HostA2\/users/cats_vg", SAME, WAIT ) Linux SnapcloneHostVolumeGroup ( "\\HostA2\/var/cats_vg", SAME, WAIT ) OpenVMS Not applicable Solaris SnapcloneHostVolumeGroup ( "\\HostA2\/usr/cats_vg", SAME, WAIT ) Tru64 UNIX SnapcloneHostVolumeGroup ( "\\HostA2\dom01", SAME, WAIT ) Windows Not applicable Comments •...
Page 333: Snapclonehostvolumetocontainers
Examples SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", NOWAIT ) OpenVMS Not applicable SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", NOWAIT ) SnapcloneHostVolumeGroupToContainersInManagedSet ( "\\HostA2\dom01", Tru64 UNIX "hvol_cats_set", NOWAIT ) Windows Not applicable Comments •...
Page 334: Snapclonehostvolumetocontainersinmanagedset
SnapcloneHostVolumeToContainers ( "\\HostA2\/home/cats", ("\\ArrayA2\CatsCon- tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/users/cats", ("\\ArrayA2\CatsCon- HP-UX tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/var/cats", ("\\ArrayA2\CatsCon- Linux tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\CATS", ("\\ArrayA2\CatsContainer", OpenVMS WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/usr/cats", ("\\ArrayA2\CatsCon- Solaris tainer", WAIT ) SnapcloneHostVolumeToContainers ( "\\HostA2\/dev/disk/dsk100c", Tru64 UNIX ("\\ArrayA2\CatsContainer", WAIT ) Windows...
Page 335: Snapcloneoracletocontainersusingrepository
Examples Host volume mount points or device names can be used. SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) SnapcloneHostVolumeToContainersInManagedSet ( "\\HostA2\/dev/disk/dsk100c",...
Page 336: Snapcloneoracleusingrepository
Managed Set Name (%managedset_of_containers%). Select or enter the name of the managed set of containers (virtual disks) to be used for the preallocated snapclones. Tablespaces or Archived Logs. Select the resources to replicate. Choices are: Value Remarks Replicate tablespaces and archived redo logs in the repository oracle_archive_log_ﬁle Replicate archived redo log ﬁles in the repository oracle_tablespace...
Page 337: Snapclonestoragevolume
Wait Flag. Select wait or nowait. See jobs wait/nowait argument. Examples SnapcloneOracleUsingRepository ( "\\HostA2\Catalog 20051214.021405", SAME, WAIT ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. List of snapclone storage volume names (UNC). For a complete list, command result values.
Page 338: Snapclonestoragevolumetocontainer
SnapcloneStorageVolumeToContainer Creates a preallocated snapclone (point-in-time copy, using a container) of a storage volume. Syntax and arguments SnapcloneStorageVolumeToContainer ( %storvol_unc_name%, %container_unc_name%, NOWAIT ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to copy. UNC Container Name (%container_unc_name%).
Page 339: Snapshotdiskdevice
Comments • Associated validation commands. ValidateSnapcloneStorageVolume • Agent and license prerequisites. Requires a local replication license for the storage systems on which the storage volumes are located. • Command result value. List of snapclone storage volume names (UNC). For a complete list, command result values.
Page 340: Snapshothostdiskdevicetocontainerinmanagedset
SnapshotDiskDevice ( "\\HostA2\/home/cats", DEMAND_ALLOCATED, SAME, "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/users/cats", DEMAND_ALLOCATED, SAME, HP-UX "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/var/cats", DEMAND_ALLOCATED, SAME, Linux "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\CATS:", DEMAND_ALLOCATED, SAME, "Cats_copy", OpenVMS WAIT ) SnapshotDiskDevice ( "\\HostA2\/usr/cats", DEMAND_ALLOCATED, SAME, Solaris "Cats_copy", WAIT ) SnapshotDiskDevice ( "\\HostA2\/dev/disk/dsk100c", DEMAND_ALLOCATED, SAME,...
Page 341: Snapshothostvolume
Examples SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/hd1”, "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c2t0d2”, HP-UX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/sda3”, Linux "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\$1$DGA2:”, OpenVMS "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/dsk/c0t5d0s6”, Solaris "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostDiskDeviceToContainerInManagedSet ( “\\HostA2\/dev/disk/dsk100c”, Tru64 UNIX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT )
Page 342: Snapshothostvolumegroup
SnapshotHostVolume ( "\\HostA2\/home/Cats", DEMAND_ALLOCATED, SAME, "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\/users/Cats", DEMAND_ALLOCATED, SAME, HP-UX "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\/var/Cats", DEMAND_ALLOCATED, SAME, Linux "Cats_copy", WAIT ) SnapshotHostVolume ( "\\HostA2\CATS", DEMAND_ALLOCATED, SAME, "Cats_copy", OpenVMS WAIT ) SnapshotHostVolume ( "\\HostA2\/usr/Cats", DEMAND_ALLOCATED, SAME, Solaris "Cats_copy", WAIT) Tru64 UNIX...
Page 343: Snapshothostvolumegrouptocontainersinmanagedset
Examples These examples show host volume mount points. Device names can also be used. SnapshotHostVolumeGroup ( "\\HostA2\/home/cats_vg", DEMAND_ALLOCATED, SAME, WAIT ) SnapshotHostVolumeGroup ( "\\HostA2\/users/cats_vg", DEMAND_ALLOCATED, HP-UX SAME, WAIT ) SnapshotHostVolumeGroup ( "\\HostA2\/var/cats_vg", DEMAND_ALLOCATED, SAME, Linux WAIT ) OpenVMS Not applicable SnapshotHostVolumeGroup ( "\\HostA2\/usr/cats_vg", DEMAND_ALLOCATED, SAME, Solaris WAIT )
Page 344: Snapshothostvolumetocontainers
Examples SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/home/cats_vg", "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/users/cats_vg", HP-UX "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/var/cats_vg", Linux "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) OpenVMS Not applicable SnapshotHostVolumeGroupToContainersInManagedSet ( "\\HostA2\/usr/cats_vg", Solaris "hvol_cats_set", FULLY_ALLOCATED, NOWAIT ) SnapshotHostVolumeGroupToContainersInManagedSet ( Tru64 UNIX "\\HostA2\dom01","hvol_cats_set", FULLY_ALLOCATED, NOWAIT Windows Not applicable Comments...
Page 345: Snapshothostvolumetocontainersinmanagedset
SnapshotHostVolumeToContainers ( "\\HostA2\/home/Cats", "\\Array2\Cats", DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/users/Cats", "\\Array2\Cats", HP-UX DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/var/Cats", "\\Array2\Cats", Linux DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\CATS", "\\Array2\Cats", OpenVMS DEMAND_ALLOCATED, WAIT ) SnapshotHostVolumeToContainers ( "\\HostA2\/usr/Cats", "\\Array2\Cats", Solaris DEMAND_ALLOCATED, WAIT SnapshotHostVolumeToContainers ( "\\HostA2\dom01#fset1", "\\Array2\Cats", Tru64 UNIX DEMAND_ALLOCATED, WAIT ) Windows...
Page 346: Snapshotoracletocontainersusingrepository
Examples Host volume mount points or device names can be used. SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/home/cats", "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/users/cats", HP-UX "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/var/cats", Linux "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\CATS", "hvol_cats_set", OpenVMS WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\/usr/cats", Solaris "hvol_cats_set", WAIT ) SnapshotHostVolumeToContainersInManagedSet ( "\\HostA2\dom01#fset1",...
Page 347: Snapshotoracleusingrepository
Tablespaces or Archived Logs. Select the resources to replicate. Choices are: Value Remarks Replicate tablespaces and archived redo logs in the repository oracle_archive_log_ﬁle Replicate archived redo logs in the repository oracle_tablespace Replicate tablespaces in the repository Wait Flag. Select wait or nowait. See jobs wait/nowait argument.
Page 348: Snapshotstoragevolume
Examples SnapshotOracleUsingRepository ( "\\HostA2\Catalog 20051214.021405", FULLY_ALLOCATED, SAME, NOWAIT ) Comments • Associated validation commands. None • Agent and license prerequisites. Requires a host agent. Requires an Oracle-integration license. • Command result value. List of snapshot storage volume names (UNC). For a complete list, see command result values.
Page 349: Snapshotstoragevolumestocontainers
Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: SnapshotStorageVolumeToContainer ( %storvol_unc_name%, %container_unc_name%, DEMAND_ALLOCATED, NOWAIT ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the UNC name of the storage volume to copy. UNC Container Name (%container_unc_name%).
Page 350: Switchoraclearchivelogfilesusingrepository
Examples SnapshotStorageVolumesToContainers ( ("\\ArrayA2\Cats", "\\ArrayA2\Dogs"), ("\\ArrayA2\CatsCon- tainer", "\\ArrayA2\DogsContainer"), FULLY_ALLOCATED, NOWAIT ) SnapshotStorageVolumesToContainers ($my_svol_list, $cont_list, FULLY_ALLOCATED, NOWAIT ) Comments • Associated validation commands. ValidateSnapshotStorageVolume • Agent and license prerequisites. Requires a local replication license for the storage systems on which the storage volumes are located. •...
Page 351: Unmountentirevolumegroup
cancelled failed stopped success executing paused Examples TestJobState ( "daily_backup-1", EXECUTING ) Comments • Associated validation commands. None. • Agent and license prerequisitesNone. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None. UnmountEntireVolumeGroup Instructs an enabled host to unmount all of the logical volumes in a host volume group.
Page 352: Unmounthostvolume
UnmountHostVolume Instructs an enabled host to unmount a host volume. The host OS removes host volume mount point, but the underlying storage volume remains presented to the host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: UnmountHostVolume ( %mount_point_unc% ) UNC Mount Point Name (%mount_point_unc%).
Page 353: Unmounthostvolumesusingrepository
Examples UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) HP-UX UnmountHostVolumes ( ( "\\HostA2\/users", "\\HostA5\/users/cats" ) ) Linux UnmountHostVolumes ( ( "\\HostA2\/var", "\\HostA5\/var/cats" ) ) OpenVMS UnmountHostVolumes ( ( "\\HostA2\CATS", "\\HostA5\DOGS" ) ) Solaris UnmountHostVolumes ( ( "\\HostA2\/usr", "\\HostA5"\/usr/cats" ) ) Tru64 UNIX UnmountHostVolumes ( %mount_point_list% ) Windows...
Page 354: Unpresentstoragevolume
UnpresentStorageVolume Ends the presentation of a storage volume to a host. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: UnpresentStorageVolume ( %storvol_unc_name%, %host_name% ) UNC Storage Volume Name (%storvol_unc_name%). Select or enter the name of the storage volume whose presentation is to end.
Page 355: Validatehost
ValidateHost Checks if an enabled host is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateHost ( %host_name% ) Host Name (%host_name%).
Page 356: Validatehostvolumedoesnotexist
ValidateHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateHostVolume ( "\\HostA2\CATS" ) Solaris ValidateHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 357: Validatehostvolumegroup
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats. ValidateHostVolumeGroup Checks if a host volume group is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops.
Page 358: Validateoracledatabase
UNC Host Volume Name (%hostvol_unc_name%). Select or enter the UNC name of the host volume to validate. Examples These examples show host volume mount points. Device names can also be used. ValidateHostVolumeMirrorclones ( "\\HostA2\/home/cats" ) HP-UX ValidateHostVolumeMirrorclones ( "\\HostA2\/users/cats" ) Linux ValidateHostVolumeMirrorclones ( "\\HostA2\/var/cats"...
Page 359: Validateoracletablespaces
ValidateOracleTablespaces Checks if an Oracle tablespace is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateOracleTablespaces ( %oracletablespace_unc_names% ) UNC Oracle Tablespace Names ( %oracletablespace_unc_names% ).
Page 360: Validatesnapclonehostvolumegroup
ValidateSnapcloneHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateSnapcloneHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateSnapcloneHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateSnapcloneHostVolume ( "\\HostA2\CATS" ) Solaris ValidateSnapcloneHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateSnapcloneHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateSnapcloneHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateSnapcloneHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 361: Validatesnapclonestoragevolume
• Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. •...
Page 362: Validatesnapshothostvolumegroup
ValidateSnapshotHostVolume ( "\\HostA2\/home/cats" ) HP-UX ValidateSnapshotHostVolume ( "\\HostA2\/users/cats" ) Linux ValidateSnapshotHostVolume ( "\\HostA2\/var/cats" ) OpenVMS ValidateSnapshotHostVolume ( "\\HostA2\CATS" ) Solaris ValidateSnapshotHostVolume ( "\\HostA2\/usr/cats" ) Tru64 UNIX ValidateSnapshotHostVolume ( "\\HostA2\dom01#fset1" ) Windows Drive ValidateSnapshotHostVolume ( "\\HostA2\E:\" ) Drive & folders ValidateSnapshotHostVolume ( "\\HostA2\E:\pets\cats" ) Comments •...
Page 363: Validatesnapshotstoragevolume
• OS speciﬁcs. Yes. See examples above. OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • resource names and UNC formats. ValidateSnapshotStorageVolume Checks if a storage volume is an available resource and that it can be replicated using the snapshot method.
Page 364: Validatestoragevolume
• OS speciﬁcs. None • resource names and UNC formats. ValidateStorageVolume Checks if a storage volume is an available resource. When the job is run, the validation command checks for availability of the resource. If the resource is not available, the job stops. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: ValidateStorageVolume ( %storvol_unc_name% )
Page 365: Waitdrgroupnormalization
• resource names and UNC formats. Wait Halts a job for a period of time. When the time has elapsed, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: Wait ( "0:0:10"...
Page 366: Waitdrgroupsynchronizationtransition
WaitDrGroupSynchronizationTransition Halts a job until the I/O mode of a DR group changes. When the I/O mode changes, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitDrGroupSynchronizationTransition ( %drgroup_unc_name% ) UNC DR Group Name (%drgroup_unc_name%).
Page 367: Waitforhostvolumegroupwritecacheflush
Comments • Associated validation commands. ValidateHost. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 368: Waitforhostvolumeswritecacheflush
Examples Host volume mount points or device names can be used. WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/home/cats" ) HP-UX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/users/cats" ) Linux WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/var/cats" ) OpenVMS WaitForHostVolumeWriteCacheFlush ( "\\HostA2\CATS" ) Solaris WaitForHostVolumeWriteCacheFlush ( "\\HostA2\/usr/cats" ) Tru64 UNIX WaitForHostVolumeWriteCacheFlush ( "\\HostA2\dom01#fset1" ) Windows Drive WaitForHostVolumeWriteCacheFlush ( "\\HostA2\E:\"...
Page 369: Waitforjob
WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) HP-UX WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/users", "\\HostA5\/users/cats") ) Linux WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/var", "\\HostA5\/var/cats") ) OpenVMS WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\[users]", "\\HostA5\CATS") ) Solaris WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\/usr", "\\HostA5"\/usr/cats") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\dom01#fset1", Tru64 UNIX "\\HostA5\dom02#fset1") ) Windows Drive WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\E:\", "HostA5\K:\") ) WaitForHostVolumesWriteCacheFlush ( ("\\HostA2\E:\pets\cats", Drive &...
Page 370: Waitforstoragevolumediscovery
WaitForStorageVolumeDiscovery Halts a job until a speciﬁc storage volume (virtual disk) is found in the replication manager database. When found, the next step in the job is executed. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForStorageVolumeDiscovery ( %storvol_unc_name% ) UNC Storage Volume Name ( %storvol_unc_name%).
Page 371: Waitforstoragevolumewritecacheflush
WaitForStorageVolumeWriteCacheFlush Halts a job until the write cache of the storage volume has been ﬂushed. When the write cache has been ﬂushed, the job proceeds to the next step. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForStorageVolumeWriteCacheFlush ( %storvol_unc_name% ) UNC Storage Volume Name (%storvol_unc_name%).
Page 372: Waitforwritecacheflushusingrepository
WaitForWriteCacheFlushUsingRepository Halts a job until the write cache of the storage volumes that underlie an Oracle database has been ﬂushed. The appropriate storage volumes are automatically selected by reference to the enabled host and database speciﬁed by the repository. Syntax and arguments When initially inserted into a job, the command syntax and default arguments are: WaitForWriteCacheFlushUsingRepository ( %oraclerepository_unc_name%, %original_replicated% ) UNC Oracle Repository Name (%oraclerepository_unc_name% ).
Page 373: Waithostvolumenormalization
Comments • Associated validation commands. ValidateHost. • Agent and license prerequisites. Requires a host agent. • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. Yes. See examples above. • resource names and UNC formats.
Page 374: Waitstoragevolumesnormalization
Examples WaitStorageVolumeNormalization ( "\\Region-1\Sales" ) Comments • Associated validation commands. ValidateStorageVolume • Agent and license prerequisites. None • Command result value. None. For a complete list, see command result values. • OS speciﬁcs. None • The storage volume is checked at regular intervals. When the volume is normal or unshared, the job proceeds to the next step.
Page 375: Waitvolumegroupnormalization
Examples WaitUntil ( "15:30:00" ) – Halts the job until 15:30 hours (3:30 PM). WaitUntil ( "2007/10/14 15:30:00" ) – Halts the job until 14 October 2007, 15:30 hours (3:30 PM). Comments • Associated validation commands. None • Agent and license prerequisites. None •...
Page 376 OpenVMS. OpenVMS does not support volume groups. This command is not applicable to OpenVMS volume sets. Windows. Windows does not support volume groups. • resource names and UNC formats. Jobs...
Page 377: Managed Sets
7 Managed sets Working with managed sets About managed sets The Managed Sets content pane displays resource sets that you can interact with through the replication manager. See GUI window content pane. Views • List of all managed sets. See managed sets list view.
Page 378: Managed Set Properties Summary
Create managed sets GUI action Job command or template CLUI command Managed Sets > New Add Managed_Set Delete managed sets GUI action Job command or template CLUI command Managed Sets > Delete Delete Managed_Set Other managed set tasks GUI action Job command or template CLUI command Managed Sets >...
Page 379: Adding Resources To A Managed Set
List view Members Adding resources to a managed set Add a resource to a managed set. Considerations • You can use the GUI or CLUI. See managed set actions cross reference. • A managed set can include only resources of the same type. Procedure Resources are added from the resource’s action menu.
Page 380: Deleting Managed Sets
In the navigation pane, select Managed Sets. On the List tab, select Actions > New. The New Managed Set window opens. Select the type of managed set you want to create in the drop-down list. Enter a name for the managed set. Click OK.
Page 381: Viewing Managed Sets
Procedure This procedure uses the GUI. In the navigation pane, select Managed Sets. On the List tab, select the managed set. Select Actions > Remove Member. The Remove Members window opens. Select the members to remove. Click OK. The members are removed Viewing managed sets Display the managed set list and member views.
Page 382: Managed Sets Of Dr Groups
Set type Guidelines DR groups managed sets of DR groups. Enabled hosts Host volumes Storage systems Virtual disks managed sets of virtual disks (and containers) (and containers) Membership • A speciﬁc resource can be a member of more than one managed set. The order in which members are added to, or appear in, a managed set does not affect the order •...
Page 383 Guidelines for managed sets of containers • When using a managed set of containers for preallocated snapclones, the number of containers and the size of each container must correspond to the source virtual disks being replicated. about containers. HP StorageWorks Replication Solutions Manager 4.0.1...
Page 384 Managed sets...
Page 385: Oracle
8 Oracle Working with Oracle resources About Oracle resources The Oracle content pane displays Oracle resources that you can interact with through the replication manager. See GUI window content pane. Views • Tabular list views - See: Oracle list view Databases, Tablespaces, Data Files, Archive logs, Control ﬁles, and Repositories.
Page 386: Replicating Oracle Resources Using Jobs
Follow the instructions in the window. An implicit job is created and run to perform the replication. See implicit jobs. GUI actions for replicating Oracle resources GUI action Remarks Replicate Database (Preallocated Snapclone Procedure Replicate Database (Snapclone) Procedure Replicate Database (Snapshot) Procedure Replicate Tablespaces (Preallocated Snapclone) Procedure...
Page 387: Replicating Oracle Databases Using Preallocated Snapclones
Job templates for replicating Oracle resources Job template Remarks Replicate using snapclones or snapshots. Template Replicate tablespace(s) Replicate tablespace(s) via pre-allocated replication, Replicate using preallocated snapclones. Template mount to a host Replicate tablespace(s), mount to a host Replicate using snapclones or snapshots. Template Replicating Oracle databases using preallocated snapclones Replicate (back up) the virtual disks that comprise an Oracle database (tablespaces and archived redo...
Page 388: Replicating Oracle Tablespaces Using Preallocated Snapclones
Considerations • You can use the GUI or jobs to create snapshots of an Oracle database. See Oracle actions cross reference. • You can choose to replicate the associated archived redo logs, or not. • Guidelines apply. See Oracle resource guidelines snapshot guidelines.
Page 389: Replicating Oracle Tablespaces Using Snapshots
Replicating Oracle tablespaces using snapshots Replicate (back up) the virtual disks that comprise an Oracle tablespace (and its associated archived redo logs) by using snapshots. See snapshots. Considerations • You can use the GUI or jobs to create snapshots of an Oracle tablespace. See Oracle actions cross reference.
Page 390: Oracle Actions Summary
Considerations • Oracle repository. You can only restore Oracle resources if a repository exists that contains point-in-time copies of the resources. The repository and resources must have been created using the replication manager. • Tablespaces. You can choose to restore all tablespaces in the repository, or not. •...
Page 391: Oracle Actions Cross Reference
Control ﬁles • View Properties. Procedure. Repositories • View Properties. Procedure. • Restore. Procedure using GUI, procedure using jobs. • Delete. Procedure. Oracle actions cross reference You can work with Oracle resources using GUI actions and jobs. This table provides a cross reference for performing typical tasks.
Page 392: Oracle Properties Summary
Other Oracle tasks GUI action Job command or template Oracle > Databases > Set Credentials SetOracleDatabaseModeUsingRepository SetWriteCacheModesUsingRepository WaitForWriteCacheFlushUsingRepository Replicate Oracle resources GUI action Job command or template Oracle > Databases > Replicate Database (Preallocated Snapclone) Replicate Oracle tablespace(s). Template Replicate Oracle tablespace(s) via pre-allocated Oracle >...
Page 393: Oracle Views
• Control ﬁles. See Oracle control ﬁles properties window. • Repositories. See Oracle repositories properties window. See also viewing Oracle properties. Oracle views See the following examples: List view, Database/Tablespace/Data File tree view tree view, and Host/Database/Children tree view. List view The list view shows all Oracle resource types: databases, tablespaces, data ﬁles, archive logs, control ﬁles, and repositories.
Page 394: Checking Oracle-Integration Licenses
Host/Database/Children tree view Checking Oracle-integration licenses. Check the status of Oracle integration-licenses for a speciﬁc storage array. In the navigation pane, select Storage Systems. The Storage Systems content pane opens. Select a storage system. Select Actions > View Properties. The Storage Properties window opens. Select Licensing.
Page 395: Setting Security Credentials For Oracle Databases
Considerations • You can use the GUI or jobs to delete a repository. See Oracle actions cross reference. • Deleting a repository does not delete the resources that are members of the repository. Procedure This procedure uses the GUI. In the navigation pane select Oracle. On the Repositories tab, select the Oracle repository to delete.
Page 396: Oracle Resource Concepts
Considerations • You can only use the GUI to view Oracle resource properties. Procedure In the navigation pane select Oracle. On the appropriate tab, select the Oracle resource whose properties you want to view. Select Actions > View Properties. An Oracle properties window opens. Oracle resource concepts Oracle replication (backup) and restore (recovery) overview The replication manager’s optional Oracle-integration features simplify and automate replication (backup)
Page 397: Oracle-Integration Licenses Overview
Oracle-integration licenses overview To use the replication manager’s Oracle-integration features with a given array, the replication manager veriﬁes that appropriate HP Oracle-integration licenses exist for that array. • For information on acquiring and installing Oracle-integration licenses, see the HP StorageWorks Replication Solutions Manager administrator guide.
Page 398: Oracle Archived Redo Logs
Oracle archived redo logs The replication manager automatically discovers archived redo logs that are associated with Oracle tablespaces. These resources are displayed in the content pane and can be backed up and recovered using GUI actions or jobs. A complete database recovery requires the most recent backup of the dataﬁles, plus backups of the archived redo logs that were generated since the backing up the dataﬁles.
Page 399: License Displays
License display Remarks License summary. A license status summary appears • The status includes replication licenses and on the right side of the status bar at the bottom of the Oracle-integration licenses. replication manager window. • Status messages indicate if all discovered licenses are valid or if there is an issue.
Page 400: Oracle Resources Mode
• Duplicate online redo logs. Oracle maintains duplicate online redo logs at two or more locations. HP recommends that these locations be on different virtual disks. Oracle resources mode The replication manager can interact with Oracle applications to perform the following: •...
Page 401: Oracle Tablespaces
Password change considerations Administrators should carefully plan and coordinate Oracle database security credential changes with replication manager operations. For example, if the security policy in your environment is to reset passwords every six months, consider that such changes can result in the replication manager server not interacting with an Oracle database.
Page 402 Oracle...
Page 403: Storage Systems
9 Storage systems Working with storage systems About storage system resources The Storage Systems content pane displays HP StorageWorks storage arrays that you can interact with through the replication manager. See GUI window content pane. Views • Tabular list view. See storage systems list view.
Page 404: Storage System Properties Summary
Validate storage systems GUI action Job template or command CLUI command ValidateStorageSystem View storage systems GUI action Job template or command CLUI command Storage Systems > View Properties Show System Storage system properties summary For help on properties, see the following tabs in the storage systems properties window. •...
Page 405: Adding Storage Systems To A Managed Set
DR group Source/Destination tree view Adding storage systems to a managed set Add storage systems to a managed set. Considerations • You can use the GUI or CLUI. See storage systems actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Storage Systems.
Page 406: Listing Individual Resource Events
Procedure In the navigation pane, select DR Groups, Storage Systems or Virtual Disks. On a List or Tree tab select any storage resource. Select Actions > Launch the Device Manager. A new browser window opens. Respond to the security alert message and then log on to HP Command View EVA. Listing individual resource events Display the events for an individual resource.
Page 407: Viewing Storage System Properties
Viewing storage system properties View the properties of a speciﬁc storage system. See storage systems properties summary. Considerations • You can use the GUI or CLUI. See storage systems actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Storage Systems. On the List tab, select the storage system to view.
Page 408: Controller Software Features
IMPORTANT: HP recommends that you include validation commands in jobs and perform validation tests to prevent or minimize the effect of license-related issues at run time. • CLUI commands. CLUI commands that run jobs or create implicit jobs behave like job commands. An event in the job log indicates that the command did not execute due to a licensing issue.
Page 409: Controller Software Features - Remote Replication
EVA controller software supported Local replication feature by RSM 4.0.1 6.1x, 3.028 4.0x 5.1x 6.0x 6.2x, 9.0x Mirrorclones Create and manage mirrorclones Create mirrorclones of virtual disks in DR groups Snapclones Create containers (for snapclones) Create snapclones in preallocated containers Instant restore of virtual disks Set disk group (for snapclones) Set Vraid in copy (cross Vraid)
Page 410 EVA controller software supported Remote replication feature by RSM 4.0.1 6.1x, 3.028 4.0x 5.1x 6.0x 6.2x, 9.0x DR groups Add or remove virtual disks from a DR group when in enhanced asynchronous write mode. 9.0.3 DR groups per storage array Virtual disks per DR group Virtual disk member without host presentation Virtual disk member with mirrorclone...
Page 411 • When using the replication manager CLUI, you can enter the names of any resource. If the command is invalid for the resource, the command will fail when it is executed. Disk groups Disk group is the term for a named pool of storage on a storage system in which virtual disks can be created.
Page 412 Storage systems...
Page 413: 10 Virtual Disks
10 Virtual disks Working with virtual disks About virtual disk resources The Virtual Disks content pane displays the virtual disks (storage volumes) that you can interact with through the replication manager. See GUI window content pane. Views • Tabular list view. See virtual disks list view.
Page 414: Virtual Disk Actions Cross Reference
• List Events. Display a list of events for the resource. Procedure. • New Virtual Disk. Create a new virtual disk. Procedure. • Instant Restore. Restore a virtual disk from one of its replicas. Procedure. • Create Mirrorclone. Create a synchronized mirrorclone of a virtual disk. Procedure. •...
Page 415: Virtual Disk Properties Summary
Other virtual disk tasks GUI action Job command CLUI command Virtual Disks > Low-Level Refresh Set Vdisk Set Container Show Container Show Snapclone Show Snapshot Show Vdisk ConvertStorageVolumeIntoContainer Set Vdisk WaitForStorageVolumeWriteCacheFlush Replicate virtual disks GUI action Job command CLUI command Virtual Disks >...
Page 416: Virtual Disk Views
• Managed sets in which the virtual disk is a member. See Membership tab. See also viewing virtual disk properties. Virtual disk views See the following examples: List view, System/Virtual Disk tree view List view System/Virtual Disk tree view Adding virtual disks to a managed set Add virtual disks to a managed set.
Page 417: Creating Containers For Virtual Disks
Creating containers for virtual disks Create a container on a storage system by specifying virtual disk properties. See virtual disk containers. To create containers by specifying a host volume or host volume group, see creating a managed set of containers for host volumes creating a managed set of containers for host volume groups respectively.
Page 418: Creating Mirrorclones
Select Actions > New DR Group. The Replicate Wizard opens. Follow the instructions in the wizard. Creating mirrorclones Use a container to create a synchronized mirrorclone copy of a virtual disk. See virtual disks synchronized mirrorclones and containers. Considerations • You can use the GUI, or jobs to create a synchronized mirrorclone.
Page 419: Creating Snapshots (Preallocated)
Considerations • You can use the GUI, jobs, or the CLUI to create snapclones. See virtual disks actions cross reference. • Guidelines apply. See virtual disks snapclone guidelines. • Dynamic capacity management guidelines apply. See Using DC-Management with replication for more information. Procedure This procedure uses the GUI.
Page 420: Creating Virtual Disks
• Dynamic capacity management guidelines apply. See Using DC-Management with replication for more information. Procedure This procedure uses the GUI. In the navigation pane, select Virtual Disks. On the List tab, select the virtual disk to replicate using the snapshot method. Select Actions >...
Page 421: Detaching Mirrorclones
In the navigation pane, select Virtual Disks. On the List tab, select the source virtual disk to delete. Select Actions > Delete. A conﬁrmation window appears. Click OK to conﬁrm the action. Detaching mirrorclones Detach a fractured mirrorclone from its source virtual disk. The detached mirrorclone becomes an independent (original) virtual disk.
Page 422: Launching The Device Manager
Considerations • You can use the GUI, or jobs to fracture a mirrorclone. See virtual disks actions cross reference. • Guidelines apply. See virtual disks mirrorclone guidelines. • When using jobs, you must explicitly ﬂush the source virtual disk write cache before the fracture is started.
Page 423: Restoring Virtual Disks (Instant Restore)
Restoring virtual disks (Instant Restore) Restore a virtual disk by replacing its data with data from one of its replicas. Considerations • You can use the GUI, jobs, or the CLUI. See virtual disks actions cross reference. IMPORTANT: HP recommends restoring by using GUI actions. •...
Page 424: Removing Virtual Disks From A Managed Set
• You can allow storage controller software to assign a LUN. See LUN automatic assignment. CAUTION: Presenting a virtual disk to more than one host at a time can cause I/O write conﬂicts on the disk and the possible loss of host application data. Procedure This procedure uses the GUI.
Page 425: Restoring Virtual Disks (Instant Restore)
CAUTION: If you discard a remote copy, the destination virtual disk and its data are deleted. Procedure This procedure uses the GUI. In the navigation pane, select Virtual Disks. On the List tab, select the source virtual disks you want to remove from a DR group pair. Select Actions >...
Page 426: Unpresenting Virtual Disks
Procedure The following procedure uses the GUI. In the navigation pane, select Virtual Disks. On the List tab, select the fractured mirrorclone to resynchronize with its source. Alternately, you can select the mirrorclone’s source virtual disk. Select Actions > Resync Mirrorclone. The Resync Mirrorclone conﬁrmation window opens. Click OK.
Page 427: Viewing Virtual Disk Properties
Viewing virtual disk properties View the properties of a speciﬁc virtual disk. See virtual disks properties summary. Considerations • You can use the GUI or the CLUI. See virtual disks actions cross reference. Procedure This procedure uses the GUI. In the navigation pane, select Virtual Disks. On the List tab, select the virtual disk to view.
Page 428: Controller Software Features - Local Replication
Controller software features - local replication HP replication Solutions Manager supports the local replication features of the HP EVA controller software listed below. For support of newer versions, visit the HP Storage web site. See “Helpful web sites” on page 19. EVA controller software supported Local replication feature by RSM 4.0.1...
Page 429 EVA controller software supported Remote replication feature by RSM 4.0.1 6.1x, 3.028 4.0x 5.1x 6.0x 6.2x, 9.0x DR groups Add or remove virtual disks from a DR group when in enhanced asynchronous write mode. 9.0.3 DR groups per storage array Virtual disks per DR group Virtual disk member without host presentation Virtual disk member with mirrorclone...
Page 430: Cache Policies
• When using the replication manager CLUI, you can enter the names of any resource. If the command is invalid for the resource, the command will fail when it is executed. Cache policies Each virtual disk on a storage system has a read cache and a write cache. The following are key cache policies (settings): write cache,...
Page 431: Container Guidelines
• Cannot store data Implementation of container features is controller software dependent. See controller software features - local replication. Containers for preallocated replication Preallocated replication refers to a snapclone or snapshot that is created by copying data from a source virtual disk to a container and immediately converting the container into a virtual disk.
Page 432: Disk Groups
• In the process of normalizing or being deleted. See normalization. Disk groups Disk group is the term for a named pool of storage on a storage system in which virtual disks can be created. Seeonline and near-online disk group categories. IMPORTANT: disk group Unless noted otherwise, the term...
Page 433: Cross Vraid Guidelines
Near- Disk use Online online Disaster tolerance Disk-to-disk backup Disk-to-tape backup Frequent ﬁle access Infrequent ﬁle access Highest performance Virus attack recovery Disk group capacity and occupancy The capacity of a disk group is established when it is created using HP Command View EVA and is expressed in terms of redundancy level (Vraid).
Page 434: Instant Restore Overview (Virtual Disks)
Source Remote copy Snapclone copy Snapshot copy Vraid0, Vraid1, or Vraid0, Vraid1, or none >>> Vraid0 Vraid0 Vraid5 Vraid5 Vraid0, Vraid1, or Vraid0, Vraid1, or Vraid0, Vraid1, or >>> Vraid1 high Vraid5 Vraid5 Vraid5 Vraid0, Vraid1, or Vraid0, Vraid1, or medium >>>...
Page 435: Instant Restore From Snapclones
Scenario, restoring from "the most recent" Create a mirrorclone of the disk to be restored at some future date. Procedure. Leave the mirrorclone in a synchronized state with its source. The mirrorclone always contains the most recent data. When necessary to restore the disk, fracture its mirrorclone. Procedure When a restore is required, restore the disk from its mirrorclone.
Page 436: Normalization
Normalization Snapclone normalization (unsharing) Snapclone normalization is a local replication background process in which a storage system copies the data from the initial snapshot to an independent virtual disk. Snapclone normalization is also called unsharing. Some actions should not be performed during snapclone normalization. When creating jobs, use wait commands to ensure that normalization is completed.
Page 437: Presentation (To Host)
• No preference. Presentation of the virtual disk is completely controlled by the controller software. • Path A - Failover only. Controller A presents the virtual disk to hosts when both controllers are simultaneously started. • Path A - Failover/failback. Controller A presents the virtual disk to hosts, but if controller A fails, control of the virtual disk is transferred to controller B, then transferred back to controller A when it is available again.
Page 438: Redundancy Level (Vraid)
• Cannot be a snapshot or a mirrorclone. See virtual disks types. • Cannot have a mirrorclone. This restriction is controller software version dependent. See controller software features - remote replication. • Must be in a normal operational state. See resources operational states.
Page 439: Snapclone Faq
Method Flush implementation Write cache setting after replication The replication manager automatically sets the source disk to write-though mode and GUI action ensures the ﬂush is completed before starting the replication. When replication is completed, the controller software automatically sets the source disk You must include job commands to set the and preallocated copy (converted container) source disk to write-through mode and wait...
Page 440: Snapshot Faq
The snapshot property indicates whether a virtual disk can be locally replicated using the snapshot method. Values are: • Yes. The virtual disk complies with snapshot guidelines. Snapshot replication can be performed. • No. The virtual disk does not comply with snapshot guidelines. Snapshot replication cannot be performed.
Page 441: Snapshot Guidelines
• Can I create a snapshot of a snapclone? Yes. • Can I create an snapshot of a snapshot? Snapshot guidelines The following guidelines apply to snapshot virtual disks: • The array must have a local replication license. See replication licenses overview.
Page 442: Tru64 Unix Host Volumes
• Demand allocated. The space allocated for the snapshot can automatically change from an initial minimum amount, up to the full capacity of the original (active) virtual disk. • Fully allocated. The space allocated for the snapshot is initially set to, and remains ﬁxed at, the full capacity of the source (active) virtual disk.
Page 443: Virtual Disk Guidelines
Type Icon Remarks Empty disks (disk space) that are preallocated for later use. Container See containers. Dependent virtual disks that use mirrorclone technology. Mirrorclone synchronized mirrorclones fractured mirrorclones. Independent virtual disks, including snapclones. Original See snapclones. Dependent virtual disks that use snapshot technology. Snapshot See snapshots.
Page 444 Virtual disks...
Page 445: 1 Events
1 1 Events Working with events About events The events pane displays replication manager event messages. Views • Tabular list views are available for storage events and license events. See events pane. • Standard and correlated views are available. See viewing events.
Page 446: Refreshing Display Panes
View event records GUI action Job command CLUI command Show Job ( event Events > Details switch) DR groups > List events Storage Systems > List events Virtual Disks > List events Refreshing display panes Update the information that is displayed in the content and event panes. Considerations •...
Page 447: Viewing Events
Procedures Resizing columns Move the cursor over a column edge in the heading. When a selection arrow appears, click and drag the column edge as required. Moving columns Click the heading of the column to move. Hold and drag the column to the desired location. Sorting Click the heading of the column on which to sort the list.
Page 448: Viewing The Trace Log
Viewing event details When using the Standard view, the details window displays the full text message of the event. When using the Correlated view, the details window displays the full text message of the last recorded event, plus other events for the individual resource. On the events pane, select an event.
Page 449: Events Log
Events pane The events pane displays summary and detailed information for storage events and license events. See viewing events. Event details pane The top line of the event resource pane identiﬁes the type of event. Examples of event identiﬁcation formats are shown below. Resource name format Job name format Implicit job ID format...
Page 450: Event Log Views
Property Remarks Date/Time Date and time the event was recorded. Event Severity Severity of the event. See event and trace log severity. Message Details of the event. Replication manager resource type, job, or CLUI command that wrote Source the event record. For example, a storage system resource or a job. •...
Page 451: 12 Clui
12 CLUI Accessing the CLUI via GUI Start an interactive CLUI session via the GUI. Considerations • For a list of CLUI commands, see using CLUI help. • Some commands can several minutes or more to return a result. Procedure Do one of the following: •...
Page 452: Legacy Hp Evmcl Commands Cross Reference
Procedure On the CLUI window, click within the Command Response pane. Press Ctrl+A. All information within the pane is selected. Press Ctrl+C. The information is copied. Open or select another application. Press Ctrl+V to paste the command response information. Example To display and copy information about all host agents: Type show host_agents full and press Enter Click in the Command Response pane, select (highlight) the response then press Ctrl+C.
Page 453: Reusing Clui Commands
HP EVMCL 2.X command CLUI command Remarks evmcl <bc server> > abort <job name> Set Job <job instance> abort continue > continue <job name> Set Job <job instance> Default is wait [wait|nowait] pause > pause <job name> Set Job <job instance> >...
Page 454 Command ? 0 Success Usage: { a[dd] | c[apture] | del[ete] | exit | h[elp] | login | sel[ect] | set | sho[w] } To display a list of commands in a category, enter the category followed by a question mark. For example, to display a list of add commands, enter add ? and press Enter.
Page 455 Displaying full help on a speciﬁc command To view the full help on a speciﬁc command, enter help followed by the command and press Enter. The full help for the command appears. Command: help add ha 0 Success Usage: Name: ADD HOST_AGENT Synopsis: A[DD] HOST_A[GENT]|HA <Host Agent Name>...
Page 456 CLUI...
Page 457: 13 Glossary
13 Glossary Glossary array Short for storage array. See storage array. container A container is virtual disk space that is preallocated for later use as a snapclone or a snapshot. For details, see containers topic. controller software (VCS / XCS) Controller software is low-level software (ﬁrmware) used by array controllers to run a storage array.
Page 458 Logical unit number. For details, see LUN. management server A server whose principal function is to run HP StorageWorks applications, such as HP Command View EVA and HP Replication Solutions Manager. mount point A host’s ﬁle system path or directory name where a host volume (device) is accessed. For details, see mount points (drive letters) and device names.
Page 459: Index
Index DR groups audience, 17 about, 83 adding virtual disks to, 87 creating, 88 deleting, 88 DR group pair (source and destination), 97 cascaded remote replication, 99 editing properties, 89 CLUI, 27, 36, 451, 453 guidelines, 109 conﬁguring the replication manager, 35 home, 102 containers, 430, 431...
Page 460 feedback documentation, 19 jobs product, 19 arguments, 185 ﬁlter command result values, 187 ﬁltering displayed resources, 58 commands, 27 ﬁlters for topology views, 80 implicit, 193 full copy imported, 193 about, 102 instances, 185 forcing, 91 templates, 200 transactions, 205 validation, 206 glossary, 457 about, 29...
Page 461 running CLUI via the GUI, 451 Oracle host commands, 1 16 archived redo logs, 398 backup and recovery, 396 control ﬁles, 398 databases, 398 security, conﬁguring, 35 licensing, 67 snapclones mount points for restores, 399 about, 438 online redo logs, 399 creating (preallocated), 418 repositories, 400...
Page 462 unpresenting virtual disks, 423 web sites documentation, 19 storage, 19 virtual disks HP Subscriber’s Choice for Business, 19 about, 413 product manuals, 17 actions, 413 adding to DR groups, 87 adding to managed sets, 416 deleting, 420 presenting, 423 removing from DR groups, 424 topology view, 78...

This manual is also suitable for:

Storageworks 60 - modular smart array Storageworks 6100 - enterprise virtual array Storageworks 70 - modular smart array Storageworks 8100 - enterprise virtual array Storageworks replication solutions manager 4.0.1

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

About this Guide

1 Replication Solutions Manager

2 Replication Resources

3 DR Groups

4 Enabled Hosts

5 Host Volumes

6 Jobs

Quick Links

Troubleshooting

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

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