Configuration 4.4

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

GUI Configuration Options

You can access the configuration options from the menu bar -> Configuration. Configuration provides different settings and parameters that define SEP sesam look and feel as well as its behavior. The following functions are available by selecting the Configuration option in the menu bar.

Configuration overview.png


Under Defaults, you can define the access to SEP sesam online help, define some extra settings, set retention periods for logs and restore tasks, customise the GUI font and tables, check the settings and set the date format. As of SEP sesam v. 4.4.3 Tigon, you can also change the default setting for data size units.


  • By default, the option Use Web help in the GUI is set. The online help is set to the user manual on the SEP sesam Wiki, thus providing the latest updated version of help topics online. Unless your GUI client has internet connection problems, it is recommended to use the latest Web help.
  • For a GUI client without internet connection, copy the user manual to local storage and set a link to the local help file by using the option Use local help in the GUI.
    • Use the search button to select the local HTML site.
    • Use the test it button to check the access to help files.
Defaults help.png


Defaults extras.png

The following settings can be activated in Extras:

  • Switch off the scrolling for warning "30 Days remaining for update authorisation"
    You can switch off the scrolling for notification about the pending expiration of updates. If there is no update permission, the notification never appears. After installing update, this option is reset.
  • Provide selection of "broken backups" in the Restore Wizard
    If this option is checked, you are allowed to perform a restore from incomplete, broken, or interrupted backups. By default, this selection is not provided.
  • Number of tracelog lines to display
    The default value for tracelog lines is 60. Click the arrows to increase or decrease the number of lines.
  • RSS Notification polling interval
    The default polling interval for RSS Notification is 720 minutes. Click the arrows to increase or decrease the polling interval.
  • User specific default interfaces for drive group
    You can set a user specific interface for each disk drive group (Default Interface). This setting overrides the default interface specified via the drive group.

Default user defined.png

  • Compress LIS files
    By default, the LIS files are not compressed. If you want to compress the LIS files, check this option and select the number of days after which the LIS files are compressed.
  • Globally activate Changed Block Tracking (CBT)
    By default, the CBT is enabled to provide change tracking thus saving disk space with optimized block level incremental and differential backups of VMDKs. Note that disabling CBT globally will affect your backup performance and use more disk space. For more details, see Changed Block Tracking.

Retention Periods
You can set up the retention period in days for SEP sesam logs, readabilitiy check logs, calendar sheet entries and restore tasks. The retention period is the time period for which the SEP sesam retaines specified data. Once the retention period expires, the data is removed from the database and is no longer available. Click the arrows to increase or decrease the predefined retention time per file.

  • Sesam Logs: The default value for preserving the SEP sesam log files is 7 days.
  • Readability Check Logs: The default value for preserving the readability check log files is 2190 days.
  • Calendar sheet entries: The default retention time for old calendar sheet entries is 35 days.
  • Restore tasks: The default retention time for old restore tasks is 7 days.
Defaults retention periods.png

Fonts and tables
You can customize your SEP sesam GUI appearance by changing:

  • Font Style: The predefined GUI font is plain. Check the Bold Font option to change the font-weight property of the entire GUI.
  • Table Striping: You can change the appearance of GUI tables by selecting one of the zebra striping tables from the drop-down list.
  • Table Row Spacing: Click the arrows to adjust the spacing between table rows in the entire GUI.
Defaults fonts.png


The register Settings is shown only when the trace (de-bug) level is increased. Displayed are the internal GUI settings.

Defaults settings.png

Default Date Format / Data displays

Depending upon your SEP sesam version, the tabs under Defaults window might be slightly different.

SEP sesam version 4.4.3

Under the last tab Default Date Format, you can change default setting for the date format.

SEP sesam version 4.4.3 Tigon

Under the last tab Data displays (previously Default Date Format), you can change the default setting for the date format as well as default setting for data size units. The data size can be specified either with decimal (KB, MB, GB, TB) or binary prefix (KiB, MiB, GiB, TiB). For details, see Changing data size units.

Defaults data size.png

Media types

Listing of all media-types defined in Sesam. Entries in black font are the media types currently used. They were set up in the database at the installation of Sesam and -contrary to the user defined media types (green font)- can be neither erased nor changed.

Media types.png

Sesam internal identification of the media type
Sesam internal drive types
Storage capacity of an allowed combination media / drive

Media management (obsolete from version 4.2)

There are no general settings for media handling available anymore. You can set up the media pool behavior directly at each media pool. For details, see Media pool – options.

Command You can create and define your own commands to be used for various tasks within SEP sesam environment.

Configuration commands.png

When configuring a new command, you have to define the following:

  • Name: Enter a name for the new event.
  • Client: Select a client, on which the command will be executed.
  • User: Enter the username of a user with sufficient access to execute the command on the client.
  • Command: Enter the complete command (and parameters if required), e.g., eventlog.ps1.
Information sign.png Note

When defining your own commands, some security considerations apply and are explained in Access restriction of command events.

Remote Server (Master GUI only)

This option is used for the server administration of the Master GUI. It is possible to both configure or remove SEP sesam servers or add new servers to the backup tree.

Information sign.png Note
The menu option is only available in the SEP sesam version Master Sesam.
Remoteserver en.jpg

Server Name  
Name of additional SEP sesam server in the network
Server is on the network (green = ON, red = Broken, gray = OFF)
Operating System  
OS of the server
GUI Build  
Connection type between GUI and kernel
Operating System  
OS of the SEP sesam server

The Master GUI allows the administrator control of all SEP sesam servers and clients.

Newremoteserver 4.0 en.jpg

When entering a new server into the SEP sesam backup scheduler there are additional parameters which must be set. The values are preset with default settings.

Server name 
Name of the SEP sesam
Switch ON or OFF
Name of the SEP sesam internal database
Port number for the database connection
Port number for client-server connecton
Optional comment by the user

User Permissions

User permissions 4.4.png

In User Permissions you can configure the user authorization. Options are 'Admin', 'Operator' and 'Restore'. The assignment of permissions is user- and client specific. If a non-authorized user or non-authorized client tries to create a GUI connection it is rejected.

New users permission 4.4.png

Note 1: If the name resolution for the selected client isn't complete (IP name and reverse lookup of the IP address) the connection is also rejected!

Note 2: Alternatively the SEP sesam program sm_setup can be utilized to assign user permissions:

  • Adding a user permission:
sm_setup allow_gui -u *|<user> -c *|<client> -m admin|operator|restore
  • Removing a user permission:
sm_setup disallow_gui -u *|<user> [-c *|<client>] [-m *|admin|operator|restore]
  • View permissions of users or clients:
sm_setup get_policy [-m user|client]

E-Mail Settings

Configuration e-mail.png

By clicking New the following window is opened:

Email account 4.4.png

  • Account: Name of account (mandatory)
  • Customer: Name of customer
  • Sender: E-mail address
  • SMTP Server: Name or IP-address of the outgoing mail server
  • SMTP user: User name for SMTP server
  • Password: Password for the Mail Server. Necessary if SMTP Server requires authentication
  • SMTP port:
  • Recipient: Address of recipient
  • CC: Address for copy of the email
  • BCC: Address for copy of the email
  • SSL: Optionally, select to connect securely via SSL or TLS

If no SMTP user name is specified, it is assumed that no authorization is necessary at the SMTP-Server.


User interfaces are small procedures of the operating system interpreter which can be programmed by the user. SEP sesam starts these procedures with certain parameters on certain events but is not concerned with what these procedures do. Only the PRE/POST-interface can have an effect on the execution of backups. These programs should not run for too long since they can delay the backup.

Templates for these procedures are delivered during the installation in the SEP sesam directory <SESAM_ROOT>/skel/templates. To activate such an interface its corresponding template file can be copied to the directory <SESAM_ROOT>/bin/sesam - it is only active there (at the client). You can also open an interface file within GUI and then click Save. Having selected a client the user can modify the templates to his needs within a text editor window on the client or open the interface within the GUI.

SEP sesam interfaces send messages by email if the email configuration is set. The default account is sesam.

Sesam offers the following interfaces: Pre-, Post-, Alarm-, Notify-, and the Disaster interface.

Interfaces pre.png

SEP sesam allows the use of Pre-, Post-, Alarm-, Notify-, and Disaster interfaces to be combined into scripts. A detailed description of these interfaces with all parameters and settings can be found in the Administration Manual.

Interfaces pre edit.png

PRE interface

Before a backup begins the user can specify several special actions that will be executed before and during the backup activity. For example, the system can generate messages notifying the user that the backup has or has not been completed successfully. You can enter end/start programs commands or you can have the system execute preparatory actions in the databases (i.e. Stop Database) you plan to backup. These actions can be programmed within the PRE-interface.

POST interface

Having finished the backup data transfer some special actions might also be needed (e.g. messages, program end/start, restart databases etc.). These actions can be programmed with the help of the post-interface.

Alarm interface

The SEP sesam system needs no administration after complete set-up of all clients and backup tasks during normal operation (except for the restore). If any functional errors occur, e.g. failure of a certain backup, this event is automatically passed on to the alarm-interface. This interface is programmable to filter desired messages and their conveyance to the authorised personnel.

Hint Do not use commands which require input from the user (OK-buttons etc.). Such commands may cause interruption of backups during the night.

Notify interface

Similarly, there's a procedure for successful backups and restores which uses the sm_notify. This can be programmed as needed.

Disaster interface

With disaster, the complete destruction of the SEP sesam server and its data is meant. In preparation for this, the so called disaster interface of SEP sesam is used. Therefore, the backup server is backing up its own data with normal backups. The metadata for these backups should be copied to other systems, so in case of disaster, this data is available to SEP sesam for recovery. After the installation of SEP sesam, a file stands by in path ./skel/templates/sm_disaster (sm_disaster.[cmd|ps1] in Windows), which the user can copy to ./bin/sesam/sm_disaster (sm_disaster.[cmd|ps1]) and change at will; this procedure is processed by all backups with the string DISASTER or SESAM in the task name. The following information is provided:

  • Label of the currently used medium.
  • The complete restore command, with which the data of the saveset can be restored from the tape or


For details, see SEP sesam Disaster Recovery.

User view

Available for v. ≤ 4.4.3. Based on the user permissions, certain SEP sesam GUI elements (Components, Tasks and Scheduling) are disabled when the user view is changed from Admin to Operator.
There are two types of user views: Admin and Operator. Only the Admin has full control over the SEP sesam, while Operator is only allowed to monitor SEP sesam events and logs on GUI client.

For more details, see SEP sesam GUI.

Configuration user view.png