Chapter 6. Management Jobs
Management Jobs assist in the cleaning of old data from automation controller, including system tracking information, tokens, job histories, and activity streams. You can use this if you have specific retention policies or need to decrease the storage used by your automation controller database.
From the navigation panel, select
The following job types are available for you to schedule and launch:
- Cleanup Activity Stream: Remove activity stream history older than a specified number of days
- Cleanup Expired OAuth 2 Tokens: Remove expired OAuth 2 access tokens and refresh tokens
- Cleanup Expired Sessions: Remove expired browser sessions from the database
- Cleanup Job Details: Remove job history older than a specified number of days
6.1. Removing Old Activity Stream Data
To remove older activity stream data, click the launch
icon beside Cleanup Activity Stream.
Enter the number of days of data you would like to save and click .
6.1.1. Scheduling deletion
Use the following procedure to review or set a schedule for purging data marked for deletion:
Procedure
For a particular cleanup job, click the Schedules tab.
Note that you can turn this scheduled management job on and off using the ON/OFF toggle button.
- Click the name of the job, "Cleanup Activity Schedule" in this example, to review the schedule settings.
Click to modify them. You can also click to create a new schedule for this management job.
Enter the appropriate details into the following fields and click Save:
- Name required
- Start Date required
- Start Time required
- Local time zone the entered Start Time should be in this timezone.
- Repeat frequency the appropriate options display as the update frequency is modified including data you do not want to include by specifying exceptions.
- Days of Data to Keep required - specify how much data you want to retain.
The Details tab displays a description of the schedule and a list of the scheduled occurrences in the selected Local Time Zone.
Jobs are scheduled in UTC. Repeating jobs that run at a specific time of day can move relative to a local timezone when Daylight Saving Time shifts occur.
6.1.2. Setting notifications
Use the following procedure to review or set notifications associated with a management job:
Procedure
- For a particular cleanup job, select the Notifications tab.
If none exist, for more information, see Notifications in the Automation controller User Guide.
The following shows an example of a notification with details specified:
6.2. Cleanup Expired OAuth2 Tokens
To remove expired OAuth2 tokens, click the launch
icon next to Cleanup Expired OAuth2 Tokens.
You can review or set a schedule for cleaning up expired OAuth2 tokens by performing the same procedure described for activity stream management jobs.
For more information, see Scheduling deletion.
You can also set or review notifications associated with this management job the same way as described in setting notifications for activity stream management jobs.
For more information, see Notifications in the Automation controller User Guide.
6.2.1. Cleanup Expired Sessions
To remove expired sessions, click the launch
icon beside Cleanup Expired Sessions.
You can review or set a schedule for cleaning up expired sessions by performing the same procedure described for activity stream management jobs. For more information, see Scheduling deletion.
You can also set or review notifications associated with this management job the same way as described in Notifications for activity stream management jobs.
For more information, see Notifications in the Automation controller User Guide.
6.2.2. Removing Old Job History
To remove job history older than a specified number of days, click the launch
icon beside Cleanup Job Details.
Enter the number of days of data you would like to save and click .
The initial job run for an automation controller resource, such as Projects, or Job Templates, are excluded from Cleanup Job Details, regardless of retention value.
You can review or set a schedule for cleaning up old job history by performing the same procedure described for activity stream management jobs.
For more information, see Scheduling deletion.
You can also set or review notifications associated with this management job in the same way as described in Notifications for activity stream management jobs, or for more information, see Notifications in the Automation controller User Guide.
