Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Related Documents
• Conventions

What's New in Oracle Application Server Release Notes?

• Chapter 1 "Introduction"
• Chapter 3, "Installation Issues"
• Chapter 4, "Management Issues"
• Chapter 7, "Oracle Application Server Portal"

1 Introduction

• 1.1 Latest Release Information
• 1.2 Purpose of this Document
• 1.3 Operating System Requirements
• 1.3.1 Certification on Linux x86-64
• 1.3.1.1 Red Hat Enterprise Linux AS/ES 3.0, Update 3 or higher (AMD64 / Intel EM64T)
• 1.3.1.2 SUSE LINUX Enterprise Server 9 (AMD64 / Intel EM64T)
• 1.4 Certification Information
• 1.5 Licensing Information

2 Installation Issues

• 2.1 Harmless Warning Message When Specifying an Invalid Instance Name
• 2.2 Termination of Installation
• 2.2.1 Insufficient ORACLE_HOME Storage Space
• 2.2.2 Insufficient Installation Storage Space
• 2.3 Oracle Application Server Companion CD 10g (10.1.2.0.0)
• 2.3.1 System Requirements for Oracle Application Server Companion CD 10g
• 2.3.2 Oracle Sensor Edge Server Administrator's Guide
• 2.4 Oracle JDeveloper Extensions
• 2.5 Installer and Graphical Components Cannot Display Japanese Fonts Properly
• 2.6 Oracle Database 10g (10.1.0.4) Patch Set

3 Management Issues

• 3.1 General Management Issues
• 3.1.1 OracleAS Guard Not Supported
• 3.1.2 Restoring an Oracle Application Server Instance
• 3.1.3 Using Oracle Enterprise Manager 10g Application Server Control Console To Perform a Recovery of an Oracle Application Server Instance
• 3.1.4 Using the Backup and Recovery Tool to Perform a Recovery Fails Due to an Unknown Log Sequence Number
• 3.1.5 Unable to Restore the Metadata Repository Backup to Same Point Twice
• 3.1.6 Enabling ARCHIVELOG Mode
• 3.1.7 Using Enterprise Manager To Perform an Instance Recovery
• 3.1.8 User Created OC4J Instances Require Entries in config_misc_files.inp File
• 3.1.9 Invoking the runstartupconsole.sh Script
• 3.1.10 Forbidden Error When Using Portal After the Installation Completes Successfully
• 3.1.11 Create Local Mapped Drive For Backups
• 3.2 Oracle Process Manager and Notification Server Issues
• 3.2.1 Error Message When Running opmnctl Commands
• 3.2.2 Internal Error Message When Running opmnctl Commands
• 3.3 Deployment Issues
• 3.3.1 Use Trusted Certificates When Enabling SSL Between mod_oc4j and OC4J
• 3.3.2 Welcome Pages Display in English in Cloned Installations
• 3.4 Documentation Errata
• 3.4.1 Missing Element in Common Configuration Example
• 3.4.2 Incorrect Attribute Definition

4 Oracle Application Server Containers for J2EE

• 4.1 Configuration Issues and Workarounds
• 4.1.1 Notes on Oracle JDBC-OCI driver upgrade in the Oracle Application Server
• 4.1.2 OC4J Out of Memory Errors
• 4.1.3 Disabling OC4J Access Logging Per Web Application
• 4.2 Servlets
• 4.2.1 Servlet Bug Fixes Between 9.0.4 and 10.1.2
• 4.3 EJB
• 4.3.1 Corrected Oracle Application Server Containers for J2EE Enterprise JavaBeans Developer's Guide
• 4.3.2 Deprecated orion-ejb-jar.xml Attributes
• 4.3.3 Big EAR File Deployment Runs Out of Memory
• 4.3.4 EJB Wrapper Code Compilation Fails When Running in zh_CN.GB18030 Locale
• 4.4 OC4J Services
• 4.4.1 ORMI - OC4J Only Creates IPv4 Sockets
• 4.4.2 ORMI Protocol Is Not Secure
• 4.4.3 Enabling IIOP in OC4J
• 4.4.4 J2EE Connector Architecture
• 4.4.4.1 J2CA Bug Fixes Between 9.0.4 and 10.1.2
• 4.5 Documentation Errata
• 4.5.1 Oracle Application Server Containers for J2EE Enterprise JavaBeans Developer's Guide Errata
• 4.5.1.1 Corrected Version of the Oracle Application Server Containers for J2EE Enterprise JavaBeans Developer's Guide
• 4.5.2 Oracle Application Server Containers for J2EE JSP Tag Libraries and Utilities Reference Errata
• 4.5.2.1 Personalization Tags Chapter Removed for 10.1.2 phase 1
• 4.5.3 Oracle Application Server Containers for J2EE User's Guide Errata
• 4.5.3.1 An OC4J Process Is Not "Contained" in an OC4J Instance
• 4.5.3.2 Correct Cross Reference for Metric-Based Load Balancing Information
• 4.5.3.3 JDK 1.4.2 Supported and Installed with OC4J
• 4.5.3.4 Primers Content Removed from Oracle Application Server Containers for J2EE User's Guide
• 4.5.3.5 Additional OC4J Deployment Notes
• 4.5.4 Oracle XML API Reference Errata
• 4.5.4.1 Add Information for formDocument() Method
• 4.5.5 Oracle Application Server Containers for J2EE Services Guide Errata
• 4.5.5.1 Correct SQLServer Data Source Example
• 4.5.6 Oracle Application Server Containers for J2EE Security Guide Errata
• 4.5.6.1 Allowed Values for establish.trust elements
• 4.5.6.2 The external.synchronization Property Is No Longer Supported
• 4.5.6.3 Define Roles in Lower Case for Third-Party LDAP Logins
• 4.5.6.4 Removing Realm Names From Principals

5 Oracle HTTP Server

• 5.1 General Issues and Workarounds
• 5.1.1 OC4J Plug-in Usage with Standalone and Core Installation
• 5.1.2 Multiple Oracle HTTP Server 2.0 Installations Cause in Port Conflicts
• 5.2 Configuration Issues and Workarounds
• 5.2.1 Redirects Break If OracleAS Web Cache is Turned Off or is Disabled
• 5.3 Documentation Errata
• 5.3.1 Incorrect CD Name for Installing Standalone Oracle HTTP Server
• 5.3.2 Incorrect Perl Version
• 5.3.3 Incorrect DMS Noun Used in Metric-based Load Balancing Section

6 Oracle Application Server TopLink

• 6.1 Known Issues
• 6.1.1 oracle.sql.TIMESTAMP
• 6.1.2 XML Parser Dependencies
• 6.1.2.1 OC4J XML Parser Dependency
• 6.1.2.2 Using OracleAS TopLink 10g (9.0.4.5) and with BEA WebLogic Application Server, 8.1
• 6.1.2.3 Crimson XML Parser Issue
• 6.1.3 UTF-8 Encoding Exceptions
• 6.1.4 Prepared Statements may Fail to Execute After a loss of Communication to the Database
• 6.1.5 Using Oracle Application Server TopLink with IBM WebSphere 5.1
• 6.1.6 OracleAS TopLink Mapping Workbench
• 6.1.6.1 Mapping Inherited Attributes
• 6.1.6.2 Changing Classes in Code
• 6.1.6.3 Refreshing Descriptors with Dependent Classes
• 6.1.6.4 OracleAS TopLink Sessions Editor Preferences
• 6.1.6.5 Using JAWS
• 6.1.6.6 Icon Size
• 6.1.6.7 Generating Source Code
• 6.1.6.8 Improper Set Method for Array Type Attributes
• 6.1.7 Using the OracleAS TopLink Web Client
• 6.1.7.1 Oracle Application Server Containers for J2EE, 10g (9.0.4)
• 6.1.8 OracleAS TopLink Examples
• 6.1.8.1 IBM WebSphere BMP Examples
• 6.1.8.2 Configuring Examples for Red Hat
• 6.2 Documentation Errata
• 6.2.1 Parameterized SQL
• 6.2.2 Sequencing Examples
• 6.2.3 Configuring the OracleAS TopLink Web Client
• 6.2.4 OracleAS TopLink Mapping Workbench Tutorial
• 6.2.5 Specifying Oracle Databases

7 Oracle Application Server Portal

• 7.1 Oracle Instant Portal Issues and Workarounds
• 7.1.1 XML File Encoding Limitations for Oracle Instant Portal Taxonomies
• 7.1.2 Additional Step When Editing Items or Portal Titles Using Netscape, Mozilla, and Firefox Browsers
• 7.2 Oracle Application Server Portal Issues and Workarounds
• 7.2.1 UI Issues and Workarounds
• 7.2.1.1 Issue Adding Regions to Pages Displayed in a Generic Page Portlet
• 7.2.1.2 Portlets on Subpages Not Displayed
• 7.2.1.3 Cannot Set Privileges Using List View on Pages Inheriting Privileges from Parent or Template
• 7.2.2 OmniPortlet, Simple Parameter Form, and Web Clipping Portlet Issues and Workarounds
• 7.2.2.1 Browser Requirements for Editing OmniPortlet, Web Clipping, and Simple Parameter Forms Portlets
• 7.2.2.2 Error Exporting and Importing OmniPortlet and Web Clipping Customizations
• 7.2.2.3 OmniPortlet Error After Middle Tier Cloning
• 7.2.3 PDK Issues and Workarounds
• 7.2.4 Globalization Support Issues and Workarounds
• 7.2.4.1 Oracle Text Searching Limitation (Text Files and HTML Files)
• 7.2.4.2 Text Entry Always Right to Left in BiDi Languages
• 7.2.4.3 Non-ISO-8859 Web Page Limitation for URL Items
• 7.2.4.4 Non-ASCII Character Limitations
• 7.2.4.5 Non-ASCII Character Limitations in Oracle Instant Portal
• 7.2.4.6 Shared Type Objects Cannot Be Exposed in a Non-English Page Group
• 7.2.4.7 Translations Lost When Item Versioning Enabled
• 7.2.4.8 Broken Links in Greek, German, and Swedish Built-in Database Portlets
• 7.3 Documentation Errata
• 7.3.1 Documentation Errors
• 7.3.1.1 Editing Item/Portlet Properties
• 7.3.1.2 Editing Pending Items
• 7.3.1.3 Referencing the Current Version of Images
• 7.3.1.4 Working in List View
• 7.3.1.5 Unpublished Items Section Documented Incorrectly
• 7.3.1.6 Item Level Security and Page Caching
• 7.3.1.7 User Profile Help Incorrect
• 7.3.1.8 Defining a Display Style for Results from a Custom Search
• 7.3.1.9 Applying Background Color or Image to Page Portlets
• 7.3.1.10 Incomplete Steps for Securing OracleAS Web Cache
• 7.3.2 Additional Documentation
• 7.3.2.1 Inaccurate Data in Log Registry Records
• 7.3.2.2 Expired Items Remain Visible in WebDAV Clients
• 7.3.2.3 Enhanced Rich Text Editor
• 7.3.2.4 Unable to Delete Tabs on Templates
• 7.3.2.5 Error Removing Subscriber from Virtual Private Portal
• 7.3.2.6 Page Metadata Not Cached in OracleAS Web Cache
• 7.3.2.7 New Shortcut Keys in Oracle Instant Portal

8 Oracle Application Server Web Cache

• 8.1 Configuration Issues and Workarounds
• 8.1.1 Reloading Issue with Cache Operations Success Message in OracleAS Web Cache Manager with Internet Explorer Browser
• 8.1.2 Failure When Submitting Global URL Parameters to Ignore in OracleAS Web Cache Manager
• 8.1.3 Invalidation Timeout Issue During Invalidation Propagation to a Cache Cluster Member
• 8.1.4 Failure to Invalidate Content in Configurations with Uppercase Site Host Names
• 8.2 Documentation Errata
• 8.2.1 Incorrect Note in Oracle Application Server Web Cache Administrator's Guide

9 Oracle Internet Directory

• 9.1 General Issues and Workarounds
• 9.1.1 Plug-in Features Not Supported in a Directory Server Running Against Oracle9i Database Server Release 2
• 9.2 Configuration Issues and Workarounds
• 9.2.1 Refer to the File ias.properties after Installing Oracle Internet Directory for LDAP Port Assignment
• 9.2.2 Using Oracle Application Server Repository Creation Assistant (RepCA) Can Generate File Creation Error Message
• 9.2.3 Do Not Install DaimondCS Port Explorer
• 9.3 Administration Issues and Workarounds
• 9.3.1 Oracle Internet Directory Servers Can Be Started Only by the Operating System User Who Installed the Oracle Internet Directory Software
• 9.3.2 Unlocking Privileged User Accounts
• 9.3.3 Restarting Directory Replication and Directory Integration and Provisioning Server Instances in Real Application Cluster or Rack-Mounted Mode
• 9.3.4 ODS Database User Password Can Be Changed Only by Using the oidpasswd Tool
• 9.3.5 Application Server Control Console Does Not Display Port Status Information if Oracle Directory Server is Running in SSL Mode Only
• 9.3.6 Intermittent Directory Update Failures
• 9.4 Documentation Errata
• 9.4.1 Parameters in init$ORACLE_SID.ora are Not Loaded Automatically at Database Startup
• 9.4.2 StopOdiServer.sh Tool Syntax is Incorrect
• 9.4.3 Figures 27-1, 27-2, and 29-1 are Incorrect
• 9.4.4 ldifwrite Command Line is Incorrect
• 9.4.5 ldapsearch Command Line is Incorrect
• 9.4.6 Oracle Identity Management Concepts and Deployment Planning Guide—Figure B-1 and Description are Incorrect
• 9.4.7 All References to the ods_server Role are Incorrect
• 9.4.8 Corrections to Procedure for Loading Data Into the Directory When Installing and Configuring a Multimaster Replication Group
• 9.4.9 bulkload.sh Command Line Error in Procedure for Configuring an LDAP-Based Replica by Using the ldifwrite Tool
• 9.4.10 Some Post-Installation Tasks are Described Incorrectly
• 9.4.11 LDIF Example for Dereferencing Alias Entries is Incorrect
• 9.4.12 Oracle Identity Management Concepts and Deployment Planning Guide Appendixes Contain High-Level Descriptions
• 9.4.13 Incorrect Statement About Installing Multimaster Replication Master
• 9.4.14 Incorrect Statement about Default Value of Grace Logins After Password Expiration
• 9.4.15 Errors in Oracle Identity Management Application Developer's Guide Chapter "Developing Oracle Internet Directory Server Plug-ins"

10 Oracle Delegated Administration Services

• 10.1 General Issues and Workarounds
• 10.1.1 Use the Oracle Internet Directory Self-Service Console to Change Passwords When Required by Password Policy
• 10.1.2 Realm Values Cannot Be Edited with Oracle Delegated Administration Services Configuration Privileges in Releases 9.0.2, 9.0.4, and 10.1.2
• 10.1.3 Roles with No Members Are not Displayed in Role Assignment Section in Create/edit User
• 10.1.4 Resetting Oracle Application Server Single Sign-On Passwords Redirects Users to Oracle Delegated Administration Services Home Page
• 10.2 Configuration Issues and Workarounds
• 10.2.1 Deploying Oracle Delegated Administration Services on a Separate Host
• 10.2.2 Configuring Oracle Delegated Administration Services to Run Against an Oracle Internet Directory Installation Upgraded from Release 9.0.4 to 10g Release 2 (10.1.2)
• 10.3 Administration Issues and Workarounds
• 10.3.1 Missing User Entries in the Oracle Internet Directory Self-Service Console
• 10.3.2 Enforcing Assignment and Revocation of Privileges Requires Starting a New Self-Service Console Session
• 10.3.3 Unified Messaging Voicemail PIN Field Mislabeled in Oracle Internet Directory Self-Service Console
• 10.3.4 Unlocking Privileged User Accounts
• 10.3.5 Running Oracle Delegated Administration Services in One DNS Domain and OracleAS Portal in Another
• 10.3.6 Users Are Not Displayed or Search Fails
• 10.4 Documentation Errata
• 10.4.1 Incomplete Information for Creating User Entries to Be Displayed in the Oracle Internet Directory Self-Service Console
• 10.4.2 Incorrect Information About Modifying Realm Configuration

11 Oracle Directory Integration and Provisioning

• 11.1 Configuration Issues and Workarounds
• 11.1.1 Directory Integration and Provisioning Server Status Post-Installation
• 11.1.2 Two Oracle Internet Directory Plug-in Features Are not Supported after Upgrade from Oracle Internet Directory 10g Release 2 (10.1.2)
• 11.2 Administration Issues and Workarounds
• 11.2.1 Loading Data from a CSV File into Oracle Internet Directory
• 11.2.1.1 Syntax for dipassistant loaddata
• 11.2.1.2 Arguments for dipassistant loaddata
• 11.2.1.3 Configuration File Properties for dipassistant loaddata
• 11.2.2 Default Mapping Rule Can Be Simplified in Single-Domain Microsoft Active Directory Deployments
• 11.2.3 Directory Integration and Provisioning Assistant Does not Support SSL Mode 2
• 11.2.4 Shell Script-based Profile Configuration Tools Are Being Deprecated
• 11.2.5 Oracle Directory Integration and Provisioning Server Does not Propagate Events for MODRDN Changes in Oracle Internet Directory
• 11.2.6 In a High Availability Environment Using Multimaster Replication, Provisioning Events May not Be Propagated or May Be Duplicated
• 11.2.7 The Oracle Directory Integration and Provisioning Server May not Shut Down if It Is Stopped and Immediately Restarted
• 11.2.8 The Provisioning Subscription Tool (oidprovtool) Does Not Enable You to Modify the Last Change Number Entry in Profile
• 11.2.9 Restarting Directory Replication and Directory Integration and Provisioning Server Instances in a Real Application Cluster or a Oracle Application Server Cluster (Identity Management) Configuration
• 11.2.10 Using Real Application Clusters and the Directory Integration and Provisioning Service
• 11.2.11 Help for dipassistant loaddata Operation Lists Unavailable Command Arguments
• 11.3 Documentation Errata

12 Oracle Application Server Single Sign-On

• 12.1 UI Issues and Workarounds
• 12.1.1 New Link on Login Page

13 Oracle Enterprise Manager

• 13.1 General Issues and Workarounds
• 13.1.1 Problems with the Oracle Enterprise Manager 10g Application Server Control Console After Deinstalling Oracle Application Server 9.0.2 or 9.0.3
• 13.1.2 Setting NLS and Operating System Locale Environment Variables Before Starting Management Processes
• 13.1.2.1 Checking the Operating System Locale
• 13.1.2.2 Setting the Operating System Locale
• 13.1.2.3 Checking the NLS_LANG Environment Variable
• 13.1.2.4 Setting the NLS_LANG Environment Variable
• 13.1.3 Misleading Error Message When Applying Properties to an OC4J Instance within an Oracle Application Server Cluster
• 13.1.4 Errors When Configuring Components or Adding or Removing OC4J Instances
• 13.1.5 Problem Viewing Performance Charts and Configuring Identity Management Using a Macintosh Browser
• 13.1.6 Problems with the Progress Page When Using a Macintosh Browser
• 13.1.7 Topology Viewer Applet Fails in OracleAS Cold Failover Cluster Configuration
• 13.1.8 Error When Clicking Topology Link from Host Page
• 13.1.9 Error When Using the ADF BUSINESS COMPONENT Link on the Host Page
• 13.1.10 Farm Locator Link Lost
• 13.1.11 Incorrect Status Reported for Oracle Business Intelligence Discoverer
• 13.1.12 Changing From JAZN LDAP User Manager Requires OC4J Restart
• 13.1.13 Posting Data From the Logging Pages
• 13.1.14 Additional Step When Removing an Application Server Target From the Grid Control Console
• 13.1.15 Security Considerations When Changing Schema Passwords with the Application Server Control Console
• 13.1.16 Problems Viewing OracleAS Portal Metrics When OracleAS Portal is Configured for Secure Sockets Layer (SSL)
• 13.1.17 Cannot Recover Database Control Files from the Application Server Control Console
• 13.2 Documentation Errata
• 13.2.1 Online Help for the Application Server Control All Metrics Page
• 13.2.2 Error in Online Help Topic About Regular Expressions