WebLogic Server Administration Guide

 

 

Overview of WebLogic Server Management

Domains, the Administration Server and Managed Servers

Administration Console

Run-time and Configuration Objects

Central Point of Access to Log Messages

Creating a New Domain

 

Starting and Stopping WebLogic Servers

WebLogic Administration Server and WebLogic Managed Servers

Startup Messages

Failover Considerations for the Administration Server

Starting the WebLogic Administration Server

Use of Passwords When Starting the WebLogic Server

Starting the WebLogic Administration Server from the Start Menu

Starting and Stopping the WebLogic Server as a Windows Service

Starting the WebLogic Administration Server from the Command Line

Starting the Administration Server Using a Script

Restarting the Administration Server when Managed Servers are Running

Server Startup Process

Adding a WebLogic Managed Server to the Domain

Starting a WebLogic Managed Server

Starting the WebLogic Managed Servers Using Scripts

Stopping WebLogic Servers from the Administration Console

Shutting Down a Server from the Command Line

Setting Up a WebLogic Server Instance as a Windows Service

Setting Up Windows Services: Main Steps

Removing WebLogic Server as a Windows Service

Changing Passwords for a Server Installed as a Windows Service

Registering Startup and Shutdown Classes

 

Node Manager

Overview of Node Manager

Node Manager Logs

Setting Up Node Manager

Setting Up Node Manager for Secure Socket Layer Protocol

Setting Up the Administration Server to Use Node Manager

Platform Support for Node Manager

Starting the Node Manager from the Command Line

Setting Up the Environment

Setting the Classpath

Starting the Node Manager

Starting the Node Manager Using Start Scripts

Remote Starting and Killing of Managed Servers

The Distinction Between Stopping and Killing a Managed Server

Starting and Killing Domains and Clusters

Setting Up Node Manager as a Windows Service

Removing Node Manager as a Windows Service

 

Configuring WebLogic Servers and Clusters

Overview of Server and Cluster Configuration

Role of the Administration Server

Starting the Administration Console

How Dynamic Configuration Works

Planning a Cluster Configuration

Server Configuration Tasks

Cluster Configuration Tasks

 

Monitoring a WebLogic Server Domain

Overview of Monitoring

Monitoring Servers

Monitoring JDBC Connection Pools

 

Using Log Messages to Manage WebLogic Servers

Overview of Logging Subsystem

Local Server Log Files

Client Logging

Log File Format

Message Attributes

Message Catalog

Message Severity

Debug Messages

Browsing Log Files

Viewing the Logs

Creating Domain Log Filters

 

Deploying Applications

Supported Formats for Deployment

Using the Administration Console to Deploy Applications

Step 1: Configure and Deploy the Application.

Step 2: Deploying Application Components.

Deployment Order

Updating Deployed Applications at Startup

Forcing Application Update at Startup

Auto-Deployment

Enabling or Disabling Auto-Deployment

Auto-Deployment of Applications in Expanded Directory Format

Undeployment or Redeployment of Auto-Deployed Applications

 

Configuring WebLogic Server Web Components

Overview

HTTP Parameters

Configuring the Listen Port

Web Applications

Web Applications and Clustering

Designating a Default Web Application

Configuring Virtual Hosting

Virtual Hosting and the Default Web Application

Setting Up a Virtual Host

How WebLogic Server Resolves HTTP Requests

Setting Up HTTP Access Logs

Log Rotation

Setting Up HTTP Access Logs by Using the Administration Console

Common Log Format

Setting Up HTTP Access Logs by Using Extended Log Format

Preventing POST Denial-of-Service Attacks

Setting Up WebLogic Server for HTTP Tunneling

Configuring the HTTP Tunneling Connection

Connecting to WebLogic Server from the Client

Using Native I/O for Serving Static Files (Windows Only)

 

Proxying Requests to Another HTTP Server

Overview

New Version of the HttpProxyServlet

Setting Up a Proxy to a Secondary HTTP Server

Sample Deployment Descriptor for the Proxy Servlet

 

Proxying Requests to a WebLogic Cluster

Overview

New Version of the HttpClusterServlet

Setting Up the HttpClusterServlet

Sample Deployment Descriptors

web.xml for HttpClusterServlet SP02

web.xml for Deprecated HttpClusterServlet

Proxy Servlet Deployment Parameters

Cluster Configuration and Proxy Plug-ins

Verifying Your Configuration

 

Installing and Configuring the Apache HTTP Server Plug-In

Overview

Keep-Alive Connections in Apache Version 1.3.x

Keep-Alive Connections in Apache Version 2.x

Proxying Requests

Certifications

Installing the Apache HTTP Server Plug-In

Installing as a Dynamic Shared Object

Installing as a Statically Linked Module

Configuring the Apache HTTP Server Plug-In

Editing the httpd.conf File

Notes on Editing the httpd.conf File

Using SSL with the Apache Plug-In

Configuring SSL Between the Apache HTTP Server Plug-In and WebLogic Server

Issues with SSL-Apache Configuration

Specifying Trust of the WL-Proxy-Client-Cert Header

Connection Errors and Clustering Failover

Connection Failures

Failover with a Single, Non-Clustered WebLogic Server

The Dynamic Server List

Failover, Cookies, and HTTP Sessions

Template for the httpd.conf File

Sample Configuration Files

Example Using WebLogic Clusters

Example Using Multiple WebLogic Clusters

Example Without WebLogic Clusters

Example Configuring IP-Based Virtual Hosting

Example Configuring Name-Based Virtual Hosting With a Single IP Address

 

 Installing and Configuring the Microsoft Internet Information Server (ISAPI) Plug-In

Overview of the Microsoft Internet Information Server Plug-In

Connection Pooling and Keep-Alive

Proxying Requests

Platform Support

Installing the Microsoft Internet Information Server Plug-In

Proxying Multiple Virtual Websites from IIS

Creating ACLs through IIS

Sample iisproxy.ini File

Using SSL with the Microsoft Internet Information Server Plug-In

Configuring SSL

Specifying Trust of the WL-Proxy-Client-Cert Header

Proxying Servlets from IIS to WebLogic Server

Testing the Installation

Connection Errors and Clustering Failover

Connection Failures

Failover with a Single, Non-Clustered WebLogic Server

The Dynamic Server List

Failover, Cookies, and HTTP Sessions

 

Installing and Configuring the Netscape Enterprise Server Plug-In (NSAPI)

Overview of the Netscape Enterprise Server Plug-In

Connection Pooling and Keep-Alive

Proxying Requests

Certifications

Installing and Configuring the Netscape Enterprise Server Plug-In

Modifying the obj.conf File

Using SSL with the NSAPI Plug-In

Configuring SSL

Specifying Trust of the WL-Proxy-Client-Cert Header

Connection Errors and Clustering Failover

Connection Failures

Failover with a Single, Non-Clustered WebLogic Server

The Dynamic Server List

Failover, Cookies, and HTTP Sessions

Failover Behavior When Using Firewalls and Load Directors

Sample obj.conf File (Not Using a WebLogic Cluster)

Sample obj.conf File (Using a WebLogic Cluster)

 

Managing Security

Steps for Configuring Security

Changing the System Password

Specifying a Security Realm

Configuring the File Realm

Configuring the Caching Realm

Configuring the LDAP Security Realm

Configuring the Windows NT Security Realm

Configuring the UNIX Security Realm

Configuring the RDBMS Security Realm

Installing a Custom Security Realm

Migrating Security Realms

Defining Users

Defining Groups

Defining ACLs

Configuring the SSL Protocol

Obtaining a Private Key and Digital Certificate

Storing Private Keys and Digital Certificates

Defining Trusted Certificate Authorities

Defining Attributes for the SSL Protocol

Using PKCS#7 Files

Modifying Parameters for SSL Session Caching

Configuring Mutual Authentication

Configuring RMI over IIOP with SSL

Protecting Passwords

Installing an Audit Provider

Installing a Connection Filter

Setting Up the Java Security Manager

Modifying the weblogic.policy File for Third Party or User-Written Classes

Using the Recording Security Manager Utility

Configuring Security Context Propagation

SSL Certificate Validation

Installation Instructions

Controlling the Level of Certificate Validation

Checking Certificate Chains

Troubleshooting Problems with Certificates

 

Managing Transactions

Overview of Transaction Management

Configuring Transactions

Additional Attributes for Managing Transactions

Monitoring and Logging Transactions

Moving a Server to Another Machine

 

Managing JDBC Connectivity

Overview of JDBC Administration

About the Administrative Console

About the Command-Line Interface

About the JDBC API

Related Information

JDBC Components—Connection Pools, Data Sources, and MultiPools

Connection Pools

MultiPools

Data Sources

JDBC Configuration Guidelines for Connection Pools, MultiPools and DataSources

Overview of JDBC Configuration

Configuring JDBC Drivers for Local Transactions

Configuring XA JDBC Drivers for Distributed Transactions

Configuring Non-XA JDBC Drivers for Distributed Transactions

Configuring and Managing JDBC Connection Pools, MultiPools, and DataSources Using the Administration Console

JDBC Configuration

Managing and Monitoring Connectivity

Increasing Performance with the Prepared Statement Cache

Usage Restrictions for the Prepared Statement Cache

Determining the Proper Prepared Statement Cache Size

Using a Startup Class to Load the Prepared Statement Cache

 

Managing JMS

JMS and WebLogic Server

Configuring JMS

JMS Configuration Naming Rules

Starting WebLogic Server and Configuring JMS

Configuring JMS Servers

Configuring Connection Factories

Configuring Destinations

Configuring JMS Templates

Configuring Destination Keys

Configuring Stores

Configuring Session Pools

Configuring Connection Consumers

Monitoring JMS

Monitoring JMS Objects

Monitoring Durable Subscribers

Tuning JMS

Persistent Stores

Using Message Paging

Recovering from a WebLogic Server Failure

Restarting or Replacing WebLogic Server

Programming Considerations

 

Using the WebLogic Messaging Bridge

What Is a Messaging Bridge?

Messaging Bridge Configuration Tasks

About the Bridge's Resource Adapters

Deploying the Bridge's Resource Adapters

Configuring the Source and Target Bridge Destinations

Configuring a Messaging Bridge Instance

Using the Messaging Bridge to Interoperate with Different WebLogic Server Versions and Domains

Naming Guidelines for WebLogic Servers and Domains

Enabling Security Interoperability for WebLogic Domains

Using the Messaging Bridge To Access Destinations In a Release 6.1 or Later Domain

Using the Messaging Bridging To Access Destinations In a Release 6.0 Domain

Using the Messaging Bridging To Access Destinations In a Release 5.1 Domain

Bridging to a Third-Party Messaging Provider

Managing a Messaging Bridge

Stopping and Restarting a Messaging Bridge

Monitoring Messaging Bridges

Configuring the Execute Thread Pool Size

 

Managing JNDI

Overview of JNDI Management

What Do JNDI and Naming Services Do?

Viewing the JNDI Tree

Loading Objects in the JNDI Tree

 

Managing the WebLogic J2EE Connector Architecture

Overview of WebLogic J2EE Connector Architecture

Installing a New Resource Adapter

Configuring and Deploying a New Connector

Configuring and Deploying Resource Adapters

Viewing Deployed Resource Adapters

Undeploying Deployed Resource Adapters

Monitoring

Deleting a Connector

Editing Resource Adapter Deployment Descriptors

 

Managing WebLogic Server Licenses

Installing a WebLogic Server License

Updating a License

 

Using the WebLogic Java Utilities

ClientDeployer

der2pem

dbping

deploy

getProperty

logToZip

MulticastTest

myip

pem2der

Schema

showLicenses

system

t3dbping

verboseToZip

version

writeLicense

 

WebLogic Server Command-Line Interface Reference

About the Command-Line Interface

Before You Begin

Using WebLogic Server Commands

Connection and User Credentials Arguments

Summary of User Credentials Arguments

WebLogic Server Administration Command Reference

CANCEL_SHUTDOWN

CONNECT

HELP

LICENSES

LIST

LOCK

PING

SERVERLOG

SHUTDOWN

STOREUSERCONFIG

THREAD_DUMP

UNLOCK

VERSION

WebLogic Server Connection Pools Administration Command Reference

CREATE_POOL

DESTROY_POOL

DISABLE_POOL

ENABLE_POOL

EXISTS_POOL

RESET_POOL

Mbean Management Command Reference

CREATE

DELETE

GET

INVOKE

SET

 

WebLogic SNMP Agent Command-Line Reference

Required Environment and Syntax for the SNMP Command-Line Interface

Environment

Common Arguments

Commands for Retrieving the Value of WebLogic Server Attributes

snmpwalk

snmpgetnext

snmpget

Commands for Testing Traps

snmpv1trap

snmptrapd

Example: Sending Traps to the Trap Daemon

 

Parameters for Web Server Plug-ins

Overview

General Parameters for Web Server Plug-Ins

SSL Parameters for Web Server Plug-Ins

Configuring Web Applications and Clusters for the Plug-in