4 4 3 Beefalo:Configuration: Difference between revisions

From SEPsesam
(Added anchor.)
(Added Jaglion-related screenshot (currently commented out).)
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<translate>
<translate>
<!--T:214-->
<noinclude><div class="noprint"><languages />
<noinclude><div class="noprint"><languages />
{{Template:Navigator_Beefalo/en|Activities|Activities|Window|Window}}</div></noinclude></translate>
{{Template:Navigator_Beefalo/en|Activities|Activities|Window|Window}}</div></noinclude></translate>




<translate>
<translate>
==={{anchor|GUI configuration options}}GUI configuration options ===               
==={{anchor|GUI configuration options}}GUI configuration options === <!--T:216-->                


<!--T:217-->
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.
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.


[[Image:Configuration_overview_Beefalo.jpg|350px|link=]]</translate>
<!--T:218-->
[[Image:Configuration_overview_Beefalo.jpg|830px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>===={{anchor|defaults}}Defaults====   
<translate>===={{anchor|defaults}}Defaults==== <!--T:219-->  


Under ''Defaults'', you can define the access to SEP sesam online help, change UI mode, customise the GUI font and tables, set the date format, set retention periods for logs and restore tasks, define some extra settings, configure the default permissions and check the settings.  
<!--T:359-->
The options in the ''Defaults'' window allow you to change UI mode, customize GUI font and tables, set the preferred date format, retention periods for logs and restore tasks, define advanced settings (Extras), configure default permissions, and add or modify SEP sesam keys in the global settings.


'''''General tab'''''
<!--T:221-->
'''''{{anchor|general}}General tab'''''</translate>


*{{anchor|Beefalo}}'''''UI Mode''''': You can select between different UI modes: ''Basic'', ''Advanced'' or ''Expert''. For example, basic mode makes GUI simpler for less advanced users, but in the expert and  advanced mode some additional options are available, e.g., ''Expert Options'' button in the restore wizard.  
*<translate><!--T:360--> '''''Common''''' (available in ≥ SEP sesam 4.4.3 ''Beefalo V2''):</translate>
*'''''Filter panels''''': You can select that filter panels are not hidden automatically by checking ''Show filter panels by default'' option.  
**<translate><!--T:361--> '''''Show SEP sesam web client landing page on startup''''': By default, SEP sesam Web UI landing page is opened when the GUI is started. Deselect the check box to prevent it from opening automatically when starting SEP sesam GUI.</translate>
*'''''Help''''': By default, the option ''Link to WEB help file'' is set. The online help is set to the SEP sesam Wiki main page, thus providing the latest updated version of help topics online. You can use the ''Test It'' button to check the access to help files.</translate>
**<translate><!--T:362--> '''''Use HTTPS for opening links in the external browser''''': By default, SEP sesam GUI opens the external links by using the ''HTTP'' protocol. By selecting the check box, you can enforce the usage of ''HTTPS'' protocol for external links. In this case, you have to accept the Sesam REST server security certificate.</translate>
<!--**<translate><!--T:377--> '''''Sort case insensitive''''': As of v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], you can enable the ''Sort case insensitive'' check box to ensure that upper- and lowercase letters are treated the same when sorting results.</translate>--> 
*<translate><!--T:222--> {{anchor|Beefalo}}'''''UI Mode''''': You can select between different UI modes: ''Basic'', ''Advanced'' or ''Expert''. For example, basic mode makes GUI simpler for less advanced users, but the advanced and expert mode provide some additional options that help you fine-tune SEP sesam operations, e.g., the ''Expert Options'' button in the restore wizard is only available in the ''Expert'' UI mode.</translate>
*<translate><!--T:223--> '''''Filter panels''''': You can select that filters are displayed/visible the whole time by enabling the option ''Show filter panels by default''. <!--As of v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], you can also set a delay (in seconds) for reloading data when changing the filter(s).--></translate>
*<translate><!--T:224-->
'''''Help''''': The field ''Link to WEB help file'' sets the path to the SEP sesam Wiki main page, thus providing the latest updated version of help topics online. Use the ''Test It'' button to check the access to help files.


<translate>
<!--T:225-->
[[Image:Defaults_general_Beefalo.jpg|link=]]</translate>
[[Image:Defaults_general_Beefalo_V2.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>
<!--[[Image:Defaults_general_Jaglion.jpg|540px|link=]]
<br clear=all>-->


<translate>
<translate>
<!--T:226-->
'''''{{anchor|font}}Fonts and Tables tab'''''
'''''{{anchor|font}}Fonts and Tables tab'''''


You can customize your SEP sesam GUI appearance by changing:
<!--T:227-->
You can customize your SEP sesam GUI appearance by changing:</translate>
 
<ul></li><translate><!--T:228--> '''''Font''''': The predefined GUI font is plain. You can select ''Choose'' button to change the default font, font style and/or size.</translate></li>
 
<translate><!--T:364-->
{{Tip|You can reset GUI font settings to SEP sesam default at any time by using the ''Reset to Default'' button.}}</translate>


* '''''Font''''': The predefined GUI font is plain. You can select ''Choose'' button to change the default font, font style and/or size.
<li><translate><!--T:229--> '''''Font used in tables and trees''''': You can change the default font (proportional) to non-proportional (monospaced).</translate></li>


* '''''Font used in tables and trees''''': You can change the default font (proportional) to non-proportional (monospaced).
<li><translate><!--T:230-->
'''''Table Striping''''': You can change the appearance of GUI tables by selecting one of the zebra striping tables from the drop-down list.</translate></li>


* '''''Table Striping''''': You can change the appearance of GUI tables by selecting one of the zebra striping tables from the drop-down list.
<li><translate><!--T:363-->
'''''Date range''''' (available in ≥ SEP sesam 4.4.3 ''Beefalo V2''): You can set the date range for the displayed data by specifying the ''Maximum number of days'' for which the SEP sesam GUI will show the data. By default, it is set to -1 = unlimited.</translate></li></ul>


[[Image:Defaults_fonts_Beefalo.jpg|link=]]</translate>
<translate><!--T:231-->
[[Image:Defaults_fonts_Beefalo_V2.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>
You can reset GUI to SEP sesam default at any time.


<translate>
<translate><!--T:233-->
'''''Display Format tab'''''
'''''{{anchor|format}}Display Format tab'''''


<!--T:212-->
<!--T:212-->
Line 49: Line 69:


<!--T:213-->
<!--T:213-->
[[Image:Defaults_display_format_Beefalo.jpg|link=]]</translate>
[[Image:Defaults_display_format_Beefalo.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate>
<!--T:234-->
{{anchor|install_update}}'''''Install/Update tab'''''
{{anchor|install_update}}'''''Install/Update tab'''''


Under the tab ''Install/Update'', you can set the desired ''Update mode''. By default, SEP sesam checks for updates automatically and updates its database accordingly without automatically installing the update; an icon (yellow '''↓''') notifying the user that an update is available is shown for the respective client and a popup notification on hover suggests that there is a new version available. The following options are available:
<!--T:235-->
The tab ''Install/Update'' allows you to set the desired ''Update mode''. By default, SEP sesam does not check, download and install updates. An icon (yellow '''↓''') notifying the user that an update is available is shown for the respective client and a popup notification on hover suggests that there is a new version available.  


*'''''Do not download or install any updates''''' (default):  If selected, updates will not be automatically downloaded and installed when a new version is available.
<!--T:365-->
*'''''Download updates automatically, but install manually''''': If selected, updates will be automatically downloaded, but you have to install them manually.
Depending on SEP sesam version (''Beefalo V1'' or v. ≥ ''Beefalo V2''), the following options are available:</translate>
*'''''Download and install updates automatically (at Sesam newday)''''': If selected, updates will be automatically downloaded and installed based on [[Special:MyLanguage/SEP_sesam_Glossary#NEWDAY|SEP sesam NEWDAY]], when a new version is available in the [https://download.sep.de/ SEP Download Center].
*<translate><!--T:366--> '''''Turn off (hide from all users)''''' (available in ≥ ''Beefalo V2''): If selected, the ''install and update'' feature is not shown in the GUI. No install/update options are visible for any of the users, not even the administrator until this mode is switched on.</translate>
*<translate><!--T:367--> '''''Do not check or install automatically''''' (default) (in ''Beefalo V1'': ''Do not download or install any updates''):  If selected, updates are not checked, downloaded nor installed when a new version is available.</translate>
*<translate> <!--T:368--> '''''Check automatically, but install manually''''' (in ''Beefalo V1'': ''Download updates automatically, but install manually''): If selected, updates are checked by using <tt>index.txt</tt> from [https://download.sep.de/ SEP Download Center] to get the list of all available packages, but you have to download and install them manually.</translate>
*<translate><!--T:369-->
'''''Check, download and install automatically''''' (in ''Beefalo V1'': ''Download and install updates automatically''): If selected, updates are automatically checked, downloaded and installed, based on [[Special:MyLanguage/SEP_sesam_Glossary#NEWDAY|SEP sesam NEWDAY]], when a new version is available in the [https://download.sep.de/ SEP Download Center]. This option may not be recommended depending on the configuration of your SEP sesam environment and its activity.


<!--T:370-->
You can also update your SEP sesam Clients by ''using a SEP sesam custom package source'' which may be stored locally, on the network drive, or is available at specified URL. The advantage of using a custom package is that you have full control over the version that is getting installed. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Updating_SEP_sesam#custom_package|Using custom SEP sesam package source]].


[[Image:Default_install_update_Beefalo.jpg|link=]]</translate>
<!--T:371-->
[[Image:Defaults_install_BeefaloV2.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate>
'''''Retention Periods tab'''''  
<!--T:240-->
'''''{{anchor|retention}}Retention Periods tab'''''  


You can set up the retention period in days for ''SEP sesam logs'', ''readability 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.
<!--T:241-->
You can set up the retention period in days for ''SEP sesam logs'', ''readability 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.</translate>


<!--T:133-->
*<translate><!--T:242--> '''''SEP sesam logs''''': The default value for preserving the SEP sesam log files is 7 days.</translate>
* '''''SEP 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.
*<translate><!--T:243--> '''''Readability check logs''''': The default value for preserving the readability check log files is 2190 days.</translate>


* '''''Calendar sheet entries''''': The default retention time for old calendar sheet entries is 35 days.
*<translate><!--T:244--> '''''Calendar sheet entries''''': The default retention time for old calendar sheet entries is 35 days.</translate>


* '''''Restore tasks''''': The default retention time for old restore tasks is 7 days.
*<translate><!--T:245-->
'''''Restore tasks''''': The default retention time for old restore tasks is 7 days.


<!--T:134-->
<!--T:246-->
[[Image:Defaults_retention_ periods_Beefalo.jpg|link=]]</translate>
[[Image:Defaults_retention_ periods_Beefalo.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate><!--T:247-->
<!--T:121-->
'''''{{anchor|extras}}Extras tab'''''
'''''Extras tab'''''


<!--T:123-->
<!--T:248-->
Under the ''Extras tab'', the following settings can be activated:
Under the ''Extras tab'', the following settings can be activated:</translate>


<!--T:124-->
*<translate><!--T:249--> '''''Switch off the scrolling for warning "30 days remaining for maintenance authorization"''''': 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.</translate><!-- Is this reset back to default? -->
* '''''Switch off the scrolling for warning "30 days remaining for maintenance authorization"''''': 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.</translate><!-- Is this reset back to default? -->
*<translate><!--T:250--> '''''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.</translate>
*<translate><!--T:251--> '''''Number of trace log lines to display''''': The default value for trace log lines is 60. Click the arrows to increase or decrease the number of lines.</translate>
*<translate><!--T:252--> '''''RSS notification polling interval''''': The default polling interval for RSS notification is 720 minutes. Click the arrows to increase or decrease the polling interval.</translate>
*<translate><!--T:253--> '''''Compress LIS files''''': By default, the LIS files are compressed after 14 days. You can change the number of days after which the LIS files are compressed or deactivate the checkbox to prevent compression of LIS files.</translate>
*<translate><!--T:254--> '''''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 [[Special:MyLanguage/Changed_Block_Tracking_(CBT)| Changed Block Tracking (CBT)]].</translate>
*<translate><!--T:372--> '''''Log Download''''': In SEP sesam ≥ [[SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']], you can set the maximum size of the log files archive. The default is 25 MiB (0 = unlimited).</translate>
*<translate><!--T:373-->
'''''Task name template''''': You can configure your own template to define the desired syntax of the backup task name. The backup task name is then generated automatically according to the new template whenever you create a new backup task. The template applies to all backup task types, except in the case that a different template has been entered directly into the SEP sesam database to be applied to the specific task type. For more details on template usage, see [[Special:MyLanguage/4_4_3_Beefalo:Task_Name_Template_–_Backup|Task Name Template – Backup]].


<translate>
<!--T:256-->
<!--T:125-->
[[Image:Defaults_extras_Beefalo_V2.jpg|530px|link=]]</translate>
* '''''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.
 
<!--T:126-->
* '''''Number of trace log lines to display''''': The default value for trace log lines is 60. Click the arrows to increase or decrease the number of lines.</translate>
 
<translate>
<!--T:127-->
* '''''RSS notification polling interval''''': The default polling interval for RSS notification is 720 minutes. Click the arrows to increase or decrease the polling interval.
 
<!--T:130-->
* '''''Compress LIS files''''': By default, the LIS files are compressed after 14 days. You can change the number of days after which the LIS files are compressed or deactivate the check box to prevent compression of LIS files.</translate>
 
<translate>
<!--T:131-->
* '''''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 [[Special:MyLanguage/Changed_Block_Tracking_(CBT)| Changed Block Tracking (CBT)]].
 
* '''''Task name template''''': You can configure a template to generate backup task name automatically, when creating new backup tasks. Note that the template applies to all task types, except if a task type provides its own template.
 
<!--T:122-->
[[Image:Defaults_extras_Beefalo.jpg|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate><!--T:257-->
'''''Permissions tab'''''  
'''''{{anchor|permissions}}Permissions tab'''''  


<!--T:258-->
You can configure the default permissons (ACLs) for all top level locations by simply selecting or adding the relevant user or group (''ADMIN'', ''OPERATOR'', ''BACKUP'' or ''RESTORE''), and enabling or disabling access (to locations) per user/group. For details on how to configure ACLs for a specific location or client, see [[Special:MyLanguage/4_4_3_Grolar:Using_Access_Control_Lists|Using Access Control Lists]].  
You can configure the default permissons (ACLs) for all top level locations by simply selecting or adding the relevant user or group (''ADMIN'', ''OPERATOR'', ''BACKUP'' or ''RESTORE''), and enabling or disabling access (to locations) per user/group. For details on how to configure ACLs for a specific location or client, see [[Special:MyLanguage/4_4_3_Grolar:Using_Access_Control_Lists|Using Access Control Lists]].  


<!--T:134-->
<!--T:259-->
[[Image:Defaults_permissions_Beefalo.jpg|link=]]</translate>
[[Image:Defaults_permissions_Beefalo.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate><!--T:260-->
<!--T:138-->
'''''{{anchor|settings}}Settings tab'''''
'''''Settings tab'''''


<!--T:139-->
<!--T:261-->
The ''Settings'' tab displays an overview of all internal GUI settings.  
The ''Settings'' tab displays an overview of all internal GUI settings. You can insert or modify the keys, for example, to set up customized retention policy. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Managing_EOL#keys|Customizing retention policy]].  


<!--T:140-->
<!--T:262-->
[[Image:Defaults_settings_Beefalo.jpg|link=]]</translate>
[[Image:Defaults_settings_Beefalo.jpg|530px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>===={{anchor|media_type}}Media types====  
<translate>===={{anchor|media_type}}Media types==== <!--T:263-->


''Media Types'' window lists all media types defined in SEP sesam. Entries in black font are the media types currently used. They were set up in the database at the installation of SEP sesam and – contrary to the user defined media types (green font) – cannot be erased nor changed.
<!--T:264-->
''Media Types'' window lists all media types defined in SEP sesam. Entries in black font are the media types currently used. They were set up in the database at the installation of SEP sesam and – contrary to the user defined media types (green font) – cannot be erased nor changed.</translate>


*'''''Media Type''''': Shows SEP sesam internal identification of the media type.
*<translate><!--T:265--> '''''Media Type''''': Shows SEP sesam internal identification of the media type.</translate>
*'''''Drive Type''''': Displays SEP sesam internal drive types.
*<translate><!--T:266--> '''''Drive Type''''': Shows SEP sesam internal drive types.</translate>
*'''''Capacity''''': Presents storage capacity of allowed media and drive combination.
*<translate><!--T:267-->
'''''Capacity''''': Presents storage capacity of allowed media and drive combination. This combination determines which media can be inserted into which drives.


[[Image:Defaults_settings_Beefalo.jpg|link=]]</translate>
<!--T:268-->
[[Image:Media_types_Beefalo.jpg|680px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate>===={{anchor|command}}Command==== <!--T:269-->  
===={{anchor|command}}Command==== <!--T:147-->


<!--T:270-->
You can create and define your own commands to be used for various tasks within SEP sesam environment.
You can create and define your own commands to be used for various tasks within SEP sesam environment.


<!--T:149-->
<!--T:271-->
When configuring a new command, you have to define the following:
When configuring a new command, you have to define the following:</translate>
* '''''Name''''': Enter a name for the new event.   
*<translate><!--T:272--> '''''Name''''': Enter the name for a new command.</translate>  
* '''''Client''''': Select a client, on which the command will be executed.
*<translate><!--T:273--> '''''Client''''': Select a client, on which the command will be executed.</translate>
* '''''User''''': Enter the user name of a user with sufficient access to execute the command on the client.
*<translate><!--T:274--> '''''User''''': Enter a user name of the user with sufficient access to execute the command on the client.</translate>
* '''''Command''''': Enter the complete command (and parameters, if required), e.g., ''eventlog.ps1''.
*<translate><!--T:275-->
'''''Command''''': Enter the complete command (and parameters, if required), e.g., <tt>eventlog.ps1</tt>.


<!--T:148-->
<!--T:276-->
[[image:Configuration_commands_Beefalo.jpg|link=]]</translate>
[[image:Configuration_commands_Beefalo.jpg|680px|link=]]</translate>
<br clear=all>
<br clear=all>


<!--T:150-->
{{<translate><!--T:277--> Note</translate>|<translate><!--T:278--> When defining your own commands, some security considerations apply and are explained in [[Special:MyLanguage/4_4_3_Beefalo:Schedules#access_restriction|Access restriction of command events]].</translate>}}
{{<translate><!--T:224-->
Note</translate>|
<translate><!--T:225-->
When defining your own commands, some security considerations apply and are explained in [[Special:MyLanguage/4_4_3_Beefalo:Schedules#access_restriction|Access restriction of command events]].</translate>}}


<translate>===={{anchor|remote server}}Remote server (Master GUI only)====  
<translate>===={{anchor|remote server}}Remote server (Master GUI only)==== <!--T:279-->


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.</translate>
<!--T:280-->
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 (''menu bar'' -> ''Configuration'' -> ''Remote Server'').</translate>


{{<translate>Note</translate>|<translate>
{{<translate><!--T:281--> Note</translate>|<translate>
The menu option is only available in the SEP sesam version ''Master Sesam''.</translate>}}
<!--T:282-->
<translate>
The Remote Server option is only available in the SEP sesam Master GUI.</translate>}}
*'''''Server name''''': Name of the additional SEP sesam Server in the network.
*<translate><!--T:283--> '''''Server Name''''': The name of the SEP sesam Server in the network.</translate>
*'''''Connection''''': Shows if Server is in the network (green = ''ON'', red = ''broken'', gray = ''OFF'').
*<translate><!--T:284--> '''''Connection''''': Shows if the Server is connected to the network (green = ''ON'', red = ''broken'', gray = ''OFF'').</translate>
*'''''GUI build''''': Displays GUI version.
*<translate><!--T:285--> '''''GUI Build''''': Displays the GUI version.</translate>
*'''''Operating system''''': OS of the SEP sesam Server.
*<translate><!--T:286-->
'''''Operating System''''': OS of the SEP sesam Server.


[[Image:Remoteserver_en.jpg|link=]]</translate>
<!--T:287-->
[[Image:Master_GUI_remote_server_Beefalo_V2.jpg|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate>
The ''Master GUI'' allows the administrator control of all SEP sesam servers and clients.
<!--T:374-->
The ''Master GUI'' allows the administrator to control all SEP sesam Servers in the SEP sesam environment.


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.    
<!--T:375-->
When adding a new server to the SEP sesam Master GUI, the following parameters must be set.</translate>    
      
      
*'''''Server name''''': Name of the SEP sesam Server.
*<translate><!--T:376--> '''''Server name''''': Enter the name of the SEP sesam remote Server that you want to administer by using the master GUI.</translate>
*'''''Connection''''': You can switch the connection ''ON'' or ''OFF''.
*<translate><!--T:291--> '''''Connection''''': You can set the connection to the server (''ON'' or ''OFF'').</translate>
*'''''RMI port''''': Define port number for client-server connection.     
*<translate><!--T:292--> '''''Port''''': Define the port number for the client-server connection.</translate>    
*'''''Comment''''': Optionally, you can add a comment.
*<translate><!--T:293-->
'''''Note''''': Optionally, you can add a comment.


[[Image:Newremoteserver 4.0 en.jpg|link=]]</translate>     
<!--T:294-->
[[Image:Master_GUI_new_remote_server_Beefalo_V2.jpg|link=]]</translate>     
<br clear=all>
<br clear=all>


<translate>
<translate>===={{anchor|user_permissions}}User Permissions ==== <!--T:295-->
===={{anchor|user_permissions}}User Permissions ====  


<!--T:296-->
The ''User Permissions'' item is only visible if policy-based authentication is activated (default). For details, see [[Special:MyLanguage/Configuring_Policy-Based_Authentication|Configuring Policy-Based Authentication]].
The ''User Permissions'' item is only visible if policy-based authentication is activated (default). For details, see [[Special:MyLanguage/Configuring_Policy-Based_Authentication|Configuring Policy-Based Authentication]].


[[Image:User_permissions_Beefalo.jpg|link=]]</translate>
<!--T:297-->
[[Image:User_permissions_Beefalo.jpg|680px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate>
In the ''User Permissions'' you can configure the user authorization. Options are ''admin'' (the only user role with full control over the SEP sesam), ''operator'' (monitors the SEP sesam Server backup status), ''backup'' (only allowed to start backups) and ''restore'' (only allowed to start restores). 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.
<!--T:298-->
In the ''User Permissions'' you can configure the user authorization. Options are ''admin'' (the only user role with full control over the SEP sesam), ''operator'' (monitors the SEP sesam Server backup status), ''backup'' (only allowed to start backups) and ''restore'' (only allowed to start restores). 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.


[[File:New_users_permission_Beefalo.jpg|link=]]</translate>
<!--T:299-->
[[File:New_users_permission_Beefalo.jpg|380px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>'''''Note 1:'''''  
<translate><!--T:300-->
'''''Note 1:'''''  
 
<!--T:301-->
If the name resolution for the selected client is not complete (IP name and reverse lookup of the IP address), the connection is also rejected!
If the name resolution for the selected client is not complete (IP name and reverse lookup of the IP address), the connection is also rejected!


<!--T:302-->
'''''Note 2:''''' Alternatively the SEP sesam program <tt>sm_setup</tt> can be utilized to assign user permissions:</translate>
'''''Note 2:''''' Alternatively the SEP sesam program <tt>sm_setup</tt> can be utilized to assign user permissions:</translate>
<ul><li><translate>Adding a  user permission:</translate></li>
<ul><li><translate><!--T:303--> Adding a  user permission:</translate></li>
  sm_setup allow_gui -u *|<translate><user></translate> -c *|<translate><client></translate> -m admin|operator|restore
  sm_setup allow_gui -u *|<translate><!--T:304--> <user></translate> -c *|<translate><!--T:305--> <client></translate> -m admin|operator|restore
<li><translate>Removing a user permission:</translate></li>
<li><translate><!--T:306--> Removing a user permission:</translate></li>
  sm_setup disallow_gui -u *|<translate><user></translate> [-c *|<translate><client></translate>] [-m *|admin|operator|restore]
  sm_setup disallow_gui -u *|<translate><!--T:307--> <user></translate> [-c *|<translate><!--T:308--> <client></translate>] [-m *|admin|operator|restore]
<li><translate>View permissions of users or clients:</translate></li>
<li><translate><!--T:309--> View permissions of users or clients:</translate></li>
  sm_setup get_policy [-m user|client]
  sm_setup get_policy [-m user|client]
</ul>
</ul>


<translate>===={{anchor|permission_management}}Permission Management====  
<translate>===={{anchor|permission_management}}Permission Management==== <!--T:310-->
 
<!--T:311-->
Introduced in v. 4.4.3, SEP sesam provides different [[Special:MyLanguage/SEP_sesam_Glossary#authentication|authentication]] methods that are mutually exclusive. For details, see [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]].  
Introduced in v. 4.4.3, SEP sesam provides different [[Special:MyLanguage/SEP_sesam_Glossary#authentication|authentication]] methods that are mutually exclusive. For details, see [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]].  


<!--T:312-->
Depending on which authentication mode is active, one of the following options is shown:</translate>
Depending on which authentication mode is active, one of the following options is shown:</translate>
<ul><li><translate>Policy-based authentication is enabled by default. You can switch to database-based authentication by using the '''''Activate Authentication''''' button in the ''Permission Management'' window. If you choose not to activate the database-based authentication, policy-based authentication stays enabled. Policy-based authentication is configured in '''''User Permissions''''' (see previous menu option). For details, see [[Special:MyLanguage/Configuring_Policy-Based_Authentication|Configuring Policy-Based Authentication]].</translate></li>  
<ul><li><translate><!--T:313--> Policy-based authentication is enabled by default. You can switch to database-based authentication by using the '''''Activate Authentication''''' button in the ''Permission Management'' window. If you choose not to activate the database-based authentication, policy-based authentication stays enabled. Policy-based authentication is configured in '''''User Permissions''''' (see previous menu option). For details, see [[Special:MyLanguage/Configuring_Policy-Based_Authentication|Configuring Policy-Based Authentication]].</translate></li>  
<li><translate>When you turn on database-based authentication by using the '''''Activate Authentication''''' button, upon the restart of a GUI and SEP sesam client, you can use any of the 5 available tabs: ''Users'', ''Groups'', ''External Groups'', ''Sources'' and ''Activation''. You can create users, modify their settings, such as adding a user to the group or removing it from the group, delete users, create external groups and add the authentication sources for the LDAP/AD authentication. You can also deactivate the database-based authentication. For details on LDAP/AD authentication, see [[Special:MyLanguage/4_4_3_Beefalo:Configuring_LDAP/AD_Authentication|Configuring LDAP/AD Authentication]].</translate></li>
<li><translate><!--T:314--> When you turn on database-based authentication by using the '''''Activate Authentication''''' button, upon the restart of a GUI and SEP sesam client, you can use any of the 5 available tabs: ''Users'', ''Groups'', ''External Groups'', ''Sources'' and ''Activation''. You can create users, modify their settings, such as adding a user to the group or removing it from the group, delete users, create external groups and add the authentication sources for the LDAP/AD authentication. You can also deactivate the database-based authentication. For details on LDAP/AD authentication, see [[Special:MyLanguage/Configuring_LDAP/AD_Authentication|Configuring LDAP/AD Authentication]].</translate></li>


<translate><!--T:246-->
<translate><!--T:315--> [[Image:Authentication_permission_management_Beefalo.jpg|780px|link=]]</translate>
[[Image:Authentication_permission_management_Beefalo.jpg|link=]]</translate>
<br clear=all>
<br clear=all>
</ul>
</ul>


<translate>===={{anchor|mail}}Email Settings==== <!--T:247-->
<translate>===={{anchor|mail}}Email Settings==== <!--T:316-->  


<!--T:248-->
<!--T:317-->
The email settings allow to configure the email accounts that can be used for sending emails from the SEP sesam interface or from the command line. The default email account is ''sesam''.   
The email settings allow to configure the email accounts that can be used for sending emails from the SEP sesam interface or from the command line. The default email account is ''sesam''.   


<!--T:167-->
<!--T:318-->
[[Image:Configuration_email_Beefalo.jpg|700px|link=]]</translate>
[[Image:Configuration_email_Beefalo.jpg|780px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
<translate><!--T:319-->
<!--T:168-->
By clicking ''New'', the ''Email Account'' window opens:
By clicking ''New'' the following window is opened:


<!--T:169-->
<!--T:320-->
[[Image:Email_account_Beefalo.jpg|600px|link=]]</translate>
[[Image:Email_account_Beefalo.jpg|730px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>
*<translate><!--T:321--> '''''Account''''': Name of the account (mandatory)</translate>
<!--T:170-->
*<translate><!--T:322--> '''''Customer''''': Name of the customer</translate>
*'''''Account''''': Name of the account (mandatory)
*<translate><!--T:323--> '''''Sender''''': Email address of the sender</translate>
*'''''Customer''''': Name of the customer
*<translate><!--T:324--> '''''SMTP server''''': Name or IP address of the outgoing mail server</translate>
*'''''Sender''''': Email address
*<translate><!--T:325--> '''''SMTP user''''': User name for SMTP server</translate>
*'''''SMTP server''''': Name or IP address of the outgoing mail server
*<translate><!--T:326--> '''''Password''''': Password for the mail server. Password is mandatory if SMTP server requires authentication.</translate>
*'''''SMTP user''''': User name for SMTP server</translate>
*<translate><!--T:327--> '''''SMTP port''''': Optionally, specify the SMTP port.</translate>
<translate>
*<translate><!--T:328--> '''''Recipient''''': Email address of the recipient</translate>
<!--T:171-->
*<translate><!--T:329--> '''''CC''''': Email address for copy of the email</translate>
*'''''Password''''': Password for the mail server. Password is mandatory if SMTP server requires authentication.
*<translate><!--T:330--> '''''BCC''''': Email address for hidden copy of the email</translate>
*'''''SMTP port''''': Optionally, specify the SMTP port.
*<translate><!--T:331-->
*'''''Recipient''''': Email address of the recipient
'''''SSL''''': Optionally, you can select to connect securely via SSL or TLS.
*'''''CC''''': Email address for copy of the email
*'''''BCC''''': Email address for hidden copy of the email
*'''''SSL''''': Optionally, you can select to connect securely via SSL or TLS.


<!--T:172-->
<!--T:332-->
If no SMTP user name is specified, it is assumed that no authorization is required at the SMTP server.
If no SMTP user name is specified, it is assumed that no authorization is required at the SMTP server.


===={{anchor|interfaces}}Interfaces==== <!--T:323-->              
===={{anchor|interfaces}}Interfaces==== <!--T:333-->            


<!--T:174-->
<!--T:334-->
User interfaces are configurable programs, intended for system administrators that can use them to create their own commands. They can be used to perform additional actions, such as exporting a database, restarting a database, and sending emails. The following interfaces are available: [[Special:MyLanguage/SEP_sesam_Glossary#pre|pre]] (sbc_pre), [[Special:MyLanguage/SEP_sesam_Glossary#post|post]] (sbc_post), [[Special:MyLanguage/SEP_sesam_Glossary#alarm|alarm]] (sm_alarm), [[Special:MyLanguage/SEP_sesam_Glossary#disaster|disaster]] (sm_disaster) and  [[Special:MyLanguage/SEP_sesam_Glossary#notify|notify]] (sm_notify). The pre/post-interface might affect backup execution; when creating a script, have in mind that any pre/post script should not take a long time to complete as it can delay the backup.
User interfaces are configurable programs, intended for system administrators that can use them to create their own commands. They can be used to perform additional actions, such as exporting a database, restarting a database, and sending emails. The following interfaces are available:  
[[Special:MyLanguage/SEP_sesam_Glossary#pre|pre]] (sbc_pre), [[Special:MyLanguage/SEP_sesam_Glossary#post|post]] (sbc_post), [[Special:MyLanguage/SEP_sesam_Glossary#alarm|alarm]] (sm_alarm), [[Special:MyLanguage/SEP_sesam_Glossary#disaster|disaster]] (sm_disaster) and  [[Special:MyLanguage/SEP_sesam_Glossary#notify|notify]] (sm_notify). The pre/post-interface might affect backup execution; when creating a script, have in mind that any pre/post script should not take a long time to complete as it can delay the backup.


<!--T:178-->
<!--T:335-->
[[Image:Interfaces_pre_Beefalo.jpg|link=]]</translate>
[[Image:Interfaces_pre_Beefalo.jpg|310px|link=]]</translate>
<br clear=all><translate>
<br clear=all>


<!--T:175-->
<translate><!--T:336-->
User interfaces can be programmed using any text editor. To use an interface, you have to activate it first and create your own commands. From the ''Interfaces'' menu, select the '''''interface''''' you want to activate; if you are configuring a pre/post interface, you have to select a ''client'' too since these two interfaces are created for each client individually and are only executed on the selected 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 <tt><SESAM_ROOT>/bin/sesam</tt> directory. For details, see [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]].  
User interfaces can be programmed using any text editor. To use an interface, you have to activate it first and create your own commands. From the ''Interfaces'' menu, select the '''''interface''''' you want to activate; if you are configuring a pre/post interface, you have to select a ''client'' too since these two interfaces are created for each client individually and are only executed on the selected 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 <tt><SESAM_ROOT>/bin/sesam</tt> directory. For details, see [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]].  


<!--T:176-->
<!--T:337-->
Alternatively, you can activate the user interfaces by using the templates that are available in the SEP sesam directory <code><SESAM_ROOT>/skel/templates</code>. To activate an interface, you have to copy its corresponding template file to the directory <code><SESAM_ROOT>/bin/sesam</code>. The templates are only active and executed on the client.  
Alternatively, you can activate the user interfaces by using the templates that are available in the SEP sesam directory <code><SESAM_ROOT>/skel/templates</code>. To activate an interface, you have to copy its corresponding template file to the directory <code><SESAM_ROOT>/bin/sesam</code>. The templates are only active and executed on the client.  


<!--T:177-->
<!--T:338-->
If the email configuration is set, SEP sesam interfaces send messages by email. The default email account is ''sesam''. For details, see [[Special:MyLanguage/How_to_configure_Mail_Notification|How to configure Mail Notification]].  
If the email configuration is set, SEP sesam interfaces send messages by email. The default email account is ''sesam''. For details, see [[Special:MyLanguage/How_to_configure_Mail_Notification|How to configure Mail Notification]].  


<!--T:179-->
<!--T:339-->
SEP sesam allows the use of Pre-, Post-, Alarm-, Notify-, and Disaster interfaces to be combined into scripts.  
SEP sesam allows the use of Pre-, Post-, Alarm-, Notify-, and Disaster interfaces to be combined into scripts.  


[[Image:Interfaces_pre_edit_Beefalo.jpg|link=]]</translate>
<!--T:340-->
[[Image:Interfaces_pre_edit_Beefalo.jpg|630px|link=]]</translate>
<br clear=all>
<br clear=all>


<translate>====={{anchor|pre}}''PRE interface''===== <!--T:180-->
<translate>====={{anchor|pre}}''PRE interface''===== <!--T:341-->  
 
<!--T:342-->
Before a backup starts, an administrator can specify special actions to be executed before and during the backup activity. For example, the system can generate messages to quickly notify the administrator of either backup job success or failure. Pre-interface can be used to create commands that will stop or start the selected programs; for example, it may be used to stop the database before it is backed up.


<!--T:181-->
====={{anchor|post}}''POST interface''===== <!--T:343-->              
Before a backup begins, an administrator can specify special actions to be executed before and during the backup activity. For example, the system can generate messages to quickly notify the administrator of either backup job success or failure. Pre-interface can be used to create commands that will stop or start the selected programs; for example, it may be used to stop the database before it is backed up.


====={{anchor|post}}''POST interface''===== <!--T:324-->              
<!--T:344-->
Once the backup is finished, some special actions may be required (e.g., notifications/messages, program end/start, restart databases etc.). These actions can be programmed by using the post-interface.


<!--T:183-->
====={{anchor|alarm}}''Alarm interface''===== <!--T:345-->                
Once the backup is finished, some special actions may be required (e.g., notifications/messages, program end/start, restart databases etc.). These actions can be programmed with the help of the post-interface.


====={{anchor|alarm}}''Alarm interface''===== <!--T:325-->              
<!--T:346-->
The SEP sesam system needs no special administration during normal operation once SEP sesam Clients are set up and backup tasks are scheduled (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 transmission to the authorized person.


<!--T:185-->
<!--T:358-->
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 authorized personnel.
If a license violation has occurred and the alarm interface is activated, an email with the license violation information is sent to the SEP sesam account. The license violations occur when you exceed the conditions set in your license, such as the maximum volume size, the maximum number of configured clients, not licensed backup task types (e.g., ''BSR''), etc. The 16th day upon receiving the violation alarm SEP sesam backups are temporarily stopped until the issue is fixed, while the restores are still available. To avoid license violations, review your license; go to ''SEP sesam GUI'' -> ''Help'' -> ''License info''. For details, see [[Special:MyLanguage/Licensing#administration|License administration]].</translate>


<!--T:186-->
{{<translate><!--T:347--> note</translate>|<translate><!--T:348--> Do not use commands which require input from the user, such as ''OK'' buttons. Commands that require user interaction may cause interruption of backups during the night.</translate>}}
{{note|Do not use commands which require input from the user, such as ''OK'' buttons. Commands that require user interaction may cause interruption of backups during the night.}}


====={{anchor|notify}}''Notify interface''===== <!--T:326-->              
<translate>====={{anchor|notify}}''Notify interface''===== <!--T:349-->        


<!--T:188-->
<!--T:350-->
Similarly, there is a procedure for successful backups and restores which uses the <tt>sm_notify</tt>. This can be programmed as needed.
Similarly, there is a procedure for successful backups and restores which uses the <tt>sm_notify</tt>. This can be programmed as needed.


====={{anchor|disaster}}''Disaster interface''===== <!--T:327-->              
====={{anchor|disaster}}''Disaster interface''===== <!--T:351-->              


<!--T:190-->
<!--T:352-->
The term disaster refers to a catastrophic failure or complete destruction of the SEP sesam Server and its data. The SEP sesam disaster interface must be properly configured  to help carry out the disaster recovery process. To prepare for a possible breakdown of the SEP sesam Server, a self-backup of the SEP sesam installation must be performed. For details on how to prepare, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]].  
The term disaster refers to a catastrophic failure or complete destruction of the SEP sesam Server and its data. The SEP sesam disaster interface must be properly configured  to help carry out the disaster recovery process. To prepare for a possible breakdown of the SEP sesam Server, a self-backup of the SEP sesam installation must be performed. For details on how to prepare, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]].  


<!--T:254-->
<!--T:353-->
The disaster interface sends an email describing the recovery procedure in the event of disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. The <tt>sm_disaster</tt> file is located in:
The disaster interface sends an email describing the recovery procedure in the event of disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. The <tt>sm_disaster</tt> file is located in:</translate>
*''Linux'': {{path|<SESAM_BIN>/skel/templates/sm_disaster}}
*''Linux'': {{path|<SESAM_BIN>/skel/templates/sm_disaster}}
*''Windows'': {{path|<SESAM_BIN>/skel/templates/sm_disaster.ps1}}
*''Windows'': {{path|<SESAM_BIN>/skel/templates/sm_disaster.ps1}}


<!--T:191-->
<translate><!--T:354-->
As an alternative to using ''Interfaces'' in GUI, the disaster interface file can also be copied to {{path|SESAM_BIN>/bin/sesam/sm_disaster}} and modified according to the needs of each environment. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]].
As an alternative to using ''Interfaces'' in the GUI, the disaster interface file can also be copied to {{path|SESAM_BIN>/bin/sesam/sm_disaster}} and modified according to the needs of each environment. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]].


<noinclude><div class="noprint">
<noinclude><div class="noprint">
===See also===  
===See also=== <!--T:355-->
[[Special:MyLanguage/4_4_3_Grolar:Using_Access_Control_Lists|Using Access Control Lists]] – [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]] – [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]] – [[Special:MyLanguage/How_to_configure_Mail_Notification|How to configure Mail Notification]] – [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]]  
[[Special:MyLanguage/4_4_3_Grolar:Using_Access_Control_Lists|Using Access Control Lists]] – [[Special:MyLanguage/4_4_3_Grolar:About_Authentication_and_Authorization|About Authentication and Authorization]] – [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]] – [[Special:MyLanguage/How_to_configure_Mail_Notification|How to configure Mail Notification]] – [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]]  


<!--T:356-->
{{Footer/en}}</noinclude></div></translate>
{{Footer/en}}</noinclude></div></translate>

Revision as of 12:58, 17 March 2021

Other languages:
<<<Back
Activities
User Manual
Next>>>
Window


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 Beefalo.jpg

Defaults

The options in the Defaults window allow you to change UI mode, customize GUI font and tables, set the preferred date format, retention periods for logs and restore tasks, define advanced settings (Extras), configure default permissions, and add or modify SEP sesam keys in the global settings.

General tab

  • Common (available in ≥ SEP sesam 4.4.3 Beefalo V2):
    • Show SEP sesam web client landing page on startup: By default, SEP sesam Web UI landing page is opened when the GUI is started. Deselect the check box to prevent it from opening automatically when starting SEP sesam GUI.
    • Use HTTPS for opening links in the external browser: By default, SEP sesam GUI opens the external links by using the HTTP protocol. By selecting the check box, you can enforce the usage of HTTPS protocol for external links. In this case, you have to accept the Sesam REST server security certificate.
  • UI Mode: You can select between different UI modes: Basic, Advanced or Expert. For example, basic mode makes GUI simpler for less advanced users, but the advanced and expert mode provide some additional options that help you fine-tune SEP sesam operations, e.g., the Expert Options button in the restore wizard is only available in the Expert UI mode.
  • Filter panels: You can select that filters are displayed/visible the whole time by enabling the option Show filter panels by default.
  • Help: The field Link to WEB help file sets the path to the SEP sesam Wiki main page, thus providing the latest updated version of help topics online. Use the Test It button to check the access to help files.

Defaults general Beefalo V2.jpg

Fonts and Tables tab

You can customize your SEP sesam GUI appearance by changing:

    Font: The predefined GUI font is plain. You can select Choose button to change the default font, font style and/or size.
    SEP Tip.png Tip
    You can reset GUI font settings to SEP sesam default at any time by using the Reset to Default button.
  • Font used in tables and trees: You can change the default font (proportional) to non-proportional (monospaced).
  • Table Striping: You can change the appearance of GUI tables by selecting one of the zebra striping tables from the drop-down list.
  • Date range (available in ≥ SEP sesam 4.4.3 Beefalo V2): You can set the date range for the displayed data by specifying the Maximum number of days for which the SEP sesam GUI will show the data. By default, it is set to -1 = unlimited.

Defaults fonts Beefalo V2.jpg

Display Format tab

Under the tab Display 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, etc.). For details, see Changing data size units.

Defaults display format Beefalo.jpg

Install/Update tab

The tab Install/Update allows you to set the desired Update mode. By default, SEP sesam does not check, download and install updates. An icon (yellow ) notifying the user that an update is available is shown for the respective client and a popup notification on hover suggests that there is a new version available.

Depending on SEP sesam version (Beefalo V1 or v. ≥ Beefalo V2), the following options are available:

  • Turn off (hide from all users) (available in ≥ Beefalo V2): If selected, the install and update feature is not shown in the GUI. No install/update options are visible for any of the users, not even the administrator until this mode is switched on.
  • Do not check or install automatically (default) (in Beefalo V1: Do not download or install any updates): If selected, updates are not checked, downloaded nor installed when a new version is available.
  • Check automatically, but install manually (in Beefalo V1: Download updates automatically, but install manually): If selected, updates are checked by using index.txt from SEP Download Center to get the list of all available packages, but you have to download and install them manually.
  • Check, download and install automatically (in Beefalo V1: Download and install updates automatically): If selected, updates are automatically checked, downloaded and installed, based on SEP sesam NEWDAY, when a new version is available in the SEP Download Center. This option may not be recommended depending on the configuration of your SEP sesam environment and its activity.

You can also update your SEP sesam Clients by using a SEP sesam custom package source which may be stored locally, on the network drive, or is available at specified URL. The advantage of using a custom package is that you have full control over the version that is getting installed. For details, see Using custom SEP sesam package source.

Defaults install BeefaloV2.jpg

Retention Periods tab

You can set up the retention period in days for SEP sesam logs, readability 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.

  • SEP 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 Beefalo.jpg

Extras tab

Under the Extras tab, the following settings can be activated:

  • Switch off the scrolling for warning "30 days remaining for maintenance authorization": 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 trace log lines to display: The default value for trace log 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.
  • Compress LIS files: By default, the LIS files are compressed after 14 days. You can change the number of days after which the LIS files are compressed or deactivate the checkbox to prevent compression of LIS files.
  • 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 (CBT).
  • Log Download: In SEP sesam ≥ 4.4.3 Beefalo V2, you can set the maximum size of the log files archive. The default is 25 MiB (0 = unlimited).
  • Task name template: You can configure your own template to define the desired syntax of the backup task name. The backup task name is then generated automatically according to the new template whenever you create a new backup task. The template applies to all backup task types, except in the case that a different template has been entered directly into the SEP sesam database to be applied to the specific task type. For more details on template usage, see Task Name Template – Backup.

Defaults extras Beefalo V2.jpg

Permissions tab

You can configure the default permissons (ACLs) for all top level locations by simply selecting or adding the relevant user or group (ADMIN, OPERATOR, BACKUP or RESTORE), and enabling or disabling access (to locations) per user/group. For details on how to configure ACLs for a specific location or client, see Using Access Control Lists.

Defaults permissions Beefalo.jpg

Settings tab

The Settings tab displays an overview of all internal GUI settings. You can insert or modify the keys, for example, to set up customized retention policy. For details, see Customizing retention policy.

Defaults settings Beefalo.jpg

Media types

Media Types window lists all media types defined in SEP sesam. Entries in black font are the media types currently used. They were set up in the database at the installation of SEP sesam and – contrary to the user defined media types (green font) – cannot be erased nor changed.

  • Media Type: Shows SEP sesam internal identification of the media type.
  • Drive Type: Shows SEP sesam internal drive types.
  • Capacity: Presents storage capacity of allowed media and drive combination. This combination determines which media can be inserted into which drives.

Media types Beefalo.jpg

Command

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

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

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

Configuration commands Beefalo.jpg

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 (menu bar -> Configuration -> Remote Server).

Information sign.png Note
The Remote Server option is only available in the SEP sesam Master GUI.
  • Server Name: The name of the SEP sesam Server in the network.
  • Connection: Shows if the Server is connected to the network (green = ON, red = broken, gray = OFF).
  • GUI Build: Displays the GUI version.
  • Operating System: OS of the SEP sesam Server.

Master GUI remote server Beefalo V2.jpg

The Master GUI allows the administrator to control all SEP sesam Servers in the SEP sesam environment.

When adding a new server to the SEP sesam Master GUI, the following parameters must be set.

  • Server name: Enter the name of the SEP sesam remote Server that you want to administer by using the master GUI.
  • Connection: You can set the connection to the server (ON or OFF).
  • Port: Define the port number for the client-server connection.
  • Note: Optionally, you can add a comment.

Master GUI new remote server Beefalo V2.jpg

User Permissions

The User Permissions item is only visible if policy-based authentication is activated (default). For details, see Configuring Policy-Based Authentication.

User permissions Beefalo.jpg

In the User Permissions you can configure the user authorization. Options are admin (the only user role with full control over the SEP sesam), operator (monitors the SEP sesam Server backup status), backup (only allowed to start backups) and restore (only allowed to start restores). 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 Beefalo.jpg

Note 1:

If the name resolution for the selected client is not 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]

Permission Management

Introduced in v. 4.4.3, SEP sesam provides different authentication methods that are mutually exclusive. For details, see About Authentication and Authorization.

Depending on which authentication mode is active, one of the following options is shown:

  • Policy-based authentication is enabled by default. You can switch to database-based authentication by using the Activate Authentication button in the Permission Management window. If you choose not to activate the database-based authentication, policy-based authentication stays enabled. Policy-based authentication is configured in User Permissions (see previous menu option). For details, see Configuring Policy-Based Authentication.
  • When you turn on database-based authentication by using the Activate Authentication button, upon the restart of a GUI and SEP sesam client, you can use any of the 5 available tabs: Users, Groups, External Groups, Sources and Activation. You can create users, modify their settings, such as adding a user to the group or removing it from the group, delete users, create external groups and add the authentication sources for the LDAP/AD authentication. You can also deactivate the database-based authentication. For details on LDAP/AD authentication, see Configuring LDAP/AD Authentication.
  • Authentication permission management Beefalo.jpg

Email Settings

The email settings allow to configure the email accounts that can be used for sending emails from the SEP sesam interface or from the command line. The default email account is sesam.

Configuration email Beefalo.jpg

By clicking New, the Email Account window opens:

Email account Beefalo.jpg

  • Account: Name of the account (mandatory)
  • Customer: Name of the customer
  • Sender: Email address of the sender
  • SMTP server: Name or IP address of the outgoing mail server
  • SMTP user: User name for SMTP server
  • Password: Password for the mail server. Password is mandatory if SMTP server requires authentication.
  • SMTP port: Optionally, specify the SMTP port.
  • Recipient: Email address of the recipient
  • CC: Email address for copy of the email
  • BCC: Email address for hidden copy of the email
  • SSL: Optionally, you can select to connect securely via SSL or TLS.

If no SMTP user name is specified, it is assumed that no authorization is required at the SMTP server.

Interfaces

User interfaces are configurable programs, intended for system administrators that can use them to create their own commands. They can be used to perform additional actions, such as exporting a database, restarting a database, and sending emails. The following interfaces are available: pre (sbc_pre), post (sbc_post), alarm (sm_alarm), disaster (sm_disaster) and notify (sm_notify). The pre/post-interface might affect backup execution; when creating a script, have in mind that any pre/post script should not take a long time to complete as it can delay the backup.

Interfaces pre Beefalo.jpg

User interfaces can be programmed using any text editor. To use an interface, you have to activate it first and create your own commands. From the Interfaces menu, select the interface you want to activate; if you are configuring a pre/post interface, you have to select a client too since these two interfaces are created for each client individually and are only executed on the selected 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 details, see Using Pre and Post Scripts.

Alternatively, you can activate the user interfaces by using the templates that are available in the SEP sesam directory <SESAM_ROOT>/skel/templates. To activate an interface, you have to copy its corresponding template file to the directory <SESAM_ROOT>/bin/sesam. The templates are only active and executed on the client.

If the email configuration is set, SEP sesam interfaces send messages by email. The default email account is sesam. For details, see How to configure Mail Notification.

SEP sesam allows the use of Pre-, Post-, Alarm-, Notify-, and Disaster interfaces to be combined into scripts.

Interfaces pre edit Beefalo.jpg

PRE interface

Before a backup starts, an administrator can specify special actions to be executed before and during the backup activity. For example, the system can generate messages to quickly notify the administrator of either backup job success or failure. Pre-interface can be used to create commands that will stop or start the selected programs; for example, it may be used to stop the database before it is backed up.

POST interface

Once the backup is finished, some special actions may be required (e.g., notifications/messages, program end/start, restart databases etc.). These actions can be programmed by using the post-interface.

Alarm interface

The SEP sesam system needs no special administration during normal operation once SEP sesam Clients are set up and backup tasks are scheduled (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 transmission to the authorized person.

If a license violation has occurred and the alarm interface is activated, an email with the license violation information is sent to the SEP sesam account. The license violations occur when you exceed the conditions set in your license, such as the maximum volume size, the maximum number of configured clients, not licensed backup task types (e.g., BSR), etc. The 16th day upon receiving the violation alarm SEP sesam backups are temporarily stopped until the issue is fixed, while the restores are still available. To avoid license violations, review your license; go to SEP sesam GUI -> Help -> License info. For details, see License administration.

Information sign.png Note
Do not use commands which require input from the user, such as OK buttons. Commands that require user interaction may cause interruption of backups during the night.
Notify interface

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

Disaster interface

The term disaster refers to a catastrophic failure or complete destruction of the SEP sesam Server and its data. The SEP sesam disaster interface must be properly configured to help carry out the disaster recovery process. To prepare for a possible breakdown of the SEP sesam Server, a self-backup of the SEP sesam installation must be performed. For details on how to prepare, see SEP sesam Server Disaster Recovery.

The disaster interface sends an email describing the recovery procedure in the event of disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. The sm_disaster file is located in:

  • Linux: <SESAM_BIN>/skel/templates/sm_disaster
  • Windows: <SESAM_BIN>/skel/templates/sm_disaster.ps1

As an alternative to using Interfaces in the GUI, the disaster interface file can also be copied to SESAM_BIN>/bin/sesam/sm_disaster and modified according to the needs of each environment. For details, see SEP sesam Server Disaster Recovery.

See also

Using Access Control ListsAbout Authentication and AuthorizationUsing Pre and Post ScriptsHow to configure Mail NotificationSEP sesam Server Disaster Recovery


Copyright © SEP AG 1999-2024. 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.