Schedule tags
Delegaris does not start and stop machines on a schedule itself. Your hosting team's scheduler does that: AWS Instance Scheduler, Systems Manager Quick Setup, or something home-built. Those schedulers decide which machines to act on by a tag, such as Schedule = office-hours.
Delegaris needs to know which tag that is. It is how it can:
- tell that a machine is on a schedule, and show its schedule in the machine's details,
- take the tag off while someone keeps the machine on, so the scheduler leaves it alone, and put it back afterwards, and
- look up the schedule's hours under Friendly names.
Setting the schedule tag
The settings on this page are under Settings > Schedules, which only administrators can open.
- Open Settings > Schedules.
- Under Schedule tag, type the tag key your scheduler reads and press Enter. The default is
Schedule. - Press Save changes.
The value starts as SCHEDULE_TAG_KEYS in the environment (see Configuration). Once saved here, the saved value applies, on every copy of the service.
The key is case sensitive: Schedule and schedule are different tags.
Several schedule tags
Type each key and press Enter after each one. Use several when:
- different accounts or teams use different schedulers, each with its own tag, or
- one scheduler uses separate tags to start and to stop machines.
A machine is on a schedule when it carries any of them. When it is kept on, every schedule tag it carries that stops machines comes off, and each goes back at the end.
Reading schedules from the scheduler adds the scheduler's tag here automatically if it is not already listed. See Reading from the scheduler.
What each tag does
Once there is at least one tag, What each tag does lists them, each with a choice:
| Choice | Meaning | Taken off during a keep-on |
|---|---|---|
| Starts and stops (one schedule tag) | The usual kind: the scheduler both starts and stops machines by this tag. The default | Yes |
| Starts only (like AutoStart) | The scheduler only starts machines by this tag | No |
| Stops only (like AutoStop) | The scheduler only stops machines by this tag | Yes |
This matters for keeping machines on:
- A keep-on takes off only the tags that stop machines. A start-only tag stays on, so the machine still starts at its usual time the next day.
- Only a tag that stops machines puts a running machine "on a schedule" for keeping on. A running machine with only a start-only tag has no Keep on… button, because nothing will turn it off.
- When looking up a machine's hours under Friendly names, the stop tag's values are used first, then "starts and stops" tags, then start-only ones.
Example: AutoStart and AutoStop
A scheduler starts machines tagged AutoStart = 0800 and stops machines tagged AutoStop = 2000.
- Under Schedule tag, add
AutoStartandAutoStop. - Under What each tag does, set
AutoStartto Starts only (like AutoStart) andAutoStopto Stops only (like AutoStop). - Press Save changes.
- Optionally, under Friendly names, give
AutoStop = 2000a name and its running hours, so Delegaris knows when the machine would normally be off.
Someone now keeps a machine on until 22:00. Delegaris takes AutoStop off and leaves AutoStart alone. The scheduler does not stop the machine at 20:00. At 22:00 Delegaris stops it and puts AutoStop = 2000 back. At 08:00 the next morning the scheduler starts it as usual.
The other settings on this tab
Settings > Schedules also holds the keep-on settings:
| Setting | Default | Effect |
|---|---|---|
| Longest keep-on, in hours | 24 | How far ahead someone may set the time (1 to 336) |
| Reminder, in minutes before | 15 | When the person is told their time is nearly up |
| Time zone | Europe/London | The clock the weekly summary and nightly backup run by, and the one offered first for a new schedule. Each schedule under Friendly names keeps its own time zone |
| Ask what it is for whenever something is kept or turned on | Off | Makes the reason compulsory for a new keep-on |
The starting values come from KEEP_ON_MAX_HOURS, KEEP_ON_WARN_MINUTES and TIMEZONE in the environment.
Machines with no schedule tag
A machine with none of the schedule tags is not on a schedule. If it is running there is nothing to keep it on past, so it has no Keep on… button. If it is stopped it can still be turned on for a set time, and is stopped again at the end.