Skip Headers

Oracle Intelligent Agent User's Guide
Release 9.0.2

Part Number A95412-01
Go To Documentation Library
Go To Product List
Solution Area
Go To Table Of Contents
Go To Index

Go to previous page Go to next page

New Agent Features for 9i

Topics covered in this document include:


Blackouts allow Enterprise Manager users to suspend any or all management and/or data collection activity on one or more managed targets. This capability permits maintenance or emergency operations to be performed

Specifically, blackouts can suspend:

Defining Blackouts

Blackouts must be created at the target-level, i.e., they must be defined on the node where the Intelligent Agent resides. Blackouts are controlled with a command line interface. The blackout subsytem associates any command line request with a special type of Agent user called the CLI user. Only one immediate blackout can be set at a time. Multiple target blackouts can exists simultaneously.

Once in effect, blackouts cannot be modified. To change the status of a particular blackout, you must first delete the existing blackout and then re-create a new blackout with the desired changes.


A blackout can only be cancelled by the user who originally set it.

Blackout Command Line Interface

The blackout command line tool exists on the node where the Agent resides and can be used by administrators to set/cancel blackouts. The Intelligent Agent must be running in order to set a blackout. User commands are as follows:

Table 3-1
Blackout Action Command

Define a blackout.

agentctl start blackout  [-d [DD] HH:MM] [<target name>]

where the -d option is used to specify duration in the format DD HH:MM where:

DD indicates number of days which is optional

HH indicates number of hours

MM indicates number of minutes

Remove a blackout

agentctl stop blackout [<target name>]

Display the status of a blackout (machine name, target type, and duration).

agentctl show blackout

Command Line Examples

The following examples illustrate how to use the blackout command line utility under different situations and the output generated.

Situation 1: You want to start a blackout on the target for 10 minutes.

$ agentctl start blackout -d 0:10
Blackout registered on database

Situation 2: You want to stop any blackout set by (the CLI user) effective on target Note: Blackouts set by other Agent users are not cancelled.

$ agentctl stop blackout
Blackout canceled on database

Situation 3: You want to start blackouts on all managed targets for an indefinite length of time. This is equivalent to blacking out the entire Agent.

$ agentctl start blackout
Do you wish to blackout the entire agent (Y/N) ? [N] y
All targets on the agent are blacked out.

Situation 4: You want to stop blackouts on all registered targets.

$ agentctl stop blackout
Do you wish to cancel blackout on all targets (Y/N) ? [N] y
Blackout canceled on all targets.

Situation 5: You want to know the status of blackouts on a target.

$ agentctl status blackout is blacked out. Blackout will end in 2 hours.

Situation 6: You want to set a blackout on a target whose name matches another target of a different type. In this case, the command line interface allows you to interactively select the desired target.

$ agentctl start blackout payroll 
Following targets matching "payroll" have been found.
1.  payRoll ( Database )
2.  payRoll ( Listener )
Choose the target to blackout [1] : 2
Blackout registered on "payroll" listener

New Control Utility

Beginning with the 9i version of the Intelligent Agent, the Intelligent Agent has its own control utility.

If you want to... Enter the command...

Start the Agent and dbsnmpwd.

agentctl start agent

Stop the Agent and dbsnmpwd.

agentctl stop agent

Verify status of the Agent

agentctl status agent

Stop and then restart (bounce) the Agent. This option will only restart the Agent if it is already running.

agentctl retart agent

Go to previous page Go to next page
Copyright © 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Go To Product List
Solution Area
Go To Table Of Contents
Go To Index