WebLogic Event Server Administration and Configuration Guide

Introduction and Roadmap

Document Scope and Audience

WebLogic Event Server Documentation Set

Guide to This Document

Samples for the WebLogic Event Server Application Developer

Creating a WebLogic Event Server Domain

Overview of WebLogic Event Server Domains

Creating a Domain

Stopping and Starting the Server

Starting the Server

Stopping the Server Using the stopwlevs Script

Next Steps

Configuring WebLogic Event Server

Overview of Configuring WebLogic Event Server

Configuring the Server by Manually Editing the config.xml File

Configuring Applications and Servers Dynamically

Overview of Dynamic Configuration

Overview of WebLogic Event Server MBeans

Configuration MBeans

MBean Hierarchy and Naming

Configuration MBean Naming

Dynamically Configuring a Component Using JMX: Typical Steps

wlevs.Admin Command-Line Reference

Overview of the wlevs.Admin Utility

Required Environment for the wlevs.Admin Utility

Running the wlevs.Admin Utility Remotely

Syntax for Invoking the wlevs.Admin Utility

Example Environment

Exit Codes Returned by wlevs.Admin

Connection Arguments

User Credentials Arguments

Common Arguments

Command for Getting Usage Help

HELP

Commands for Managing the Server Life Cycle

SHUTDOWN

Commands for Managing the EPL Rules of an Application

ADDRULE

DELETERULE

GETRULE

UPLOAD

DOWNLOAD

Commands for Managing WebLogic Event Server MBeans

Specifying MBean Types

MBean Management Commands

GET

INVOKE

QUERY

SET

Configuring Security for WebLogic Event Server

Overview of Security in WebLogic Event Server

Configuring Security With the File-Based Provider

Configuring File-Based Security: Main Steps

Avoiding Cleartext Passwords in the startwlevs Script

Being Prompted for a Password at Server Startup

Putting the Encrypted Password in a Security XML file

Disabling File-Based Security

The passgen Command Line Utility

passgen Syntax

Examples of Using passgen

Using passgen interactively

Providing a Password on the Command Line

The secgen Command Line Utility

Generating a File-Based Provider Configuration File

Generating a Key File

Using the secgen Properties File

Examples of Using secgen

Limitations of secgen

Configuring Jetty for WebLogic Event Server

Overview Of Jetty Support in WebLogic Event Server

Servlets

Network I/O Integration

Thread Pool Integration

Work Managers

Understanding How WebLogic Event Server Uses Thread Pools

Understanding Work Manager

Configuring a Jetty Server Instance

jetty Configuration Object

netio Configuration Object

work-manager Configuration Object

jetty-web-app Configuration Object

Developing Servlets for Jetty

Web App Deployment

Example Jetty Configuration

Configuring JMX for WebLogic Event Server

Overview of JMX Support in WebLogic Event Server

Configuring JMX

jmx Configuration Object

rmi Configuration Object

jndi-context Configuration Object

exported-jndi-context Configuration Object

Example of Configuring JMX

Configuring Access to a Relational Database

Overview of Database Access from a WebLogic Event Server Application

Description of WebLogic Event Server Data Sources

Data Source Configuration

Configuring Access to a Relational Database: Main Steps

Configuring Logging and Debugging

Configuration Scenarios

Overview of Logging Services Configuration

Setting the Log Factory

Using Log Severity Levels

Log Message Format

Format of Output to Standard Out and Standard Error

OSGI Framework Logger

How to Use the Commons Logging API

Configuring the WebLogic Event Server Logging Service

Logging Service

log-stdout

log-file

Debug

Configuring debug using System Properties

Configuring debug using a Configuration File

Supported Debug Flags

Example Debug Configuration

Log4j

The following sections provide information on using Log4j:

About Log4j

Loggers

Appenders

Layouts

log4j Properties

Enabling Log4j Logging