Create a Restore Job Definition - IBM Spectrum Virtualize
ECX leverages Copy Data Management technology for recovering IBM Spectrum Virtualize volumes through IBM Spectrum Virtualize Restore jobs.
Instant Disk Restore 
Provides instant writable access to a volume. An ECX snapshot is mapped to a target server where it can be accessed, copied, or put immediately into production use as needed.
Restore Volume(s) 
Recover a volume from a FlashCopy or Global Mirror created through an ECX IBM Spectrum Virtualize Backup job. Volumes can be restored to their original location or a new volume in the same or different IBM storage system.
BEFORE YOU BEGIN:
- Create and run one or more IBM Spectrum Virtualize Backup jobs. See Create a Backup Job Definition - IBM Spectrum Virtualize.
- For email notifications, at least one SMTP server must be configured. Before defining a job, add SMTP resources. See Register a Provider.
CONSIDERATIONS:
- IBM providers utilize port 22 for communication with ECX.
- Note that to restore data to an original volume, you must first offline the target disk on the host prior to recovery. Once recovery completes, bring the target disk back online.
- Note that after restoring data to an alternate location you must map the host to the restore volume on the IBM storage system. Then rescan the disk on the host, and bring the disk online.
- In IBM storage environments, port grouping and IP partnerships are required to enable remote copy connections. See IBM's SAN Volume Controller and Storwize Family Native IP Replication Guide.
- One or more schedules might also be associated with a job. Job sessions run based on the triggers defined in the schedule. See Create a Schedule.
To create an Instant Disk Restore IBM Spectrum Virtualize Restore job definition:
- Click the Jobs
tab. Expand the Storage Controller folder, then select IBM Spectrum Virtualize. - Click New
, then select Restore. The job editor opens. - Enter a name for your job definition and a meaningful description.
- Select the Instant Disk Restore template.
- Click Source
. From the drop-down menu select Volume to select a source site and an associated IBM source to view volumes with available recovery points. Select one or more resources, and change the order in which the resources are recovered by dragging and dropping the resources in the grid. - Alternatively, select Volume Search from the drop-down menu to search for volumes with available recovery points. Add volume copies to the job definition by clicking Add. Change the order in which the resources are recovered by dragging and dropping the resources in the grid.
- Click Copy
. Sites containing copies of the selected data display. Select a site. By default the latest copy of your data is used. To choose a specific version, select a site and click Select Version. Click the Version field to view specific copies and their associated job and completion time. If recovery from one snapshot fails, another copy from the same site is used. - Note: When selecting a specific version, data created through VMware Backup jobs that apply to the selected IBM resource display, as the same data is contained with the snapshot for VMware and non-VMware related data.
- Click Destination
. Select the IBM hosts that contain the iSCSI Qualified Name (IQN) or Fibre Channel WWPN of the application that you want to assign to. - Note: The IBM hosts that are used during runtime may be different based on the initiator name.
- To create the job definition using default options, click Create Job. The job can be run manually from the Jobs tab.
- To edit options before creating the job definition, click Advanced. Set the job definition options.
- Make IA clone resource permanent
- Enable to turn the snapshot copy into a proper resource that will not be cleaned up after the Instant Disk Restore job completes.
- Continue with next source on failure
- Toggle the recovery of a resource in a series if the previous resource recovery fails. If disabled, the Restore job stops if the recovery of a resource fails.
- Automatically clean up resources on failure
- Enable to automatically clean up allocated resources as part of a restore if the volume recovery fails.
- Allow to overwrite and force clean up of pending old sessions
- Enabling this option allows a scheduled session of a recovery job to force an existing pending session to clean up associated resources so the new session can run. Disable this option to keep an existing test environment running without being cleaned up.
- Job-Level Scripts
- Job-level pre-scripts and post-scripts are scripts that can be run before or after a job runs at the job-level. A script can consist of one or many commands, such as a shell script for Linux-based virtual machines or Batch and PowerShell scripts for Windows-based virtual machines.
- In the Pre-Script and/or Post-Script section, click Select to select a previously uploaded script, or click Upload to upload a new script. Note that scripts can also be uploaded and edited through the Scripts
view on the Configure 
tab. See Configure Scripts. - Once complete, the script displays in the Pre-Script or Post-Script section. Click the Parameters field at add a parameter to the script, then click Add. Note additional parameters can be added to a script by entering parameters one at a time in the field, then clicking Add. Next, click the Identity field to add or create the credentials required to run the script. Finally, click the Application Server field to define the location where the script will be injected and executed.
- Repeat the above procedure to add additional Pre-Scripts and Post-Scripts. For information about script return codes, see Return Code Reference.
- For Restore job post-scripts only, the positional arguments state and status can be passed to the script. For information about this feature, see Using State and Status Arguments in Postscripts. State and status arguments are not supported for Backup jobs.
- Select Continue operation on script failure to continue running the job if a command in any of the scripts associated with the job fails.
- Optionally, expand the Notification section to select the job notification options.
- SMTP Server
- From the list of available SMTP resources, select the SMTP Server to use for job status email notifications. If an SMTP server is not selected, an email is not sent.
- Email Address
- Enter the email addresses of the status email notifications recipients. Click Add
to add it to the list. - Optionally, expand the Schedule section to select the job scheduling options. Select Start job now to create a job definition that starts the job immediately. Select Schedule job to start at later time to view the list of available schedules. Optionally select one or more schedules for the job. As each schedule is selected, the schedule's name and description displays.
- Note: To create and select a new schedule, click the Configure tab, then select Schedules
. Create a schedule, return to the job editor, refresh the Available Schedules pane, and select the new schedule. - When you are satisfied that the job-specific information is correct, click Create Job. The job runs as defined by your schedule, or can be run manually from the Jobs tab.
To create a Restore Volume(s) IBM Spectrum Virtualize Restore job definition:
- Click the Jobs tab. Expand the Storage Controller folder, then select IBM Spectrum Virtualize.
- Click New , then select Restore. The job editor opens.
- Enter a name for your job definition and a meaningful description.
- Select the Restore Volume(s) template.
- Click Source . From the drop-down menu select Volume to select a source site and an associated IBM source to view volumes with available recovery points. Select one or more resources, and change the order in which the resources are recovered by dragging and dropping the resources in the grid.
- Alternatively, select Volume Search from the drop-down menu to search for volumes with available recovery points. Add volume copies to the job definition by clicking Add. Change the order in which the resources are recovered by dragging and dropping the resources in the grid.
- Click Copy . Sites containing copies of the selected data display. Select a site. By default the latest copy of your data is used. To choose a specific version, select a site and click Select Version. Click the Version field to view specific copies and their associated job and completion time. If recovery from one snapshot fails, another copy from the same site is used.
- Click Destination . To restore to the original volume, select Restore to original volume, or select Restore to alternative location and select a volume and associated pool. If no pool is selected, the pool with the largest amount of space available is chosen by default.
- To create the job definition using default options, click Create Job. The job can be run manually from the Jobs tab.
- To edit options before creating the job definition, click Advanced. Set the job definition options.
- Continue with next source on failure
- Toggle the recovery of a resource in a series if the previous resource recovery fails. If disabled, the Restore job stops if the recovery of a resource fails.
- Automatically clean up resources on failure
- Enable to automatically clean up allocated resources as part of a restore if the volume recovery fails.
- Job-Level Scripts
- Job-level pre-scripts and post-scripts are scripts that can be run before or after a job runs at the job-level. A script can consist of one or many commands, such as a shell script for Linux-based virtual machines or Batch and PowerShell scripts for Windows-based virtual machines.
- In the Pre-Script and/or Post-Script section, click Select to select a previously uploaded script, or click Upload to upload a new script. Note that scripts can also be uploaded and edited through the Scripts view on the Configure tab. See Configure Scripts.
- Once complete, the script displays in the Pre-Script or Post-Script section. Click the Parameters field at add a parameter to the script, then click Add. Note additional parameters can be added to a script by entering parameters one at a time in the field, then clicking Add. Next, click the Identity field to add or create the credentials required to run the script. Finally, click the Application Server field to define the location where the script will be injected and executed.
- Repeat the above procedure to add additional Pre-Scripts and Post-Scripts. For information about script return codes, see Return Code Reference.
- For Restore job post-scripts only, the positional arguments state and status can be passed to the script. For information about this feature, see Using State and Status Arguments in Postscripts. State and status arguments are not supported for Backup jobs.
- Select Continue operation on script failure to continue running the job if a command in any of the scripts associated with the job fails.
- Optionally, expand the Notification section to select the job notification options.
- SMTP Server
- From the list of available SMTP resources, select the SMTP Server to use for job status email notifications. If an SMTP server is not selected, an email is not sent.
- Email Address
- Enter the email addresses of the status email notifications recipients. Click Add to add it to the list.
- Optionally, expand the Schedule section to select the job scheduling options. Select Start job now to create a job definition that starts the job immediately. Select Schedule job to start at later time to view the list of available schedules. Optionally select one or more schedules for the job. As each schedule is selected, the schedule's name and description displays.
- Note: To create and select a new schedule, click the Configure tab, then select Schedules . Create a schedule, return to the job editor, refresh the Available Schedules pane, and select the new schedule.
- When you are satisfied that the job-specific information is correct, click Create Job. The job runs as defined by your schedule, or can be run manually from the Jobs tab.
NEXT STEPS:
- If you do not want to wait until the next scheduled job run, run the job session on demand. See Start, Pause, and Hold a Job Session.
- Track the progress of the job session on the Jobs tab. See Monitor a Job Session.
- If notification options are enabled, an email message with information about the status of each task is sent when the job completes.
Catalogic ECX™ 2.9
© 2019 Catalogic Software, Inc. | All rights reserved.
MySupport | Knowledge Base | Trademarks | info@catalogicsoftware.com