Skip Headers
Oracle® Application Server 10
g
Administrator's Guide
10
g
(9.0.4)
Part No. B10376-02
Home
Solution Area
Index
Contents
List of Figures
List of Tables
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 10
g
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 10
g
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 the Application Server Control Console Online Help
2.3
Getting Started with the Application Server Control Console
2.3.1
Displaying the Application Server Control Console
2.3.1.1
Using the Application Server Control Console URL
2.3.1.2
Displaying the Application Server Control Console from the Welcome Page
2.3.1.3
Understanding the Initial Application Server Control Console Home Page
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 the Application Server Control Console
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
2.6
About Oracle Enterprise Manager 10
g
Grid Control
2.6.1
About the Components of Grid Control
2.6.2
Installing the Grid Control Components
2.6.3
Logging In to the Grid Control Console
2.6.4
Viewing a List of Application Servers in the Grid Control Console
2.6.5
Overview of Grid Control Monitoring Tasks
2.6.6
Obtaining More Information About Grid Control
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 the Application Server Control Console
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.1.1
ODL Message Formatting and ODL Log File Naming
4.1.1.2
Log File Messages by Component
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 ODL Log Files
4.6.2.1
ODL Message Contents
4.6.2.2
ODL Log File Naming
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.5.1
Configuring Oracle HTTP Server to Produce ODL Messages
4.6.5.2
Configuring OC4J to Produce ODL Messages
4.6.5.3
Configuring OC4J to Produce 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 10
g
Ports
5.3.2
Changing OC4J Ports
5.3.3
Changing Oracle HTTP Server Ports
5.3.3.1
Changing the Oracle HTTP Server Non-SSL Listen Port (with Web Cache)
5.3.3.2
Changing the Oracle HTTP Server SSL Listen Port (with Web Cache)
5.3.3.3
Changing the Oracle HTTP Server Non-SSL Listen Port (No Web Cache)
5.3.3.4
Changing the Oracle HTTP Server SSL Listen Port (No Web Cache)
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.1.1
Changing the KEY value for an IPC Listener
5.6.2
Changing Oracle Internet Directory Ports
5.6.2.1
Changing the Oracle Internet Directory Non-SSL Port
5.6.2.2
Changing the Oracle Internet Directory SSL Port
5.6.3
Changing the HTTP Server (SSO) Port on Identity Management
5.6.3.1
Changing the Oracle HTTP Server Non-SSL Listen Port on Identity Management
5.6.3.2
Changing the Oracle HTTP Server SSL Listen 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 the Application Server Control Console
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
9.8
Changing the Hostname After Upgrading from Windows 2000 to Windows 2003
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 the Application Server Control
A.1.1
Starting and Stopping the Application Server Control Console on UNIX
A.1.2
Starting and Stopping the Application Server Control Console on Windows
A.2
Understanding Application Server Control Console Processes on UNIX
A.3
Changing the ias_admin Password
A.3.1
Changing the Password Using the Application Server Control Console
A.3.2
Changing the Password Using the emctl Command-Line Tool
A.4
Configuring Security for Enterprise Manager the Application Server Control Console
A.5
Enabling ODL for the Application Server Control Log File
A.5.1
Modifying the Application Server Control Logging Properties
A.5.2
More About the Application Server Control Console 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 Type)
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 Enterprise Manager 10
g
Grid Control Ports
C.1.8
Oracle Content Management Software Development Kit Ports
C.1.9
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 Enterprise Manager 10
g
Grid Control Ports
C.3.8
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
Output 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
