Controlling Resources Using Control Actions

What is a Control Action?

Control actions enable you to control certain types of servers and services from SAS Environment Manager. You can create control actions to perform operations such as starting, stopping, restarting, pausing, and resuming a server or starting, stopping, and sending messages through a service. The specific actions available depend on the server or service type selected. You can define resource actions to run immediately, to run on a schedule, or to run in response to an alert.
You can use control actions to control these types of servers:
  • PostgreSQL SAS Web Infrastructure Platform Data Server (PostgreSQL 9.x)
  • SAS Object Spawner
  • SAS OLAP Server
  • SAS Metadata Server
  • SAS Web Application Server (SpringSource tc Runtime)

Performing Immediate Resource Control Actions

To use a control action to perform an immediate action on a resource, follow these steps:
  1. In the Resource Details page for the selected server or service, click Control. If this menu item is not present, the resource does not support control actions. The Control Action page is displayed.
    control action page
  2. In the Quick Control area, select the type of action that you want to perform in the Control Action field.
  3. Specify any arguments for the action in the Control Arguments field.
  4. Click the start icon to perform the action.

Scheduling Resource Control Actions

To create a scheduled resource control action, follow these steps:
  1. In the Resource Details page for the selected resource, click Control. If this menu item is not present, the resource does not support control actions. The Control Action page is displayed.
  2. In the Control Action Schedule area, click New. The Scheduled Control Action page is displayed.
  3. Select the action that you want to perform in the Control Action field.
  4. In the Schedule area, select the radio button next to the date and specify the date and time that the scheduled action should take place.
  5. Specify how often the action should recur and when the scheduled recurrence should end.
    control action recurrence
  6. Click OK to save the scheduled control action.
To view the list of scheduled control actions for the resource, click Control in the Resource Details page for the selected resource. All scheduled control actions are listed in the Control Action Schedule area.

Performing Control Actions in Response to an Alert

To define a control action to occur in response to an alert, follow these steps:
  1. Create or edit an alert definition. See Defining an Alert for more information. On the Alert Definition page, click Control Action, the click Edit. The Add Control Action page is displayed
  2. Use the Resource Type field to select the type of server or service for which you want to create the control action.
  3. After you select the resource type, the Resource Name field is populated with all instances of the selected resource type. Select the instance for which you want to create the control action.
  4. Select the type of action to be performed in the Control Type field. The field contains only actions that are supported on the selected resource type.
  5. Click OK to define the control action. The defined action now take place whenever the associated alert occurs.