Source:Creating a Custom Calendar-Jaglion: Difference between revisions

From SEPsesam
(Fixed heading levels and excluded items from print for SCA book.)
(Marked this version for translation)
(4 intermediate revisions by 2 users not shown)
Line 5: Line 5:


<!--T:2-->
<!--T:2-->
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2'']]
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo V2''/5.0.0 ''Jaglion'']]
|link=[[Special:MyLanguage/4_4_3:Creating_Custom_Calendar|Creating Custom Calendar in previous versions]]}}</div>
|link=[[Special:MyLanguage/4_4_3:Creating_Custom_Calendar|Creating Custom Calendar in previous versions]]}}</div>


Line 14: Line 14:
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5--> [[File:SEP_next.png|45px|link=Special:MyLanguage/About_Scheduling]]</translate>
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5--> [[File:SEP_next.png|45px|link=Special:MyLanguage/About_Scheduling]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6--> See also: [[Special:MyLanguage/About_Scheduling|About Scheduling]] – [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]] – [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]] – [[Special:MyLanguage/Special_Schedules|Special Schedules]] – [[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6--> See also: [[Special:MyLanguage/About_Scheduling|About Scheduling]] – [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]] – [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]] – [[Special:MyLanguage/Special_Schedules|Special Schedules]] – [[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]] – [[Special:MyLanguage/Automating_Backup_Process|Automating Backup Process]]</translate>
|}
|}


Line 38: Line 38:


<!--T:13-->
<!--T:13-->
[[image:Schedule-user_defined_Beefalo_V2.jpg|500px|link=]]</translate>
[[image:Schedule-user_defined_Jaglion_V2.jpg|570px|link=]]</translate>
<br clear=all>
<br clear=all>


Line 51: Line 51:


<!--T:63-->
<!--T:63-->
Note that you can simply modify, import, export, and delete your custom calendar, as described in the section [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#manage_calendar|Managing custom calendars]].
Note that you can simply modify, import, export, and delete your custom calendar, as described in the section [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#manage_calendar|Managing custom calendars]].</translate>


=== {{anchor|set_up}}Setting up a custom calendar === <!--T:16-->  
=== {{anchor|set_up}}<translate><!--T:16-->
Setting up a custom calendar === 


<!--T:17-->
<!--T:17-->
Line 60: Line 61:
<li><translate><!--T:19--> The '''Execution''' is enabled by default. If you select the ''Execution off'' option, all events that are linked to this schedule will be deactivated.</translate></li>
<li><translate><!--T:19--> The '''Execution''' is enabled by default. If you select the ''Execution off'' option, all events that are linked to this schedule will be deactivated.</translate></li>
<li><translate><!--T:20--> Specify the start time for the schedule in the '''Start''' field. By default, the current date is already entered. In the next field, specify the start time, e.g., 18.30. The schedule will be activated after the specified date and time. If you want your schedule to be valid only for a limited period of time, use the [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#expiration|Expiration date]] option.</translate></li>
<li><translate><!--T:20--> Specify the start time for the schedule in the '''Start''' field. By default, the current date is already entered. In the next field, specify the start time, e.g., 18.30. The schedule will be activated after the specified date and time. If you want your schedule to be valid only for a limited period of time, use the [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#expiration|Expiration date]] option.</translate></li>
<translate><!--T:21--> [[image:Custom_calendar_dialog_01_Beefalo_V2.jpg|500px|link=]]</translate>
<translate><!--T:21--> [[image:Custom_calendar_dialog_01_Jaglion_V2.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:22--> In the table providing selection of different time parameters tabs (''Once'', ''Daily'', ''Weekly'', ''Monthly'', ''Yearly'', ''User Defined''), click the '''User Defined''' tab and then click the '''New''' button below the ''Calendar name'' field. The ''New Calendar'' dialog is displayed.</translate></li>
<li><translate><!--T:22--> In the table providing selection of different time parameters tabs (''Once'', ''Daily'', ''Weekly'', ''Monthly'', ''Yearly'', ''User Defined''), click the '''User Defined''' tab and then click the '''New''' button below the ''Calendar name'' field. The ''New Calendar'' dialog is displayed.</translate></li>
<translate><!--T:23--> [[image:Custom_calendar_dialog_02_Beefalo_V2.jpg|680px|link=]]</translate>
<translate><!--T:23--> [[image:Custom_calendar_dialog_02_Jaglion_V2.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>{{anchor|setting_calendar}}<translate><!--T:24--> In the ''Name'' field, enter the name for your custom calendar. You can either add calendar events by '''single-clicking''' the days you want to include in your calendar or by '''double-clicking''' the desired date to open the ''Change event'' dialog. In the ''Change event'' dialog you can write a description in the ''Event'' field, expand the date range to several days, and choose the start and end time of the event. Deselecting the '''Active''' check box will deactivate the calendar event. Click '''OK''' to add the calendar event to the calendar.</translate></li>
<li>{{anchor|setting_calendar}}<translate><!--T:24--> In the ''Name'' field, enter the name for your custom calendar. You can either add calendar events by '''single-clicking''' the days you want to include in your calendar or by '''double-clicking''' the desired date to open the ''Change event'' dialog. In the ''Change event'' dialog you can write a description in the ''Event'' field, expand the date range to several days, and choose the start and end time of the event. Deselecting the '''Active''' check box will deactivate the calendar event. Click '''OK''' to add the calendar event to the calendar.</translate></li>
<translate><!--T:25--> [[image:Calendar_event_Beefalo_V2.jpg|400px|link=]]</translate>
<translate><!--T:25--> [[image:Calendar_event_Jaglion_V2.jpg|400px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:26--> After adding all calendar events needed for the calendar, save your custom calendar by clicking the '''Create Calendar''' button.</translate></li>
<li><translate><!--T:26--> After adding all calendar events needed for the calendar, save your custom calendar by clicking the '''Create Calendar''' button.</translate></li>
Line 80: Line 81:


<!--T:34-->
<!--T:34-->
> [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#run|Create an event for running additional jobs on specified dates]]
> [[#run|Create an event for running additional jobs on specified dates]]


<!--T:35-->
<!--T:35-->
> [[Special:MyLanguage/4_4_3_Beefalo:Creating_a_Custom_Calendar#prevent|Create an event to prevent scheduled jobs from running on specified dates]]
> [[#prevent|Create an event to prevent scheduled jobs from running on specified dates]]


<!--T:36-->
<!--T:36-->
For general details on how to create the SEP sesam events, see [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]].
For general details on how to create the SEP sesam events, see [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]].</translate>


==== {{anchor|run}}Create an event for running additional jobs on specified dates ==== <!--T:37-->
==== {{anchor|run}}<translate><!--T:37-->
Create an event for running additional jobs on specified dates ====  


<!--T:38-->
<!--T:38-->
Line 94: Line 96:
<ol><li><translate><!--T:39--> Select the schedule and right-click it. Then select the event type you want to add, for example backup, and click '''New Backup Event'''.</translate></li>
<ol><li><translate><!--T:39--> Select the schedule and right-click it. Then select the event type you want to add, for example backup, and click '''New Backup Event'''.</translate></li>
<li><translate><!--T:40--> Under ''Sequence control'', set up the '''Priority''' of your event. SEPuler always executes the schedules with the highest priority first. The default priority level is 1, which is the lowest priority (the highest priority is 99). The only exception are schedules with priority 0, which override all other priorities and are always executed. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar#event_priority|event priorities]].</translate></li>
<li><translate><!--T:40--> Under ''Sequence control'', set up the '''Priority''' of your event. SEPuler always executes the schedules with the highest priority first. The default priority level is 1, which is the lowest priority (the highest priority is 99). The only exception are schedules with priority 0, which override all other priorities and are always executed. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar#event_priority|event priorities]].</translate></li>
<li><translate><!--T:41--> Under ''Object'', select the '''task''' or '''task group''' to which you want to link this event. Then click '''OK''' to save the event.</translate></li>
<li><translate><!--T:41--> Under ''Object'', select the '''task''' or '''task group''' to which you want to link this event. Then set the priority. Events with the highest priority are always executed first. The default priority level is 1 (the lowest priority). Then click '''OK''' to save the event.</translate></li>


<translate><!--T:42--> [[image:Add_event_to_schedule_01.jpg|600px|link=]]</translate>
<translate><!--T:42--> [[image:Add_event_to_schedule_01.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
</ol>
</ol>


<translate>==== {{anchor|prevent}}Create an event to prevent scheduled jobs from running on specified dates ==== <!--T:43-->
==== {{anchor|prevent}}<translate><!--T:43-->
Create an event to prevent scheduled jobs from running on specified dates ====  


<!--T:44-->
<!--T:44-->
Line 110: Line 113:
<!--T:47-->
<!--T:47-->
{{note|A '''Blocking date''' option is used to prevent the activation of certain events on specific days (e.g., end of year, holidays) or to prevent the execution of other jobs related to the same object only within the specified hours. For details on the latter, see [[Special:MyLanguage/Special_Schedules|Special Schedules]].}} </translate></li>
{{note|A '''Blocking date''' option is used to prevent the activation of certain events on specific days (e.g., end of year, holidays) or to prevent the execution of other jobs related to the same object only within the specified hours. For details on the latter, see [[Special:MyLanguage/Special_Schedules|Special Schedules]].}} </translate></li>
<li><translate><!--T:48--> Under '''Object''', select the ''task'' or ''task group'' to which you want to link this event. Then click '''OK''' to save the event.</translate></li>
<li><translate><!--T:48--> Under '''Object''', select the ''task'' or ''task group'' to which you want to link this event. Then set a high priority that will prevail over the priority of the event you want to block and select the '''Blocking date''' check box. Click '''OK''' to save the event.</translate></li>


<translate><!--T:49--> [[image:Add_event_to_schedule_02_Beefalo_V2.jpg|600px|link=]]</translate>
<translate><!--T:49--> [[image:Add_event_to_schedule_02_Jaglion_V2.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
</ol>
</ol>


<translate>==={{anchor|manage_calendar}}Managing custom calendars=== <!--T:50-->  
==={{anchor|manage_calendar}}<translate><!--T:50-->
Managing custom calendars=== 


<!--T:51-->
<!--T:51-->
Line 128: Line 132:
<li><translate><!--T:57--> '''Import''': Enables you to add an existing online calendar (iCalendar) to your SEP sesam custom calendars by importing it. This way you can easily add country's or region's holidays (that are already defined in some other online calendar) to your list of calendars without having to manually create each holiday/event. To import the calendar, in the ''file browser'' select the ''.ics'' calendar file that contains the events you want to import and click '''Open'''. Note that it may take some time to load the imported calendar.</translate></li>  
<li><translate><!--T:57--> '''Import''': Enables you to add an existing online calendar (iCalendar) to your SEP sesam custom calendars by importing it. This way you can easily add country's or region's holidays (that are already defined in some other online calendar) to your list of calendars without having to manually create each holiday/event. To import the calendar, in the ''file browser'' select the ''.ics'' calendar file that contains the events you want to import and click '''Open'''. Note that it may take some time to load the imported calendar.</translate></li>  
<li><translate><!--T:58--> '''Export''': Enables you to use the SEP sesam calendar by other applications, such as ''Google'' and ''Apple Calendar''. To export the calendar, in the ''file browser'' select the directory where you want to save your exported calendar. Optionally, change the name of your exported file. By default, a calendar is exported as an ''.ics'' file. You can also copy all events from one SEP sesam calendar to another by ''exporting'' and then ''importing'' a calendar.</translate></li>
<li><translate><!--T:58--> '''Export''': Enables you to use the SEP sesam calendar by other applications, such as ''Google'' and ''Apple Calendar''. To export the calendar, in the ''file browser'' select the directory where you want to save your exported calendar. Optionally, change the name of your exported file. By default, a calendar is exported as an ''.ics'' file. You can also copy all events from one SEP sesam calendar to another by ''exporting'' and then ''importing'' a calendar.</translate></li>
<translate><!--T:59--> [[image:Custom_calendar_options.jpg|500px|link=]]</translate>
<translate><!--T:59--> [[image:Custom_calendar_options.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
</ul></ol>
</ul></ol>


<noinclude><translate>
<noinclude>
{{<translate><!--T:64--> tip</translate>|<translate><!--T:65--> In v. ≥ [[Special:MyLanguage/SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], you can automate the process of backing up multiple VMs by automatically generating tasks for VMs that are connected to the same host; you can also automatically create clients for VMs to which the created tasks and ACLs can be assigned. It is recommended to use these features when a new hypervisor is added and many new VMs need to be backed up. For details, see [[Special:MyLanguage/Automating_Backup_Process|Automating Backup Process]].</translate>}}
 
<translate>
<!--T:60-->
<div class="noprint">
<div class="noprint">
=== See also === <!--T:60-->
=== See also ===
[[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]] – [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]] – [[Special:MyLanguage/Special_Schedules|Special Schedules]] – [[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]]</div></translate></noinclude>
[[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules Overview]] – [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]] – [[Special:MyLanguage/Special_Schedules|Special Schedules]] – [[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]] – [[Special:MyLanguage/Automating_Backup_Process|Automating Backup Process]]</div></translate></noinclude>

Revision as of 12:42, 12 January 2023

Other languages:

Template:Copyright SEP AG en

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3 Beefalo V2/5.0.0 Jaglion. For previous documentation version(s), check Creating Custom Calendar in previous versions.


Overview

SEP sesam provides flexible scheduling features to customize how and when your events are processed. By using the User defined option of a schedule, you can create a calendar that is customized according to your country- or company-specific requirements.

For example, you can define a calendar with specific days on which you want to perform special job executions, such as backup and migration. It also provides the ability to define specific dates on which the scheduled jobs are prevented from running, allowing you to set up a custom calendar of public holiday dates for each year and linking events with blocking date to it to stop scheduled jobs from running during holidays.

Schedule-user defined Jaglion V2.jpg

You can create as many custom calendars as you need. A custom calendar can be defined for a limited period of time, e.g., for one year if the holidays and other specific dates are entered only for the next year, for several years, or for an unlimited time.

When creating a calendar, you can change the month or year in a calendar by clicking the single arrow (at the top/right corner of the calendar) for selecting a month or the double arrow for selecting a year.

After entering a calendar name and saving a calendar, you can switch to a calendar table view by selecting the Table View option. This view provides an overview of all your events, i.e., event start/end date and whether the event is active or not. You can add a new event by clicking the Add Event button (below the Events table). You can also modify and delete an existing event by double-clicking it (or selecting it and clicking Change Event/Delete Event button).

Note that you can simply modify, import, export, and delete your custom calendar, as described in the section Managing custom calendars.

Setting up a custom calendar

To create a custom calendar with dates on which you want to run additional jobs or prevent scheduled jobs from running, proceed as follows:

  1. From Main Selection -> Scheduling -> Schedules, click New schedule. The New Schedule window appears.
  2. The Execution is enabled by default. If you select the Execution off option, all events that are linked to this schedule will be deactivated.
  3. Specify the start time for the schedule in the Start field. By default, the current date is already entered. In the next field, specify the start time, e.g., 18.30. The schedule will be activated after the specified date and time. If you want your schedule to be valid only for a limited period of time, use the Expiration date option.
  4. Custom calendar dialog 01 Jaglion V2.jpg
  5. In the table providing selection of different time parameters tabs (Once, Daily, Weekly, Monthly, Yearly, User Defined), click the User Defined tab and then click the New button below the Calendar name field. The New Calendar dialog is displayed.
  6. Custom calendar dialog 02 Jaglion V2.jpg
  7. In the Name field, enter the name for your custom calendar. You can either add calendar events by single-clicking the days you want to include in your calendar or by double-clicking the desired date to open the Change event dialog. In the Change event dialog you can write a description in the Event field, expand the date range to several days, and choose the start and end time of the event. Deselecting the Active check box will deactivate the calendar event. Click OK to add the calendar event to the calendar.
  8. Calendar event Jaglion V2.jpg
  9. After adding all calendar events needed for the calendar, save your custom calendar by clicking the Create Calendar button.
  10. Under Advanced settings you can further refine your schedule.
    • To define the maximum allowed startup time (the amount of time an event can be in the queue), specify the startup time in days and/or hours in the Start time frame field. The actual event startup depends on the processor load of the system. At the starting time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority are finished. For jobs with the same priority, the FIFO rule (first in, first out) applies. If the event cannot be executed within this specified time frame, it will not be executed at all.
    • You can also specify the time frame for the event to be repeated. Select the Repeat task check box and then specify the repetition cycle to repeat the event every n hours or minutes. Use the For a duration of field to specify the duration of the repeated event in days and/or hours.
    • To specify the time frame after which the scheduled event will be cancelled, select the check box in front of the option Stop task if runs longer than and set the amount of time (days and/or hours) after the event's scheduled start time at which the event will be cancelled.
    • Select the Expiration date check box if you want your schedule to be valid only for a limited period of time, e.g., until the end of the year. Then specify the date of schedule suspension. The schedule will be deleted after the Expiration date criterion is met. By default, this option is disabled and the schedule will be repeated in perpetuity.
  11. Click OK to save the schedule.

You can access all your configured schedules and events under Scheduling in the Main selection pane. Depending on the purpose of creating an event for a custom calendar, select one of the following procedures:

> Create an event for running additional jobs on specified dates

> Create an event to prevent scheduled jobs from running on specified dates

For general details on how to create the SEP sesam events, see Schedules Overview.

Create an event for running additional jobs on specified dates

You have to create the event(s) you want to run on the dates set by your newly created schedule:

  1. Select the schedule and right-click it. Then select the event type you want to add, for example backup, and click New Backup Event.
  2. Under Sequence control, set up the Priority of your event. SEPuler always executes the schedules with the highest priority first. The default priority level is 1, which is the lowest priority (the highest priority is 99). The only exception are schedules with priority 0, which override all other priorities and are always executed. For details, see event priorities.
  3. Under Object, select the task or task group to which you want to link this event. Then set the priority. Events with the highest priority are always executed first. The default priority level is 1 (the lowest priority). Then click OK to save the event.
  4. Add event to schedule 01.jpg

Create an event to prevent scheduled jobs from running on specified dates

You have to create the event(s) you want to prevent from running on the dates set by your newly created schedule:

  1. Select the schedule and right-click it. Then select the event type you want to add, for example backup, and click New Backup Event.
  2. Under Sequence control, set up the Priority of your exclude event. SEPuler always executes the schedules with the highest priority first. The default priority level is 1, which is the lowest priority (the highest priority is 99). The only exception are schedules with priority 0, which override all other priorities and are always executed. For details, see event priorities. Then select the Blocking date check box. Make sure that this option is used together with a high priority that prevails over priority of the event you want to block.
    Information sign.png Note
    A Blocking date option is used to prevent the activation of certain events on specific days (e.g., end of year, holidays) or to prevent the execution of other jobs related to the same object only within the specified hours. For details on the latter, see Special Schedules.
  3. Under Object, select the task or task group to which you want to link this event. Then set a high priority that will prevail over the priority of the event you want to block and select the Blocking date check box. Click OK to save the event.
  4. Add event to schedule 02 Jaglion V2.jpg

Managing custom calendars

You can modify, import, export, and delete your SEP sesam calendar(s). You can only manage one calendar at the time.

  1. From Main Selection -> Scheduling -> Schedules, double-click the calendar-related schedule, e.g., bank_holidays.
  2. In the table providing selection of different time parameters tabs (Once, Daily, etc.), click the User Defined tab.
  3. From the Calendar Name drop-down list, select the target calendar. Depending on what you want to do with it, select one of the following options:
    • Change: Enables you to modify an existing calendar or change its specific events. The procedure is the same as when you create a new calendar, see above section Setting up a custom calendar.
    • Delete: Delete the calendar. If the calendar is still being used by another schedule, you will receive a message.
    • Import: Enables you to add an existing online calendar (iCalendar) to your SEP sesam custom calendars by importing it. This way you can easily add country's or region's holidays (that are already defined in some other online calendar) to your list of calendars without having to manually create each holiday/event. To import the calendar, in the file browser select the .ics calendar file that contains the events you want to import and click Open. Note that it may take some time to load the imported calendar.
    • Export: Enables you to use the SEP sesam calendar by other applications, such as Google and Apple Calendar. To export the calendar, in the file browser select the directory where you want to save your exported calendar. Optionally, change the name of your exported file. By default, a calendar is exported as an .ics file. You can also copy all events from one SEP sesam calendar to another by exporting and then importing a calendar.
    • Custom calendar options.jpg


SEP Tip.png Tip
In v. ≥ 5.0.0 Jaglion, you can automate the process of backing up multiple VMs by automatically generating tasks for VMs that are connected to the same host; you can also automatically create clients for VMs to which the created tasks and ACLs can be assigned. It is recommended to use these features when a new hypervisor is added and many new VMs need to be backed up. For details, see Automating Backup Process.