Documentation/Scheduling/Timed Scheduled Scripts

Documentation :: Scheduling :: Time Scheduled Scripts

ScriptRunner provides the ability to schedule scripts to run at specific times. This is not intended to provide a replacement for tools such as cron, but can be useful when you want to capture the output of the script within ScriptRunner, or have ScriptRunner alert when the job fails. This can be extended further with Batch Schedules that allow scripts dynamically chained together.

Creating A Time Scheduled Script

• From the menu, select Schedules > Time Scheduled Scripts.

• Click .

• The Create Time Scheduled Script window should now be shown.
  
  
  
  
  • Description: A descriptive name that will be used to reference the job in other areas of ScriptRunner, including alerts.
  • Script: Select the script you wish to schedule. Only scripts applicable to your user group will be shown.
  • Start Time / End Time: (Optional) (Format HH:MM:SS) These define the time period in which the schedule will be triggered. Outside of the time window defined by these, the Time Scheduled Script will be not started. This can be useful for when wanting to schedule scripts to run only for a limited period of time, and then automatically stop.
    If the script is set to run on an agent, ScriptRunner will automatically set this host as the agent.
  • Script Host: (Optional) To override the host the script triggers on, select a Script Host here. If the script itself is set to run on a SSH host, then this host will need to have SSH access to that host for the scheduled to work. SSH hosts themselves can not be selected.
  • Run Time: (Format HH:MM) The time the script should trigger in format HH:MM.
  • Day Of Week: Select the day of week the script should trigger on.
  • Day Of Month: Enter the day of the month the script should trigger on, or 0 for every day.
  • Enabled: Tick this to allow the Time Scheduled Script to trigger and planned, or untick to prevent it running.

• Click .

• The Time Scheduled Script should now be saved and picked up to run a the given schedule.

Editing Time Scheduled Scripts

• From the menu, select Schedules > Time Scheduled Scripts.

• Click against the Time Scheduled Script you wish to update. Use and to scroll through pages of Time Scheduled Scripts if needed.

• The Edit Time Scheduled Script window should now be shown with details of the selected Time Scheduled Script.
  
  
  
  
  • Script: Select the script you wish to schedule. Only scripts applicable to your user group will be shown.
  • Start Time / End Time: (Optional) (Format HH:MM:SS) These define the time period in which the schedule will be triggered. Outside of the time window defined by these, the Time Scheduled Script will be not started. This can be useful for when wanting to schedule scripts to run only for a limited period of time, and then automatically stop.
    If the script is set to run on an agent, ScriptRunner will automatically set this host as the agent.
  • Script Host: (Optional) To override the host the script triggers on, select a Script Host here. If the script itself is set to run on a SSH host, then this host will need to have SSH access to that host for the scheduled to work. SSH hosts themselves can not be selected.
  • Run Time: (Format HH:MM) The time the script should trigger in format HH:MM.
  • Day Of Week: Select the day of week the script should trigger on.
  • Day Of Month: Enter the day of the month the script should trigger on, or 0 for every day.
  • Enabled: Tick this to allow the Time Scheduled Script to trigger and planned, or untick to prevent it running.

• Click .

• Changes to the Time Scheduled Script will now be saved. Any changes will take affect immediately.

Removing A Time Scheduled Script

• From the menu, select Schedules > Time Scheduled Scripts.

• Click against the Time Scheduled Script you wish to remove. Use and to scroll through pages of groups if needed.

• Click on the confirmation prompt.
  
  .

• The selected Timed Schedueld Script will now be removed.