10.14.Configuration of a File system restore job
File system restore jobs are used to restore already archived items from shortcuts back into the original file location. To create a restore job, navigate to File Archive ⇒ Archive ⇒ Jobs button (File archive jobs page), and click on +new. In the Add new job instance dialog, select File system restore job from the dropdown list, select a node where the job should run from the Run on node dropdown list (if you would not like to specify a node here and the job should run on any available node, then select “Any available”), enter a Display name, and click on Add.
On the File system restore job’s configuration page the user is required to set the following sections:
✓ Scheduling settings:
In this step the running times of the restore job must be selected. It is possible either to select a scheduler from the list or to create a new scheduler via create new option. Restore jobs are run only in specific cases. In most of the cases a One time scheduler is used for the restore job (e.g. with start date 7th of September as in our case). (For more information about how to set schedulers refer to the section Schedules above.)
✓ Folder to process
In this section you have to select the local folder(s) or remote share(s) where the shortcuts — which replaced the original files — are located. The job will restore the original files from these shortcuts. There are 2 methods how these folders may be specified:
- Via “new” button:
Click on + new and fill in the path to restore into the Folder to process dialog.
- Via the ”import” button:
Import the folder path(s) to be restored from a file. Click “import”, browse for the import file, select the import method and specify the required settings, then upload the file with the desired file path(s). Learn more about files to import in chapter Importing contentACCESS configurations from files of this guide.
✓ Exclude folders
With this function you may set, which folders/subfolders should not be restored. If you would not like to exclude any folder from the restore process, you can skip these settings.
The folders may be excluded using one of the available methods: a) They may be added manually via the + new option; b) or may be imported in one of the available file formats via the import option.
- Add exclude folders manually:
Click on + new option. In the Exclude folder dialog’s textbox specify the folder(s) to be excluded. Use the hints that are listed in the same dialog. the same dialog.
- Import the list of folders:
Exclude folders may be imported as files in one of the available formats: CSV, XML, Tab delimited files or Space delimited file. The file to be imported must contain the list of folders to exclude. To import such a file with the list of folders refer to chapter Importing contentACCESS configurations from files of this guide.
✓ Modification date
This section allows to command to a restore job to restore the archived item a) either with the original modification date [original modification date (default)], or b) with the date of restore (restore date).
It is rather recommended to restore the item with the original modification date, which is also set as default. However, “restore date” option might be useful in case, if an archive job on the selected folder path is already running and the age filter is set to younger older than the restore date. With this setting we can prevent the restored document from re-archiving. From this reason we also set in this use case “restore date” option.
✓ Notification settings.
Select here, when you will need to get notifications from the File Archive restore job. It is possible to set here, if you need a notification email always/never, or, you need it only in case when an error/warning occurred during the restoring process − for example, if the restore of one or more documents failed, then you will get a notification email about this error. Into the Recipient list textbox insert the email addresses of the persons, to whom you would like to send these emails. Notifications emails may be used as means of troubleshooting of possible failures/errors. (In this use case we do not require such notifications, so we set it to “Never”)
✓ Resource settings.
Set the value, which will determine how many items will be processed simultaneously by the file restore job. The recommended value is “2”.
At the end never forget to save your job configurations: click on Save in the left upper corner of UI.
The restore job has finished its task. The restored items can be viewed in the original file location, with the restore dates.