Contents

Title and Copyright Information

Send Us Your Comments

Preface

Audience

Documentation Accessibility

Organization

Related Documentation

Conventions

What's New in Oracle Application Server Administration?

Part I Getting Started

1 Getting Started After Installing Oracle Application Server

1.1 Task 1: Set Up Your Operating System User Account

1.2 Task 2: Use the Oracle Application Server Welcome Page

1.3 Task 3: Check Your Port Numbers

1.4 Task 4: Get Started with Managing Components

1.4.1 Getting Started with Oracle Process Manager and Notification Server (OPMN)

1.4.2 Getting Started with Distributed Configuration Management (DCM)

1.4.3 Getting Started with Oracle HTTP Server

1.4.4 Getting Started with Oracle Application Server Containers for J2EE (OC4J)

1.4.5 Getting Started with OracleAS Web Cache

1.4.6 Getting Started with OracleAS Portal

1.4.7 Getting Started with OracleAS Wireless

1.4.8 Getting Started with OracleAS Discoverer

1.4.9 Getting Started with OracleAS Forms Services

1.4.10 Getting Started with OracleAS Reports Services

1.4.11 Getting Started with OracleAS Personalization

1.5 Task 5: Check the Status of OracleAS Metadata Repository Schemas

1.6 Task 6: Enable SSL (Optional)

1.7 What's Next?

2 Introduction to Administration Tools

2.1 Overview of Oracle Application Server Administration Tools

2.1.1 Managing Oracle Application Server with Oracle Enterprise Manager

2.1.2 Managing Oracle Application Server from the Command Line

2.1.3 Using Other Tools to Monitor the Built-In Performance Metrics

2.2 About Oracle Enterprise Manager Application Server Control

2.2.1 Introducing the Enterprise Manager Home Pages

2.2.2 About the Underlying Technologies

2.2.3 Managing Previous Versions of Oracle Application Server

2.2.4 Using Application Server Control Online Help

2.3 Getting Started with Application Server Control

2.3.1 Displaying Oracle Enterprise Manager Application Server Control

2.3.2 Using the Application Server Home Page

2.3.3 Using the Oracle Application Server Farm Home Page

2.3.4 Using an Oracle Application Server Component Home Page

2.4 Monitoring and Diagnosing with Application Server Control

2.4.1 Reviewing General Information and Resource Usage

2.4.2 Reviewing the Resources of the Application Server Host

2.4.3 Monitoring Application Server Components

2.4.4 Monitoring Your J2EE Applications

2.4.5 Obtaining More Information about Monitoring Oracle Application Server

2.5 Managing the OracleAS Metadata Repository Database

3 Starting and Stopping

3.1 Overview of Starting and Stopping Procedures

3.2 Starting and Stopping Application Server Instances

3.2.1 Starting an Infrastructure

3.2.2 Stopping an Infrastructure

3.2.3 Starting a Middle-Tier Instance

3.2.4 Stopping a Middle-Tier Instance

3.3 Starting and Stopping Components

3.3.1 Starting and Stopping Using opmnctl

3.3.2 Starting and Stopping Using Application Server Control

3.4 Enabling and Disabling Components

3.5 Starting and Stopping an Oracle Application Server Environment

3.5.1 Starting an Oracle Application Server Environment

3.5.2 Stopping an Oracle Application Server Environment

3.6 Starting and Stopping: Special Topics

3.6.1 Use opmnctl Instead of Other Command-Line Tools to Start and Stop

3.6.2 Starting and Stopping Log Loader

3.6.3 Starting and Stopping in High Availability Environments

3.6.4 Resolving OC4J Errors When Starting Multiple Instances

3.6.5 Shutting Down OracleAS Metadata Repository with the IMMEDIATE Option

Part II Basic Administration

4 Managing Log Files

4.1 Introduction to Oracle Application Server Logging

4.1.1 Understanding Log File Data and Naming

4.1.2 Using A Log Repository

4.1.3 Configuring Component Logging Options

4.2 Listing and Viewing Log Files With Enterprise Manager

4.2.1 Listing Log Files for All Components

4.2.2 Listing Log Files for Selected Components

4.2.3 Listing Log Files from Oracle Application Server Components Pages

4.2.4 Using Log Files Advanced Search

4.2.5 Viewing Log File Details and Log File Contents

4.3 Searching Diagnostic Messages In A Log Repository

4.3.1 Getting Started With Log Repository

4.3.2 Searching Log Repository With Simple Search

4.3.3 Searching Log Repository With Advanced Search

4.3.4 Viewing Repository Log Entry Details

4.3.5 Using Regular Expressions With Log Repository Search

4.4 Diagnosing Problems and Correlating Messages

4.4.1 Correlating Messages Across Log Files and Components

4.4.2 Diagnosing Component Problems

4.5 Using Oracle Application Server Log Loader

4.5.1 Starting and Stopping Log Loader

4.5.2 Enabling and Disabling Log Loader

4.5.3 Updating the Log Configuration

4.5.4 Setting Log Loader Properties

4.5.5 Understanding Log Loader Diagnostic Messages

4.6 Advanced Logging Topics

4.6.1 Using the printlogs Tool to View Log Messages

4.6.2 Understanding ODL Messages and OLD Log Files

4.6.3 Understanding Log Loader Log File Format Conversion

4.6.4 Component Diagnostic Log File Registration

4.6.5 Configuring Components to Produce ODL Messages and ECIDs

4.6.6 Limitations and Configuration

5 Managing Ports

5.1 About Managing Ports

5.2 Viewing Port Numbers

5.3 Changing Ports Common to All Middle-Tier Instances

5.3.1 Changing Oracle Enterprise Manager Ports

5.3.2 Changing OC4J Ports

5.3.3 Changing Oracle HTTP Server Ports

5.3.4 Changing the Web Cache Non-SSL Listener Port (Middle-Tier Installations)

5.3.5 Changing the Web Cache SSL Listener Port (Middle-Tier Installations)

5.3.6 Changing the Web Cache Administration Port

5.3.7 Changing the Web Cache Invalidation Port

5.3.8 Changing the Web Cache Statistics Port

5.3.9 Changing the DCM Java Object Cache Port

5.3.10 Changing the Java Object Cache Port

5.3.11 Changing the JServ Servlet Engine Port

5.3.12 Changing the Log Loader Port

5.3.13 Changing OPMN Ports (ONS Local, Request, and Remote)

5.3.14 Changing the Oracle HTTP Server Diagnostic Port

5.3.15 Changing the Port Tunneling Port

5.4 Changing Portal and Wireless Ports

5.4.1 Changing OracleAS Portal Ports

5.4.2 Changing OracleAS Wireless Ports

5.5 Changing Business Intelligence and Forms Ports

5.5.1 Changing OracleAS Discoverer Ports

5.5.2 Changing OracleAS Forms Services Ports

5.5.3 Changing the OracleAS Reports Services SQL*Net Port

5.6 Changing Infrastructure Ports

5.6.1 Changing the Metadata Repository Net Listener Port

5.6.2 Changing Oracle Internet Directory Ports

5.6.3 Changing the HTTP Server (SSO) Port on Identity Management

5.6.4 Changing OracleAS Certificate Authority Ports

6 Managing an OracleAS Metadata Repository

6.1 Frequently Asked Questions About the Metadata Repository

6.2 Changing Schema Passwords

6.2.1 Changing Schema Passwords Using Application Server Control

6.2.2 Changing Schema Passwords Using SQL*Plus

6.2.3 Viewing and Changing Schema Passwords in Oracle Internet Directory

6.3 Changing the Character Set of the Metadata Repository

6.4 Renaming and Relocating Datafiles

6.5 Specifying Segment Space Management When Creating Tablespaces

Part III Advanced Administration

7 Reconfiguring Application Server Instances

7.1 Expanding a Middle-Tier Installation

7.2 Configuring Additional Components After Installation

7.2.1 Configuring JServ After Installation

7.2.2 Configuring Web Cache After Installation

7.2.3 Configuring Portal After Installation

7.2.4 Configuring Wireless After Installation

7.2.5 Configuring Discoverer After Installation

7.2.6 Configuring Forms After Installation

7.2.7 Configuring Reports After Installation

7.2.8 Configuring Single Sign-On (SSO) After Installation

7.2.9 Configuring Delegated Administration Service (DAS) After Installation

7.2.10 Configuring Directory Integration and Provisioning (DIP) After Installation

7.3 Deconfiguring Components

7.4 Deleting OC4J Instances

7.5 Configuring J2EE and Web Cache to Use Infrastructure Services

7.5.1 Using Identity Management

7.5.2 Using an OracleAS Metadata Repository with Identity Management

7.5.3 Using an Existing Database

7.5.4 Using an OracleAS Metadata Repository without Identity Management

8 Changing Infrastructure Services

8.1 Overview of Procedures for Changing Infrastructure Services

8.2 Changing the OID or HTTP (SSO) Ports on Identity Management

8.3 Changing Oracle Internet Directory from Dual Mode to SSL Mode

8.4 Moving Identity Management to a New Host

8.4.1 Sample Uses for this Procedure

8.4.2 Assumptions and Restrictions

8.4.3 Overview

8.4.4 Procedure

8.4.5 Strategy for Performing Failover with this Procedure

8.5 Changing from a Test to a Production Environment

8.5.1 Sample Uses for this Procedure

8.5.2 Overview

8.5.3 Procedure

8.6 Changing the Metadata Repository Used by a Middle-Tier Instance

8.6.1 Sample Uses for this Procedure

8.6.2 Assumptions and Restrictions

8.6.3 Overview

8.6.4 Procedure

9 Changing Network Configurations

9.1 Which Networking Features are Supported on Your Platform?

9.2 Overview of Procedures for Changing Network Configurations

9.3 Changing the Hostname and IP Address (Middle Tier)

9.3.1 Obtaining the DSGATEWAY Schema Password

9.4 Changing the IP Address (Infrastructure)

9.5 Moving Between Off-network and On-network

9.5.1 Moving from Off-network to On-network (Static IP Address)

9.5.2 Moving from Off-network to On-network (DHCP)

9.5.3 Moving from On-network to Off-network (Static IP Address)

9.5.4 Moving from On-network to Off-network (DHCP)

9.6 Changing Between a Static IP Address and DHCP

9.6.1 Changing from a Static IP Address to DHCP

9.6.2 Changing from DHCP to a Static IP Address

9.7 Recovering from Errors when Using chgiphost.sh

10 Management Considerations for Recommended Topologies

10.1 About the Recommended Topologies

10.2 General Development Topologies

10.2.1 Java Developer Topology

10.2.2 Portal and Wireless Topology

10.2.3 Forms, Reports, and Discoverer Developer Topology

10.2.4 Integration Architects and Process Modelers Topology

10.3 General Deployment Topologies

10.3.1 Enterprise Data Center Topologies

10.3.2 Departmental Topology

10.3.3 Development Life Cycle Support Topology

Part IV Backup and Recovery

11 Introduction to Backup and Recovery

11.1 Philosophy of Oracle Application Server Backup and Recovery

11.2 Overview of the Backup Strategy

11.2.1 Types of Backups

11.2.2 Recommended Backup Strategy

11.3 Overview of Recovery Strategies

11.4 What is the Oracle Application Server Backup and Recovery Tool?

11.5 Assumptions and Restrictions

11.6 Backup and Recovery Considerations for DCM

11.6.1 Considerations for DCM File-based Repositories

11.6.2 Considerations for DCM Archives

11.7 Backup and Recovery Considerations for High Availability Environments

11.7.1 Considerations for OracleAS Cold Failover Cluster

11.7.2 Considerations for OracleAS Active Failover Cluster

11.7.3 Considerations for OracleAS Disaster Recovery

11.8 Roadmap for Getting Started with Backup and Recovery

12 Oracle Application Server Backup and Recovery Tool

12.1 What is the Oracle Application Server Backup and Recovery Tool?

12.2 How to Obtain the OracleAS Backup and Recovery Tool

12.3 How to Install the OracleAS Backup and Recovery Tool

12.4 How to Configure the OracleAS Backup and Recovery Tool

12.5 Customizing the Tool for Your Configuration Files

12.5.1 How the Tool Works When Backing Up Configuration Files

12.5.2 How to Customize the Tool

12.6 OracleAS Backup and Recovery Tool Usage Summary

12.6.1 Prerequisites for Running the Tool

12.6.2 Syntax

12.6.3 Usage Examples

12.7 Best Practices for Restoring and Recovering the Metadata Repository

12.7.1 Restoring and Recovering the Metadata Repository to the Same Host

12.7.2 Restoring and Recovering the Metadata Repository to a New Host

12.8 Error Messages You Can Ignore

13 Backup Strategy and Procedures

13.1 Backup Strategy

13.2 Backup Procedures

13.2.1 Enabling ARCHIVELOG Mode

13.2.2 Creating a Record of Your Oracle Application Server Configuration

13.2.3 Performing a Complete Oracle Application Server Environment Backup

13.2.4 Performing an Online Backup

14 Recovery Strategies and Procedures

14.1 Recovery Strategies

14.1.1 Recovery Strategies for Data Loss, Host Failure, or Media Failure (Critical)

14.1.2 Recovery Strategies for Process Crashes and System Outages (Non-Critical)

14.2 Recovery Procedures

14.2.1 Restoring an Infrastructure to the Same Host

14.2.2 Restoring an Infrastructure to a New Host

14.2.3 Restoring and Recovering the Metadata Repository

14.2.4 Restoring Infrastructure Configuration Files

14.2.5 Restoring a Middle-tier Installation to the Same Host

14.2.6 Restoring a Middle-tier Installation to a New Host

14.2.7 Restoring Middle-tier Configuration Files

Part V Appendixes

A Managing and Configuring Application Server Control

A.1 Starting and Stopping Application Server Control

A.2 Understanding Application Server Control Processes

A.3 Changing the ias_admin Password

A.3.1 Changing the Password Using Application Server Control

A.3.2 Changing the Password Using the emctl Command-Line Tool

A.4 Configuring Security for Enterprise Manager Application Server Control

A.5 Enabling ODL for the Application Server Control Log File

A.5.1 Modifying Application Server Control Logging Properties

A.5.2 More About Application Server Control Log File Properties

A.6 Enabling Enterprise Manager Accessibility Mode

A.6.1 Making HTML Pages More Accessible

A.6.2 Providing Textual Descriptions of Enterprise Manager Charts

A.6.3 Modifying the uix-config.xml File to Enable Accessibility Mode

B Oracle Application Server Command-Line Tools

B.1 Oracle Application Server Command-Line Tools (Sorted by Command)

B.2 Oracle Application Server Command-Line Tools (Sorted by Component)

B.3 Oracle Application Server Command-Line Tool Descriptions

C Oracle Application Server Port Numbers

C.1 Port Numbers and How They Are Assigned (Sorted by Installation)

C.1.1 J2EE and Web Cache Ports

C.1.2 Portal and Wireless Ports

C.1.3 Business Intelligence and Forms Ports

C.1.4 Infrastructure Ports

C.1.5 OracleAS ProcessConnect Ports

C.1.6 OracleAS InterConnect Ports

C.1.7 Oracle Content Management Software Development Kit Ports

C.1.8 OracleAS Developer Kits

C.2 Port Numbers (Sorted by Port Number)

C.3 Guidelines for Changing Port Numbers (Sorted by Installation Type)

C.3.1 J2EE and Web Cache Ports

C.3.2 Portal and Wireless Ports

C.3.3 Business Intelligence and Forms Ports

C.3.4 Infrastructure Ports

C.3.5 OracleAS ProcessConnect Ports

C.3.6 OracleAS InterConnect Ports

C.3.7 Oracle Content Management Software Development Kit Ports

D Metadata Repository Schemas

D.1 Metadata Repository Schema Descriptions

D.1.1 Identity Management Schemas

D.1.2 Product Metadata Schemas

D.1.3 Management Schema

D.2 Metadata Repository Schemas, Tablespaces, and Default Datafiles

E printlogs Tool Syntax and Usage

E.1 Introduction

E.2 Basic Syntax

E.3 Detailed Option Descriptions

E.3.1 Input Options

E.3.2 Filter Options

E.3.3 Ouput Options

E.3.4 General Options

E.4 Log Record Fields

E.5 Environment Variable

E.6 Examples

F Auxiliary Procedures for Changing Infrastructure Services

F.1 About LDAP-based Replicas

F.1.1 What is an LDAP-based Replica?

F.1.2 How is the LDAP-based Replica Used for Changing Infrastructure Services?

F.2 Installing and Setting Up an LDAP-based Replica

F.2.1 Things to Know Before You Start

F.2.2 Procedure

F.3 Migrating SSO and DIP Data

F.4 Migrating Oracle Internet Directory Data

G Examples of Administrative Changes

G.1 How to Use This Appendix

G.2 Examples of Administrative Changes (by Component)

H Viewing Oracle Application Server Release Numbers

H.1 Release Number Format

H.2 Viewing Oracle Application Server Installation Release Numbers

H.3 Viewing Component Release Numbers

H.4 Viewing Oracle Internet Directory Release Numbers

H.5 Viewing Metadata Repository Release Numbers

Index