Contents

Title Page

Copyright Page

Preface

Purpose of This Document

Who Should Read This Document

How This Document Is Organized

How to Use This Document

Opening the Document in a Web Browser

Printing from a Web Browser

Documentation Conventions

Related Documentation

Log Central Documentation

Contact Information

Documentation Support

Customer Support

1. Overview

Log Messages in System Management

Agent/Manager Architecture

Log Central and Enterprise Management Systems

Data Collection Agents

Log Central Components on the Managed Node

Log Monitor

Message Sender

Process Monitor

Central Collector

Message Receiver

Message Processor

2. Getting Started

Setting Up Log Central

Optional Setup Tasks

Configuring Log Central

Required Information for Host Configuration Utility

Running the Host Configuration Utility

Configuring Multiple Instances of Log Central

3. Configuring the Database for Use with Log Central

Managing Your Database

Creating a Database Schema

Dropping a Database Schema

Categorizing Messages by Resource

Creating Subsystem Entries in the Database

Deleting a Subsystem Entry

Managing Log Central User Entries

Add a User

Delete a User

Modify a Password

List Users

4. Integrating Logs into Log Central

Log Monitor Configuration File Options

Specifying Option Values

Example of Using Log Monitor with a Configuration File

Multiple Separators with the -S Option

Using the -p and -x Options

Field Lengths

Specifying the Date Format (%f)

Filtering a System Log

Specifying Date Format

Converting Input Dates

5. Creating and Loading Message Definitions

Message Definitions

Getting Message Definitions into the Log Central Database

Create a Message Definition File

Description of Message Definition File

Fields of a Message Definition File

Example

Load the Message Definition File

Using Other Message Definition Commands

Exporting Message Definitions

Deleting Message Definitions

How to Delete a List of Message Definitions

How to Delete Message Definitions Associated with a Subsystem

6. Host and Filter Configuration

Default Configuration

Where to Put Intermediate Files

Specifying a Backup Central Collector

Host Name Usage

Specifying Nondefault Global Parameters

Assigning Filters to Agents

Using a MANAGED_NODE Entry

Turning Off Global Filters on a Particular Node

Assigning a Filter to a Particular Node

Defining Agent Filters

Defining Conditions

Defining Actions

Dropping a Message

Executing a Command

Sending an SNMP Trap Notification

Example

Filter Recommendations

7. Integrating Log Central with an SNMP Manager

Facilities for Managing Log Central

Management Information Base Support for Log Central

Process Monitor Agent

Central Collector SNMP Trap Generation

Data Collection Agent SNMP Trap Generation

Setting Up SNMP Management of Log Central

Integrating Events Generated by Agent Integrator Polling

8. Starting and Stopping Log Central

Starting the Log Central Data Collection System

Starting Log Central on a Central Host

Starting Log Central on the Managed Nodes

Starting Log Monitor

Starting Log Monitor with Predefined Mappings

Starting Log Monitor with Mappings in a Configuration File

Starting Log Monitor with Mapping Specified on the Command Line

Stopping the Log Central Data Collection System

Displaying Log Central System Information

Example

9. Using the Log Central Console

Invoking the Launch Panel

Using the Message Browser

Message Browser Main Window

How to Monitor Incoming Messages

How to Perform Historical Queries of the Message Database

How to Delete Messages

How to Acknowledge Messages

How to Remove Acknowledgment from Messages

How to Filter Messages

How to Change the Message Layout in the Main Window

How to Change Message Colors

How to View Message Details

How to Generate Reports

How to View Summary Reports

How to View Detail Reports

Using the Message Definition Editor

Message Definition Main Window

How to Display Message Definitions

How to Add a New Message Definition

How to Modify a Message Definition

How to Delete Message Definitions

How to Define Filtering Criteria for Retrieving Message Definitions

How to Change the Message Definition Layout

How to Change Message Definition Colors

How to Modify the Subsystem Description

How to Generate Reports

How to View Summary Reports

How to View Detail Reports

Using the Basic Trap Configuration Tool

Configuring Trap Generation by Severity

Configuring Trap Generation by Message Definition

Generating Traps Based on both Severity and Message Definition

Using the Storage Maintenance Tool

Storage Maintenance Main Window

How to Prepare the Records Processing Script

Example

How to Schedule Deletion of Database Records

How to Manually Process Database Records

How to Schedule Processing of Database Records

How to Schedule Both Processing and Deletion of Database Records

How to Schedule Deletion of Intermediate Files

A. Message Format

Message Format

Message Attributes at the Agent

Log ID

Logging Le1vel

Date and Time

Subsystem Name

Message ID

Host Name

Process ID

User ID

Function Name

Transaction ID

Body

Attributes in the Message Definition

Severity

Summary

Description

Recommendation

Trap Generation

Trap ID

Automatic Acknowledgment Flag

Execute on DB Upload

B. Environment Variables

BEA_LC_IPCKEY

Using a New IPCKEY Value

BEA_LC_CONF_SERVICE

Using a Different UDP Communication Service

BEA_SM_BEAMGR_CONF

Setting a New Location for the BEA Manager Configuration File

C. Testing and Debugging Commands

Generating Test Messages

Examples

Reading the Current Intermediate Log File

Examples

D. MIB Reference

Log Central Traps MIB

beaTrapLcLogLevel

beaTrapLcTimestamp

beaTrapLcSubsys

beaTrapLcMid

beaTrapLcHost

beaTrapLcPid

beaTrapLcUid

beaTrapLcFunction

beaTrapLcTxKey

beaTrapLcVersion

beaTrapLcSeverity

beaTrapLcMessageBody

Process Monitor MIB

beaPmProcsEnvtVar

beaPmMonitorPid

beaPmMonitorTimer

beaPmMonitorLastWakeup

beaPmMaxProcRestarts

beaPmMaxProcRestartsIntvl

beaPmProcTable

beaPmTblEntityName

beaPmTblProcId

beaPmTblStatus

beaPmTblFirstRegTime

beaPmTblLastRegTime

beaPmTblRestartEnabled

beaPmTblRestartCmd

beaPmTblNumRestarts

beaPmTblRefRestartTime

beaPmTblNumRestartsFromRef

beaPmTblFirstRestartTime

beaPmTblLastRestartTime

beaPmTblUid

beaPmTblGid

beaPmTblEuid

beaPmTblEgid

beaPmTblSwName

beaPmTblSwVersion

beaPmTblSwDate

beaPmTblSwTime

E. Database Schema

Schema Tables

Log Message Definitions

Logging Levels

Message Severities

Subsystem Definitions

Trap Classes

Logged Message Data

User Data

F. Initialization File

Initialization File

G. Predefined Log Mapping

BEA TUXEDO Message Mapping

Log Central Message Fields

Windows NT Event Log

Oracle Alert Log

Glossary

Index