Skip to main content

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​

Administrators only

The settings on this page are under Settings > Schedules, which only administrators can open.

  1. Open Settings > Schedules.
  2. Under Schedule tag, type the tag key your scheduler reads and press Enter. The default is Schedule.
  3. 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:

ChoiceMeaningTaken 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 defaultYes
Starts only (like AutoStart)The scheduler only starts machines by this tagNo
Stops only (like AutoStop)The scheduler only stops machines by this tagYes

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.

  1. Under Schedule tag, add AutoStart and AutoStop.
  2. Under What each tag does, set AutoStart to Starts only (like AutoStart) and AutoStop to Stops only (like AutoStop).
  3. Press Save changes.
  4. Optionally, under Friendly names, give AutoStop = 2000 a 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:

SettingDefaultEffect
Longest keep-on, in hours24How far ahead someone may set the time (1 to 336)
Reminder, in minutes before15When the person is told their time is nearly up
Time zoneEurope/LondonThe 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 onOffMakes 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.