Oracle Enterprise Manager Administrator's Guide 
Release 1.6 
A63731-01
 
Library
 
Product
 
Contents
 
Index
 

Prev Next

5
Event Management

The Event Management System (EMS) allows you to monitor specific event conditions, such as loss of service or lack of storage, that occur in your network environment. You choose events on databases, listeners, or nodes, then select the threshold parameters for which you want to be notified. You can notify specific system administrators when an event condition occurs. For some events, you can also choose to execute a fixit job that automatically corrects the problem.

The following topics are discussed in this chapter:

Event Management Process

The Event Management System allows you to efficiently monitor a large system. Using EMS and Intelligent Agents, you can effectively monitor any number of databases 24 hours a day, and be alerted when a problem is detected. You can also pinpoint only the services you wish to monitor. EMS can be extended to include other third-party applications that detect events independent of the Intelligent Agents. These applications can be integrated into EMS and communicate directly with the Intelligent Agents.

In the Event Management System, event settings are stored based on the administrator registering the event. This allows administrators of large systems to customize their event systems to their preferences and tasks. Administrators receive only those messages related to the events that they have submitted.

The Event Management System includes the following processes:

Determining Administrators

You set up the notification services and the administrators that need to be notified for the events. If you plan to notify administrators other than the current Console operator, you need to determine:

Using Event Sets

You need to create and register event sets, which are simply a group of event conditions that you want to monitor. Oracle Enterprise Manager includes a variety of predefined events that you can use when creating event sets. The events are grouped by services:

Creating Events

You can use several Oracle predefined event sets that have been installed with Enterprise Manager. See Event Categories and Types on page 5-6. You can also create your own event scripts. EMS events are implemented as Tcl scripts with Oracle extensions (OraTcl) to include database specific commands. For information on writing event scripts, see the Oracle Enterprise Manager Application Developer's Guide.

Some events have parameters with threshold values that you can customize for your system. The parameter settings, fixit job, and frequency are entered in the Event Information section of the Parameters page of the Event Set Management property sheet. See Event Set Management Parameters Page on page 5-16.

Registering Events

Event sets are registered to specific destinations, such as nodes, listeners, or databases. The status of a registered set is viewed in the Status page of the Modify Registration property sheet. This property sheet is displayed with the Modify Registration option of the Event menu. See Registrations Status Page on page 5-21.

When an event is submitted to an agent, the Communication Daemon attempts to validate the specified destinations. See Destination Validation Dialog on page 2-14.

The event scripts are stored, registered, and executed on a node with the permissions of the Intelligent agent. However, some of the database events, such as Chain Row, require access to system tables and require additional permissions. You need to set up preferred credentials for the monitored database with a user that has system privileges. See Console User Preferences on page 1-25.

The Intelligent agent is responsible for detecting when a specific event condition has occurred, notifying the Console, and running a fixit job to correct the problem if specified. You need to create fixit jobs with the Job system before you can associate them with an event.

Event scripts can save a state, such as values of global variables, between executions of an event script. This allows the agent to remember if it has already detected a certain event and eliminates redundant event messages to the Console.

The Event Management system uses the Console's daemon process to register event set information with the appropriate Intelligent Agents on nodes in the network. You determine the frequency that an agent checks an event. See Frequency on page 5-17 for details on setting the frequency interval for an event.

Event Occurrences

When an event condition occurs, the agent is responsible for alerting the Console and administrators. Each event is logged in the repository and can be viewed and acknowledged in the Outstanding Events window of the Console. See Figure 5-1, "Event Management Menu and Window" for an illustration of the Event window.

Note:

If an event has been registered on a node, then the UpDown Node event is implicitly registered and is triggered when the Intelligent Agent is down.

Event Notifications

The administrators can be notified in various ways, such as electronic mail or paging. Notification occurs as follows:

Interpreting Events

All events return values and some events produce output messages. The events return color values depending on the severity of the event. The colors are displayed on the event severity flag that is located:

The colors of the event severity flag are:

Note:

Some events, such as UpDown, Probe, and User Blocks events, do not return a warning value because the warning threshold parameter is not used. The event has either occurred or not occurred.

Some events produce output messages that are displayed in the Error Messages for Event list in the Status page of the Modify Registration property sheet. See Registrations Status Page on page 5-21.

Correcting Problems

When an event occurs, you need to correct the problem. In some cases, you can create a fixit job specifically for the event. These situations are noted in the online help for Oracle events.

In other cases, the solution requires careful attention by a system administrator. For example, space management event conditions may require an administrator to increase space requirements and resource management conditions may require an administrator to adjust initialization parameters.

For information on how to correct event conditions, refer to the appropriate documentation. To correct Oracle database problems, refer to the Oracle Server Administrator's, Tuning, and Reference Guides. For network problems, refer to the Oracle networking guides for your system.

Event Categories and Types

The Oracle predefined events for the database, listener, and node service types are grouped into categories:

Only the UpDown events are included with Oracle Enterprise Manager. Additional advanced events are available with the optional Oracle Performance Pack. For information on events and their parameters, see the online help for Oracle predefined events and Oracle UpDown Events on page 5-31. All the Node events are supported on Unix and Windows NT platforms. For other platforms, see your platform-specific documentation.

Fault Management Events

This category of events monitors for catastrophic conditions on the system, such as a database, node, or listener is down. Immediate action must be taken by the administrator. Examples of events available in this category include:

Most of the fault management events do not require any threshold values because the event only checks whether the service is up or down. For the Alert event, The event checks whether error messages are written into the database alert log file.

The UpDown events are provided with the Enterprise Manager base product. These events check whether a database, listener, or node is available. With the UpDown event for databases or listeners, you can use the Startup Database or Startup Listener task as a fixit job to re-start the database or listener. To avoid executing that job when the database or listener is brought down intentionally, you need to remove the event registration.

Space Management Events

This category of events tracks possible space problems, such as running out of space on a disk or archive device. Examples of space management events in this category include:

To check for space management events, set a threshold on the free space left. For example, set an alert if the free space on a disk falls below a specific number of bytes. In order to properly choose the threshold value, you need to know the characteristics of the tablespaces. For example, you would want to know whether the tablespaces contain online transaction processing (OLTP) tables or decision support tables. The former usually has a very fast growth rate, while the latter almost never grows.

Resource Management Events

This category of events tracks possible resource problems, such as exceeding datafile or lock limits. Examples of resource management events in this category include:

To check for resource management events, set a threshold on the percentage of a resource used. For example, you can set an alert if the percentage of the datafile resource used is greater than a specified value.

Performance Management Events

This category of event monitors the system for performance problems, such as excessive disk input/output or library cache miss rate. Examples of events in this category include:

To check for performance management events, set a threshold on a system value. For example, you can set an alert if the library cache miss rate is greater than a specific value. The set of threshold values is system specific, depending on the hardware platform, number of users, and other factors.

Event Window

The Event Management window contains the following pages:

You can switch between the pages by clicking the tab of each page. The rows in both pages can be sorted on any column by clicking the column heading. See Figure 5-1, "Event Management Menu and Window" for an illustration of the Event window.

Figure 5-1 Event Management Menu and Window

 

The Event window can be hidden or shown by selecting Show Event Pane in the Console View menu. You can also hide or show the window by clicking on the square clock icon in the Console toolbar.

Outstanding Events Page

The Outstanding Events page displays event sets that have been applied and have occurred.

Event

Name of the event and severity flag. Severity of the event can be alert, warning, and clear. These are represented by red, yellow, and green.

Node

Node where the event was monitored.

Type

Type of service that the event monitors, such as Database, Listener, or Node.

Destination

The service that is being monitored.

Date

Date of the event.

Event Message

Message associated with the event, such as "Database went down" or "Tablespace SYSTEM reached 90% capacity."

Ack. Text

The Comment entered when the event was acknowledged.

Acknowledging Events

To acknowledge an event that has occurred, double-click on the event to display the Acknowledge Event property sheet. You can also select an event and choose the Acknowledge option in the Event menu. When you acknowledge an event, you can enter notes on the nature and progress of the event condition. After you have reviewed an event, you can move it to the History window. See Acknowledging an Event on page 5-23.

Event History Page

The Event History page displays a history of events that have occurred and have been acknowledged by an administrator or cleared by an agent. The Event History Page contains the same columns as the Outstanding Events page, plus the following:

Cleared By

Name of user that cleared the event.

Ack. Date

Date that the event was acknowledged.

Viewing Acknowledgments

To view any Comments made by the administrator that acknowledged the event, double-click on the event to display the Acknowledge Event dialog box.

Saving Event History

You can save the events from the Event History page to a text file and clear the events from the Event History window. This prevents the Event History page from being overloaded with obsolete events that occurred in previous days.

Registrations Page

The Registrations page displays the event sets that have been applied and registered to monitor events on any network objects. The Registrations page contains the following information:

Type

Type of event set, such as Database, Node, or Listener is signified by an icon.

Destination

The service that event is monitoring.

Set Name

Name of the event set that is registered.

Event Status

The number of the pending, and successful, and failed events in the event set.

Modify Registrations Property Sheet

Select Modify Registration from the Event menu or double-click on the selected registered event set to display the property sheet for the event set. The property sheet allows you to view and modify registration information. Select the status page tab to display a detailed view of the status of each event. Some events produce output messages that are displayed in the Error Messages for Event list in the Status page of the Modify Registration property sheet. See Registrations Status Page on page 5-21.

Event Set Library Page

The Event Set Library page displays the event sets that have been created. The Event Set Library page contains the following information:

Type

Type of event set, such as Database, Node, or Listener is signified by an icon.

Set Name

Name of the event set.

Description

Description of the event set.

# of Events

Number of events in the set.

Event Set Property Sheet

Double-click on an event set to display the property sheet for the event set. The property sheet allows you to view and modify the event sets.

Oracle Event Sets

Several predefined event sets have been installed with Enterprise Manager. These appear in the Event Set Library page of the Event window. You can apply these event sets to destinations on your network. The event sets include:

Note:

Only the UpDown event sets are included with Oracle Enterprise Manager. Additional advanced event sets are available with the optional Oracle Performance Pack.

To view the specific events assigned to an event set, double-click on the event set in the Event Set Library page and view the Event page of the Event Set Management property sheet. For information on Oracle events and their parameters, see the online help for Oracle events and Oracle UpDown Events on page 5-31.

Event Menu

The Event menu allows you to set up event set and administrator information. This menu also provides options to register, track, and view specific events. Menu options are enabled depending on the items selected in the Event window. See Figure 5-1, "Event Management Menu and Window" for an illustration of the Event menu.

Note:

When you register or remove an event, there is usually a slight delay while the agent processes the request.

Acknowledge Event

Acknowledges the selected event in the Outstanding Events page.

Enter any optional Comments on the nature or progress of the event condition in the General page of the Acknowledge Event property sheet, then click on the Move to History button to move the event to the Event History page or click on the Keep button to leave the event in the Outstanding Events page. See Acknowledging an Event on page 5-23.

Register Event Set

Registers, or applies, the selected event set to a destination. This action monitors the destination, or network object. See Creating, Modifying, or Viewing an Event Registration on page 5-19.

Modify Registration

Modifies the selected registered event set. See Creating, Modifying, or Viewing an Event Registration on page 5-19.

Remove Registration

Removes the selected registered event set. If you experience problems removing an event, see the Delete option of the Daemon Manager Menu on page 6-11.

Create Event Set

Displays the Event Set Management property sheet and allows you to create the definition of a new event set. See Creating or Modifying an Event Set on page 5-14.

Modify Event Set

Modifies the definition of an existing event set. See Creating or Modifying an Event Set on page 5-14.

Remove Event Set

Removes the selected event set from the Event window.

Save History

Saves the contents of the Event History page to a file.

Print History

Prints the contents of the Event History page to a file.

Clear History

Clears the contents of the Event History page to a file.

Administrator List

Displays a list of administrators in the Administrators dialog box. Each row in the list contains the Administrator's Name, Paging Service, Email Service, and Email ID.

You can add, delete, and modify administrator information in the Administrators dialog box. When add or modify an administrator, the Administrator property sheet appears. The property sheet contains the General, Systems, and Availability pages. See Managing Administrators on page 5-24.

Configure Services

Displays the Services Configuration menu. You can configure Mail, Paging, or Modem information.

To configure mail services, see Configuring Mail Services on page 5-27.

To configure paging services, see Configuring Paging Services on page 5-28.

To configure modem settings, dialing information, and trace log, see Oracle UpDown Events on page 5-31.

Context-Sensitive Menus

If you select an item in the Event window with the right mouse button, the context-sensitive menu for that item appears. This menu is a subset of the Event menu.

Creating or Modifying an Event Set

Event sets include the service type and the event information that you want to monitor. Event sets can consist of multiple events. To create or modify an event set:

  1. Choose the Create Event Set option from the Event menu to display the Event Set Management property sheet
  2. Complete or modify the fields in the General, Events, and Parameter pages of the property sheet to create a new event set. If you modify an event set that has been registered, those changes are not used by the registered event set.
  3. Click the OK button at the bottom of the property sheet to save and exit. The new event set appears in the Event Set Library page of the Event window.
  4. You can now register this event set to the destinations you want to monitor.

The property sheet for creating a new event set is the same as the property sheet for modifying an event set, except that the event set name field is read-only. See Figure 5-2, "Event Set Property Sheet" for an illustration of the Event Set Management property sheet.

You can also use event sets that have been installed with Oracle Enterprise Manager. See Event Categories and Types on page 5-6.

Event Set Management General Page

On the General page, you determine the set name, service type, description, and whether this event set should monitor third-party events.

Name:

Enter an event set name.

Service Type:

Select the service type you want to monitor from the pull-down list. The types include Database, Listener, Node, or other service that is integrated into the Console.

Description:

Enter a description or comment for the event set.

Accept third-party events

Check this box to allow the Event system to monitor events that have been initiated outside the Event Management system. You do not need to enter information in the Events or Parameters pages. After completing the Event Set General page, save the event set and register the set at selected destinations. For information on event scripts, see the Oracle Enterprise Manager Application Developer's Guide.

Event Set Management Events Page

On the Events page, you determine the events that you want to monitor.

Available Events:

Select the events in the list you want to monitor in this event set, then click on the << (Add) button to move the events to the Selected Events list.

Selected Events:

Select the events in the list you want to remove from this event set, then click on the >> (Remove) button.

Figure 5-2 Event Set Property Sheet

 

Event Set Management Parameters Page

The fixit job, frequency, and parameter settings are entered in the Event Information section of the Parameters page of the Event Set Management property sheet. The settings and types of parameters vary according to the event selected. Some events do not have parameters. For information on events and their parameters, see the online help for Oracle events and Oracle UpDown Events on page 5-31.

Choose Fixit Job

A fixit job is designed to correct a problem. For example, you may want the agent to run a job to restart a database when the database instance has shut down unexpectedly. Fixit jobs have been created with the Job system and have been designated as fixit jobs. The jobs must be submitted and running on the same destination that the event is set on. See Job General Page on page 4-10.

Fixit job options are:

To turn off a fixit job after an event set has been registered, you must remove the event registration, select <None> for the fixit job, and then register the event set.

Note:

Each event set must use a unique fixit job on each destination where the event is registered. Also, when a single agent is monitoring multiple databases at a destination, create a separate event set and fixit job for each database.

Frequency

Determine the frequency that you want the event to monitor the selected destinations. The frequency determines how often the event condition is checked. For example, if the frequency is set to 30 seconds, the event condition is checked every 30 seconds. To ensure timely notification, set the frequency to the smallest interval possible. To set the frequency:

See Event Notifications on page 5-4 for details on the notification frequency.

Parameters

The parameters for an event are displayed when the event is selected in the Selected Events list. The parameters vary according to the event selected. Some events do not have parameters.

You can accept the default values or change the values for the parameters. To enter parameter values for an event, you can:

Filtering

Filtering is used in event sets such as Chunk Small and Maximum Extents. Examples of filters are = 'SYSTEM', LIKE '%SMP%', and IN ('SYSTEM', 'TOOLS'). Note that the quotes are single quotes. Use uppercase to match the case of the database object names. If you enter a filter value that does not select any objects or is an incorrect value, the event fails.

Example: Creating an Event Set

In the following example, a new event set for monitoring extents in a database is created and the General, Events, and Parameters Pages are completed.

  1. To create a new event set, select Create Event Set from the Event Menu to display the General Page of the Event Set Management property sheet.
  2. Enter an event set name in the Name field, such as MyEventSet.
  3. Select Database from the Service Type pull-down list.
  4. Enter a brief description of and comments about the event set in the Description field. The event in this example will monitor Maximum Extents. This event is only available with the optional Performance Pack product.
  5. Do not check the Accept third party events box.
  6. Click on the Events page tab to display the Events Page.
  7. Select the Maximum Extents event. This event monitors the number of available extents for table, index, cluster, or rollback segments. Because this event accesses system tables, you must set up User Preferred Credentials with a user that has system privileges. See Console User Preferences on page 1-25.
  8. Click on the << (Add) button. The event is moved to the Selected Events list and will be added to the event set.
  9. Click on the Parameters page tab to display that page. If you had selected several events, you would need to select a specific event in the Selected Events list to display the Event Information and Parameters for the event.
  10. Do not select a fixit job (if any are available). These are jobs that have been created with the Job system and have been designated as fixit jobs.
  11. Do not change the frequency that the event monitors the destination. The default frequency interval is acceptable.
  12. Double-click on Warning threshold in the scrolling list, to change the value of the parameter. Enter 3 in the New Value field of the Enter Parameter Value dialog box, then click the OK button.
  13. Double-click on Alert threshold in the scrolling list, to change the value of the parameter. Enter 2 in the New Value field of the Enter Parameter Value dialog box, then click the OK button.
  14. Do not change the other parameters. Note that the * in the Tablespace name, Segment name, and Segment type parameter fields signifies all existing values. To monitor a specific tablespace, such as USERS, you would enter = 'USERS' in the Tablespace name field.
  15. Click the OK button at the bottom of the property sheet to save and exit. The new event set appears in the Event Set Library page of the Event window.

After you have created an event set, you can now register the event set to the destinations you want to monitor.

Creating, Modifying, or Viewing an Event Registration

You need to register, or apply, an event set to monitor events on specific destinations in the network environment. The Register Event Set and Modify Registration property sheets are very similar. The property sheets contain:

Registering an Event Set

  1. Select a event set in the Event Set Library page of the Event window.
  2. Choose the Register Event Set option of the Event menu to display the Register Event Set property sheet.
Note:

You can first select the Register Event Set option of the Event menu and then select an event set from the set name drop-down list in the General page.

  1. Complete the fields in the General and Notification pages of the property sheet to register the event set.
  2. Click the OK button at the bottom of the property sheet to save and exit. The event set appears in the Registrations page of the Event window. Each destination database is listed separately with the event set.
  3. After the agent for a destination processes the event set, the event set appears in the Registrations page of the Event window. If an event condition occurs, the event set appears in the Outstanding Events page of the Event window.

When threshold values are exceeded for the events, a notification is sent to Console window. This notification changes the color of the severity flag for the event in the Outstanding Events page. If the destination database icon is displayed in the Map window, the flag on the icon changes color. The colors and their meaning are:

Note:

There is usually a slight delay between the registering the event set and the notification by the agent.

Modify or Viewing An Event Set

  1. Select a registered event set in the Registrations page of the Event window.
  2. Choose the Modify Registration option of the Event menu to display the Modify Registration property sheet.
  3. You can modify fields in the Notification page but not the General page. Display the Status page to view of the status of each event at every destination.

Registrations General Page

On the General page, you identify the event set and destinations that you want the event set to monitor.

Warning:

Do not register an UpDown event against the database or node where the repository table is stored. Note that the UpDown event is included in the Oracle DB Fault event set. The communication between the Intelligent Agent and Communication Daemon can cause problems with the repository database connection. If the database or node is down, the event cannot notify the Console because the repository is not available.

Service Type:

Select a service type from the pull-down list. The types include Database, Node, or Listener.

Set Name:

Select an existing event set name from the pull-down list.

Description:

Displays the description of the event set.

Available Destinations:

Select the destinations in the list you want to monitor in this event set, then click on the << (Add) button. The Available destinations vary according to the service type and event set selected. You can register an event only once on any destination; the destination will not display for the event again. Only network objects that have been discovered correctly and have an Intelligent Agent running are included in the list of available destinations. See Discovering Services on page 2-8.

Selected Destinations:

Select the events in the list you want to remove from this event set, then click on the >> (Remove) button.

Registrations Notification Page

On the Notification page, you determine who is notified and how they are notified for each destination.

Note:

You need to set up administrators and notification methods before you complete this page. See Managing Administrators on page 5-24.

Destination

Select a destination from the pull-down list.

Notify Operator on Duty

Check this option to notify the operator that is on duty when the event occurs.

Cause SNMP Trap At Agent

Check this box to trap the notification at the destination where the agent is located.

Operators

Select an operator (administrator) in the list, then select the notification method for this operator. Notification can also be specified when setting up administrators. See Managing Administrators on page 5-24.

Notification Method

Choose the method for notifying the operator selected in the Operators list. You can choose paging or mail if those methods have been set up for the operator.

Registrations Status Page

On the Status page, you can view the status and output messages (if any) of each event at every destination where the event has been registered. The Status page contains the following:

Destination

Select an event destination from the pull-down list. The events registered at this destination display in the Status of Registered Event list.

Status of Registered Event at Destination

Select an event in the list to view the error messages, if present.

Error Message for Event

Scroll through the list of messages to view the output of the event. The specific output of each event is described in the online help for Oracle events.

Example: Registering an Event Set

In the following example, an event set for monitoring a database is registered at several databases.

  1. Select the event set name from the Event Set Library page in the Event window.
  2. Select Register Event Set from the Event menu to display the Registration Property sheet.
  3. If necessary, select Database from the Service Type pull-down list in the General page.
  4. Select a database from the Available Destinations list, then click on the << (Add) button. The database is moved to the Selected Destinations list and will be monitored for the events in the event set.
  5. Repeat the previous step for several additional databases.
  6. Click on the Notification page tab to display the Notification page.
  7. Verify that the Notify Operator on Duty box is checked.
  8. Do not check the Cause SNMP Trap At Agent box.
  9. If you have set up email services and an administrator with email, select that administrator in the list and check the Email box.
  10. Click the OK button at the bottom of the property sheet to save and exit. After the destination is validated and the agent for a destination processes the event set, the set appears in the Registrations page of the Event window. Each destination database is listed separately with the event set.
  11. If an event condition occurs, the event set appears in the Outstanding Events page of the Event window. If an administrator has been selected to be notified by email or paging, an email or page is sent from the Console.

When threshold values are exceeded for the events, a notification is sent to Console window. This notification will change the color of the severity flag for the event in the Outstanding Events page. If the destination database icon is displayed in the Map window, the flag on the icon changes color. The colors and their meaning are:

After an event condition is fixed, the event is cleared. You can also clear an event by acknowledging and moving the event to the Event History page.

Acknowledging an Event

Acknowledging events allows you to add Comments to an event and move the event from the Outstanding Events to the Event History page.

To acknowledge an event that has occurred, double-click on the event in the Outstanding Events page to display the Acknowledge Event property sheet. You can also select an event and choose the Acknowledge option in the Event menu. The Acknowledge Event property sheet contains the General and Notification pages. After you have viewed the information on the pages and entered any optional Comments in the Comments field of the General page, you can:

Acknowledge Event General Page

The General page contains the following fields. Only the Comments field can be updated.

Event

Name of the event.

Date

Date that the event occurred.

System

System where the event occurred.

Node

Destination node.

Event Message

A message describing the event that took place.

Comments

Enter an optional Comment for this event. Comments are useful for explaining how the problem was corrected.

Acknowledge Event Notification Page

The Notification page contains the Notification Status field. This field is for display only and cannot be updated.

Managing Administrators

The Event Management system allows you to set up the administrators that are notified when an event occurs. To manage administrators, choose Administrator List in the Event menu to display the Administrator List dialog box. From the dialog box, you can add, modify, and delete administrators.

You can select specific administrators to be notified when applying an event set. When using a paging service or mail notification, each administrator can be assigned responsibility for specific systems at specific days and times.

Each administrator can be associated with both an email ID and a pager number. The administrator's schedule can be set up for any hours on any days of the week by specific system. For example, an administrator can be scheduled from 7:00 AM through 12:00 PM from Monday to Friday, 10:00AM through 2:00 PM on Saturday, and not available on Sunday.

Note:

If you plan to use a mail or paging service for notification, you need to configure the mail, paging, and modem settings for your system before you set up administrators. See Configuring Mail Services on page 5-27 and Configuring Paging Services on page 5-28. To configure the modem for the system, access the Modems option in the Control Panel.

Adding New Administrators

  1. Click on the Add button in the Administrator dialog box to display the Administrator property sheet.
  2. Complete the General, Systems, and Availability pages in the Administrator property sheet to set up a new administrator.

Modifying Administrators

  1. Select an administrator in the list and click on the Modify button in the Administrator dialog box to display the Administrator property sheet.
  2. Modify the General, Systems, and Availability pages in the Administrator property sheet.

Deleting Administrators

  1. Select an administrator in the list.
  2. Click on the Delete button in the Administrator dialog box to delete the administrator.

Administrator General Page

The General page contains the Administrator's Name, Comments, Paging Information, and EMailing Information. Complete this page to set up the paging service and email address for the administrator.

Name:

Enter the name of the administrator.

Comments:

Enter any Comments.

Paging Information:

Carrier:

Select the name of the paging carrier service from the pull-down list. The carriers are set up with the Configure Paging Services option in the Event menu.

Pin:

Enter the paging PIN, if required. This entry is required for the GSM and TAP protocols for alphanumeric pagers. For GSM, the PIN is the actual phone number of the administrator.

Test:

Click the Test button to check the accuracy of the Paging information. In the Test Pager dialog box, select the paging service from the pull-down list. For alphanumeric pagers, enter the PIN number and a text message. For numeric pagers, 12345 and a prefix, if specified, is sent. Click on the Send button to send a test page to the specified pager. A message displays to inform you of the status of the test page.

If the test fails, check the paging services configuration. You can also view the paging trace log file in the ORACLE_HOME\sysman\output directory if the trace file is enabled in the paging configuration Trace Setup dialog. Contact Oracle Worldwide Customer Support for an explanation of the messages in the log file.

Prefix:

Enter an optional prefix that is added to the numeric pager event Ids that are sent to a numeric pager. This allows you to avoid conflicts with other numeric Ids that are sent to the pager. It also allows you to set up a prefix for specific destinations where events are monitored. You can set up identical administrators except for the administrator's name and prefix assigned to the numeric event Ids. For a list of pager event Ids, see Numeric Pager Event Ids on page 5-33.

EMailing Information:

MAPI Mail ID:

Enter the MAPI mail address of the administrator.

SMTP Mail ID:

Enter the SMTP mail address of the administrator, such as jayr@smp.com.

Test:

Click the Test button to check the accuracy of the mail information. In the Test Email dialog box, you can enter the subject of the email and the text of the message. Click on the Send button to send a test email to the specified mail Id. A message displays to inform you of the status of the test email.

If the test fails, check the mail configuration. You can also view the mail log file in the ORACLE_HOME\sysman\output directory. Contact Oracle Worldwide Customer Support for an explanation of the messages in the log file.

Email Subject

Enter up to 200 characters in the subject field of the email message. The default is OEM Notification.

Administrator Systems Page

The Systems page defines the systems that the administrator is responsible for.

Available Systems:

Select the names of the systems that the administrator is responsible for, then click the << (Add) button.

Systems responsible for:

Select the names of the systems that the administrator is no longer responsible for, then click the >> (Remove) button.

Administrator Availability Page

The Availability page defines the Notification method and the Availability of the administrator for each system that the administrator is responsible for.

Note:

The Console must be running for the notification to be sent.

Notification:

Select the notification method, All, Email, or Paging, from the pull-down list. Paging is recommended for urgent events or critical systems.

Systems responsible for:

Select the system in the tree list for which the administrator is responsible.

Availability

Select the hours and days of the week in the table when the administrator is available for the system selected in the list. This day/hour selection determines when the administrator is notified for an event on the selected system.

Configuring Mail Services

The Mail Configuration dialog box allows you to determine the mail service information for your system. You must set up this information correctly to notify administrators by mail. To configure mail services, select the Configure Services Mail option from the Event menu. In the Mail Configuration dialog box, define the information in the following fields:

Current Mail Engine

Set up the mail engine to match the mail engine of your system. Select from the following options in the pull-down list:

MAPI Setup

See the Windows documentation and online help for information on setting up and using the Microsoft Mail Messaging System. You can use this setup with Microsoft Mail or any mail system that is compatible with MAPI.

Send Mail As

Enter the name of a MAPI profile that you have previously set up with the Mail program in the Control Panel. Mail notification from the Console will be sent from this profile.

Password

Enter the password for the mail system.

SMTP Setup

SMTP is the Simple Mail Transport Protocol that uses a TCP/IP-based mail protocol and requires that TCP/IP services are set up on the Console machine. To set up TCP/IP services, access Network settings in the Control Panel of the Windows system.

Send Mail As

Enter an optional name or label that you want to attach to the address of the email notification. For example, event_system.

SMTP Server:

Enter the location of the SMTP server, such as mailserver.company.com.

Configuring Paging Services

The Event Management paging services notify an administrator with a page when an event has occurred. Alphanumeric pagers provide a brief text message identifying the event and numeric pagers provide the numeric pager event Ids. To configure paging services, select the Configure Services Paging option in the Event menu to display the Paging Services Configuration dialog.

In the Paging Services Configuration dialog box, you can add, modify, or delete paging services. You determine specific Service Settings, pager type and access number, for each service. You also specify the system modem, Telephony Dialing properties, and Trace log setup for all services. After a service is configured, it can be assigned to system administrators with the General Page of the Administrator Paging Property Sheet. See Administrator General Page on page 5-25.

Note:

Verify that the system modem has been set up. To configure the modem for the system, access the Modems option in the Control Panel. If a modem has not been set up or the selected modem is not available, a warning message displays.

Adding New Paging Services

  1. Select the Add button in the Paging Services Configuration dialog box and enter a name for the paging service in the Service Name field of the New Service Name dialog box. Select the OK button.
  2. Determine the settings in the Paging Services Configuration dialog box and select the OK button.

Modifying Paging Services

  1. Select a paging service name in the Paging Services Names list of the Paging Services Configuration dialog box.
  2. Modify the settings in the Paging Services Configuration dialog box and select the OK button.

Deleting Paging Services

  1. Select a paging service name in the Paging Services Names list of the Paging Services Configuration dialog box.
  2. Select the Delete button. Select Yes to confirm the deletion.

Paging Services Configuration Dialog

Complete the fields to set up the paging service.

Paging Services Names

Add, modify, or delete a paging service name.

Pager Type

Select Alphanumeric or Numeric depending on the pager type.

Where to Dial

Specify the paging phone number.

Modem

Select the modem for use with the current Console machine. This modem is used for all the paging services. To configure the modem for the system, access the Modems option in the Control Panel. If you are having problems with the paging system, try reducing the baud rate to 2400 or less. If the modem disconnects prematurely from the paging service, check the property setting that determines when the modem stops trying to connect. For the TAP and GSM protocols, the data bits, parity, and stop bits settings are provided and override the modem settings in the Control Panel.

How to Dial

Determine whether you want to use the Telephony Dialing Properties for all paging services on the current Console machine. You can access the Telephony properties with Dialing Properties button if you have elected to use Telephony dialing properties. You can also access Telephony properties with the Telephony option in the Windows Control Panel. You would not want use the Telephony properties if they conflicted with a paging service access number. This could occur when a telephone country code has been changed and does not match the Telephony setting.

Trace Setup

The Paging Trace Configuration dialog allows you to turn Log Paging Trace Information on and off for the current Console machine. By default, the tracing is on and a log is written to a machine-specific location. Each time the Console is started, the existing trace log is replaced. The trace information is very important for debugging problems with the paging system. Oracle recommends that tracing is on. If you experience problems with the paging system, contact Oracle Worldwide Customer Support to arrange for the trace log to be sent to support.

Oracle UpDown Events

This section lists the Event Management System UpDown events with their parameters and return values. For information on entering parameter values, see Event Set Management Parameters Page on page 5-16. A list of events with numeric pager event Ids is also provided. See Numeric Pager Event Ids on page 5-33.

UpDown events are specified for database, listener, and node services. The events are also divided into fault, space, resource, and performance management categories.


Note:  

Only the UpDown events are included with Oracle Enterprise Manager. Additional advanced events are available with the optional Oracle Diagnostics Pack. For more information on advanced events, see the Oracle Enterprise Manager Performance Monitoring and Planning Guide. 


 
 

The event scripts are written in the Tool Command Language (Tcl) enhanced with Oracle Tcl commands (OraTcl). For information on using Tcl and OraTcl to write event scripts, see Oracle Enterprise Manager Application Developer's Guide.

Some of the events require special tables in the database. For example, the catblock.sql script needs to be run to use the User Blocks event. See the Oracle Enterprise Manager Configuration Guide for scripts that need to be executed against the database that will be monitored.

Some of the database events require access to system tables and require additional permissions. You need to set up preferred credentials for the monitored database with a user that has system privileges. See Console User Preferences on page 1-25.

Database Fault Management Events

This category of events monitors for catastrophic conditions on the system. The administrator should take immediate action when these conditions arise.

UpDown (Database)

This event checks whether the database being monitored is running. If this event is triggered, other database events are not ignored.

Parameters

none

User Action

The Startup Database job task can be set up as a fixit job for automatically correcting the problem.

Node Fault Management Events

This category of events monitors for catastrophic conditions on the system. Immediate action needs to be taken by the administrator.

Up/Down (Node)

This event checks whether the Data Gatherer being monitored is running. If the Data Gatherer is down, this event is triggered.

Parameters

none

Output

none

Default Frequency

30 seconds

User Action

Restart Data Gatherer.

Listener Fault Management Events

This category of events monitors for catastrophic conditions on the system. Immediate action needs to be taken by the administrator.

UpDown (Listener)

This event checks whether the listener on the node being monitored is available.

Parameters

none

User Action

The Startup Listener job task can be set up as a fixit job for automatically correcting the problem.

Numeric Pager Event Ids

The Event Management System provides paging services which notify an administrator with a page when an event has occurred. Alphanumeric pagers provide a brief text message identifying the event. Numeric pagers provide the numeric pager event Ids to identify the event.

The following is a list of Oracle events and the assigned numeric paging Ids.

Database events

Node events

Listener events:




 
Prev
 
Next
 
Oracle 
Copyright © 1998 Oracle Corporation. 
All Rights Reserved. 
 
Library
 
Product
 
Contents
 
Index