Source:Special Schedules: Difference between revisions

From SEPsesam
(Fixed link.)
(Added navigation, Special:MyLanguage to links, and prepared for translation.)
Line 1: Line 1:
{{Copyright SEP AG en}}
__FORCETOC__
== Overview ==
<translate><div class="noprint"><languages />
SEP sesam establishes schedules as a frame, to which you link different events, such as backup, migration, replication etc. A schedule defines the recurrence of an event and may be executed in minutes, hours, days, months or years. All schedules and related jobs are configured and run in the time zone of the SEP sesam Server. For more details on scheduling concepts, see [[The SEPuler - an event calendar 4.4#SEPuler|SEPuler an event calendar]].
{{Copyright SEP AG|en}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Grolar'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</div></translate><br />
<translate>==Overview==</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>Additional resources</translate></b></center>
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate>
[[File:SEP_next.png|45px|link=Special:MyLanguage/Creating_Custom_Calendar]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate>
See also: [[Special:MyLanguage/Creating_Custom_Calendar|Creating Custom Calendar]] [[Special:MyLanguage/About_Scheduling|About Scheduling]]</translate>
|}


'''SEP sesam also provides options to prevent activation of individual events on specific days, such as holidays, and on certain hours''':
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
#From '''v. 4.4.3 onwards''', SEP sesam scheduling includes new '''User defined''' option which enables you to quickly and simply create a customized calendar, which enables you to set the dates on which you would like to run additional jobs or prevent specific jobs to be run. For details, see [[Creating Custom Calendar]].
| rowspan="2" style="padding:0px 10px 0px;" |
#When your custom calendar is set, create the desired event for it. Use the option '''Blocking date''' in the ''Event properties'' to prevent a job from being run. Such event is called a '''blocking event''': any type of event with a higher priority that obstructs another event of the same type and prevents it from being activated. It can be specified to prevent activation of a specified event on specific days or hours. The latter example is given below. For general details on how to configure a schedule and link an event to it, see [[Standard_Backup_Procedure|Standard Backup Procedure, step 2 and 3]].
<translate>
[[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
<translate>
Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.</translate>
|}


== Configuring a blocking event only for the specified hours ==
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
A blocking event is created during configuration of an event or later in the event properties. It is used to prevent the activation of certain events on specific days (e.g., end of year, holidays). It may also be configured to prevent the execution of other jobs related to the same object only within the specified hours.
| rowspan="2" style="padding:0px 10px 0px;" | <translate>
{{note|
[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]</translate>
*By default, a blocking event suppresses any job with the same task name at respective ([[SEP_sesam_Glossary#backup day|SEP sesam backup day]]) day, regardless of whether it is scheduled to be run before, during or after the blocking event.
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate>
Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].</translate>
|}</div>
<translate>SEP sesam establishes schedules as a frame, to which you link different events, such as backup, migration, replication etc. A schedule defines the recurrence of an event and may be executed in minutes, hours, days, months or years. All schedules and related jobs are configured and run in the time zone of the SEP sesam Server. For more details on scheduling concepts, see [[Special:MyLanguage/The SEPuler - an event calendar 4.4#SEPuler|SEPuler – an event calendar]].
 
'''SEP sesam also provides options to prevent activation of individual events on specific days, such as holidays, and on certain hours''':</translate>
#<translate>From '''v. 4.4.3 onwards''', SEP sesam scheduling includes new '''User defined''' option which enables you to quickly and simply create a customized calendar, which enables you to set the dates on which you would like to run additional jobs or prevent specific jobs to be run. For details, see [[Special:MyLanguage/Creating_Custom_Calendar|Creating Custom Calendar]].</translate>
#<translate>When your custom calendar is set, create the desired event for it. Use the option '''Blocking date''' in the ''Event properties'' to prevent a job from being run. Such event is called a '''blocking event''': any type of event with a higher priority that obstructs another event of the same type and prevents it from being activated. It can be specified to prevent activation of a specified event on specific days or hours. The latter example is given below. For general details on how to configure a schedule and link an event to it, see [[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure, step 2 and 3]].
 
== {{anchor|configuration}}Configuring a blocking event only for the specified hours ==
 
A blocking event is created during configuration of an event or later in the event properties. It is used to prevent the activation of certain events on specific days (e.g., end of year, holidays). It may also be configured to prevent the execution of other jobs related to the same object only within the specified hours.</translate>
{{<translate>note</translate>|
*<translate>By default, a blocking event suppresses any job with the same task name at respective ([[Special:MyLanguage/SEP_sesam_Glossary#backup_day|SEP sesam backup day]]) day, regardless of whether it is scheduled to be run before, during or after the blocking event.</translate>
}}
}}
If you want to set the blocking event to be applied only within the specified hours, you must perform some specific steps. If you are configuring a blocking event that is valid for a whole ([[SEP_sesam_Glossary#backup day|SEP sesam backup day]]) (default), see [[Standard_Backup_Procedure#Step_3:_Creating_a_backup_event|Creating an event]].  
<translate>If you want to set the blocking event to be applied only within the specified hours, you must perform some specific steps. If you are configuring a blocking event that is valid for a whole ([[SEP_sesam_Glossary#backup day|SEP sesam backup day]]) (default), see [[Special:MyLanguage/Creating_a_Backup_Event|Creating an event]].  


To enable the blocking event within the specified hours, the SEP sesam database table ''defaults'' must contain an entry <tt>suppress_with_timerange</tt> with value <tt>yes</tt>. Without this entry the blocking event prevents related jobs to be activated for the whole sesam day!
To enable the blocking event within the specified hours, the SEP sesam database table ''defaults'' must contain an entry <tt>suppress_with_timerange</tt> with value <tt>yes</tt>. Without this entry the blocking event prevents related jobs to be activated for the whole sesam day!</translate>
<ol><li>Set a SEP sesam profile as described in [[Special:MyLanguage/FAQ#profile_setting|FAQ: What happens when I set a profile]].</li>
<ol><li><translate>Set a SEP sesam profile as described in [[Special:MyLanguage/FAQ#profile_setting|FAQ: What happens when I set a profile]].</translate></li>
<li>Once you set the profile, use the command line to insert the following to SEP sesam database:</li>
<li><translate>Once you set the profile, use the command line to insert the following to SEP sesam database:</translate></li>
  sm_db "INSERT INTO defaults (key,user_name,value) VALUES ('suppress_with_timerange','sesam','yes');"
  sm_db "INSERT INTO defaults (key,user_name,value) VALUES ('suppress_with_timerange','sesam','yes');"
<li>The following scenario presumes that you have already defined an ''hourly-scheduled backup for ORACLE'' with command event ''oracle_XE_full'' and [[SEP_sesam_Glossary#event priority|event priority]] 1 (default). Now you want to disallow execution from noon till 2 p.m. Therefore you need to create another schedule, e.g., ''block_ORACLE_1200-1400''. In this schedule, you specify recurrence as:
<li><translate>The following scenario presumes that you have already defined an ''hourly-scheduled backup for ORACLE'' with command event ''oracle_XE_full'' and [[SEP_sesam_Glossary#event priority|event priority]] 1 (default). Now you want to disallow execution from noon till 2 p.m. Therefore you need to create another schedule, e.g., ''block_ORACLE_1200-1400''. In this schedule, you specify recurrence as:</translate>
<ul><li>weekly execution, from Monday till Friday</li>
<ul><li><translate>weekly execution, from Monday till Friday</translate></li>
<li>starting time 12:00 o'clock, duration 2 hours</li></ul></li>
<li><translate>starting time 12:00 o'clock, duration 2 hours</translate></li></ul></li>
[[Image:Blocking_schedule_execution_schedule.jpg|left]]
<translate>[[Image:Blocking_schedule_execution_schedule.jpg|link=]]</translate>
<br clear=all>
<br clear=all>
<li>You must connect your newly created schedule, in our example ''block_ORACLE_1200-1400'', to the same command event as mentioned above, e.g., ''oracle_XE_full''. Set the priority to a higher value. Note that this event's priority must be higher than the priority of the linked event. Then enable the '''Blocking Date''' option ('Sperrtermin').</li>
<li><translate>You must connect your newly created schedule, in our example ''block_ORACLE_1200-1400'', to the same command event as mentioned above, e.g., ''oracle_XE_full''. Set the priority to a higher value. Note that this event's priority must be higher than the priority of the linked event. Then enable the '''Blocking Date''' option ('Sperrtermin').</translate></li>
 
<translate>[[Image:Blocking_schedule_execution_params.jpg|link=]]</translate>
[[Image:Blocking_schedule_execution_params.jpg|left]]
 
<br clear=all></ol>
<br clear=all></ol>
<translate>If you want to use this function with a regular backup job, keep in mind that the blocking event has to reference the same task name as the backup event does.


If you want to use this function with a regular backup job, keep in mind that the blocking event has to reference the same task name as the backup event does.
<div class="noprint">
 
==See also==
==See also==
 
[[Special:MyLanguage/Creating_Custom_Calendar|Creating Custom Calendar]] – [[Special:MyLanguage/About_Scheduling|About Scheduling]]</div></translate>
[[Creating Custom Calendar]]

Revision as of 14:45, 5 September 2018

Other languages:

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.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Grolar. For previous documentation version(s), check documentation archive.


Overview

SEP sesam establishes schedules as a frame, to which you link different events, such as backup, migration, replication etc. A schedule defines the recurrence of an event and may be executed in minutes, hours, days, months or years. All schedules and related jobs are configured and run in the time zone of the SEP sesam Server. For more details on scheduling concepts, see SEPuler – an event calendar.

SEP sesam also provides options to prevent activation of individual events on specific days, such as holidays, and on certain hours:

  1. From v. 4.4.3 onwards, SEP sesam scheduling includes new User defined option which enables you to quickly and simply create a customized calendar, which enables you to set the dates on which you would like to run additional jobs or prevent specific jobs to be run. For details, see Creating Custom Calendar.
  2. When your custom calendar is set, create the desired event for it. Use the option Blocking date in the Event properties to prevent a job from being run. Such event is called a blocking event: any type of event with a higher priority that obstructs another event of the same type and prevents it from being activated. It can be specified to prevent activation of a specified event on specific days or hours. The latter example is given below. For general details on how to configure a schedule and link an event to it, see Standard Backup Procedure, step 2 and 3.

Configuring a blocking event only for the specified hours

A blocking event is created during configuration of an event or later in the event properties. It is used to prevent the activation of certain events on specific days (e.g., end of year, holidays). It may also be configured to prevent the execution of other jobs related to the same object only within the specified hours.

Information sign.png Note
  • By default, a blocking event suppresses any job with the same task name at respective (SEP sesam backup day) day, regardless of whether it is scheduled to be run before, during or after the blocking event.

If you want to set the blocking event to be applied only within the specified hours, you must perform some specific steps. If you are configuring a blocking event that is valid for a whole (SEP sesam backup day) (default), see Creating an event.

To enable the blocking event within the specified hours, the SEP sesam database table defaults must contain an entry suppress_with_timerange with value yes. Without this entry the blocking event prevents related jobs to be activated for the whole sesam day!

  1. Set a SEP sesam profile as described in FAQ: What happens when I set a profile.
  2. Once you set the profile, use the command line to insert the following to SEP sesam database:
  3. sm_db "INSERT INTO defaults (key,user_name,value) VALUES ('suppress_with_timerange','sesam','yes');"
  4. The following scenario presumes that you have already defined an hourly-scheduled backup for ORACLE with command event oracle_XE_full and event priority 1 (default). Now you want to disallow execution from noon till 2 p.m. Therefore you need to create another schedule, e.g., block_ORACLE_1200-1400. In this schedule, you specify recurrence as:
    • weekly execution, from Monday till Friday
    • starting time 12:00 o'clock, duration 2 hours
  5. File:Blocking schedule execution schedule.jpg

  6. You must connect your newly created schedule, in our example block_ORACLE_1200-1400, to the same command event as mentioned above, e.g., oracle_XE_full. Set the priority to a higher value. Note that this event's priority must be higher than the priority of the linked event. Then enable the Blocking Date option ('Sperrtermin').
  7. File:Blocking schedule execution params.jpg

If you want to use this function with a regular backup job, keep in mind that the blocking event has to reference the same task name as the backup event does.