Contents

Title and Copyright Information

Send Us Your Comments

Preface

• Intended Audience
• Documentation Accessibility
• Structure
• Related Documents
• Conventions

Part I Installing Oracle Application Server Standard Edition One

1 Product and Installation Overview

• 1.1 Product Overview
• 1.2 What's New?
• 1.3 Installation Overview
• 1.3.1 Oracle J2EE and Web Services
• 1.3.2 OracleAS Portal
• 1.3.3 Basic and Advanced Installation
• 1.3.4 General Installation Procedure
• 1.4 Things to Know Before Installing Oracle Application Server Standard Edition One
• 1.4.1 Where can I Install Oracle Application Server Standard Edition One?
• 1.4.2 Oracle Home Directory
• 1.4.3 Oracle Application Server Instances and Instance Names
• 1.4.4 The ias_admin User and Restrictions on its Password
• 1.4.5 Global Database Name and Restrictions on its Password
• 1.4.6 Language and Locale Settings
• 1.4.7 Ports
• 1.4.8 If Port 1521 is Already in Use
• 1.4.9 Where Does the Installer Write Files?

2 System and Installation Requirements

• 2.1 System Requirements
• 2.1.1 Tips for Reducing Memory Usage
• 2.2 Windows System Files (wsf.exe)
• 2.3 Operating System User
• 2.4 Environment Variables
• 2.4.1 How to Set Environment Variables
• 2.4.2 ORACLE_HOME and ORACLE_SID Environment Variables
• 2.4.3 PATH Environment Variable
• 2.4.4 TNS_ADMIN Environment Variable
• 2.4.5 TEMP Environment Variable
• 2.5 The %WINDIR%\system32\drivers\etc\hosts File
• 2.5.1 Location of the Default Identity Management Realm
• 2.5.2 Hostname for Oracle Application Server Single Sign-On
• 2.6 Network Topics
• 2.6.1 Installing on DHCP Computers
• 2.6.2 Installing on Computers with Multiple IP Addresses
• 2.6.3 Installing on Computers with Multiple Aliases
• 2.6.4 Installing on Non-Networked Computers
• 2.6.5 Installing on Static IP Computers that You Want to Disconnect from the Network Later
• 2.6.6 Installing a Loopback Adapter
• 2.6.7 Copying CD-ROMs or DVD-ROM to Hard Drive, and Installing from the Hard Drive
• 2.6.8 Installing from a Remote CD-ROM or DVD-ROM Drive
• 2.6.9 Installing on Remote Computers Through Remote Control Software
• 2.7 Prerequisite Checks Performed by the Installer

3 Installing J2EE and Web Services

• 3.1 J2EE and Web Services Components
• 3.2 Adding the OracleAS Portal Components After Installing J2EE and Web Services
• 3.3 Installing J2EE and Web Services
• 3.3.1 Before you Begin
• 3.3.2 Basic Installation Summary
• 3.3.3 Advanced Installation Summary
• 3.4 What Should I Do Next?

4 Installing OracleAS Portal

• 4.1 OracleAS Portal Components
• 4.2 Using an Existing Database for the Metadata Repository
• 4.3 Installing OracleAS Portal
• 4.3.1 Before you Begin
• 4.3.2 Basic Installation Summary
• 4.3.3 Advanced Installation Summary for OracleAS Portal with a New Metadata Repository
• 4.3.4 Advanced Installation Summary for OracleAS Portal with an Existing Metadata Repository
• 4.4 What Should I Do Next?

5 Installation Screens

• 5.1 Starting the Oracle Universal Installer
• 5.2 Welcome Screen
• 5.2.1 Completing the Basic Installation for J2EE and Web Services
• 5.2.2 Completing the Basic Installation for OracleAS Portal with Identity Management and Metadata Repository
• 5.3 Select a Product to Install
• 5.4 Select Additional Languages
• 5.5 Specify Port Configuration Method
• 5.6 Specify Instance Name and ias_admin Password (J2EE and Web Services Installation)
• 5.7 Specify Namespace in Internet Directory
• 5.8 Specify Database Configuration Options
• 5.9 Specify Schema Passwords
• 5.10 Specify Instance Names and ias_admin Password (OracleAS Portal Installation)
• 5.11 Specify Repository
• 5.12 Summary
• 5.13 Install in Progress
• 5.14 Configuration Assistants
• 5.15 Installation Complete
• 5.15.1 Post-Installation Tasks
• 5.15.2 Troubleshooting Information

6 Post-Installation Tasks

• 6.1 State of Oracle Application Server Instances After Installation
• 6.2 Restarting the Computer After Installation
• 6.3 Passwords for Oracle Application Server Components
• 6.4 Backup and Recovery
• 6.5 Enabling SSL
• 6.6 Regional and Language Option Settings and the NLS_LANG Parameter
• 6.7 Component Configuration After Installation
• 6.7.1 Configuring mod_osso (Required for Oracle Delegated Administration Services)
• 6.8 Components that Require Post-Installation Tasks
• 6.9 What Should I Do Next?

Part II Getting Started with Oracle Application Server Standard Edition One

7 Getting Started

• 7.1 Setting Environment Variables
• 7.2 Using the Oracle Application Server Welcome Page
• 7.2.1 Accessing the Welcome Page
• 7.2.2 What's on the Welcome Page?
• 7.3 Checking Your Port Numbers
• 7.4 Getting Started with Managing Components
• 7.4.1 Oracle Process Manager and Notification Server (OPMN)
• 7.4.2 Distributed Configuration Management (DCM)
• 7.4.3 Oracle HTTP Server
• 7.4.4 Oracle Application Server Containers for J2EE (OC4J)
• 7.5 Changing the ias_admin Password
• 7.5.1 Using the Application Server Control Console
• 7.5.2 Using the emctl Command-line Tool

8 Using the Administration Tools

• 8.1 Understanding Oracle Enterprise Manager Application Server Control
• 8.2 Understanding the Application Server Control Console
• 8.2.1 Application Server Control Home Pages
• 8.2.2 Displaying the Application Server Control Console
• 8.2.3 Using the Application Server Home Page
• 8.2.4 Using the Oracle Application Server Farm Home Page
• 8.2.5 Using an Oracle Application Server Component Home Page
• 8.2.6 Monitoring and Diagnosing with the Application Server Control Console
• 8.3 Understanding the Underlying Software Technologies
• 8.3.1 Available Technologies
• 8.3.2 Command-Line Tools
• 8.4 Managing the OracleAS Metadata Repository Database with Database Control

9 Starting and Stopping

• 9.1 Starting and Stopping All Application Server Instances
• 9.2 Starting and Stopping OracleAS Infrastructure
• 9.2.1 Starting OracleAS Infrastructure from the Start Menu
• 9.2.2 Starting OracleAS Infrastructure Manually
• 9.2.3 Stopping OracleAS Infrastructure from the Start Menu
• 9.2.4 Stopping OracleAS Infrastructure Manually
• 9.3 Starting and Stopping the Middle Tier
• 9.3.1 Starting a Middle Tier from the Start Menu
• 9.3.2 Starting a Middle Tier Manually
• 9.3.3 Stopping a Middle Tier from the Start Menu
• 9.3.4 Stopping a Middle Tier Manually
• 9.4 Starting and Stopping Components
• 9.4.1 Starting and Stopping Using opmnctl
• 9.4.2 Starting and Stopping Using the Application Server Control Console
• 9.5 Enabling and Disabling Components
• 9.6 Starting and Stopping an Oracle Application Server Standard Edition One Environment
• 9.6.1 Starting an Oracle Application Server Standard Edition One Environment
• 9.6.2 Stopping an Oracle Application Server Environment

10 Changing the HTTP Port and Listener Settings

• 10.1 Changing the HTTP Port on a Middle Tier Instances
• 10.2 Changing the HTTP (SSO) Port on Identity Management

11 Viewing Log Files

• 11.1 Introduction to Oracle Application Server Standard Edition One Logging
• 11.1.1 Understanding Log File Data and Naming
• 11.1.2 Using a Log Repository
• 11.1.3 Configuring Component Logging Options
• 11.2 Listing and Viewing Log Files With Application Server Control
• 11.2.1 Listing Log Files
• 11.2.2 Listing Log Files for Selected Components
• 11.2.3 Listing Log Files from Oracle Application Server Standard Edition One Component Pages
• 11.2.4 Using Log Files Advanced Search
• 11.2.5 Viewing Log File Details and Log File Contents
• 11.3 Using Oracle Application Server Standard Edition One Log Loader
• 11.3.1 Starting and Stopping Log Loader
• 11.3.2 Enabling and Disabling Log Loader
• 11.3.3 Updating the Log Configuration
• 11.3.4 Setting Log Loader Properties
• 11.3.5 Understanding Log Loader Diagnostic Messages

12 Changing Network Configurations

• 12.1 Overview of Procedures for Changing Network Configurations
• 12.2 Changing Your Hostname, Domain Name, or IP Address
• 12.2.1 Changing the Hostname or Domain Name of a J2EE and Web Services Installation
• 12.2.2 Changing the IP Address of an Infrastructure Containing a Metadata Repository
• 12.2.3 Special Topics for Changing Your Hostname or Domain Name
• 12.3 Moving Between Off-network and On-network
• 12.3.1 Moving from Off-network to On-network (Static IP Address)
• 12.3.2 Moving from Off-network to On-network (DHCP)
• 12.3.3 Moving from On-network to Off-network (Static IP Address)
• 12.3.4 Moving from On-network to Off-network (DHCP)
• 12.4 Changing Between a Static IP Address and DHCP
• 12.4.1 Changing from a Static IP Address to DHCP
• 12.4.2 Changing from DHCP to a Static IP Address

13 Enabling SSL

• 13.1 SSL Communication Paths in the Infrastructure
• 13.2 Common SSL Configuration Tasks for the Infrastructure
• 13.2.1 Configuring SSL for OracleAS Single Sign-On and Oracle Delegated Administration Services
• 13.2.2 Configuring SSL for Oracle Internet Directory
• 13.2.3 Configuring SSL in the Identity Management Database
• 13.3 SSL Communication Paths in the Middle Tier
• 13.4 Common SSL Configuration Tasks for the Middle Tier
• 13.4.1 Enabling SSL in OracleAS Web Cache
• 13.4.2 Enabling SSL in the Oracle HTTP Server
• 13.4.3 Enabling SSL in OracleAS Portal
• 13.4.4 Configuring SSL for Application Server Control

14 Backup and Recovery

• 14.1 Comparison of Backup and Recovery Services
• 14.2 Backup and Recovery Using Application Server Control
• 14.2.1 Configuring your Backup and Recovery Settings
• 14.2.2 Performing a Backup
• 14.2.3 Performing a Recovery
• 14.3 Backup and Recovery Using the OracleAS Backup and Recovery Tool
• 14.3.1 Obtaining the OracleAS Backup and Recovery Tool
• 14.3.2 Configuring the OracleAS Backup and Recovery Tool
• 14.3.3 Customizing OracleAS Backup and Recovery Tool for Your Configuration Files
• 14.3.4 OracleAS Backup and Recovery Tool Usage Summary
• 14.4 Backup Procedures
• 14.4.1 Enabling Block Change Tracking
• 14.4.2 Enabling ARCHIVELOG Mode
• 14.4.3 Creating a Record of Your Oracle Application Server Standard Edition One Configuration
• 14.4.4 Performing an Instance Backup
• 14.4.5 Performing a Complete Environment Backup
• 14.4.6 Performing a Configuration and Metadata Backup

Part III Installing Oracle Application Server Metadata Repository Creation Assistant

15 Oracle Application Server Metadata Repository Creation Assistant Overview and Requirements

• 15.1 Oracle Application Server Metadata Repository Creation Assistant Overview
• 15.1.1 Where is the Oracle Application Server Metadata Repository Creation Assistant?
• 15.1.2 Support for Different Database Storage Types
• 15.1.3 Support for Local and Remote Databases
• 15.2 Steps for Running Oracle Application Server Metadata Repository Creation Assistant
• 15.3 Requirements for the Computer Running Oracle Application Server Metadata Repository Creation Assistant
• 15.4 Installing Oracle Application Server Metadata Repository Creation Assistant
• 15.5 Requirements for the Database
• 15.5.1 Running the Prerequisite Check Tool
• 15.5.2 Which Database Versions are Supported?
• 15.5.3 Notes for Standard Edition Databases
• 15.5.4 Swap Space Requirement
• 15.5.5 Disk Space Needed for SYSTEM and UNDO Tablespaces
• 15.5.6 Disk Space Needed for OracleAS Metadata Repository Tablespaces
• 15.5.7 Patch Needed for Registering with Oracle Internet Directory in SSL Mode
• 15.5.8 OracleAS Metadata Repository on Windows XP Not Supported
• 15.5.9 Initialization Parameters
• 15.5.10 Database Options
• 15.5.11 PL/SQL Packages
• 15.5.12 DBMS_LDAP Package
• 15.5.13 Knowledge Base Required (Oracle Database 10g Only)
• 15.5.14 Password File Authentication
• 15.5.15 Schemas and Tablespaces
• 15.5.16 Registration with Oracle Internet Directory
• 15.6 Requirements for Oracle Internet Directory
• 15.7 Starting Oracle Application Server Metadata Repository Creation Assistant
• 15.8 Which Section to Read Next?

16 Loading the OracleAS Metadata Repository into an Existing Database

• 16.1 Installing in a Database that Uses the File System
• 16.2 Installing in a Database that Uses Raw Devices
• 16.3 Installing in a Database that Uses Oracle-Managed Files
• 16.4 Harmless Errors in the Log File
• 16.4.1 SP2-0332 Errors
• 16.4.2 SP2-0606 Errors
• 16.5 Post-Installation Steps
• 16.5.1 Update sqlnet.ora File
• 16.5.2 Copy ldap.ora File to the Database Oracle Home
• 16.5.3 Unlock the DCM Schema and Set Its Password
• 16.5.4 Create Instance for Oracle Ultra Search
• 16.6 If Loading Failed
• 16.7 Re-Installing the OracleAS Metadata Repository in the Same Database

17 Registering OracleAS Metadata Repository with Oracle Internet Directory

• 17.1 Registering with Oracle Internet Directory
• 17.2 Post-Registration Step
• 17.3 If You Exit Before Registration Is Completed, or If Registration Fails

Part IV Appendixes

A Deinstallation and Reinstallation

• A.1 Deinstalling Oracle Application Server Standard Edition One
• A.2 Deinstalling Oracle Application Server Metadata Repository Creation Assistant
• A.3 Deconfig Tool
• A.3.1 Running the Deconfig Tool
• A.3.2 Deconfiguring the Middle Tier with the Deconfig Tool
• A.3.3 Deinstalling the OracleAS Infrastructure with the Deconfig Tool
• A.4 Harmless Errors in the Log File
• A.5 Deinstalling All Oracle Products Manually
• A.6 Reinstallation
• A.7 Troubleshooting

B Deregistering and Removing OracleAS Metadata Repository

• B.1 Deregistering an Oracle Internet Directory Database
• B.2 Checking If Middle Tiers Are Using the OracleAS Metadata Repository
• B.3 Deregistering and Removing OracleAS Metadata Repository Using the Wizard
• B.4 Removing the OracleAS Metadata Repository
• B.5 Deregistering the OracleAS Metadata Repository
• B.6 Removing OracleAS Metadata Repository Using the cleanMR Script
• B.7 Removing Oracle Internet Directory Objects
• B.8 Cleaning up the Database If You Cancelled a Deregistration Operation

C Default Port Numbers

• C.1 Method of Assigning Default Port Numbers
• C.2 Default Port Numbers

D Ports to Open in Firewalls

E OracleAS Metadata Repository Schemas

• E.1 OracleAS Metadata Repository Schema Descriptions
• E.1.1 Oracle Identity Management Schemas
• E.1.2 Product Metadata Schemas
• E.1.3 Management Schema
• E.2 OracleAS Metadata Repository Schemas, Tablespaces, and Default Datafiles

F Installing Java Access Bridge

• F.1 Introduction
• F.2 Setup for JRE 1.4.2
• F.3 Setup for Oracle Installed Components
• F.3.1 Installing Java Access Bridge
• F.3.2 Configuring Oracle Components to Use Java Access Bridge

G Configuration Assistants

• G.1 Oracle Application Server Standard Edition One Configuration Assistants
• G.2 Troubleshooting Configuration Assistants

H Troubleshooting

• H.1 Log Files
• H.2 General Troubleshooting Tips
• H.3 Installation Problems and Solutions
• H.3.1 Location of Log Files
• H.3.2 Message About Installing in a Non-Empty Directory
• H.3.3 Installer Does Not Appear
• H.3.4 Unable to Clean Up a Failed Installation
• H.3.5 Forgot the Password for the cn=orcladmin Account
• H.3.6 cn=orcladmin Account Becomes Locked
• H.3.7 User Interface Does Not Display in the Desired Language, or Does Not Display Properly
• H.3.8 Unable to Run Oracle Application Server Standard Edition One On-Network and Off-Network
• H.3.9 Configuration Assistant Failures - General
• H.3.10 OracleAS Randomize Password Configuration Assistant Failures
• H.3.11 Database Configuration Assistant (DBCA) Failures
• H.3.12 Harmless Error Message from Database Configuration Assistant (DBCA)
• H.3.13 Application Server Control Configuration Assistant Failure
• H.3.14 OPMN Configuration Assistant - Start HTTP Server Failures
• H.3.15 OPMN Configuration Assistant - Start DAS Instance Failures
• H.4 Deinstallation Problems and Solutions
• H.4.1 Obsolete Partner URLs Still Remain on the Oracle Application Server Single Sign-On Administration Screen
• H.4.2 Unable to Reuse Instance Name of a Deleted Instance
• H.4.3 Unable to Reuse Database Name
• H.4.4 Harmless Error Message During Deinstallation
• H.4.5 Harmless Warning Dialog Window During Deinstallation
• H.5 Backup and Recovery Problems and Solutions
• H.5.1 Restoring After a Failed Restore Attempt
• H.6 Configuration Assistant Problems and Solutions
• H.6.1 General Tips
• H.6.2 Configuration Assistant Result Codes
• H.7 OracleAS Portal Problems and Solutions
• H.7.1 Retrieving an OracleAS Portal Password
• H.7.2 Unable to Login to OracleAS Portal Using Internet Explorer with SSL Enabled
• H.8 OracleAS Metadata Repository Creation Assistant Problems and Solutions
• H.8.1 Unable to Connect to the Database
• H.8.2 Unable to Connect as "sys" User
• H.8.3 Manual Steps: Cleaning Up a Failed Registration or Deregistering OracleAS Metadata Repository
• H.8.4 ORA-01403: No Data Found
• H.9 Database Problems and Solution
• H.10 Need More Help?

Index