Create a Restore Job Definition - File System
ECX leverages Copy Data Management technology for recovering physical Windows, AIX, and Linux file systems through File System Restore jobs. Clones can be utilized and consumed instantly through ECX Instant Disk Restore jobs. ECX catalogs and tracks all cloned instances. Instant Disk Restore jobs mount file systems from storage copies containing application data.
BEFORE YOU BEGIN:
- Review File System requirements. See File System Requirements.
- Create and run a File System Backup job. See Create a Backup Job Definition - File System.
- For email notifications, at least one SMTP server must be configured. Before defining a job, add SMTP resources. See Register a Provider.
- You must add credentials to the destination virtual machine when recovering with the subnet option. See Add Credentials to a Virtual Machine.
To create a File System Restore job definition:
- Click the Jobs tab. Expand the File System folder, then select File System.
- 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 Application Browse to select a source site and a file system to view available recovery points. Select resources, and change the order in which the resources are recovered by dragging and dropping the resources in the grid.
- Alternatively, select Application Search from the drop-down menu to search for file systems with available recovery points. Add 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 . Select a source site and an associated destination. Review the destination's mount point mapping settings. Optionally, click the Enter an alternate mount point field to create an alternate mount point, or select Use original mount points.
- 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.
- Overwrite Existing Mount Points
- Select to overwrite the mount points at their original location.
- Continue with next source on failure
- Toggle the recovery of a resource in a series if the previous resource recovery fails. If unselected, 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 database recovery fails.
- Allow to overwrite vDisk
- In cases where the Make Permanent option is enabled, and the destination VM has conflicting VMDK files, enable the Allow to overwrite vDisk option to delete the existing VMDK and overwrite it with the selected source.
- 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.
-
Note: If adding a script to a Windows-based File System job definition, the user running the script must have the "Log on as a service" right enabled, which is required for running prescripts and postscripts. For more information about the "Log on as a service" right, see https://technet.microsoft.com/en-us/library/cc794944.aspx.
- Make Permanent
- Set the default permanent restoration action of the job. All database recovery operations can leverage Instant or Test modes and then either be deleted or promoted to permanent mode. This behavior is controlled through the Make Permanent option.
- Enabled - Always make permanent through full copy FlashCopy
- Disabled - Never make permanent
- User Selection - Allows the user to select Make Permanent or Cleanup when the job session is pending
- Protocol Priority
- If more than one storage network protocol is available, select the protocol to take priority in the job. Available protocols include iSCSI and Fibre Channel.
- 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 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