If you’re an ImmyBot starter client, you do not have access to Schedules in ImmyBot
Overview
This document is intended to show you how to create schedules in ImmyBot for ongoing maintenance. Within Schedules you can manage when maintenance runs for your endpoints, set whether to send notification emails out, and choose which deployments to apply the Schedule to.
Prerequisites
Access to an ImmyBot instance that is either Immy Standard or Immy Forever.
Creating a Schedule
- Navigate to Schedules on the left hand column
- Click New at the top
- Fill out this form as necessary
- Click Create
Cron Expressions in ImmyBot
Common Examples
| Description | Cron Expression |
|---|---|
| Every day at 2:00 AM | 0 2 * * * |
| Every Sunday at 3:00 AM (weekly maintenance) | 0 3 * * 0 |
| Every weekday at 6:00 AM (business hours prep) | 0 6 * * 1-5 |
| First day of every month at midnight | 0 0 1 * * |
| Every Monday at 1:00 AM | 0 1 * * 1 |
Field Reference
โโโ Minute (0-59) โ โโโ Hour (0-23) โ โ โโโ Day of Month (1-31) โ โ โ โโโ Month (1-12) โ โ โ โ โโโ Day of Week (0=Sun, 6=Sat) โ โ โ โ โ * * * * *
Tips
- ImmyBot uses standard 5-field cron (no seconds field)
- Times are evaluated in the tenant’s local timezone if configured, otherwise UTC
- Schedules are allowed to run at most once per day
- For patching windows, pairing a maintenance schedule with a detection schedule (e.g. detect daily, remediate weekly) is a common pattern
Unsupported Schedule Patterns
ImmyBot does not support sub-daily or interval-based schedules. The symbols *, ,, /, and - are not permitted in the minute or hour fields โ both must be set to a single fixed value. This means expressions like */30 * * * * (every 30 minutes) or 0 */6 * * * (every 6 hours) are invalid.
ImmyBot also does not support interval-based day patterns such as:
- “Every other Wednesday”
- “Every 3rd weekday”
- “Every other week on Tuesday and Thursday”
Cron has no concept of “every N weeks” or alternating days, and ImmyBot’s once-per-day limit means these patterns cannot be approximated with step syntax either.
Creating Schedules for Specific Tenants
There are 2 ways to go about this.
- Follow the Creating a Schedule instructions above and set Tenant in the Target section to whoever you need it to apply to
- Create the Schedule within the Tenant itself
- Navigate to Tenants on the left hand column
- Click on Schedules
- Click on New
- Fill out the form as necessary
Deleting a Schedule
- Navigate to Schedules on the left hand column
- Click on the Red Trashcan button to the left of the Schedule you want to delete
Recovering a Schedule
ImmyBot does not support recovery of Schedules natively, however, you can look at the Audit Log and recreate the deleted Schedule.
- Navigate to Show More > Audit
- Filter the Object Type to Schedule
- Find the Schedule that was deleted and expand the audit log
- This contains the information of the schedule that was deleted. You will need to follow the Creating a Schedule instructions above and recreate the Schedule.
Caveats and Considerations
ImmyBot will run every schedule applied to a tenant or endpoint, there is no inheritance for schedules like there is for deployments. Keep this in mind as you move forward with creating and applying tenants.
Best Practices
Please see Best Practices for our recommendations.