5.6 Controlling Oracle Traffic Director Instances Through Scheduled Events

As an administrator, if you have to manage a large number of configurations and their instances, repetitive tasks such as restarting and reconfiguring instances of each configuration individually can become tedious. You can schedule events for administrative tasks to be performed automatically at defined intervals; or on specific days of the week, times of the day, or dates of the month.

You can create and manage events by using either the administration console or the CLI.

Note:

The CLI examples in this section are shown in shell mode (tadm>). For information about invoking the CLI shell, see Section 2.3.1, "Accessing the Command-Line Interface."

Managing Events Using the Administration Console

To manage events by using the administration console, do the following:

Log in to the administration console, as described in Section 2.3.2, "Accessing the Administration Console."
Click the Configurations button that is situated at the upper left corner of the page.

A list of the available configurations is displayed.
Select the configuration for which you want to schedule events.
In the navigation pane, select Advanced Settings.

The Advanced Settings page is displayed.
Scroll down to the Scheduled Events section of the page.

It lists events that are currently scheduled for the configuration.
- To enable or disable an event, select the Enable/Disable check box.
- To delete an event, click the Delete icon.
- To create an event, click New Event.
  
  The New Configuration Event dialog box is displayed.
  
  Select the event that you want to schedule, and specify the interval or time at which the event should be performed, and then click OK.
A message, confirming the change, is displayed in the Console Messages pane.

In addition, the Deployment Pending message is displayed at the top of the main pane. You can either deploy the updated configuration immediately by clicking Deploy Changes, or you can do so later after making further changes as described in Section 4.3, "Deploying a Configuration."

Managing Events Using the CLI

Creating an event

To create an event, run the create-event command, as shown in the following examples.
```
tadm> create-event --config=soa --command=restart --interval=86400
tadm> create-event --config=soa --command=reconfigure --time=14:00
```
The first command schedules an event to restart all the instances of the configuration soa after every 86400 seconds.

The second command schedules an event to reconfigure all the instances of the configuration soa at 2 p.m. every day.

Note:

For the scheduled events to take effect, you should redeploy the configuration.

Viewing a list of events

To view a list of scheduled events, run the list-events command.

For example, the following command displays the events scheduled for instances of the configuration soa.

tadm> list-events --config=soa --verbose --all
command        enabled    day-of-month   month   day-of-week   time    interval
-------------------------------------------------------------------------------
restart        false      -              -       -             -       60
reconfig       true       -              -       -             -       60

Disabling an event

When you create an event, it is enabled automatically, unless you specified the --no-enabled option.

To disable an event, run the disable-event command, as shown in the following example:
```
tadm> disable-event --config=soa --command=restart --interval=86400
```
Enabling an event

To enable an event, run the enable-event command, as shown in the following example:
```
tadm> enable-event --config=soa --command=restart --interval=86400
```
Deleting an event

To delete an event, run the delete-event command, as shown in the following example:
```
tadm> delete-event --config=soa --command=restart --interval=86400
```

For the updated configuration to take effect, you should deploy it to the Oracle Traffic Director instances by using the deploy-config command.

For more information about the CLI commands mentioned in this section, see the Oracle Traffic Director Command-Line Reference or run the commands with the --help option.