Oracle Intelligent Agent User's Guide
Release 9.0.1

Part Number A88771-02
Go To Documentation Library
Go To Product List
Book List
Go To Table Of Contents
Go To Index

Master 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 mainentance 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 utiltiy.

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 

Go to previous page Go to next page
Copyright © 1996-2001, Oracle Corporation.

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

Master Index