Skip Headers
Oracle® Application Server Administrator's Guide
10
g
(10.1.4.0.1)
Part Number B28185-01
Home
Book List
Index
Master Index
Contact Us
Next
View PDF
Contents
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documentation
Conventions
What's New in Oracle Application Server Administration?
New Features for 10
g
(10.1.4.0.1)
Part I Getting Started
1
Getting Started After Installing Oracle Application Server
1.1
Task 1: Set Up Environment Variables
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 Oracle HTTP Server
1.4.3
Getting Started with Oracle Containers for J2EE (OC4J)
1.4.4
Getting Started with Identity Management Components
1.5
Task 5: Enable SSL (Optional)
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.1.1
Using Application Server Control to Manage Oracle Application Server
2.1.1.2
Using Grid Control to Manage Your Enterprise
2.1.1.3
Using Database Control to Manage an OracleAS Metadata Repository Database
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
Components of the Application Server Control
2.2.2
About the Enterprise Manager Home Pages
2.2.3
About the Underlying Technologies
2.2.4
Introducing the New Oracle Identity Management Features of Application Server Control
2.2.5
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 URL
2.3.1.2
Displaying the Application Server Control Console from the Welcome Page
2.3.2
Using the Oracle Application Server Farm Page
2.3.2.1
About the Instances and Clusters Shown on the Farm Page
2.3.2.2
Tasks You Can Perform From the Farm Page
2.3.3
Using the Application Server Home Page
2.3.4
Using the Oracle Application Server Component Home Pages
2.3.5
Using the Oracle Identity Management Component Home Pages
2.4
Monitoring and Diagnosing with the Application Server Control Console
2.4.1
Reviewing the Application Server Component Topology
2.4.2
Reviewing General Information and Resource Usage
2.4.3
Reviewing the Resources of the Application Server Host
2.4.4
Monitoring Application Server Components
2.4.5
Displaying the All Metrics Page for the Application Server or an Application Server Component
2.4.6
Obtaining More Information About Monitoring Oracle Application Server
2.5
Managing the OracleAS Metadata Repository Database with Database Control
2.6
About Oracle Enterprise Manager 10
g
Grid Control
2.6.1
About the Components of Grid Control
2.6.2
Installing Grid Control
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
Installing and Using the Identity Management Grid Control Plug-in
2.6.7
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 OracleAS Infrastructure
3.2.2
Stopping OracleAS Infrastructure
3.2.3
Starting a Middle-Tier Instance
3.2.4
Stopping a Middle-Tier Instance
3.2.5
Starting Oracle Identity Federation
3.2.6
Stopping Oracle Identity Federation
3.3
Starting and Stopping Components
3.3.1
Starting and Stopping Components Using opmnctl
3.3.2
Starting and Stopping Components Using 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
Starting and Stopping Log Loader
3.6.2
Starting and Stopping in High Availability Environments
3.6.3
Resolving OC4J Errors When Starting Multiple Instances
3.6.4
Forcing a Shut Down of OracleAS Metadata Repository
Part II Basic Administration
4
Managing Ports
4.1
About Managing Ports
4.2
Viewing Port Numbers
4.3
Changing Ports
4.3.1
Changing Oracle Enterprise Manager Ports
4.3.2
Changing OC4J Ports
4.3.3
Changing the HTTP Server Port on an Identity Management Installation
4.3.4
Changing the HTTP Server Port on an Oracle Identity Federation Installation
4.3.5
Changing the Oracle HTTP Server Diagnostic Port
4.3.6
Changing the DCM Discovery Port
4.3.7
Changing the Java Object Cache Port
4.3.8
Changing the Log Loader Port
4.3.9
Changing OPMN Ports (ONS Local, Request, and Remote)
4.3.10
Changing the Port Tunneling Port
4.3.11
Changing Infrastructure Ports
4.3.11.1
Changing the OracleAS Metadata Repository Net Listener Port
4.3.11.2
Changing Oracle Internet Directory Ports
4.3.11.3
Changing OracleAS Certificate Authority Ports
5
Managing Log Files
5.1
Introduction to Oracle Application Server Logging
5.1.1
Understanding Log File Data and Naming
5.1.2
Using a Log Repository
5.1.3
Configuring Component Logging Options
5.2
Listing and Viewing Log Files with Application Server Control
5.2.1
Listing Log Files for Components
5.2.2
Listing Log Files from Oracle Application Server Components Pages
5.2.3
Using Log Files Advanced Search
5.3
Searching Diagnostic Messages in a Log Repository
5.3.1
Getting Started with Log Repository
5.3.2
Searching Log Repository with Simple Search
5.3.3
Searching Log Repository with Advanced Search
5.3.4
Viewing Repository Log Entry Details
5.3.5
Using Regular Expressions with Log Repository Search
5.4
Diagnosing Problems and Correlating Messages
5.4.1
Correlating Messages Across Log Files and Components
5.4.2
Diagnosing Component Problems
5.5
Using Oracle Application Server Log Loader
5.5.1
Starting and Stopping Log Loader
5.5.2
Enabling and Disabling Log Loader
5.5.3
Updating the Log Configuration
5.5.4
Setting Log Loader Properties
5.5.5
Understanding Log Loader Diagnostic Messages
5.6
Advanced Logging Topics
5.6.1
Using the printlogs Tool to View Log Messages
5.6.2
Understanding ODL Messages and ODL Log Files
5.6.2.1
ODL Message Contents
5.6.2.2
ODL Log File Naming
5.6.3
Understanding Log Loader Log File Format Conversion
5.6.4
Component Diagnostic Log File Registration
5.6.5
Configuring Components to Produce ODL Messages and ECIDs
5.6.5.1
Configuring Oracle HTTP Server to Produce ODL Messages
5.6.5.2
Configuring OC4J to Produce ODL Messages
5.6.5.3
Configuring OC4J to Produce ECIDs
5.6.6
Creating and Managing a Diagnostic Message Database Repository
5.6.6.1
Creating a Diagnostic Message Database Repository
5.6.6.2
Removing Old Messages from the Diagnostic Message Repository
5.6.6.3
Deleting the Diagnostic Message Repository
5.6.6.4
Reconfiguring Log Loader to Use a File-Based Repository
5.6.7
Limitations and Configuration Issues
6
Managing an OracleAS Metadata Repository
6.1
Frequently Asked Questions About OracleAS Metadata Repository
6.2
Postinstallation Status of OracleAS Metadata Repository Schemas
6.3
Viewing OracleAS Metadata Repository Schema Passwords
6.3.1
Viewing OracleAS Metadata Repository Schema Passwords Using Oracle Directory Manager
6.3.2
Viewing OracleAS Metadata Repository Schema Passwords Using ldapsearch
6.4
Changing OracleAS Metadata Repository Schema Passwords
6.4.1
Changing Schema Passwords Using the Application Server Control Console
6.4.2
Changing Schema Passwords Using SQL*Plus
6.4.3
Changing Schema Passwords in Oracle Internet Directory
6.5
Changing the Character Set of OracleAS Metadata Repository
6.6
Renaming and Relocating OracleAS Metadata Repository Datafiles
Part III Advanced Administration
7
Reconfiguring Application Server Instances
7.1
Configuring Additional Components After Installation
7.1.1
Configuring OracleAS Single Sign-On After Installation
7.1.1.1
Configuring OracleAS Single Sign-On
7.1.1.2
Post-Configuration Tasks
7.1.2
Configuring Oracle Delegated Administration Services After Installation
7.1.2.1
Configuring mod_osso for Oracle Delegated Administration Services
7.1.2.2
Configuring Delegated Administration Service
7.1.2.3
Post-Configuration Tasks
7.1.3
Configuring Oracle Directory Integration Platform After Installation
7.2
Deconfiguring Components
7.3
Deleting OC4J Instances
7.4
Configuring 10.1.2 and 10.1.3 Middle Tiers to Use OracleAS Infrastructure
7.4.1
Configuring 10.1.2 Middle Tiers to Use Oracle Identity Management
7.4.2
Configuring 10.1.2 Middle-Tiers with Oracle Identity Management to Use OracleAS Metadata Repository
7.4.3
Configuring 10.1.2 Middle Tiers to Use an Existing Database as a Repository
7.4.4
Configuring 10.1.3 Middle Tiers to Use 10.1.4 Oracle Identity Management
7.5
Disabling and Enabling Anonymous Binds
7.5.1
Disabling Anonymous Binds for Run Time Environments
7.5.2
Enabling Anonymous Binds for Configuration Changes
8
Changing Network Configurations
8.1
Overview of Procedures for Changing Network Configurations
8.2
Changing the Hostname, Domain Name, or IP Address
8.2.1
Understanding the chgiphost Command
8.2.2
Changing the Hostname, Domain Name, or IP Address of an Identity Management Installation
8.2.3
Changing the Hostname, Domain Name, or IP Address of an Oracle Identity Federation Installation
8.2.4
Changing the Hostname or Domain Name of an OracleAS Certificate Authority Installation
8.2.5
Changing the IP Address of an Infrastructure Containing a Metadata Repository
8.2.6
Special Topics for Changing Your Hostname or Domain Name
8.2.6.1
Running SSLConfigTool for SSL Environments
8.2.6.2
Setting the Log Level for chgiphost
8.2.6.3
Customizing the chgiphost Command
8.2.6.4
Changing a Hostname After Upgrading from Windows 2000 to Windows 2003
8.2.6.5
Recovering from Errors When Changing Your Hostname
8.3
Moving Between Off-Network and On-Network
8.3.1
Moving from Off-Network to On-Network (Static IP Address)
8.3.2
Moving from Off-Network to On-Network (DHCP)
8.3.3
Moving from On-Network to Off-Network (Static IP Address)
8.3.4
Moving from On-Network to Off-Network (DHCP)
8.4
Changing Between a Static IP Address and DHCP
8.4.1
Changing from a Static IP Address to DHCP
8.4.2
Changing from DHCP to a Static IP Address
9
Changing Infrastructure Services
9.1
Overview of Procedures for Changing Infrastructure Services
9.2
Changing the Oracle Internet Directory or Oracle HTTP Server Ports on Identity Management
9.3
Changing Oracle Internet Directory from Dual Mode to SSL Mode
9.3.1
Procedure
9.4
Moving Identity Management to a New Host
9.4.1
Sample Uses for This Procedure
9.4.2
Assumptions and Restrictions
9.4.3
Procedure
9.4.4
Strategy for Performing Failover with This Procedure
9.5
Changing the Metadata Repository Used by a Middle-Tier Instance
9.5.1
Sample Uses for This Procedure
9.5.2
Assumptions and Restrictions
9.5.3
Overview
9.5.4
Procedure
9.6
Changing the Metadata Repository Used by Identity Management
9.6.1
Sample Uses for This Procedure
9.6.2
Assumptions and Restrictions
9.6.3
Procedure
10
Changing from a Test to a Production Environment
10.1
Understanding the Options for Creating a Production Middle Tier
10.2
Scenarios with a 10.1.2 Middle Tier
10.2.1
Scenario 1: Moving J2EE Applications from a Test Middle Tier with Oracle Identity Management to a New Production Environment
10.2.1.1
Preexisting Configuration Assumptions
10.2.1.2
Procedure
10.2.2
Scenario 2: Moving Applications from a Test Middle Tier with Identity Management to a Production Environment with a Preexisting Identity Management
10.2.2.1
Preexisting Configuration Assumptions
10.2.2.2
Procedure
10.2.2.3
Creating a Second Middle-Tier Instance in the Production Environment
10.2.3
Scenario 3: Moving Applications from a Test Middle Tier with Identity Management and a Product Metadata Repository to an Existing Production Environment with Identity Management
10.2.3.1
Preexisting Configuration Assumptions
10.2.3.2
Procedure
10.2.3.3
Creating a Second Middle-Tier Instance in the Production Environment
10.2.4
Related Procedures
10.3
Scenarios with a 10.1.3 Middle Tier
10.3.1
Scenario 1: Moving J2EE Applications from a Test Middle Tier with Oracle Identity Management to a New Production Environment
10.3.1.1
Preexisting Configuration Assumptions
10.3.1.2
Procedure
10.3.2
Scenario 2: Creating a Test Environment for Development and Rolling Out J2EE Applications to a Production Environment with a Preexisting Oracle Identity Management
10.3.2.1
Preexisting Configuration Assumptions
10.3.2.2
Procedure
10.3.3
Related Procedures
Part IV Secure Sockets Layer (SSL)
11
Overview of Secure Sockets Layer (SSL) in Oracle Application Server
11.1
What SSL Provides
11.2
About Private and Public Key Cryptography
11.3
How an SSL Session Is Set Up (the "SSL Handshake")
11.4
Requirements for Using SSL in Oracle Application Server
11.5
Certificates and Oracle Wallets
11.5.1
How to Get a Certificate
11.5.2
Oracle Wallet
11.5.3
Client Certificates
11.6
SSL Configuration Overview
11.6.1
Default SSL Configuration
11.6.2
Partial SSL Configuration
11.7
Integration with Hardware Security Modules
11.7.1
Protocol Converters
11.7.2
Mathematics Accelerators (PKCS #11 Integration)
12
Using the SSL Configuration Tool
12.1
Overview
12.2
Understanding SSL Termination
12.3
Command Line Interface
12.3.1
Where Can I Find the SSL Configuration Tool?
12.3.2
Syntax
12.3.3
Configuration File for Silent Mode
12.3.4
Default Wallet Locations
12.4
Common SSL Configuration Scenarios
12.4.1
Configuring SSL to Load Balancer for OracleAS Single Sign-On/Oracle Delegated Administration Services
12.4.1.1
What It Does
12.4.1.2
Running the SSL Configuration Tool
12.4.1.3
For More Information
12.4.2
Configuring SSL to Load Balancer for OracleAS Portal
12.4.2.1
What It Does
12.4.2.2
Running the SSL Configuration Tool
12.4.2.3
For More Information
12.4.3
Configuring SSL to Oracle HTTP Server for Oracle HTTP Server/Oracle Containers for J2EE
12.4.3.1
What It Does
12.4.3.2
Running the SSL Configuration Tool
12.4.3.3
For More Information
12.4.4
Configuring SSL to OracleAS Web Cache for J2EE
12.4.4.1
What It Does
12.4.4.2
Running the SSL Configuration Tool
12.4.4.3
For More Information
12.4.5
Configuring SSL to Oracle HTTP Server for OracleAS Single Sign-On/Oracle Delegated Administration Services
12.4.5.1
What It Does
12.4.5.2
Running the SSL Configuration Tool
12.4.5.3
For More Information
12.4.6
Configuring SSL to Oracle HTTP Server for OracleAS Portal
12.4.6.1
What It Does
12.4.6.2
Running the SSL Configuration Tool
12.4.6.3
For More Information
12.4.7
Configuring an HTTP Instance
12.4.8
Configuring SSL for Cluster Configurations
12.5
Manual Steps
12.6
Troubleshooting the SSL Configuration Tool
12.6.1
General Troubleshooting Procedure
12.6.2
Oracle Application Server Wireless Requires Manual Changes
12.6.3
Configuring Seeded Providers for OracleAS Portal
12.6.4
SSL Configuration Tool Does Not Support IASCONFIG_LOC Environment Variable
12.6.5
SSL Configuration Tool Does Not Modify sso_apache.conf File
12.6.6
SSL Configuration Tool Does Not Modify opmn.xml Parameters
13
Managing Wallets and Certificates
13.1
Using Oracle Wallet Manager
13.1.1
Oracle Wallet Manager Overview
13.1.1.1
Wallet Password Management
13.1.1.2
Strong Wallet Encryption
13.1.1.3
Microsoft Windows Registry Wallet Storage
13.1.1.4
Backward Compatibility
13.1.1.5
Third-Party Wallet Support
13.1.1.6
LDAP Directory Support
13.1.2
Starting Oracle Wallet Manager
13.1.3
How to Create a Complete Wallet: Process Overview
13.1.4
Managing Wallets
13.1.4.1
Required Guidelines for Creating Wallet Passwords
13.1.4.2
Creating a New Wallet
13.1.4.3
Opening an Existing Wallet
13.1.4.4
Closing a Wallet
13.1.4.5
Exporting Oracle Wallets to Third-Party Environments
13.1.4.6
Exporting Oracle Wallets to Tools That Do Not Support PKCS #12
13.1.4.7
Uploading a Wallet to an LDAP Directory
13.1.4.8
Downloading a Wallet from an LDAP Directory
13.1.4.9
Saving Changes
13.1.4.10
Saving the Open Wallet to a New Location
13.1.4.11
Saving in System Default
13.1.4.12
Deleting the Wallet
13.1.4.13
Changing the Password
13.1.4.14
Using Auto Login
13.1.5
Managing Certificates
13.1.5.1
Managing User Certificates
13.1.5.2
Managing Trusted Certificates
13.2
Performing Certificate Validation and CRL Management with the orapki Utility
13.2.1
orapki Overview
13.2.1.1
orapki Utility Syntax
13.2.2
Displaying orapki Help
13.2.3
Creating Signed Certificates for Testing Purposes
13.2.4
Managing Oracle Wallets with the orapki Utility
13.2.4.1
Creating and Viewing Oracle Wallets with orapki
13.2.4.2
Adding Certificates and Certificate Requests to Oracle Wallets with orapki
13.2.4.3
Exporting Certificates and Certificate Requests from Oracle Wallets with orapki
13.2.5
Managing Certificate Revocation Lists (CRLs) with the orapki Utility
13.2.5.1
About Certificate Validation with Certificate Revocation Lists
13.2.5.2
Certificate Revocation List Management
13.2.6
orapki Utility Commands Summary
13.2.6.1
orapki cert create
13.2.6.2
orapki cert display
13.2.6.3
orapki crl delete
13.2.6.4
orapki crl display
13.2.6.5
orapki crl hash
13.2.6.6
orapki crl list
13.2.6.7
orapki crl upload
13.2.6.8
orapki wallet add
13.2.6.9
orapki wallet create
13.2.6.10
orapki wallet display
13.2.6.11
orapki wallet export
13.3
Interoperability with X.509 Certificates
13.3.1
Public-Key Cryptography Standards (PKCS) Support
13.3.2
Multiple Certificate Support
14
Enabling SSL in the Infrastructure
14.1
SSL Communication Paths in the Infrastructure
14.2
Recommended SSL Configurations
14.3
Common SSL Configuration Tasks
14.3.1
Configuring SSL for OracleAS Single Sign-On and Oracle Delegated Administration Services
14.3.2
Configuring SSL for Oracle Internet Directory
14.3.3
Configuring SSL for Oracle Internet Directory Replication Server and Oracle Directory Integration Platform
14.3.4
Configuring SSL in the Identity Management Database
14.3.5
Additional SSL Configuration in the OC4J_SECURITY Instance
14.3.5.1
Configuring SSL from mod_oc4j to OC4J_SECURITY
14.3.5.2
Using Port Tunneling from mod_oc4j to the OC4J_SECURITY Instance
14.3.5.3
Configuring JDBC/SSL (ASO support)
14.3.6
SSL in Oracle Application Server Certificate Authority
14.3.7
Configuring SSL for Oracle Enterprise Manager 10
g
14.3.7.1
Configuring Security for the Grid Control
14.3.7.2
Configuring Security for the Application Server Control Console
15
Enabling SSL in the Middle Tier
15.1
SSL Communication Paths in the Middle Tier
15.2
Recommended SSL Configurations
15.3
Common SSL Configuration Tasks for the Middle Tier
15.3.1
Enabling SSL in OracleAS Web Cache
15.3.2
Enabling SSL in Oracle HTTP Server
15.3.3
Enabling SSL in OC4J
15.3.3.1
Configuring SSL from Oracle HTTP Server to OC4J
15.3.3.2
Using Port Tunneling (iaspt) from Oracle HTTP Server to OC4J
15.3.3.3
Configuring ORMI/HTTP SSL
15.3.3.4
Configuring Oracle Application Server Java Authentication and Authorization Service (JAAS) Provider for SSL with Oracle Internet Directory
15.3.3.5
Configuring Oracle HTTP Server for SSL
15.3.3.6
Configuring SSL in Standalone OC4J Installations
15.3.4
Enabling SSL in J2EE and Web Cache Installations
15.3.5
Enabling SSL in Virtual Hosts
15.3.6
Enabling SSL in OracleBI Discoverer
15.3.7
Enabling SSL in OracleAS Wireless
15.3.8
Enabling SSL in OracleAS Portal
15.3.9
Configuring SSL for Oracle Enterprise Manager 10
g
16
Troubleshooting SSL
16.1
Name-Based Virtual Hosting and SSL
16.2
Common ORA Errors Related to SSL
Part V Backup and Recovery
17
Introduction to Backup and Recovery
17.1
Philosophy of Oracle Application Server Backup and Recovery
17.2
Overview of the Backup Strategy
17.2.1
Types of Backups
17.2.2
Oracle Application Server Component Backup Input Files
17.2.3
Recommended Backup Strategy
17.3
Overview of Recovery Strategies
17.4
What Is the Oracle Application Server Backup and Recovery Tool?
17.5
Assumptions and Restrictions
17.6
Roadmap for Getting Started with Backup and Recovery
18
Oracle Application Server Backup and Recovery Tool
18.1
How to Obtain the Oracle Application Server Backup and Recovery Tool
18.1.1
Manually Installing the OracleAS Backup and Recovery Tool
18.2
Using Oracle Application Server Control to Configure the Backup and Recovery Tool
18.3
How to Configure the OracleAS Backup and Recovery Tool Manually
18.4
Running the Portal Validation/Cleanup Utility
18.5
Customizing the Tool for Your Configuration Files
18.5.1
How the Tool Works When Backing Up Configuration Files
18.5.2
How to Customize the Tool
18.6
OracleAS Backup and Recovery Tool Usage Summary
18.6.1
Prerequisites for Running the Tool
18.6.2
Syntax
18.6.3
Usage Examples
18.6.4
Purging Backups and Moving Them to Tertiary Storage
19
Backup Strategy and Procedures
19.1
Recommended Backup Strategy
19.2
Backup Procedures
19.2.1
Enabling Block Change Tracking
19.2.2
Enabling ARCHIVELOG Mode
19.2.3
Creating a Record of Your Oracle Application Server Configuration
19.2.4
Performing an Instance Backup of Oracle Application Server Using Application Server Control Console
19.2.5
Performing an Oracle Application Server Instance Backup from the Command Line
19.2.6
Performing a Complete Oracle Application Server Environment Backup
19.3
Recovering a Loss of Host Automatically
19.3.1
Preparing to Use Loss of Host Automation
19.3.2
Enabling Loss of Host Automation
19.3.3
Restoring a Node on a New Host
19.3.4
Restoring a Host with Identity Management to a Host with a Different Name
19.3.5
Recovering an Instance on the Same Host
20
Recovery Strategies and Procedures
20.1
Recovery Strategies
20.1.1
Recovery Strategies for Data Loss, Host Failure, or Media Failure (Critical)
20.1.2
Recovery Strategies for Process Failures and System Outages (Non-Critical)
20.2
Recovery Procedures
20.2.1
Using Application Server Control Console to Recover an Oracle Application Server Instance
20.2.2
Restoring an Infrastructure to the Same Host
20.2.3
Restoring an Infrastructure to a New Host
20.2.4
Restoring an Identity Management Instance to a New Host
20.2.5
Restoring and Recovering the Metadata Repository
20.2.5.1
Restoring and Recovering the Metadata Repository to the Same Host
20.2.5.2
Restoring and Recovering the Metadata Repository to a New Host
20.2.6
Restoring Infrastructure Configuration Files
20.2.7
Restoring a File-Based Repository to a New Host
20.2.8
Restoring an Oracle Application Server Instance
21
Troubleshooting the Backup and Recovery Tool
21.1
Problems and Solutions
21.1.1
Receiving restore_config Operation Fails Error
21.1.2
Receiving Missing Files Messages During restore_config Operation
21.1.3
File-Based Repository Restoration Fails
21.1.4
Cannot Run a Cold Backup on Identity Management or J2EE Instance
21.1.5
Failure Due to Loss or Corruption of OPMN.XML File
21.1.6
A restore_config Operation Fails
21.1.7
Backup Operation Fails on a DCM File-Based Repository
21.1.8
Timeout Occurs While Trying to Stop Processes Using opmnctl stopall
21.1.9
Using the Backup and Recovery Tool to Perform a Recovery Fails Due to an Unknown Log Sequence Number
21.1.10
Enterprise Manager Cannot Access Restored Nodes on New Hosts
21.1.11
Restore of OracleAS Portal Fails After Deleting OC4J Instance
21.1.12
Cold Backups Do Not Shut Down All Databases in RAC Environment
21.1.13
A restore_instance Fails at restore_repos Stage
21.1.14
Changing ORACLE_HOME May Cause Backup or Recovery Failure
21.1.15
Restore Operation Changes Farm Topology Leaving an Instance in Inconsistent State
21.1.16
Post-deployment Changes to Configuration Files Are Lost After Restoring DCM-Managed Components
Part VI Appendixes and Glossary
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.1.3
Verifying That the Application Server Control Is Running
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 Application Server Control Console
A.5
Using the EM_OC4J_OPTS Environment Variable to Set Additional Application Server Control Options
A.5.1
Summary of Options You Can Set with the EM_OC4J_OPTS Environment Variable
A.5.2
Setting the EM_OC4J_OPTS Environment Variable
A.6
Enabling ODL for the Application Server Control Log File
A.6.1
Configuring the Application Server Control Logging Properties to Enable ODL
A.6.2
About the Application Server Control ODL Logging Properties
A.6.3
Configuring Logging Properties When ODL Is Not Enabled
A.7
Enabling Enterprise Manager Accessibility Mode
A.7.1
Making HTML Pages More Accessible
A.7.2
Providing Textual Descriptions of Enterprise Manager Charts
A.7.3
Modifying the uix-config.xml File to Enable Accessibility Mode
B
Oracle Application Server Command-Line Tools
C
URLs for Components
D
Oracle Application Server Port Numbers
D.1
Port Numbers and How They Are Assigned
D.1.1
Oracle HTTP Server, OC4J, and OPMN Ports
D.1.2
Infrastructure Ports
D.1.3
Oracle Enterprise Manager 10
g
Grid Control Ports
D.2
Port Numbers (Sorted by Port Number)
D.3
Ports to Open in Firewalls
E
Metadata Repository Schemas
E.1
Metadata Repository Schema Descriptions
E.1.1
Identity Management Schemas
E.1.2
Product Metadata Schemas
E.1.3
Management Schemas
E.2
Metadata Repository Schemas, Tablespaces, and Default Datafiles
F
printlogs Tool Syntax and Usage
F.1
Introduction
F.2
Basic Syntax
F.3
Detailed Option Descriptions
F.3.1
Input Options
F.3.2
Filter Options
F.3.3
Output Options
F.3.4
General Options
F.4
Log Record Fields
F.5
Environment Variable for printlogs
F.6
Examples
G
Examples of Administrative Changes
G.1
How to Use This Appendix
G.2
Examples of Administrative Changes (by Component)
H
Supplementary Procedures for Configuring LDAP-Based Replicas
H.1
About LDAP-Based Replicas
H.1.1
What Is an LDAP-Based Replica?
H.1.2
How Is the LDAP-Based Replica Used for Changing Infrastructure Services?
H.2
Installing and Setting Up an LDAP-Based Replica
H.2.1
Things to Know Before You Start
H.2.2
Procedure
I
Viewing Oracle Application Server Release Numbers
I.1
Release Number Format
I.2
Viewing Oracle Application Server Installation Release Numbers
I.3
Viewing Component Release Numbers
I.4
Viewing Oracle Internet Directory Release Numbers
I.5
Viewing Metadata Repository Release Numbers
I.6
Using the OPatch Utility
I.6.1
Requirements
I.6.2
Running the OPatch Utility
I.6.2.1
apply Option
I.6.2.2
lsinventory Option
I.6.2.3
query Option
I.6.2.4
rollback Option
I.6.2.5
version Option
J
Troubleshooting Oracle Application Server
J.1
Diagnosing Oracle Application Server Problems
J.2
Common Problems and Solutions
J.2.1
Oracle Application Server Infrastructure Instance Will Not Start
J.2.2
Cannot Reset Administrator (ias_admin) Password
J.2.3
Cannot Restore Backup to a Different Host
J.2.4
Application Performance Impacted by Garbage Collection Pauses
J.2.5
Application Server Returns Connection Refused Errors
J.2.6
Oracle HTTP Server Unable to Start Due to Port Conflict
J.2.7
Machine Overloaded by Number of HTTPD Processes
J.2.8
Oracle Application Server Process Does Not Start
J.2.9
OPMN Start Up Consumes CPU Processing Capability
J.2.10
OPMN Cannot Start
J.2.11
DCM Daemon Cannot Start
J.2.12
DCM Unable to Connect to the Directory
J.2.13
DCM Cannot Access the Infrastructure Database
J.2.14
Oracle Internet Directory Server Does Not Start
J.2.15
Poor LDAP Search Performance
J.2.16
Authentication Failed
J.2.17
Logging into OracleAS Single Sign-On Takes a Long Time
J.2.18
Standby Site Not Synchronized
J.2.19
Failure to Bring Up Standby Instances After Failover or Switchover
J.2.20
Previously Working Application Using ADF Business Components Throws JDBC Errors
J.3
Troubleshooting Application Server Control
J.3.1
Application Server Control General Problems and Solutions
J.3.1.1
Resetting the Administrator (ias_admin) Password
J.3.1.2
Unavailable Metric and Chart Data in the Application Server Control Console
J.3.1.3
Application Server Status Is Down When Server Components Are Up
J.3.1.4
Errors When Starting Application Server Control
J.3.1.5
Problems Connecting to an Application Server Instance from Farm or Cluster Page
J.3.1.6
Application Server Home Page Indicates That the Farm Is Unavailable
J.3.1.7
Error Connecting to the Directory Server
J.3.1.8
Browser Displays "SMISession has been invalidated" Error
J.3.1.9
Memory Errors Generated by the Oracle Management Agent
J.3.1.10
Administration Tasks Performed Using the Command Line Are Not Reflected in Application Server Control Console
J.3.1.11
SSL Timeout Issues with Microsoft Internet Explorer Browsers
J.3.1.12
Session Has Expired Message When Using Multiple Browser Windows
J.3.1.13
Topology Viewer Applet Not Loading
J.3.1.14
No Propagation Between Grid Control and Application Server Control When Creating a New OC4J Instance
J.3.1.15
Problems Viewing Metrics When Configured for Secure Sockets Layer (SSL)
J.3.1.16
Problems Displaying the Date Selection Window When Searching the Log Repository
J.3.2
OC4J Management Problems and Solutions
J.3.2.1
Problems Using the OC4J Security Page
J.3.2.2
Lookup Error When Deploying an OC4J Application
J.3.2.3
Redeploying WAR Applications with Application Server Control
J.3.2.4
Deployment Performance in Internet Explorer and Netscape Navigator 7.0
J.3.2.5
Problems Deploying Large OC4J Applications
J.3.2.6
Troubleshooting OC4J Out of Memory Errors
J.4
Need More Help?
Glossary
Index