-
Notifications
You must be signed in to change notification settings - Fork 1
2.1 Recurring Maintenances
These are the ones you'll probably use the most. Once set, they will always be set for the dates matching the given ruleset. Recurrences can be repeated on a daily, weekly or monthly basis.
maintenance[<[timezone]>|<recurrence>|<weekday>|<dates>|<months>|<start time><end time>|<[description]>]
Values in brackets are optional, the rest needs to be there.
| Column | Description |
|---|---|
| timezone | This is the timezone that will be applied to the maintenance window. When omitted, the default timezone will be used. You can use any IANA formatted timezone here. A list of all timezones can be found under http://php.net/manual/en/timezones.php |
| recurrence | This defines the frequency of the maintenance window. For example every first Monday, the last Sunday or every second friday. Note that some combinations, e.g. the 5th Friday in February don't make much sense as they practically never happen. The format looks like this: [daily|weekly|monthly]-[interval]-[dd/mm/YYYY] Daily, Weekly, and Monthly are the frequencies. Interval is a numeric value, determining which occurrence of the rule you want the rule to match. The date is any date in the past or future, allowing you to make maintenance windows only match after a certain date. See examples below. |
| weekday | Represents the days of the week. You can combine them via comma, e.g. mo,tu,fr. You can also use all for the rule to apply to all weekdays. If you preceed them with numbers 1-5 combined with a monthly recurrence rule, it will match the nth day of the week. Positive numbers start from the beginning, negative from the end of the interval. See examples below fore a more detailed description. Allowed values are all, mo, tu, we th, fr, sa, and su |
| date | The days of the month the rules apply to. You could do 1,2,3 for the first three days of the month or -1,-2 for the rule to match the last and penultimate days of the month. all can be used as well here. Allowed values are all and integers from 1 to 31 (comma-separated) |
| month | These resemble the months. The rules will only apply to these months, e.g. the last Sunday in December. Allowed values are all and integers from 1 to 12 (comma-separated) |
| start time | The start time of the maintenance window in 24h format, e.g. 23:00 |
| end time | The end time of the maintenance window in 24h format, e.g. 23:30 |
| description | A description of the maintenance window. It will show up in the report and help to keep track of them |
maintenance[daily-3-9/06/2017|all|all|all|23:00|23:30|SLA Window]
| Recurrence | Weekdays | Dates | Months | Start | End | Description |
|---|---|---|---|---|---|---|
| daily-3-9/06/2017 | all | all | all | 23:00 | 23:30 | SLA Window |
Every 3 days at 23h at minute 0, starting from 6/9/17, 11:00 PM
maintenance[weekly-2-20/06/2017|mo,tu,we,th,fr|all|all|20:00|22:00|Maintenance Window]
| Recurrence | Weekdays | Dates | Months | Start | End | Description |
|---|---|---|---|---|---|---|
| weekly-2-20/06/2017 | mo,tu,we,th,fr | all | all | 20:00 | 22:00 | Maintenance Window |
Every other week on Monday, Tuesday, Wednesday, Thursday and Friday at 20h at minute 0, starting from 6/20/17, 8:00 PM
maintenance[monthly-1-20/06/2017|1mo,2tu,-1fr|all|all|20:00|22:00|New Window]
| Recurrence | Weekdays | Dates | Months | Start | End | Description |
|---|---|---|---|---|---|---|
| monthly-1-20/06/2017 | 1mo,2tu,-1fr | all | all | 20:00 | 22:00 | Maintenance Window |
Monthly on the first Monday, the second Tuesday, and the last Friday of the month at 20h at minute 0, starting from 6/20/17, 8:00 PM
- You'll need to configure a start date, otherwise the repetition rule won't be accurate
- nᵗʰ day of the week configurations only work with the monthly frequency
- yearly can also be used, but has not been tested