Activities 4.4

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English
User Manual

Icon archived docs.png Note
This is not the latest version of the article and, as such, does not provide information on features and enhancements introduced in the latest release. For the latest documentation, check User Manual.



By clicking the dashboard item SEP sesam web dashboard is displayed. This online monitoring tool constantly tracks SEP sesam operations and their state and provides key metrics of your backup environment. You can check if all your backups and restores have been completed successfully and review other various useful information, such as daily, weekly, monthly or custom statistics on SEP sesam events, on total size of backed up and restored data and on data store utilization.

You are able to filter the reports by events, clients, tasks and state; check backups and restores per client or application over time; get an overview of up-coming events and data store utilization. Note that all information provided by SEP sesam dashboard is currently read-only. For details, see SEP sesam Dashboard.


By clicking the restore item you start the restore wizard which leads you through the process of restoring backup files from backup media (tape, disk, etc.) to the desired computer (client). Note that the options in the restore wizard change depending on the selected task type for restore, therefore some options may not be available.

Activities restore filter.png

Searching by task name
Search for a certain task intended for restore by using the fields Task and Saved in period. If you use the wildcard [*], all tasks are selected. After clicking the Next button, all save sets created within the given period are shown in tabular form.
Searching by filename or path
Search for the known files or directories to find the backups that match the search term. Use input-field Search pattern for filename or path together with drop-down boxes Task and Saved in period to narrow the search requirements.
Information sign.png Note
By using the wildcard [*], all tasks are selected which may take a long time to process.

After clicking the Next button, all save sets created within the given period and matching the search pattern are shown in tabular form.

Show external results
If this option is selected, the "external" backups will be displayed. Typically, these are the backups that would normally not be restored directly by the restore wizard (e.g., Oracle, DB2). You can restore a save set directly from the backup media into the file system and then process it in a special way.
Select Task
Activities restore select task.png

Select the backup you want to restore. Choose one of the following options:

Complete restore of selected task
If this option is selected, no further selections or additional options are available. You go directly to the final step of the restore wizard (start of the restore). If it is not selected, the file selection is available for selective restore.
Hide migrated
If a backup job has been migrated, the restore wizard will by default provide the original save set if it is accessible. Hide migrated is enabled by default. To force the access to the migrated data, you have to deselect it. If the original save set was deleted, the migrated save set will be displayed by default.
Broken tasks
If you select this option, broken backups will also be displayed. Keep in mind that it is only possible to restore data from the backups that have completed successfully.
Generation restore
If a DIFF or INC backup is chosen for restore and this option is enabled, SEP sesam calculates all required restore steps from the last FULL backup to the selected DIFF/INC version. The whole backup chain is processed for restore without user intervention, including all media changes, etc. If this option is disabled, only the selected backup (INC or DIFF) will be used. Once you selected the desired save set for restore, click Next to display the Select Files window.
Disaster restore
This option is only available when a SEP sesam self-backup (SESAM_BACKUP) is going to be restored. This function provides a recovery of the SEP sesam Server after a system failure. For details, see SEP sesam Server Disaster Recovery.
Mount save set
As of SEP sesam v. 4.4.2, you can select the option Mount saveset under Single File Restore to mount the target save set to the disk and make it accessible as if it was a separate volume on the disk. It is a recommended option for restoring specific data, such as Exchange, Hyper-V and V-Sphere backups, because it provides faster restore time and performance. You can mount any non-compressed and non-encrypted file-based save set stored to default data store Path or to Si3 data store. Mounting is not possible if the save sets are stored to tapes. The target save set is mounted to the SEP sesam home directoryvar\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\save_set_ID. For more information, see Cross-Platform Recovery File System Layer.
As path restore
This option is available for restoring from task types that store directories and files similar to path backup. For example, you can use it instead of a Hyper-V or VMware task type, but it is not available for other types, such as MS SQL Server, SAP and DB2. It provides a simple and straightforward restore – by selecting the files from directory tree – also for special task types without their specific processing, e.g., restoring a Hyper-V VM to original location or with relocation. Compared to similar option As path backup option under the Expert options, choosing As path restore allows you to select individual files for restore while the As path backup restores all files.
SEP Tip.png Tip
  • If the number of actual backup tasks is too big to show in a list, set a filter string by task name in the above search field.
  • You can also store a default table view: After you have selected the columns you need and arranged them, you can save the settings by moving the mouse pointer over the column header, right-click it and select the Save View option.

For each task in the list, the following attributes are displayed:

  • Task type: The type, according to which the data is backed up (path, system state, SAP Hana, Exchange Server, etc.).
  • Task: The name of the task (given by user).
  • Start: The time at which the backup was started.
  • Count: Running number from the backup task on the backup day.
  • Backup level: Specifies the level of data that is copied from source to destination (C = Copy, D = Differential, F = Full, I = Incremental).
  • No. of media: Number of used media for the task.
  • Size: Size of the backup.
  • Client: Target client.
  • Backup day: Date of the backup. Note that backup day defines a time interval between two NEWDAY events.
Media pool
The name of the source media pool.
Identification of the save set.
Select Files
Activities restore select files.png

The previously selected task is visible in the upper part of the window. In the lower part all directories and files from the saved backup are displayed in a standard tree view. Clicking [+]/ [-] (the plus and minus control) expands/collapses the folder content.

Checking the box next to the folder/file selects items for restore. The absolute path of the selected folders or files is shown above in the field Position.

Information sign.png Note
When you select a folder/directory, its subfolders/subdirectories are automatically selected.

The button Search opens a search function that allows you to search the save sets by task name or by filename or path or by any part of it.

Find Pattern
Activities restore find pattern.png

The results of the search are listed below. Select the files you want to restore and click Next. The last step of the wizard opens Save and Start window is shown.

Save and Start

In the upper field, the save set that is selected for restore is displayed with its attributes. The available restore options depend on the selected task type for restore.

Activities restore start.png

The name of the task is assigned automatically. If the restore is planned to be started by scheduler, enter the corresponding task name.
The drive which SEP sesam will use for restore.
The name of the server from which the files are being restored. This is either a Remote Device Server (RDS) or SEP sesam Server.
Target node
The name of the server where the files are being restored to. Only computers with the same platform (Windows or UNIX) are available. If you need to perform a cross-platform restore, return to the task selection step of the wizard and choose Mount saveset.
Preferred media pool
If the data was migrated or replicated and different media pools were used for the process, the source media pool to restore from can be selected from the drop-down list of available media pools.
Used media | Barcode
If the data was migrated, the migrated copy is stored to another media. Here the source media to restore from can be selected from the drop-down list of available media.
Target path settings
Restore to original target path
This option is selected by default. It restores the data to the same location from which it was backed up. Note that this only applies if the target node is the same server from which the data was backed up, i.e. when source and target server are the same.
Original tree structure
This check box at the right is enabled by default when restoring to original location. The directory structure of the restored files is the same as the original directory structure of the backed up data. If this option is disabled, the directory structure is not recreated and only the files are restored (flat structure).
New restore target
This option enables you to restore data to some other location. The path to the directory to which the data should be restored can be entered manually or by using the Browser button to open the file explorer.
Execution options
If the files with the same name in the target directory already exist, the following selection can be made:
do not overwrite existing files
Selected by default. Files will be restored only if they are not already present on the target system.The original data will not be overwritten.
overwrite existing files
Files on the target system will be overwritten and replaced with their restored version.
create new version
Data from backup is restored as a new version by appending a tilde to the original file name. The original data remains intact. For example:


The restore is started by clicking the Start button. If the restore configuration should be started manually at a later time or by a scheduled task, use the Save button to save the task under the assigned name in the Name field. All, started and scheduled restores are saved in SEP sesam under Main selection -> Tasks -> Tasks by clients/Tasks by groups with the current timestamp. A restore can be restarted by using the menu item Activities -> Restore or from Main selection -> Job state -> Restore -> right-click selected restore -> Immediate start.

Expert Options

Clicking the button Expert options will open a new window, where more specific options and actions can be defined.

Restore expert options.jpg


Restore options text box allows user to provide additional specific options for restore. This is helpful for special options of the sbc command. For details on commands, see SBC CLI.

Verbose level allows user to change the verbosity of the main log to display more information than the default logging mode. Verbose levels from 0 to 6 are available. The higher the number, the more trace information will be logged during restore.

SEP Tip.png Tip
If required, you can get more information on options from SEP sesam support or search for them in additional documentation for special SBC clients (e.g., SBC for MS Exchange).
Restore the complete saveset
Restores all files from the saveset.
Restore according to the composed list
Restores previously selected directories and files.
Disk_info disaster recovery
This option is available when restoring from DISK_INFO backup of a Linux host. It is required when recovering a Linux server for restoring the backed up file partition information. A special BSR license (Bare System Recovery) is required. For details, see List of Licenses.
Restore relocation.jpg

By default, no relocation is selected: files are restored to original path with the original tree structure.

The with relocation option allows to specify a new target location for restored files. Individual files can be restored to separate paths. For example, the files from C:\Program Files\Java are going to be saved as a new restore target in the directory C:\Java, where all sub-directories are recreated (see screenshot).

Restore filter.jpg

The Filter tab allows to restore only data that matches the filter criteria. Regular wildcards should be used (* and ?). For example, *.doc would result in restoring only files that have the extension ".doc".

The filtering is first applied to the client, i.e. all data will be sent over the network. Filtering is especially useful if no LIS file is available, thus enabling selective restore.

Task type
Restore backup type.jpg

By default, the task type according to which the data is backed up is selected (default is path; other task types are, for example, Hyper-V, SAP Hana, Exchange Server, Lotus Notes, MySQL, VMware vSphere etc.).

When you have backed up data with task type other than default path, for example Hyper-V, you can still use the option As path backup. This option allows you to restore your data directly to the file system without any additional action, for example, files from a Hyper-V backup, rather than restoring according to your special task type, for example, restoring (and importing) Hyper-V data to the Hyper-V manager.

The option Write saveset into file allows you to restore the entire save set into a single file.

Restore pre post.jpg

Under the Pre/Post tab you can specify whether any pre- or post-script should be applied for this restore task.

Information sign.png Note
To use a pre/post interface, you have to activate it first and create your own commands. Interfaces can be activated in GUI: in the menu bar, click Configuration -> Interfaces -> select the interface you want to activate and the client. The interface script window opens, allowing you to configure the desired action. Once done, click Save to activate the interface. The interface is saved to the <SESAM_ROOT>/bin/sesam directory. For more details, see Using Pre and Post Scripts.

The following options are available:

Execute pre
The commands from the pre-interface are run.
Start restore in spite of pre error
Typically, the restore will not start if the pre- commands are not successful. By selecting this option, the restore will ignore the pre-command errors.
Execute post
The commands from the post interface are run.
Start post in spite of restore error
If the restore did not finished successfully, you can force the execution of post commands by enabling this option (e.g., booting a database).
Restore EOL.png

Specifies for how long (in days) this restore task will be kept and can be accessed using GUI. Default is 7 days. If you want to use a restore task after a longer period of time or use it as a template, it is recommended to set a longer retention time. Setting the value to 0 (zero) means unlimited lifetime.

Start time
Restore start time.jpg

  • Instead of starting your restore immediately, you can specify the Start time by entering the desired date and hour.
  • In the Delay start for up to, the maximum allowed startup time (the amount of time an event can be in the queue) can be specified in days and/or hours. The actual event startup depends on the processor load of the system. At the starting time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority are finished. For jobs with the same priority, the FIFO rule (first in first out) applies. If the event cannot be executed within this specified time frame, it will not be executed at all.
  • Stop task if it runs longer than can be defined by setting the amount of time (days and/or hours) after the event's scheduled start time at which the event will be cancelled.
  • Additionally, Stop task at can be used to define the exact date and time when the task should be stopped.
  • A Follow Up event can be specified to trigger the predefined event on the SEP sesam Server once the restore is completed. For details, see Follow-up Events.

Clicking Ok will save all adjustments made in the Expert options window.

Immediate Start

Immediate Start -> Backup
Immediate start-backup.png

Selection of a previously applied task.
Task group
Selection of a previously applied task group.
Backup level
Definition of the backup level (FULL, DIFF, INCR, COPY).
Special backup parameters, applicable only for Citrix XenServer backup.
Media pool
Selection of a media pool that will be used for this backup.
Drive group
This inactive field displays the name of the drive group, which is defined for the specified media pool. The backup is executed automatically on a drive from the assigned drive group.
You can define which drive handles the backup job for drive groups with several drives. If no drive is selected, SEP sesam selects the available drive based on criteria for load sharing.
If multiple network connections are available, the hostname for the backup source (if necessary, the network interface) is defined.
Start time
Instead of starting your backup immediately, you can specify the startup time by entering the desired date and hour.
Delay start for up to
You can define the maximum allowed startup time (the amount of time an event can be in the queue) in days and/or hours. The actual event startup depends on the processor load of the system. At the starting time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority are finished. For jobs with the same priority, the FIFO rule (first in first out) applies. If the event cannot be executed within this specified time frame, it will not be executed at all.
Stop task if it runs longer than 
You can set the amount of time (days and/or hours) after the event's scheduled start time at which the event will be cancelled.

By clicking the Start button, the backup process is picked up by SEPuler that initiates the execution of the event immediately or (if the time is specified) at the desired start time.

Immediate Start -> Restore

From the list of the restored tasks select the desired task.

Immediate start restore.jpg

Once you have selected the task, the final step of the restore wizard is displayed. It provides an overview of the restore task. For details, see Restore – Save and Start.

Immediate Start -> Migration

In the migration task window, the tab Execution Parameter is displayed.

Immediate start-migration.jpg

Select the desired migration task from the Task Name drop-down list. The selected migration task is displayed with its parameters. You can modify the migration destination and filter settings. By clicking the Start migration button, the changes of the migration task are saved and the migration is started. For details on migration options, see Migration tasks. For step-by-step procedure, see Configuring Migration.

Immediate Start -> Media Action

Media events can be activated by SEPuler (timetable) as user-defined events, overflow of media (EOM) or backup itself. For details on media event configuration, see Creating a Media Event.

Immediate start media event.png

You can choose from four different media actions:

Initializing media prepares it for use with SEP sesam. Initialization process rewrites the tape label. Any existing information on tape are deleted. A media event prepares the medium of the selected pool to be used for backup.
Readability check
The readability check tests the backup data readability. During the check the data on medium is read in blocks, the structure of tape is checked and recorded.
Close tape
Closing the tape means that EOM (End of Media) is created on tape regardless of whether it is full or not. Such a tape can no longer be used for storing data.
Archive adjustment
An archive adjustment makes a comparison between media in the loader carousel or magazine and the SEP sesam media archive database.
Sequence Control
Event priority is used for resolving scheduling conflicts. Priorities can be assigned to schedules, from lowest (1, default) to highest (99). For details, see Prioritization of events.
Blocking date 
A blocking event is any type of event with a higher priority that obstructs another event. A blocking event only affects other events with the same name when schedules are overlapping. For details, see Blocking Events.
Media Pool 
Defines the media pool that is used for the media event.
Optionally, you can define a specific drive for the event execution. If a drive is not selected, SEP sesam Server automatically selects one of the available drives.
Drive group 
Displays the name of the drive group that belong to the media pool.
Optionally, you can select the medium that you want to use. If no medium is selected, SEP sesam Server automatically assigns the medium with the oldest EOL. For details on GET_OLDEST strategy, see Media Strategy.
If required, set additional execution options.
Start time
Optionally, you can delay the immediate start by modifying the start time.
Immediate Start -> Command

Starts a preconfigured command event by inserting it with the actual time into the calendar. Events initiated with the Immediate start command from the GUI or command line are listed in the calendar as non-recurring events. For details on command event configuration, see Creating a Command Event.

Immediate start command.png

Use the Choose button to select a command from the drop-down list of already configured commands. Select the command and click OK.
Select hostname of the computer on which the command is going to be executed.
Specify a user with rights to execute the command on the client. This is only valid for Unix systems, on Windows the command is executed with the rights required to run SEP sesam service. For information on access restrictions for command events, see section Access limitation of command events.
The selected command is displayed.
Command selection.png

Start time
Instead of starting your command event immediately, you can specify the startup time by entering the desired date and hour.
Delay start for up to
You can define the maximum allowed startup time (the amount of time an event can be in the queue) in days and/or hours. The actual event startup depends on the processor load of the system. At the starting time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority are finished. For jobs with the same priority, the FIFO rule (first in first out) applies. If the event cannot be executed within this specified time frame, it will not be executed at all.
Stop task if it runs longer than
You can set the amount of time (days and/or hours) after the event's scheduled start time at which the event will be canceled.

Access limitation of command events

External commands are executed only if the user and command are inserted into the file /etc/sesam_cmdusers.allow on the client computer. Therefore, if necessary, the template from path <SESAM-BIN>/skel/templates must be copied to /etc and adapted accordingly. Format: user command|* (* = all commands can be started)
External commands are only executed if the user and command are inserted into the registry on the client computer at key //HKLM/SOFTWARE/SEP Elektronik GmbH/sesam/CommandEvents/<user>/<command>.
Command Execution
* all instructions
cmd /c all DOS instructions (dir etc.)
ping only command ping

Restart backups

You can restart all defective or aborted backups of a SEP sesam backup day.

Activities restart backup.jpg

Clicking [+] button marks all selections for the job, while clicking [-] clears the selections. By enabling and disabling the check box in front of each backup you activate or deactivate individual backups.

All restarted backups are put into the queue with priority 0 (zero; the highest priority that overrides all other priorities) and are executed unconditionally. If you need to adjust the priority, select it by using the Prio option.

Cancel current running activities

Allows you to stop all running activities in your SEP sesam environment. If you respond to the confirmation dialog with OK, SEP sesam stops all running tasks. This is useful for resetting your backup environment or for maintenance operation.