View source for 5 0 0:Customizing Global Retention Policy

<translate>
<!--T:1-->
<noinclude>
<div class="noprint"><languages /></translate>

<translate>
<!--T:2-->
{{Copyright SEP AG|en}}
{{draft}}

<!--T:3-->
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2''/5.0.0  ''Jaglion'']]|link=[[Special:MyLanguage/4_4_3_Beefalo:Managing_EOL|Managing EOL in earlier versions]]}}</div></translate><br />

<translate><!--T:4--> </noinclude>=== Overview === </translate>
<translate> <!--T:5--> <noinclude></translate><div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b><translate>

<!--T:6-->
Additional resources</translate></b></center>

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" |[[File:SEP_next.png|45px|link=Special:MyLanguage/Managing_EOL]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |<translate>

<!--T:7-->
See also: [[Special:MyLanguage/Automatic_Retention_(EOL)_Management|Automatic Retention (EOL) Management]] – [[Special:MyLanguage/Changing_Retention_(EOL)|Changing Retention (EOL)]] – [[Special:MyLanguage/Backup_Chain_Dependencies|Backup Chain Dependencies]] – [[Special:MyLanguage/Backup Strategy Best Practices|Backup Strategy Best Practices]] – [[Special:MyLanguage/Tape_Management|Tape Management]] </translate>
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_Video.png|45px|link=Special:MyLanguage/Video Tutorials & Screencasts|]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |<translate>

<!--T:8-->
Watch SEP sesam [[Special:MyLanguage/Video Tutorials & Screencasts#installation|installation videos & screencasts]].</translate>
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate>

<!--T:9-->
Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.</translate>
|}

{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate>

<!--T:10-->
Problems? See the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]. </translate>
|}</div></noinclude>
<translate>
<!--T:11-->
You can configure global retention settings to customize the default backup retention behavior, such as to allow increased retention time of different media pools for migrated savesets, decrease retention time for failed backups, and change the automatic retention of the last successful backup and/or migration. 

<!--T:12-->
;Migrated savesets:If savesets that belong to a backup chain (FULL/DIFF/INCR) are migrated to different media pools, their retention time is the same as the retention time of the original backup. The retention policy settings configured when creating a media pool also apply to migrated savesets. To change the retention time of migrated savesets, you can insert or modify [[Special:MyLanguage/SEP_sesam_Glossary#EOL|EOL-related keys]] in the global settings in the GUI, as described in the section [[Special:MyLanguage/5_0_0:Customizing_Global_Retention_Policy#EOL_migration|Allow increased retention of another media pool for migrated savesets]]. 

<!--T:13-->
;Failed backups:You can also specify the desired retention length for failed backups; by default, the backup retention policy (retention time of media pool) is applied equally to successful and failed backups. This means that a failed backup is retained for as long as the retention time (of a media pool) specifies. To shorten the retention time for failed backups, use the special key <tt>eol_for_failed_backups</tt>, as described in the section [[Special:MyLanguage/5_0_0:Customizing_Global_Retention_Policy#EOL_failed_bck|Set retention for failed backups]].

<!--T:14-->
;Last successful backup/migration:SEP sesam automatically retains the last successful backup or migration saveset when the next backup/migration fails. This behavior is enabled by default and can be changed by setting the values of the respective keys, as described in the section [[Special:MyLanguage/5_0_0:Customizing_Global_Retention_Policy#EOL_retain_last_successful|Modify automatic retention of last successful backup/migration]].
</translate>

<translate>
==={{anchor|steps}}Customizing the retention policy=== <!--T:15--> 

<!--T:16-->
To change the retention policy, you can add or modify the keys associated with retention: SEP sesam menu bar, click ''Configuration'' -> ''Defaults'' -> ''Settings''. 
{{note|Some keys may not be supported in earlier SEP sesam versions, see [[Special:MyLanguage/4_4_3:Managing_EOL|Managing EOL in versions 4.4.3-4.4.3 ''Grolar'']] for details.}}

<!--T:17-->
All EOL-related keys are listed in the table [[Special:MyLanguage/Customizing_Global_Retention_Policy#keys|Global retention keys]].</translate>

<translate>
===={{anchor|EOL_migration}}Allow increased retention of another media pool for migrated savesets==== <!--T:18-->  

<!--T:19-->
Typically, a chain of backup savesets is migrated to one media pool. You may want to migrate savesets of one backup chain (FULL/DIFF/INCR) to different media pools. There are two ways to change the retention time of migrated savesets.</translate> 

<ul><li><translate> <!--T:20--> You can enable extended retention for migration by using a specific GLBV:</translate> 
 <tt>'gv_adjust_eol_migration_increases_eol_on_other_pool'</tt>.</li>
<li><translate><!--T:21--> You can enable migration to increase the EOL of referenced savesets on other media pools (not just on the target media pool) by adding (or modifying) the following key in the global settings in the GUI:</translate>
<ol><li><translate><!--T:22--> In the menu bar, click ''Configuration'' -> ''Defaults'' -> ''Settings''.</translate></li>
<li><translate> <!--T:23--> Click [+] to add the following key to the global settings (or modify the key value, if it already exists): <tt>eol_adjust_migration_on_other_pool|1|sesam</tt><br /> where ''value=1'' means that the key is active and ''sesam'' is the user name.</translate></li>
<translate> <!--T:24--> [[image:EOL_migration.jpg|550px|link=]]</translate></li></ul>
<br clear=all>
</ol>

<translate>
===={{anchor|EOL_failed_bck}}Set retention for failed backups==== <!--T:25-->  

<!--T:26-->
By default, the backup retention policy (retention time of media pool) is applied equally to successful and failed backups. A failed backup is retained as specified by the media pool retention time. To free up repository space and shorten the number of days to retain failed backups, you can specify the desired retention period for failed backups in days.</translate>

<translate><!--T:27--> To specify the desired length of retention for failed backups, use the following keys:</translate> 
<tt>eol_for_failed_backups</tt>, <tt>eol_for_failed_not_file_system_backups</tt>.
<ol><li><translate><!--T:28--> Open the global settings in the GUI:</translate>
<translate><!--T:29--> In the menu bar, click ''Configuration'' -> ''Defaults'' -> ''Settings''.</translate></li>
<li><translate> <!--T:30-->
Click [+] to add the following key to the global settings (or modify the key value if it already exists): <tt>eol_for_failed_backups</tt><br /> where ''value=<no>'' means the number of days for which failed backups will be retained and ''sesam'' is the user name. 
*For example, 3 means that SEP sesam will automatically delete all failed backups after 3 days. 
*0 (default) means that all failed backups are retained according to the media pool retention time.
</translate></li>
<li><translate> <!--T:31-->
You can also specify the desired retention specifically for all [[Special:MyLanguage/SEP_sesam_Glossary#task_type|non-filesystem (non-Path) type]] backups by adding (or modifying) the key <tt>eol_for_failed_not_file_system_backups</tt> where ''value=<no>'' means the number of days for which all failed non-filesystem backups will be retained and ''sesam'' is the user name.
*For example, 3 means that SEP sesam will automatically delete all failed non-filesystem backups after 3 days. 
*0 (default) means that all failed non-filesystem backups are retained according to the <tt>eol_for_failed_backups</tt> parameter if set to > 0, or according to the media pool retention time if none of the <tt>eol_for_failed...</tt> parameters is set (value 0).</translate></li>
<translate> <!--T:32--> [[image:EOL_failed_bck.jpg|550px|link=]]</translate></li></ol>
<br clear=all>

<translate>
===={{anchor|EOL_retain_last_successful}}Modify automatic retention of last successful backup/migration==== <!--T:33-->  

<!--T:34-->
SEP sesam automatically retains the last successful backup or migration saveset if the next backup/migration fails to ensure that at least one successful backup is retained. This behavior is enabled by default and can be changed by setting the values of <tt>eol_adjust_failed_backup</tt> and <tt>eol_adjust_failed_migration</tt> to 0.</translate>

<ol><li><translate><!--T:35--> To change the automatic retention of the last successful backup/migration, open the global settings in the GUI:</translate>
<translate><!--T:36--> In the menu bar, click ''Configuration'' -> ''Defaults'' -> ''Settings''.</translate></li>
<li><translate> <!--T:37--> Click [+] to add the following key to the global settings (or modify the key value, if it already exists): <tt>eol_adjust_failed_backup</tt><br />, where ''value=1'' (default) means that the key is active and the last backups are automatically retained; to disable this behavior, set the value to ''value=0''</translate></li>
<li><translate> <!--T:38--> You can also specify the desired behavior for retaining the last succesful migrated savesets by adding (or modifying) the key <tt>eol_adjust_failed_migration</tt>, where ''value=1'' (default) means that the key is active and the last migrated savesets are automatically retained; to disable this behavior, set the value to ''value=0''.</translate></li>
<translate> <!--T:39--> [[image:EOL_retain_last_successful.jpg|550px|link=]]</translate></li></ol>
<br clear=all>

<translate>
===={{anchor|keys}}Global retention keys==== <!--T:40--> </translate>
{| border="2" cellpadding="4" cellspacing="0" style="width:90%; margin: 1em 1em 1em 0; background: #fcfcfc; border: 1px #aaa solid; border-collapse: collapse;"
|- style="background:#FFCC01; color:#002F55"
! scope="col" style="text-align:left;" | <translate><!--T:41--> EOL-related key</translate>
! scope="col" style="text-align:left;" | <translate><!--T:42--> Value</translate>
! scope="col" style="text-align:left;"| <translate><!--T:43--> Description</translate>
! scope="col" style="text-align:left;" | <translate><!--T:44--> Available from [[Special:MyLanguage/SEP_sesam_Release_Versions|''version'']]</translate>
! scope="col" style="text-align:left;" | <translate><!--T:45--> Note</translate>
 |- 
|<tt>eol_adjust_migration_on_other_pool</tt> || | '''1''' (<translate><!--T:46--> allow</translate>) <br />'''0''' (<translate> <!--T:47--> disable</translate>)|| <translate><!--T:48--> Allow increased retention time of another media pool for migrated savesets</translate> || [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo'']]||
|- 
|<tt>eol_adjust_failed_backup</tt>|| | '''1''' (<translate><!--T:49--> enable</translate>) <br />'''0''' (<translate><!--T:50--> disable</translate>)|| <translate><!--T:51--> Automatic retention of the last successful backup saveset</translate> ||[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3.47 ''Tigon V2'' ]]||
 |-
|<tt>eol_adjust_failed_migration</tt>|| | '''1''' (<translate><!--T:52--> enable</translate>) <br />'''0''' (<translate><!--T:53--> disable</translate>)|| <translate><!--T:54--> Automatic retention of the last successful migration saveset</translate> || [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3.47 ''Tigon V2'' ]]||
 |-
|<tt>eol_for_failed_backups</tt>|| | '''0''' (<translate><!--T:55--> use media pool retention time</translate>) <br />'''> 0''' (<translate><!--T:56--> specify retention time in days, e.g., 3</translate>) || <translate><!--T:57--> Set retention time (in days) for failed backups</translate> || [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']] || 
<translate><!--T:58--> By default, a failed backup is retained for the number of days specified by the [[Special:MyLanguage/Automatic_Retention_(EOL)_Management|media pool retention time]]. If you want to free up space on the storage repository and shorten the number of days to keep failed backups, specify the desired length of retention for failed backups in days. For example, 3 means that SEP sesam will automatically delete all failed backups after 3 days. 0 (default) means that all failed backups are retained according to the media pool retention time.</translate> 

 |-
|<tt>eol_for_failed_not_file_system_backups</tt>|| | '''0''' (<translate><!--T:59--> use media pool retention time</translate>) <br /> '''> 0''' (<translate><!--T:60--> specify retention time in days, e.g., 3</translate>) || <translate><!--T:61--> Set the retention time (in days) for all ''non-filesystem'' (''non-Path'') [[Special:MyLanguage/SEP_sesam_Glossary#task_type|type]] backups, e.g., SAP Hana, Exchange Server, VMware vSphere etc.</translate> ||  4.4.3 ''Beefalo V2'' || <translate><!--T:62--> The only difference with the previous parameter (''eol_for_failed_backups'', see above) is that you can specify the desired retention specifically for all ''non-filesystem'' (''non-Path'') [[Special:MyLanguage/SEP_sesam_Glossary#task_type|type]] backups. For example, 3 means that SEP sesam will automatically delete all failed ''non-filesystem'' backups after 3 days. 0 (default) means that all failed ''non-filesystem'' backups are retained according to the ''eol_for_failed_backups'' parameter if set to ''> 0'', or according to the ''media pool retention time'' if none of the ''eol_for_failed...'' parameters is set (value 0).</translate> 
 |-
 |}
<translate>
<!--T:63-->
The screenshot shows the ''Defaults'' -> ''Settings'' table with the EOL-related paramaters.
 
[[image:EOL_keys.jpg|550px|link=]]</translate>
<br clear=all><noinclude><translate>
<!--T:64-->
<div class="noprint">

===See also=== <!--T:65-->
[[Special:MyLanguage/Automatic_Retention_(EOL)_Management|Automatic Retention (EOL) Management]] – [[Special:MyLanguage/Changing_Retention_(EOL)|Changing Retention (EOL)]] – [[Special:MyLanguage/Backup_Chain_Dependencies|Backup Chain Dependencies]] – [[Special:MyLanguage/Backup Strategy Best Practices|Backup Strategy Best Practices]] – [[Special:MyLanguage/Tape_Management|Tape Management]] </div></translate></noinclude>