In FireDaemon Pro, schedules can be defined to start or restart a program at a given point in time or to run within a given time interval. Schedules can be repeated endlessly, or they can be limited to a fixed date range.
A schedule can start or stop a program on a particular day, week, month, or year. A schedule can also be defined as "nth day of the week in a month", which allows you to start or stop a program on a given weekday, e.g. on 3rd Monday of January.
A schedule is created either through the FireDaemon user interface or by importing a schedule definition in an XML file.
Further details are provided in the following sub-sections
The New Schedule Dialog
To create a new schedule, click the Add Schedule button (the Plus icon) on the Service Definition toolbar.
The following table describes the fields on the New Schedule page.
Field | Description |
---|---|
Schedule Name | The name of the schedule. Naming a schedule is optional but useful when running multiple schedules for one service. If a name is not specified, the default name “New Schedule” is used. |
Schedule Type | The schedule type. The Schedule Type options depend on the service type setting. For services marked as Always Running Program, two options are available:
For services marked as Self Completing Task, one setting applies:
Based on the selected Schedule Type, the input fields on the dialog will change. |
Restart Settings (Always Running Program) Start Settings (Self Completing Task) | The timing setting for a program (re)start. The following options are available:
|
Origin | The time of the program's first (re)start event. The value of the Origin minutes field is fixed, i.e. it cannot be changed. |
Restart Time | The time of the program's first (re)start event. This field is available when Specific time of day is selected above |
Repeat Interval | The following options are available: For Schedule Type - Restart Program
|
Every | The repeat interval, in minutes, hours or day, for a restart action. This field is only visible when the schedule type is set to Restart Program. |
From | The start time for the selected schedule interval. The value of this field changes according to the time selected in the Origin field. This field is only visible when the schedule type is set to Restart Program. |
Till following | The end time for the selected schedule interval. The value of this field changes according to the time selected in the Origin field. This field is only visible when the schedule type is set to Restart Program. |
Execute | The start time for the selected duration interval. If the Repeat Interval is set to Weekly - specific days or Weekly - range of days, then after setting the Execute time, also set the day of the week in the On field. This field is only visible when the Schedule Type is set to Duration. |
Complete | The end time for the selected duration interval. If the Repeat Interval is set to Weekly - range of days, then after setting the Complete time, also set the day of the week in the On field. This field is only visible when the Schedule Type is set to Duration. |
Fixed Period | The fixed dates on which the schedule is to start and end. Start Date: This is the calendar date on which the schedule is to start. To set this field, tick its checkbox and enter the day, month and year, or select a date using the pulldown calendar widget. End By: This is the date on which the schedule is to end. To set this field, tick its checkbox and enter the day, month and year, or select a date using the pulldown calendar widget. A fixed period is optional. If a fixed period is not defined, the schedule will be effective from the time it is created and it will have no end time. If defined, a fixed period must always have a Start Date. The End By date is optional. |
Summary | This displays a summary description of the schedule's settings (read-only). |
Adding a New Schedule
- In FireDaemon Pro, open the service which is to be scheduled.
- In the Service Definition panel, click on the Scheduling tab.
- On the toolbar, click the Add Schedule button.
- The New Schedule dialog box appears. In this dialog box, enter the appropriate schedule settings.
For more information about the schedule fields, see The New Schedule Dialog. - Click the OK button.
The new schedule is added to the Scheduling tab.
Importing a Schedule
FireDaemon Pro provides two options for Importing a schedule in an XML file. These are accessed via the pulldown menu arrow button on the Service Definition toolbar.
- In FireDaemon Pro, open the service that is to be modified.
- In the Service Definition panel, click on the Scheduling tab.
- On the Service Definition toolbar, click the arrow next to the Add Schedule button.
A drop-down menu appears. - Select one of the following options:
- Import and Amend Schedule: Amend the existing schedule(s) using the imported schedule(s). Existing schedule(s) of the same name are replaced.
- Import and Replace Schedule: Delete all existing schedule(s) and replace them with the imported schedule(s).
- Select the XML file that contains the schedule details and click the Open button.
FireDaemon Pro immediately imports the new scheduling definitions and updates the schedule list accordingly.
Examples of Schedule Definitions
This section provides some sample schedule definitions in XML format.
To use one of these examples, copy and save the XML fragment to a .XML file on your system. Then import it into FireDaemon Pro as explained in Importing a Schedule above.
Restart on 1st day of each month
This schedule will restart the service at 4:00 AM on the 1st day of each month.
<?xml version="1.0"?> <fds:schedules xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:fds="http://xml.firedaemon.com/scheduling/v2" xmlns:fd="http://xml.firedaemon.com"> <schedule name="Restart on 1st day of each each month at 4AM"> <interval xsi:type="fds:attributive_interval" granularity="month_interval" length="1" blueprint="evenly_clocked"> <onset minute="0" hour="4" monthday="0"/> </interval> </schedule> </fds:schedules>
Restart on 2nd Tuesday each month
This schedule will restart the service at 4:00 AM on the 2nd Tuesday of every month.
<?xml version="1.0"?> <fds:schedules xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:fds="http://xml.firedaemon.com/scheduling/v2" xmlns:fd="http://xml.firedaemon.com"> <schedule name="Restart on 2nd Tuesday each month at 4AM"> <interval xsi:type="fds:attributive_interval" granularity="month_interval" length="1" blueprint="evenly_clocked"> <onset minute="0" hour="4" weekday="1" first_dow="0" nth_kday_of_month="2"/> </interval> </schedule> </fds:schedules>