Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Related Documents
• Conventions

1 What's New in the Oracle Application Server Release Notes?

• 1.1 Chapter 3, "Installation Issues"

2 Introduction

• 2.1 Latest Release Information
• 2.2 Purpose of this Document
• 2.3 Operating System Requirements
• 2.4 Certification Information
• 2.5 Licensing Information

3 Installation Issues

• 3.1 Harmless Warning Message When Specifying an Invalid Instance Name
• 3.2 Deinstallation Error Messages
• 3.3 Termination of Installation
  • 3.3.1 Insufficient ORACLE_HOME Storage Space
  • 3.3.2 Insufficient Installation Storage Space
• 3.4 Oracle Application Server Companion CD 10g (10.1.2.0.0)
  • 3.4.1 System Requirements for Oracle Application Server Companion CD 10g
  • 3.4.2 Oracle Sensor Edge Server Administrator's Guide
• 3.5 Oracle JDeveloper Extensions
• 3.6 Error Message during Deinstallation
• 3.7 Documentation Errata
  • 3.7.1 Incorrect Password Type Specified in Troubleshooting Section
  • 3.7.2 Invalid Solution Documented in Troubleshooting Section

4 Management Issues

• 4.1 General Management Issues
  • 4.1.1 OracleAS Guard Not Supported
  • 4.1.2 Restoring an Oracle Application Server Instance
  • 4.1.3 Using Oracle Enterprise Manager 10g Application Server Control Console To Perform a Recovery of an Oracle Application Server Instance
  • 4.1.4 Using the Backup and Recovery Tool To Perform a Recovery Fails Due To an Unknown Log Sequence Number
  • 4.1.5 Enabling ARCHIVELOG Mode
  • 4.1.6 Received Warning Message During Backup with Backup and Recovery Tool
  • 4.1.7 Using Enterprise Manager To Perform an Instance Recovery
  • 4.1.8 User Created OC4J Instances Require Entries in config_misc_files.inp File
  • 4.1.9 Invoking the runstartupconsole.bat Script
  • 4.1.10 Create Local Mapped Drive For Backups
• 4.2 Oracle Process Manager and Notification Server Issues
  • 4.2.1 Error Message When Executing opmnctl Commands
• 4.3 Deployment Issues
  • 4.3.1 Use Trusted Certificates When Enabling SSL Between mod_oc4j and OC4J
  • 4.3.2 Welcome Pages Display in English in Cloned Installations
  • 4.3.3 Using Oracle Application Server Backup and Recovery Tool to Back Up the Infrastructure Database in OracleAS Cold Failover Cluster Environment
• 4.4 Documentation Errata
  • 4.4.1 Missing Element in Common Configuration Example
  • 4.4.2 Incorrect Attribute Definition

5 Oracle Application Server Containers for J2EE

• 5.1 Configuration Issues and Workarounds
  • 5.1.1 Notes on Oracle JDBC-OCI driver upgrade in the Oracle Application Server
  • 5.1.2 OC4J Out of Memory Errors
  • 5.1.3 Disabling OC4J Access Logging Per Web Application
• 5.2 Servlets
  • 5.2.1 Servlet Bug Fixes Between 9.0.4 and 10.1.2
• 5.3 EJB
  • 5.3.1 Corrected Oracle Containers for J2EE Enterprise JavaBeans Developer's Guide
  • 5.3.2 Deprecated orion-ejb-jar.xml Attributes
  • 5.3.3 Big EAR File Deployment Runs Out of Memory
  • 5.3.4 EJB Wrapper Code Compilation Fails When Running in zh_CN.GB18030 Locale.
• 5.4 OC4J Services
  • 5.4.1 ORMI - OC4J Only Creates IPv4 Sockets
  • 5.4.2 ORMI Protocol Is Not Secure
  • 5.4.3 Enabling IIOP in OC4J
  • 5.4.4 J2EE Connector Architecture
    • 5.4.4.1 J2CA Bug Fixes Between 9.0.4 and 10.1.2
• 5.5 Documentation Errata
  • 5.5.1 Oracle Containers for J2EE Enterprise JavaBeans Developer's Guide Errata
    • 5.5.1.1 Corrected Version of the EJB Developer's Guide
  • 5.5.2 Oracle Containers for J2EE JSP Tag Libraries and Utilities Reference Errata
    • 5.5.2.1 Personalization Tags Chapter Removed for 10.1.2 phase 1
  • 5.5.3 Oracle Application Server Containers for J2EE User's Guide Errata
    • 5.5.3.1 An OC4J Process Is Not "Contained" in an OC4J Instance
    • 5.5.3.2 Correct Cross Reference for Metric-Based Load Balancing Information
    • 5.5.3.3 JDK 1.4.2 Supported and Installed with OC4J
    • 5.5.3.4 Primers Content Removed from OC4J User's Guide
    • 5.5.3.5 Additional OC4J Deployment Notes
  • 5.5.4 Oracle XML API Reference Errata
    • 5.5.4.1 Add Information for formDocument() Method
  • 5.5.5 Oracle Containers for J2EE Services Guide Errata
    • 5.5.5.1 Correct SQLServer Data Source Example
  • 5.5.6 Oracle Containers for J2EE Security Guide Errata
    • 5.5.6.1 Allowed Values for establish.trust elements
    • 5.5.6.2 The external.synchronization Property Is No Longer Supported
    • 5.5.6.3 Define Roles in Lower Case for Third-Party LDAP Logins
    • 5.5.6.4 Removing Realm Names From Principals

6 Oracle HTTP Server

• 6.1 General Issues and Workarounds
  • 6.1.1 OC4J Plug-in Usage with Standalone and Core Installation
  • 6.1.2 Multiple Oracle HTTP Server 2.0 Installations Cause in Port Conflicts
• 6.2 Configuration Issues and Workarounds
  • 6.2.1 Redirects Break If OracleAS Web Cache is Turned Off or is Disabled
• 6.3 Documentation Errata
  • 6.3.1 Incorrect CD Name for Installing Standalone Oracle HTTP Server
  • 6.3.2 Incorrect Perl Version
  • 6.3.3 Incorrect DMS Noun Used in Metric-based Load Balancing Section

7 Oracle TopLink

• 7.1 Known Issues
  • 7.1.1 oracle.sql.TIMESTAMP
  • 7.1.2 XML Parser Dependencies
    • 7.1.2.1 OC4J XML Parser Dependency
    • 7.1.2.2 Using TopLink 10g (9.0.4.5) and with BEA WebLogic Application Server, 8.1
    • 7.1.2.3 Crimson XML Parser Issue
  • 7.1.3 UTF-8 Encoding Exceptions
  • 7.1.4 Prepared Statements may Fail to Execute After a loss of Communication to the Database
  • 7.1.5 Using Oracle TopLink with IBM WebSphere 5.1
  • 7.1.6 TopLink Workbench
    • 7.1.6.1 Mapping Inherited Attributes
    • 7.1.6.2 Changing Classes in Code
    • 7.1.6.3 Refreshing Descriptors with Dependent Classes
    • 7.1.6.4 Spaces in JDBC Paths
    • 7.1.6.5 Oracle TopLink Sessions Editor Preferences
    • 7.1.6.6 Classpath with Spaces in Directory Names
    • 7.1.6.7 Using JAWS
    • 7.1.6.8 Icon Size
    • 7.1.6.9 Generating Source Code
    • 7.1.6.10 Improper Set Method for Array Type Attributes
  • 7.1.7 Using the TopLink Web Client
    • 7.1.7.1 Oracle Containers for J2EE, 10g (9.0.4)
  • 7.1.8 TopLink Examples
    • 7.1.8.1 IBM WebSphere BMP Examples
    • 7.1.8.2 Configuring Examples for RedHat
• 7.2 Documentation Errata
  • 7.2.1 Parameterized SQL
  • 7.2.2 Sequencing Examples
  • 7.2.3 Configuring the TopLink Web Client
  • 7.2.4 TopLink Workbench Tutorial
  • 7.2.5 Specifying Oracle Databases

8 Oracle Application Server Portal

• 8.1 Oracle Instant Portal Issues and Workarounds
  • 8.1.1 XML File Encoding Limitations for Oracle Instant Portal Taxonomies
  • 8.1.2 Additional Step When Editing Items or Portal Titles Using Netscape, Mozilla, and Firefox Browsers
• 8.2 Oracle Application Server Portal Issues and Workarounds
  • 8.2.1 UI Issues and Workarounds
    • 8.2.1.1 Issue Adding Regions to Pages Displayed in a Generic Page Portlet
    • 8.2.1.2 Portlets on Subpages Not Displayed
    • 8.2.1.3 Cannot Set Privileges Using List View on Pages Inheriting Privileges from Parent or Template
  • 8.2.2 OmniPortlet, Simple Parameter Form, and Web Clipping Portlet Issues and Workarounds
    • 8.2.2.1 Browser Requirements for Editing OmniPortlet, Web Clipping, and Simple Parameter Forms Portlets
    • 8.2.2.2 Error Exporting and Importing OmniPortlet and Web Clipping Customizations
    • 8.2.2.3 OmniPortlet Error After Middle Tier Cloning
  • 8.2.3 PDK Issues and Workarounds
  • 8.2.4 Globalization Support Issues and Workarounds
    • 8.2.4.1 Oracle Text Searching Limitation (Text Files and HTML Files)
    • 8.2.4.2 Text Entry Always Right to Left in BiDi Languages
    • 8.2.4.3 Non-ISO-8859 Web Page Limitation for URL Items
    • 8.2.4.4 Non-ASCII Character Limitations
    • 8.2.4.5 Non-ASCII Character Limitations in Oracle Instant Portal
    • 8.2.4.6 Shared Type Objects Cannot Be Exposed in a Non-English Page Group
    • 8.2.4.7 Translations Lost When Item Versioning Enabled
    • 8.2.4.8 Broken Links in Greek, German, and Swedish Built-in Database Portlets
• 8.3 Documentation Errata
  • 8.3.1 Documentation Errors
    • 8.3.1.1 Editing Item/Portlet Properties
    • 8.3.1.2 Editing Pending Items
    • 8.3.1.3 Referencing the Current Version of Images
    • 8.3.1.4 Working in List View
    • 8.3.1.5 Unpublished Items Section Documented Incorrectly
    • 8.3.1.6 Item Level Security and Page Caching
    • 8.3.1.7 User Profile Help Incorrect
    • 8.3.1.8 Defining a Display Style for Results from a Custom Search
    • 8.3.1.9 Applying Background Color or Image to Page Portlets
    • 8.3.1.10 Incomplete Steps for Securing OracleAS Web Cache
  • 8.3.2 Additional Documentation
    • 8.3.2.1 Inaccurate Data in Log Registry Records
    • 8.3.2.2 Expired Items Remain Visible in WebDAV Clients
    • 8.3.2.3 Enhanced Rich Text Editor
    • 8.3.2.4 Unable to Delete Tabs on Templates
    • 8.3.2.5 Error Removing Subscriber from Virtual Private Portal
    • 8.3.2.6 Page Metadata Not Cached in OracleAS Web Cache
    • 8.3.2.7 New Shortcut Keys in Oracle Instant Portal

9 Oracle Application Server Web Cache

• 9.1 Configuration Issues and Workarounds
  • 9.1.1 Reloading Issue with Cache Operations Success Message in OracleAS Web Cache Manager with Internet Explorer Browser
  • 9.1.2 Failure When Submitting Global URL Parameters to Ignore in OracleAS Web Cache Manager
  • 9.1.3 Invalidation Timeout Issue During Invalidation Propagation to a Cache Cluster Member
  • 9.1.4 Failure to Invalidate Content in Configurations with Uppercase Site Host Names
• 9.2 Documentation Errata
  • 9.2.1 Incorrect Note in Oracle Application Server Web Cache Administrator's Guide

10 Oracle Internet Directory

• 10.1 General Issues and Workarounds
  • 10.1.1 Plug-in Features Not Supported in a Directory Server Running Against Oracle9i Database Server Release 2
• 10.2 Configuration Issues and Workarounds
  • 10.2.1 Editing Oracle Internet Directory Users Can Result in "Constraint Violation" Error
  • 10.2.2 Using Oracle Application Server Repository Creation Assistant (RepCA) Can Generate File Creation Error Message
  • 10.2.3 TCP-Based Monitoring of Oracle Internet Directory Server Availability Can Cause Service to Become Unavailable
  • 10.2.4 Do Not Install DaimondCS Port Explorer
• 10.3 Administration Issues and Workarounds
  • 10.3.1 Oracle Internet Directory Servers Can Be Started Only by the Operating System User Who Installed the Oracle Internet Directory Software
  • 10.3.2 Unlocking Privileged User Accounts
  • 10.3.3 Restarting Directory Replication and Directory Integration and Provisioning Server Instances in Real Application Cluster or Rack-Mounted Mode
  • 10.3.4 ODS Database User Password Can Be Changed Only by Using the oidpasswd Tool
  • 10.3.5 Application Server Control Console Does Not Display Port Status Information if Oracle Directory Server is Running in SSL Mode Only
  • 10.3.6 Intermittent Directory Update Failures
• 10.4 Documentation Errata
  • 10.4.1 Parameters in init$ORACLE_SID.ora are Not Loaded Automatically at Database Startup
  • 10.4.2 StopOdiServer.sh Tool Syntax is Incorrect
  • 10.4.3 Figures 27-1, 27-2, and 29-1 are Incorrect
  • 10.4.4 ldifwrite Command Line is Incorrect
  • 10.4.5 ldapsearch Command Line is Incorrect
  • 10.4.6 Oracle Identity Management Concepts and Deployment Planning Guide—Figure B-1 and Description are Incorrect
  • 10.4.7 All References to the ods_server Role are Incorrect
  • 10.4.8 Corrections to Procedure for Loading Data Into the Directory When Installing and Configuring a Multimaster Replication Group
  • 10.4.9 bulkload.sh Command Line Error in Procedure for Configuring an LDAP-Based Replica by Using the ldifwrite Tool
  • 10.4.10 Some Post-Installation Tasks are Described Incorrectly
  • 10.4.11 LDIF Example for Dereferencing Alias Entries is Incorrect
  • 10.4.12 Oracle Identity Management Concepts and Deployment Planning Guide Appendixes Contain High-Level Descriptions
  • 10.4.13 Incorrect Statement About Installing Multimaster Replication Master
  • 10.4.15 Errors in Oracle Identity Management Application Developer's Guide Chapter "Developing Oracle Internet Directory Server Plug-ins"

11 Oracle Delegated Administration Services

• 11.1 General Issues and Workarounds
  • 11.1.1 Use the Oracle Internet Directory Self-Service Console to Change Passwords When Required by Password Policy
  • 11.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
  • 11.1.3 Roles with No Members Are not Displayed in Role Assignment Section in Create/edit User
  • 11.1.4 Resetting Oracle Application Server Single Sign-On Passwords Redirects Users to Oracle Delegated Administration Services Home Page
• 11.2 Configuration Issues and Workarounds
  • 11.2.1 Deploying Oracle Delegated Administration Services on a Separate Host
  • 11.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)
• 11.3 Administration Issues and Workarounds
  • 11.3.1 Missing User Entries in the Oracle Internet Directory Self-Service Console
  • 11.3.2 Enforcing Assignment and Revocation of Privileges Requires Starting a New Self-Service Console Session
  • 11.3.3 Unified Messaging Voicemail PIN Field Mislabeled in Oracle Internet Directory Self-Service Console
  • 11.3.4 Unlocking Privileged User Accounts
  • 11.3.5 Running Oracle Delegated Administration Services in One DNS Domain and OracleAS Portal in Another
  • 11.3.6 Users Are Not Displayed or Search Fails
• 11.4 Documentation Errata
  • 11.4.1 Incomplete Information for Creating User Entries to Be Displayed in the Oracle Internet Directory Self-Service Console
  • 11.4.2 Incorrect Information About Modifying Realm Configuration

12 Oracle Directory Integration and Provisioning

• 12.1 Configuration Issues and Workarounds
  • 12.1.1 Directory Integration and Provisioning Server Status Post-Installation
  • 12.1.2 Two Oracle Internet Directory Plug-in Features Are not Supported after Upgrade from Oracle Internet Directory 10g Release 2 (10.1.2)
• 12.2 Administration Issues and Workarounds
  • 12.2.1 Loading Data from a CSV File into Oracle Internet Directory
    • 12.2.1.1 Syntax for dipassistant loaddata
    • 12.2.1.2 Arguments for dipassistant loaddata
    • 12.2.1.3 Configuration File Properties for dipassistant loaddata
  • 12.2.2 Default Mapping Rule Can Be Simplified in Single-Domain Microsoft Active Directory Deployments
  • 12.2.3 Directory Integration and Provisioning Assistant Does not Support SSL Mode 2
  • 12.2.4 Shell Script-based Profile Configuration Tools Are Being Deprecated
  • 12.2.5 Oracle Directory Integration and Provisioning Server Does not Propagate Events for MODRDN Changes in Oracle Internet Directory
  • 12.2.6 In a High Availability Environment Using Multimaster Replication, Provisioning Events May not Be Propagated or May Be Duplicated
  • 12.2.7 The Oracle Directory Integration and Provisioning Server May not Shut Down if It Is Stopped and Immediately Restarted
  • 12.2.8 The Provisioning Subscription Tool (oidprovtool) Does Not Enable You to Modify the Last Change Number Entry in Profile
  • 12.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
  • 12.2.10 Using Real Application Clusters and the Directory Integration and Provisioning Service
  • 12.2.11 Help for dipassistant loaddata Operation Lists Unavailable Command Arguments
• 12.3 Documentation Errata

13 Oracle Application Server Single Sign-On

• 13.1 UI Issues and Workarounds
  • 13.1.1 New Link on Login Page

14 Oracle Enterprise Manager

• 14.1 General Issues and Workarounds
  • 14.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
  • 14.1.2 Setting NLS and Operating System Locale Environment Variables Before Starting Management Processes
    • 14.1.2.1 Checking the Operating System Locale
    • 14.1.2.2 Setting the Operating System Locale
    • 14.1.2.3 Checking the NLS_LANG Environment Variable
    • 14.1.2.4 Setting the NLS_LANG Environment Variable
  • 14.1.3 Misleading Error Message When Applying Properties to an OC4J Instance within an Oracle Application Server Cluster
  • 14.1.4 Timestamp on Log Files May Not Be Accurate
  • 14.1.5 Errors When Configuring Components or Adding or Removing OC4J Instances
  • 14.1.6 Problem Viewing Performance Charts and Configuring Identity Management Using a Macintosh Browser
  • 14.1.7 Problems with the Progress Page When Using a Macintosh Browser
  • 14.1.8 Topology Viewer Applet Fails in OracleAS Cold Failover Cluster Configuration
  • 14.1.9 Error When Clicking Topology Link from Host Page
  • 14.1.10 Error When Using the ADF BUSINESS COMPONENT Link on the Host Page
  • 14.1.11 Farm Locator Link Lost
  • 14.1.12 Incorrect Status Reported for Oracle Business Intelligence Discoverer
  • 14.1.13 Changing From JAZN LDAP User Manager Requires OC4J Restart
  • 14.1.14 Posting Data From the Logging Pages
  • 14.1.15 Additional Step When Removing an Application Server Target From the Grid Control Console
  • 14.1.16 Security Considerations When Changing Schema Passwords with the Application Server Control Console
  • 14.1.17 Problems Viewing OracleAS Portal Metrics When OracleAS Portal is Configured for Secure Sockets Layer (SSL)
  • 14.1.18 Restrictions When Specifying Remote Directories for Backup and Recovery Configuration Settings in the Application Server Control Console Console
  • 14.1.19 Cannot Recover Database Control Files from the Application Server Control Console
• 14.2 Documentation Errata
  • 14.2.1 Online Help for the Application Server Control All Metrics Page
  • 14.2.2 Error in Online Help Topic About Regular Expressions