4 4 3 Beefalo:Activities

From SEPsesam
Jump to: navigation, search
Other languages:
Deutsch • ‎English
<<<Back
File
User Manual
Next>>>
Configuration


Draft.png WORK IN PROGRESS
This page is a draft. Treat the information on this page with caution as it may be incomplete.


Activities

From the menu bar -> Activities, you can access the SEP sesam dashboard, perform a restore, start different actions immediately, restart the backups or cancel running activities.

Dashboard

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.

Restore Assistant

By clicking the Restore Assistant, you can perform an online restore of files, directories, virtual machines (VMware, Hyper-V, Citrix, RHV and OpenNebula), and emails from Kopano backups to which you have been granted access. Only authenticated users that have been granted appropriate permissions are able to access the Restore Assistant and restore their data. For details, see Restore Assistant.

Restore

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.

Restore filter Beefalo.jpg

  • 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 savesets 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 savesets 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 saveset directly from the backup media into the file system and then process it in a special way.
Select Task

Restore select task Beefalo.jpg

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 saveset 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 saveset was deleted, the migrated saveset 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 INCR 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/INCR 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 (INCR or DIFF) will be used. Once you selected the desired saveset 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 saveset: You can select the option Mount saveset under Single file restore to mount the target saveset 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 saveset stored to default data store Path or to Si3 store. Mounting is not possible if the savesets are stored to tapes. The target saveset is mounted to the SEP sesam home directory var\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 on 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.
  • Start: The time at which the backup has been started.
  • Level: Specifies the backup level of data that is copied from the source to the destination (C = Copy, D = Differential, F = Full, I = Incremental).
  • Client: The target client.
  • Size: Size of the backup.
  • 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.
  • Saveset: Identification of the saveset.
Select Files

Restore select files Beefalo.jpg

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 savesets by task name or by filename or path or by any part of it.

Find Pattern

Restore find pattern Beefalo.jpg

The results of the search are listed below. Select the files you want to restore and click Next. The Target Settings window opens.

Target Settings

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

Restore target settings Beefalo.jpg

  • Restore task name: The name of the task is assigned automatically. If the restore is planned to be started by scheduler, enter the corresponding task name.
  • 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.

Target path settings provides the following options which are slightly different when restoring VMs:

  • Restore to original target path or Restore to original VM (in case of VM restore): 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 or Change VM target selection (in case of VM restore): 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.
  • Restore with new VM name: Relevant only for VM restore; this option enables you to restore the data to the original or a different location with a new VM name. If you are restoring a VM to a different location with a different VM name, you also have to specify a new target path under Change VM target selection.

Execution options or VM restore options (in case of VM restore); if the files with the same name in the target directory already exist, you can select between the following options:

  • Do not overwrite existing items: 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 items: Files on the target system will be overwritten and replaced with their restored version.
  • Create a 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:
  • README.TXT -> ~README.TXT
    

    When performing a VM restore, you can also select to automatically start a virtual machine after restore.

Optional data source selection:

  • 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.
  • Drive: The drive which SEP sesam will use for the restore.
  • Interface: The name of the server from which the files are being restored. This is either a Remote Device Server (RDS) or SEP sesam Server.

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 with different tabs, where you can specify more specific options and actions.

Information sign.png Note
As of v. 4.4.3. Beefalo, the Expert Options button for specifying more advanced restore options is only available in the Advanced and Expert UI mode. It is not available for users that run the GUI in Basic mode. In the latter case, to set additional restore options you first have to change the Basic UI mode to Advanced or Expert, as described in UI Mode.

Options tab

Restore expert options Beefalo.jpg

  • Verbose level: Allows you to change the verbosity of the main and trace logs to display more information than the default logging mode. For details, see Setting Log Level.
  • Restore options: Allows you to provide additional specific options for restore. This is helpful for special options of the sbc command. For details on commands, see SBC CLI.
  • 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 according to the regular expression-based filtering; see Filter tab below.
  • 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.

Relocation tab

Restore relocation Beefalo.jpg

By default, No relocation is selected; this restores the savesets to the original target 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 above).

Filter tab

Restore expert options filter Beefalo.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 which end with .doc.

The filtering is first applied to the client, i.e., all data will be sent across the network. Filtering is especially useful when you want to perform a selective restore and there is no metadata (LIS file) available.

Task Type tab

Restore task type Beefalo.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 saveset into a single file.

Pre/Post tab

Restore pre post Beefalo.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).

EOL tab

Restore EOL Beefalo.jpg

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; a restore task will be kept permanently unless you manually delete it.

Start Time tab

Restore start time Beefalo.jpg

  • Instead of starting your restore immediately, you can specify the Start time by entering the desired date and hour.
  • Start time frame: You can specify 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 up the amount of time (days and/or hours) after the event's scheduled start time at which the event will be cancelled.
  • Stop task at: Additionally, you can define the exact date and time when the task should be stopped.
  • Follow up: You can specify the follow-up event 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.

Summary

In the final step of the restore wizard, you can review all the settings of your restore task. You can also change the seetings by using Change Selection button. You can start the restore immediately or save the restore task as a template for future use.

Immediate Start

Immediate Start: Backup

Immediate start-backup Beefalo.jpg
Settings tab

  • Task: Selection of a previously configured task.
  • Task group: Selection of a previously configured task group.
  • Task type: Selection of a previously configured task type, e.g., Path, Hyper-V, SAP Hana, etc.
  • Backup level: Displays the backup level (FULL, DIFF, INCR, COPY).
  • Hot (online)/Cold (offline) backup: Special backup parameters, applicable for VMs and databases.
  • 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.
  • Drive: 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.
  • Interface: If multiple network connections are available, the hostname for the backup source (if necessary, the network interface) is defined.
  • Migration task: From the drop-down list, you can select available migration task for the migration.

Start Time tab

  • Start time: Instead of starting your backup immediately, you can specify the start time by entering the desired date and hour.
  • Start time frame: 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.
  • Stop task at: Additionally, you can define the exact date and time when the task should be stopped.
  • Follow up: You can specify the follow-up event to trigger the predefined event on the SEP sesam Server once the backup is completed. For details, see Follow-up Events.

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 relevant restore task.

Immediate start restore Beefalo.jpg
Once you have selected the task, the Target Settings window is displayed. It provides an overview of the restore task. For details, see Restore – Target Settings.

Immediate Start: Migration

In the migration task window, the tabs Settings and Start time are displayed.

Immediate start migration Beefalo.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 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 Beefalo.jpg

Settings tab

Sequence control:

  • Priority: Event priority is used for resolving scheduling conflicts. Priorities can be assigned to schedules, from lowest (1, default) to highest (99). For details, see Event Priority.
  • 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.

You can choose from four different media actions:

  • Initialize: 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, and the structure of tape is checked and recorded. For details, see Configuring a Readability Check.
  • Archive adjustment: An archive adjustment scans media in selected loader to update SEP sesam information about the media in the loader. It is required if the media in the loader have changed, for example if new media are added. For details, see Setting up Archive Adjustment.
  • 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 the data.

Parameter:

  • Media pool: Defines the media pool that is used for the media event.
  • Drive: 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.
  • Media: 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.
  • Drive group: Displays the name of the drive group that belong to the media pool.
  • Loader: Optionally, you can select the loader (tape library) for which you want to synchronize its contents with the SEP sesam database.
  • Options: If required, set additional execution options.

Start time tab

  • Start time: Instead of starting your media event immediately, you can specify the start time by entering the desired date and hour.
  • Start time frame: 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.
  • Stop task at: Additionally, you can define the exact date and time when the task should be stopped.
  • Follow up: You can specify the follow-up event to trigger the predefined event on the SEP sesam Server once the media event is completed. For details, see Follow-up Events.
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 Beefalo.jpg

Settings tab

  • Name: Use the Select button to select a relevant command from the drop-down list of already configured commands. Select the command and click OK.
  • Client: Select hostname of the computer on which the command is going to be executed.
  • User: 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.
  • Retention time: Optionally, specify the time period for which the media are protected after data is written to the medium, thus preserving the savesets and keeping them available for restore. For details, see Managing EOL.
  • Command: The selected command is displayed.
  • Command selection Beefalo.jpg

Start Time tab

  • Start time: Instead of starting your command event immediately, you can specify the startup time by entering the desired date and hour.
  • Start time frame: 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.
  • Stop task at: Additionally, you can define the exact date and time when the task should be stopped.
  • Follow up: You can specify the follow-up event to trigger the predefined event on the SEP sesam Server once the command event is completed. For details, see Follow-up Events.

Access limitation of command events

  • UNIX: 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)
  • Windows: 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/migrations

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

Activities restart backup Beefalo.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 or migration you activate or deactivate individual backups or migrations.

All restarted backups/migrations 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.

Disaster recovery

Enables you to perform a disaster recovery immediately. Note that disaster recovery requires special preparation and configuration. The SEP sesam disaster recovery solutions are Bare Metal Recovery Linux, Bare Metal Recovery MS Windows and SEP sesam Server self-recovery. For details on each solution, see Bare Metal Recovery Linux, SEP sesam BSR Pro for Windows, and SEP sesam Disaster Recovery.

Cancel current running activities

Allows you to stop all running activities (backups, restores and migrations) 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.

See also

Standard Restore ProcedureStandard Backup ProcedureConfiguring MigrationCreating a Media EventCreating a Command Event


Copyright © SEP AG 1999-2019. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.