Oracle Fusion Middleware Release Notes, 11g Release 1 (11.1.1) for Microsoft Windows x64 (64-Bit)

11g Release 1 (11.1.1)

E14774-32

Contents

Title and Copyright Information

Preface

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

Part I Oracle Fusion Middleware

1 Introduction

- 1.1 Latest Release Information

- 1.2 Purpose of this Document

- 1.3 System Requirements and Specifications

- 1.4 Memory Requirements

- 1.5 Certification Information

- 1.5.1 Where to Find Oracle Fusion Middleware Certification Information

- 1.5.2 Certification Exceptions

- 1.5.2.1 Certification Information for Oracle Fusion Middleware 11g R1 with Oracle Database 11.2.0.1

- 1.5.2.2 Excel Export Issue on Windows Vista Client

- 1.5.2.3 Oracle Forms and Oracle Reports 11g Installer Issues In Windows Vista and Windows XP

- 1.5.2.4 Restrictions on Specific Browsers

- 1.5.3 Upgrading Sun JDK From 1.6.0_07 to 1.6.0_11

- 1.5.4 JMSDELIVERYCOUNT Is Not Set Properly

- 1.5.5 Viewer Plugin Required On Safari 4 To View Raw XML Source

- 1.6 Downloading and Applying Required Patches

- 1.7 Licensing Information

2 Installation, Patching, and Configuration

- 2.1 Installation Issues and Workarounds

- 2.1.1 Oracle SOA Suite Installation Issues

- 2.1.1.1 Installing Oracle SOA Suite on a Dual Stack Host with IPv4

- 2.1.1.2 Installing Oracle SOA Suite Release 11.1.1.3.0 in a Turkish Environment

- 2.1.2 Oracle Portal, Forms, Reports and Discoverer Installation Issues

- 2.1.2.1 Installing Oracle Portal, Forms, Reports and Discoverer on Windows with IPv6

- 2.1.2.2 Missing Shortcuts in the Oracle Portal, Forms, Reports and Discoverer Installation

- 2.1.2.3 Prerequisite Warnings During Installation

- 2.1.3 Oracle Web Tier Installation Issues

- 2.1.3.1 Oracle SOA Suite and Oracle Application Developer Must Be Installed Before Oracle Web Tier

- 2.1.3.2 Re-Installing Oracle Web Cache if Double Backslashes (\\) Are Specified During Installation

- 2.1.3.3 Oracle Web Tier Silent Install Requires Oracle Web Cache Component Name

- 2.1.4 Oracle Identity Management Installation Issues

- 2.1.4.1 "Null" Dialog Box Appears When Installing Oracle Identity Management to FAT32 File System on Windows

- 2.1.4.2 WebLogic Administration Server Must Be Running When Extending Oracle Identity Management Domains

- 2.1.4.3 Do Not Install Patch 9824531 During the Setup of OIM and OAM Integration

- 2.1.4.4 Welcome Screen of Oracle Entitlements Server Installer Not Translated

- 2.1.4.5 Additional Information When Using a Java Security Module with Oracle Entitlements Server

- 2.1.5 JDK and JRE Installation Issues

- 2.1.5.1 Specifying the JRE Location if Installing with Automatic Updates

- 2.1.5.2 Upgrading Sun JDK in the Oracle Home Directory

- 2.1.5.3 Out of Memory Errors When Using JDK 6 Update 23

- 2.1.6 Oracle Universal Installer Issues

- 2.1.6.1 Installer Produces Errors When Checking for Software Updates on My Oracle Support

- 2.1.6.2 Running the Installer From C:\Documents and Settings When C:\Documents Also Exists

- 2.1.7 Database and Schema Installation Issues

- 2.1.7.1 Problems with the Oracle Home Directory Being Overwritten on Windows

- 2.1.7.2 Database Connection Failure During Schema Creation When Installing Oracle Internet Directory

- 2.1.7.3 Command to Drop Tablespaces and Data Files Does Not Drop Data Files from the File System

- 2.1.8 Error Messages and Exceptions Seen During Installation

- 2.1.8.1 JRF Startup Class Exceptions May Appear in Oracle WebLogic Managed Server Logs After Extending Oracle Identity Management Domain

- 2.1.8.2 Sun JDK and Oracle Configuration Manager Failures in the Installation Log File

- 2.1.9 Deinstallation Issues

- 2.1.9.1 Proper Deinstallation for Reinstallation in the Event of a Failed Installation

- 2.1.9.2 Verify PATH Before Starting Classic Installation on Microsoft Windows x64 (64-Bit)

- 2.1.9.3 Deinstallation Does Not Remove WebLogic Domains

- 2.1.10 Installing Oracle Service Registry in the Same Domain as Oracle SOA Suite

- 2.1.11 Problems Installing in Thai and Turkish Locales

- 2.1.12 Enterprise Manager Configuration Fails with Timezone Error Message

- 2.2 Patching Issues and Workarounds

- 2.2.1 Oracle SOA Suite Patching Issues

- 2.2.1.1 Exception Seen When Extending Your Existing Oracle SOA Suite Domain with Oracle Business Process Management Suite

- 2.2.1.2 Exception Seen When Undeploying any SOA Composite with Range-Based Dimension Business Indicators

- 2.2.1.3 Running Oracle Business Process Management Suite with Microsoft SQL Server 2008 Database

- 2.2.1.4 Update to Oracle SOA Suite Release 11.1.1.3.0 Does Not Remove the b2b.r1ps1 Property

- 2.2.1.5 Manual Steps for Migrating Oracle UMS and Oracle MDS

- 2.2.1.6 Monitored BPEL Processes Generate Warning Messages in Log File After Applying 11g Release 1 (11.1.1.4.0) Patch Set

- 2.2.1.7 Oracle Rules Error in Administration Server Log Files After Patching an 11g Release 1 (11.1.1.2.0) Domain

- 2.2.1.8 Incorrect Instance State of Composite Applications After Applying the Latest Patch Set

- 2.2.2 Oracle WebCenter Portal Patching Issues

- 2.2.2.1 Granting Access to Network-Related Packages for the Oracle Portal Schema

- 2.2.2.2 Some WebCenter Portal Applications Show Old Version Number

- 2.2.2.3 Problem Using WebCenter Portal: Spaces Customizations with .jsp Pages After Installing the 11.1.1.6.0 Patch Set

- 2.2.2.4 Errors When Updating Oracle WebCenter Portal Using WLST Commands

- 2.2.3 Oracle Identity Management Patching Issues

- 2.2.3.1 Installer Does Not Detect Existing Oracle Home

- 2.2.3.2 Uploading Third Party JAR Files to the Database

- 2.2.3.3 Updating Oracle Identity Management with LDAP Sync Enabled Generates XML Errors

- 2.2.3.4 Access Policy With Approval Does Not Work After Patch

- 2.2.3.5 OID and OVD Saved Connections Not Available After Patch From Release 11.1.1.2.0 or 11.1.1.3.0

- 2.2.3.6 Error When Running the upgradeOpss() Command When Upgrading Oracle Identity Management

- 2.2.3.7 Errors in the Log Files After Patching Oracle Identity Management to Release 11.1.1.4.0

- 2.2.3.8 Warning Message When Migrating Oracle Identity Federation from Release 11.1.1.1.0 to Release 11.1.1.2.0

- 2.2.3.9 Benign Errors Logged When Patching Oracle Identity Management 11.1.1.2.0 Installation to 11.1.1.3.0

- 2.2.3.10 Exception Seen When Starting Oracle Identity Management Server

- 2.2.4 System Component Patching Issues

- 2.2.4.1 Redeploy System Components to Ensure Proper Deinstallation

- 2.2.5 Version Numbers Not Displaying Correctly After Patching

- 2.2.5.1 MDS Schema Version Number is Incorrect

- 2.2.5.2 Oracle BI Components Show Incorrect Version Number After Patching

- 2.2.6 Issues with Displays During or After Patching

- 2.2.6.1 Pages in Oracle Enterprise Manager and Oracle Directory Services Manager do not Display Correctly

- 2.2.7 Error When Accessing the Oracle Portal Home Page

- 2.2.8 Warnings When Running upgradeOpss()

- 2.2.9 "Patch Already Installed" Warning Message in Log File

- 2.2.10 Manual Step for ODI-BAM Users After Installing 11.1.1.4.0 Patch Set

- 2.2.11 Applications Generate javax.xml.bind.JAXBException Runtime Errors After Installing 11.1.1.4.0 Patch Set

- 2.3 Configuration Issues and Workarounds

- 2.3.1 Oracle SOA Suite Configuration Issues

- 2.3.1.1 SOAINFRA Schema Contains Invalid Objects

- 2.3.1.2 Exception Seen for Oracle SOA Suite with WebSphere Application Server

- 2.3.2 Oracle Identity Management Configuration Issues

- 2.3.2.1 Oracle Identity Federation oif-upgrade-11.1.1.2.0-11.1.1.6.0.py Script is not run on Remote Machines

- 2.3.2.2 Errors Logged to Managed Server Log Files When Extending a 11.1.1.3.0 Oracle Identity Management Domain on a Remote System

- 2.3.2.3 Log Messages Appearing on Console During Oracle Identity Management Schema Creation

- 2.3.2.4 Configuring Oracle Identity Management When WebLogic Node Manager is Running

- 2.3.2.5 Configuring OID with Oracle Data Vault

- 2.3.2.6 OIDMON Does Not Start After Configuring Oracle Internet Directory on Windows

- 2.3.2.7 Password Requirements for Oracle Internet Directory Administrator

- 2.3.2.8 Error Message When Configuring Oracle Identity Federation

- 2.3.3 Configuration Wizard Issues

- 2.3.3.1 Starting the Configuration Wizard From a New Window

- 2.3.3.2 Specify Security Updates Screen Does Not Appear in the Configuration Wizard

- 2.3.4 Repository Creation Utility Issues

- 2.3.4.1 Schemas Are Not Visible After Upgrade of Oracle Identity Management

- 2.3.4.2 RCU Summary Screen Issues

- 2.3.5 Pack and Unpack Issues

- 2.3.5.1 Ensure There Are No Missing Products When Using unpack.sh or unpack.cmd

- 2.3.5.2 Running unpack.sh or unpack.cmd on a Different Host

- 2.3.5.3 Starting Managed Servers on Remote System After Packing and Unpacking Domain

- 2.3.6 Configuration Issues Working With Clusters

- 2.3.6.1 Extend Domain and Expand Cluster Scenarios with Remote Systems

- 2.3.6.2 Unable to Extend an Existing Domain by Selecting Only Oracle Directory Integration Platform Without Cluster

- 2.3.6.3 Expand Cluster Requires Changes to the emd.properties File

- 2.3.7 Setting the PATH Environment Variable for Oracle Configuration Manager

- 2.3.8 Oracle WebCenter Portal wc-post-install.py Script Not Supported for Oracle RAC Datasources

- 2.3.9 FileNotFoundException When Cloning on Windows

- 2.3.10 Changing the Listen Address of a Managed Server

- 2.3.11 Domain Extension Overwrites JDBC Data Source Name

- 2.3.12 Rerouting to Original URL After SSO Authentication in Firefox and Safari Browsers

- 2.3.13 Deleting the Browser Cache in Browsers

- 2.3.14 WebLogic Administration Server Fails to Start Due to Memory Issues

- 2.4 Known Issues

- 2.4.1 Forms and Reports Builder Not Supported

- 2.5 Documentation Errata

- 2.5.1 Updating OIM Configuration to Use Oracle HTTP Server 10g WebGate

- 2.5.2 Missing Logout Configuration Steps in the Oracle Identity Management Installation Guide

3 Upgrade

- 3.1 General Issues and Workarounds

- 3.1.1 Patches Required to Address Specific Upgrade and Compatibility Requirements

- 3.1.1.1 Obtaining Patches and Support Documents From My Oracle Support (Formerly OracleMetaLink)

- 3.1.1.2 Upgrading the Oracle BAM Schema on Oracle Database 11g on Microsoft Windows

- 3.1.2 Unable to Read Composite Model Error During SOA Application Upgrade

- 3.1.3 Oracle BAM Upgrade Issues

- 3.1.3.1 Datapump Export for Oracle BAM Upgrade Plug-in Fails in Oracle Database 10g (10.2.0.3), 10g (10.1.2.0.4), and Oracle Database 11g (11.1.0.7)

- 3.1.3.2 Dependent Alerts Do Not Upgrade Correctly

- 3.1.3.3 Problem Upgrading a Report that Contains Calculated Fields

- 3.1.3.4 Calculated Fields Reference the Field ID Rather Than Field Names After Upgrade to Oracle BAM 11g

- 3.1.3.5 Using the Oracle BAM 11g Samples After Upgrade from Oracle BAM 10g

- 3.1.4 Error When Upgrading Oracle Internet Directory Due to Invalid ODS Schema

- 3.1.5 Restore From Backup Required If Upgrade Fails During a Colocated Oracle Internet Directory and Oracle Directory Integration Platform Upgrade

- 3.1.6 Cannot Verify Oracle Forms Services Upgrade When Oracle HTTP Server is Running On a Separate Host

- 3.1.7 WebCenter Security Upgrade Release Notes

- 3.1.7.1 RowSetPermission check fails with compatibility flag set

- 3.1.7.2 Grants not migrated properly if application contains grants without permissions

- 3.1.7.3 Shared/public credentials not found after external application deployed

- 3.1.8 Oracle B2B Upgrade Release Notes

- 3.1.8.1 Service Name Is Required When Using ebMS with Oracle B2B

- 3.1.8.2 Converting Wallets to Keystores for Oracle B2B 11g

- 3.1.8.3 Oracle B2B UCCnet Documents Not Upgraded to 11g

- 3.1.8.4 Errors in the Upgrade Log Files Even When Oracle B2B Schema Upgrade is Successful

- 3.1.9 Problem Accessing the Welcome Pages in Oracle HTTP Server After Upgrade

- 3.1.10 Misleading Error Message When Upgrading Oracle Internet Directory

- 3.1.11 Additional Steps Required When Redeploying the SOA Order Booking Sample Application on Oracle Fusion Middleware 11g

- 3.1.12 Additional Steps Required When Upgrading Human Taskflow Projects

- 3.1.13 Stopping Oracle Virtual Directory Processes During Upgrade

- 3.1.14 Providing Input to Upgrade Assistant Screens When Oracle Internet Directory Upgrade Fails

- 3.1.15 Upgrading Oracle Access Manager Middle Tier

- 3.1.16 Inaccurate Results When Running the Upgrade Assistant Verify Feature

- 3.1.17 Missing jdk_version.log File When Launching Upgrade Assistant

- 3.1.18 Test Suites in Oracle SOA Suite 10g Projects Not Upgraded to 11g

- 3.2 General Issues and Workarounds for Migrating from 11.1.1.1.0

- 3.2.1 Stopping the 11.1.1.2.0 Domain

- 3.2.2 Editing the patchMaster.properties File

- 3.2.3 Patching the Schema for Oracle Internet Directory

- 3.2.4 Changing the patchmaster.ValidationErrorContinue Property

- 3.2.5 Changing the Default Setting for Validation Tasks

- 3.2.6 Severe Error When Running the execute-sql-rcu Macro

- 3.2.7 Machine Names Do Not Appear in the Oracle WebLogic Server Administration Console

- 3.2.8 Using the Oracle BAM 11g Prepackaged Samples After Migrating from 11.1.1.1.0

- 3.2.8.1 Configuring the Oracle BAM 11g Samples After Migrating from 11.1.1.1.0

- 3.2.8.2 Using the Foreign Exchange Sample After Migrating from 11.1.1.1.0

- 3.3 Documentation Errata for Upgrade

- 3.3.1 Documentation Errata for the Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

- 3.3.1.1 Errors in Additional Steps for Upgrading Technology Adapter Headers

- 3.3.1.2 FrameworkFolders Not Enabled by Default on Content Server

- 3.3.2 Documentation Errata for the Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management

- 3.3.2.1 Error in Procedure for Identifying Additional Oracle Internet Directory Instances

- 3.3.2.2 Error in Oracle Virtual Directory Releases Supported

- 3.3.3 Documentation Errata for the Oracle Fusion Middleware Upgrade Guide for Java EE

- 3.3.3.1 Clarification of Post-Upgrade Tasks for SSL-Enabled Oracle HTTP Server

4 Oracle Fusion Middleware Administration

- 4.1 General Issues and Workarounds

- 4.1.1 Clarification About Path for OPMN

- 4.1.2 Fusion Middleware Control May Return Error in Mixed IPv6 and IPv4 Environment

- 4.1.3 Deploying JSF Applications

- 4.1.4 Limitations in Moving from Test to Production

- 4.1.5 Limitations in Moving Oracle Business Process Management from Test to Production Environment

- 4.1.6 Message Returned with Incorrect Error Message Level

- 4.2 Configuration Issues and Workarounds

- 4.2.1 Must Stop Oracle SOA Suite Managed Server Before Stopping soa-infra

- 4.2.2 Configuring Fusion Middleware Control for Windows Native Authentication

- 4.2.3 Fusion Middleware Control Does Not Keep Column Preferences in Log Viewer Pages

- 4.2.4 Topology Viewer Does Not Display Applications Deployed to a Cluster

- 4.2.5 Changing Log File Format

- 4.2.6 SSL Automation Tool Configuration Issues

- 4.3 Documentation Errata for the Oracle Fusion Middleware Administrator's Guide

5 Oracle Enterprise Manager Fusion Middleware Control

- 5.1 General Issues and Workarounds

- 5.1.1 Product Behavior After a Session Timeout

- 5.1.2 Fixing Errors Displayed When Selecting the TopLink Sessions Command in Fusion Middleware Control

- 5.1.3 Verifying the DISPLAY Variable to Correct Problems Displaying Graphics

- 5.1.4 Incomplete Information Available on the MDS Configuration Page

- 5.1.5 Exceptions When Starting Oracle Web Cache After Accessing Configuration Pages from Oracle Enterprise Manager Fusion Middleware Control

- 5.1.6 Table Display Problems When Using Some Language Variants

- 5.1.7 Problems When Internet Explorer 7 is Configured to Open Pop-Up Windows in a New Tab

- 5.1.8 Additional Fusion Middleware Control Release Notes

- 5.1.9 Problem with Performance Charts After Moving a Chart Region

- 5.1.10 Memory Issue When Configuring SOA on Microsoft Windows x64 (64-Bit)

- 5.1.11 Display Problems When Running JDK 160_18 on Intel Systems that Support the SSE4.2 Instruction Set

- 5.1.12 Adobe Flash Plugin Required When Displaying Fusion Middleware Control in the Apple Safari Browser

- 5.1.13 Unable to Access Fusion Middleware Control After Installing the Oracle Identity Management 11.1.1.4.0 Patch Set

- 5.1.14 Error Message on Deleting the Shared Folder After Scale-Out

- 5.2 Documentation Errata

- 5.2.1 Search Unavailable for Some Embedded Administrator's Guides

- 5.2.2 Patching Section in the Fusion Middleware Control Online Help is Not Supported

6 Oracle Fusion Middleware High Availability and Enterprise Deployment

- 6.1 General Issues and Workarounds

- 6.1.1 Secure Resources in Application Tier

- 6.1.2 mod_wl Not Supported for OHS Routing to Managed Server Cluster

- 6.1.3 Only Documented Procedures Supported

- 6.1.4 SOA Composer Generates Error During Failover

- 6.1.5 Accessing Web Services Policies Page in Cold Failover Environment

- 6.1.6 Considerations for Oracle Identity Federation HA in SSL Mode

- 6.1.7 Online Help Context May be Lost When Failover Occurs in High Availability Environment

- 6.1.8 ASCRS Cannot be Used to Create a Database Resource for the Oracle Database Console Service on Windows

- 6.1.9 Changes to Rulesets May Not be Persisted During an Oracle RAC Instance Failover

- 6.1.10 Manual Retries May be Necessary When Redeploying Tasks During an Oracle RAC Failover

- 6.1.11 Timeout Settings for SOA Request-Response Operations are Not Propagated in a Node Failure

- 6.1.12 Scale Out and Scale Up Operations Fail

- 6.1.13 Harmless SQLIntegrityConstraintViolationException Can be Received in a SOA Cluster

- 6.1.14 WebLogic Cluster WS-AT Recovery Can Put a Server into a 'Warning' State

- 6.1.15 Very Intensive Uploads from I/PM to UCM May Require Use of IP-Based Filters in UCM Instead of Hostname-Based Filters

- 6.1.16 Worklist Application May Throw Exception if Action Dropdown Menu is Used During a Failover

- 6.1.17 ClassCastExceptions in a SOA Cluster for the SOA Worklist Application

- 6.1.18 Use srvctl in 11.2 Oracle RAC Databases to Set Up AQ Notification and Server-side TAF

- 6.1.19 Oracle I/PM Input Files May Not be Processed Correctly During an Oracle RAC Failover

- 6.1.20 Failover Is Not Seamless When Creating Reports in Oracle BI Publisher

- 6.1.21 Failed to Load Error Appears in Layout View When Oracle BI Publisher Managed Server is Failed Over

- 6.1.22 When Scheduling an Oracle BI Publisher Job, a Popup Window Appears After Managed Server Failover

- 6.1.23 Cannot Save Agent When Oracle Business Intelligence Managed Server Fails Over

- 6.1.24 Set an Extra Property After Configuring a Virtual IP and Whole Server Migration for a BI Cluster

- 6.1.25 Installing Additional Oracle Portal, Forms, Reports, and Discoverer Instances After Upgrading Oracle Single Sign-On 10g to Oracle Access Manager 11g

- 6.1.26 JMS Instance Fails In a BI Publisher Cluster

- 6.1.27 Null Pointer Exception Error Window Opens during Approving Task When Failover Occurs

- 6.2 Configuration Issues and Workarounds

- 6.2.1 jca.retry.count Doubled in a Clustered Environment

- 6.2.2 Cluster Time Zones Must Be the Same

- 6.2.3 Cookie Persistence Setting on Load Balancer May Result in Intermittent Timeouts in accessing Portal on Windows platforms

- 6.2.4 Fusion Middleware Control May Display Incorrect Status

- 6.2.5 Accumulated BPEL Instances Cause Performance Decrease

- 6.2.6 Extra Message Enqueue when One a Cluster Server is Brought Down and Back Up

- 6.2.7 Duplicate Unrecoverable Human Workflow Instance Created with Oracle RAC Failover

- 6.2.8 Configuration Files Missing after Planned Administration Server Node Shutdown or Reboot

- 6.2.9 No High Availability Support for SOA B2B TCP/IP

- 6.2.10 WebLogic Administration Server on Machines with Multiple Network Cards

- 6.2.11 Additional Parameters for SOA and Oracle RAC Data Sources

- 6.2.12 Message Sequencing and MLLP Not Supported in Oracle B2B HA Environments

- 6.2.13 Credentials not Propagated for Transport Protocols in B2B

- 6.2.14 Create a Protected Resource for Oracle Identity Navigator

- 6.2.15 Use Fully-Qualified Hostnames when Configuring Front-end Hosts in High Availability Configurations

- 6.2.16 Managed Server goes into Suspended Status After Oracle RAC Failover

- 6.2.17 Primary/Secondary Configuration Section of the Availability Tab is Not Visible

- 6.2.18 Server Start Parameters Not Getting Set After Scaling Out the Oracle Business Intelligence Managed Server

- 6.2.19 Ensuring the Oracle HTTP Server Lock File is on a Local Drive

- 6.2.20 Recreating OSSO Agents that Point to the Load Balancer URL

- 6.2.21 Use Lower-Case Letters for GridLink Data Source RAC Service Name

- 6.2.22 Additional Steps Needed for Oracle RTD Request Forwarding to Work Correctly

- 6.3 Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS

- 6.4 Documentation Errata

- 6.4.1 Documentation Errata for the Fusion Middleware High Availability Guide

- 6.4.1.1 Latest Requirements and Certification Information

- 6.4.2 Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter

- 6.4.2.1 Link to Section 8.1.3 is Missing

- 6.4.2.2 Additional Information for Discussions Forum Mulitcast to Unicast Conversion

- 6.4.2.3 Additional Discussion Connection Properties Explained in Administration Guide

- 6.4.3 Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management

- 6.4.3.1 Set -DDomainRegistrationEnabled=true when Starting Node Manager

- 6.4.3.2 Ignore Empty Section in the Oracle Virtual Directory Chapter

- 6.4.4 Documentation Errata for the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence

- 6.4.4.1 Additional Step Must be Performed After Setting the Location of the BI Publisher Configuration Folder

- 6.4.4.2 Corrections to the Setting the Location of the Shared Oracle BI Presentation Catalog Section

- 6.4.5 Documentation Errata Affecting Multiple Enterprise Deployment Guides

- 6.4.5.1 Sections on Configuring Oracle Coherence for SOA Composites Need Fixes

- 6.4.5.2 Updates are Needed to Steps for Testing Server Migration

- 6.4.5.3 Steps for Updating Data Sources for Server Migration Need Updates

- 6.4.5.4 Clarification of the Procedure for Configuring the Analytics Collectors

- 6.4.5.5 Correction to Table 2-2, "Ports Used"

- 6.4.5.6 Note Missing from Configure Cluster Screens Step in Extend Domain for SOA Chapter

7 Oracle Fusion Middleware on IBM WebSphere

- 7.1 General Issues and Workarounds

- 7.1.1 Accessibility Mode for User Messaging Preferences is Ignored on an IBM WebSphere Application Server

- 7.1.2 Adding Shared Libraries to Deploy a Task Form from Oracle JDeveloper

- 7.1.3 Setting Cookie Paths for Oracle SOA Suite Applications

- 7.1.4 Deploying a SOA Composite Application to a SOA Cluster

- 7.1.5 Cannot Deploy a SOA Bundle File from Oracle Enterprise Manager Fusion Middleware Control

- 7.1.6 One-and-Only-One Event Subscriptions Are Not Supported

- 7.1.7 Deployed Task Form Startup Failure in IBM WebSphere Administration Console

- 7.1.8 Oracle BPM Worklist Displays as Undefined in Administration Console

- 7.1.9 Dashboard Tab May Display Completed SOA Composite Instance States as Running

- 7.1.10 Two-Way SSL Configuration with Oracle SOA Suite Is Not Supported

- 7.1.11 Multiple Fault Recovery Failure with the Recover With Options Dialog

- 7.1.12 IBM WebSphere Application Server - ND Installation Requires a Server Restart

- 7.1.13 Test Emulations of Asynchronous BPEL Processes Fail

- 7.1.14 SETMANAGEDCONNECTION() Fails with ILLEGALSTATEEXCEPTION for the AQ Adapter

- 7.1.15 Invalid PolicySet Error When Accessing a Deployed Oracle Fusion Middleware Application on IBM WebSphere

- 7.1.16 Cannot Stop or Start Oracle Internal Applications From Fusion Middleware Control on IBM WebSphere

- 7.1.17 For the JMS Adapter, Instances Become Recoverable Even Without Failover

- 7.1.18 HTTP 500 Error Accessing Spaces Workflow Notifications in the Worklist Task Flow

- 7.2 Configuration Issues and Workarounds

- 7.2.1 Error Configuring a Cell When IBM WebSphere Installed on Windows 2003 and 2008

- 7.2.2 Configuring Coherence for a SOA Cluster on IBM WebSphere

- 7.2.3 Limitations When Configuring Oracle Business Activity Monitoring for High Availability on IBM WebSphere

- 7.2.4 Requests Received by IBM HTTP Server (IHS) Are Routed to the Fusion Middleware Welcome Page

- 7.2.5 Registering WSRP/JPDK Producers in an IBM WebSphere Application Server Instance

Part II Oracle Development Tools

8 Oracle JDeveloper and Oracle Application Development Framework (ADF)

9 Oracle TopLink

- 9.1 General Issues and Workarounds

- 9.1.1 TopLink Object-Relational Issues

- 9.1.1.1 Cannot set EclipseLink log level in WLS System MBean Browser

- 9.1.1.2 Incorrect outer join SQL on SQLServer2005

- 9.1.1.3 UnitOfWork.release() not Supported with External Transaction Control

- 9.1.1.4 Returning Policy for UPDATE with Optimistic Locking

- 9.1.1.5 JDBC Drivers returning Timestamps as Strings

- 9.1.1.6 Unit of Work does not add Deleted Objects to Change Set

- 9.1.2 TopLink Workbench Issues

- 9.1.2.1 User Interface Issue

- 9.1.2.2 Accessibility

- 9.1.2.3 Running the TopLink Workbench on Windows OS

- 9.1.3 Oracle Database Extensions with TopLink

- 9.1.3.1 Template JAR for Spatial and XDB Support in Oracle WebLogic Server

- 9.1.4 Allowing Zero Value Primary Keys

- 9.1.5 Managed Servers on Sybase with JCA Oracle Database Service

- 9.1.6 Logging Configuration with EclipseLink Using Container Managed JPA

- 9.1.7 Grid Cache requires CacheLoader

Part III Web Tier

10 Oracle HTTP Server

- 10.1 Configuration Issues and Workarounds

- 10.1.1 OHS Fails to Start When mod_perl is Enabled on Microsoft Windows x64 (64-Bit) 2008

- 10.1.2 Oracle HTTP Server Fails To Load mod_wls module on Windows 64-Bit Server Systems

11 Oracle Web Cache

- 11.1 Configuration Issues and Workarounds

- 11.1.1 Reset the Random Password Generated When Installing Oracle Portal, Forms, Reports, and Discoverer

- 11.1.2 Running Oracle Web Cache Processes as a Different User Is Not Supported

- 11.2 Documentation Errata

- 11.2.1 Procedure to Enable Generation of Core Dump

- 11.2.2 Clarification About Support for CRLs

- 11.2.3 Clarifications About Configuring the CRL Location

Part IV Oracle WebLogic Server

12 Oracle WebLogic Server

- 12.1 General Issues and Workarounds

- 12.1.1 Multi-Byte Characters Display Incorrectly in Filenames When Using Safari

- 12.1.2 Oracle WebLogic Server Version Number

- 12.1.3 Oracle ojdbc14.jar File Has Been Changed to ojdbc6.jar

- 12.1.4 Strong Password Enforcement May Cause Issues With WLST Offline Scripts

- 12.1.5 In Turkish Locale, MDS Initialization Fails

- 12.1.6 Availability of Sun JDK 6 U24-B50 for 10.3.5.0 Oracle WLS Generic Installation

- 12.2 Administration Console Issues and Workarounds

- 12.2.1 Cached JDBC Information is not Displayed

- 12.2.2 Pressing Browser Back Button Discards Context

- 12.2.3 Unsupported Work Manager Configurations Can Be Created

- 12.2.4 Server Status Table Reflects Inconsistent Information

- 12.2.5 Exceptions When Defining a Security Policy for an EJB

- 12.2.6 Administration Console Does Not Always Reflect External Changes Made in a Deployment Plan

- 12.2.7 Oracle OCI Driver Support

- 12.2.8 Data Takes a Long Time to Display on the Metric Browser Tab

- 12.3 Apache Beehive Support Issues and Workarounds

- 12.4 Configuration Issues and Workarounds

- 12.4.1 ASProvWorkflowException Occurs When Creating a WebLogic Domain

- 12.4.2 Use the -Dfile.encoding Property When Running WLST in a Non-English Locale

- 12.4.3 Configuration Tools Can Fail If WebLogic Installation Path Contains Spaces

- 12.5 Connector (Resource Adapter) Issues and Workarounds

- 12.6 Console Extensions Issues and Workarounds

- 12.7 Core Server and Core Work Manager Issues and Workarounds

- 12.7.1 Threads Become Stuck While Waiting to Get a Connection

- 12.7.2 Using IPv6-Formatted Addresses

- 12.7.3 Server Cannot Be Started After a Whole Server Migration

- 12.7.4 Object State is not Retained After Renaming Field

- 12.7.5 Forcing Unicast Messages To Be Processed in Order

- 12.7.6 Servers Configured to Listen on a Host Name Are Listening on a Different Host Name After Startup

- 12.8 Deployment Issues and Workarounds

- 12.8.1 security-permission Element is not Available in weblogic-application.xml

- 12.8.2 Extraneous String Values Interpreted as File Specification

- 12.8.3 java.lang.NoClassDefFoundError is Displayed

- 12.8.4 The restore Method Does Not Update the DConfig Bean With Plan Overrides

- 12.8.5 config-root <directory> not found Warning Is Displayed When Applying a Plan

- 12.8.6 Deployment Task Fails When a Large Application File Is Deployed

- 12.9 EJB Issues and Workarounds

- 12.9.1 Primary Key in Oracle Table is CHAR

- 12.9.2 No Available Annotation That Enables Creation of a Clusterable Timer

- 12.9.3 Kodo's MappingTool Cannot Generate Schemas

- 12.9.4 Extensions to the JPA Metadata Model Can Only Be Specified Via Annotations

- 12.9.5 Lookup Method Injection Not Supported by Spring

- 12.9.6 Deserializing a JDO PersistenceManagerFactory in a Managed Environment May Fail

- 12.9.7 Indexes Not Always Created During Schema Creation

- 12.9.8 OpenJPA throws an exception when @Id fields are also annotated as @Unique

- 12.9.9 Cache Hit and Miss Counts May Rise Unexpectedly

- 12.9.10 Open JPA Tries to Create a Table Even if the Table Exists

- 12.9.11 EJB Applications Fail During Serialization

- 12.9.12 Non-Transactional Message-Driven Bean Container Can Fail to Provide Reproducible Behavior For Foreign Topics

- 12.10 Examples Issues and Workarounds

- 12.10.1 Security Configuration in medrec.wls.config

- 12.10.2 HTML File not Created for StreamParser.java File

- 12.10.3 Warning Message Appears When Starting Medrec or Samples Domain

- 12.11 HTTP Publish/Subscribe Server Issues and Workarounds

- 12.11.1 Authentication and Authorization of the Local Client is not Supported

- 12.11.2 Event Messages Published by Local Clients Cannot Be Received

- 12.11.3 Event Messages Published By Local Clients Do Not Go Through Filters

- 12.12 Installation Issues and Workarounds

- 12.12.1 Sybase JDBC Drivers Not Downloaded with Upgrade Installation

- 12.12.2 Improper Rollback to Previous Installation May Occur After Exiting an Upgrade Installation Prematurely

- 12.12.3 WebLogic Server Installer Fails With Insufficient Disk Space Error

- 12.12.4 WebLogic Server Home Cannot Be the Same as the Middleware Home

- 12.12.5 WebLogic Server Installation Fails When Installed Using Network Drive

- 12.13 Java EE Issues and Workarounds

- 12.13.1 FastSwap May Relax the Access Modifiers of Fields and Methods

- 12.13.2 FastSwap Does Not Support Redefinition of the Entity Bean and ejbClass

- 12.13.3 Classpath Order Is Not Guaranteed When There Are Multiple JARs in an EAR File

- 12.14 JDBC Issues and Workarounds

- 12.14.1 Call To setTransactionIsolation() May Fail When Using the JDBC Driver for MS SQLServer

- 12.14.2 An Attempt to Access a Remote 10.3.2 or Later WLS Data Source Fails

- 12.15 JMS Issues and Workarounds

- 12.15.1 Deployment Descriptor Validation Fails

- 12.15.2 Exception When Multiple Producers Use the Same Client SAF Instance

- 12.15.3 Multi-byte Characters are not Supported in Store File and Directory Names

- 12.15.4 Generation of the Default UOO Name Has Changed

- 12.15.5 Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS

- 12.15.6 JMS Message Consumers Will Not Always Reconnect After a Service Migration

- 12.15.7 Forcing Unicast Messages To Be Processed in Order

- 12.16 JNDI Issues and Workarounds

- 12.17 JSP and Servlet Issues and Workarounds

- 12.17.1 Deployment Plans Cannot Be Used To Override Two Descriptors

- 12.17.2 Spring Dependency Injection Not Supported on JSP Tag Handlers

- 12.17.3 503 Error When Accessing an Application With a Valid sessionid

- 12.18 JTA Issues and Workarounds

- 12.19 Java Virtual Machine (JVM) Issues and Workarounds

- 12.19.1 1.4 Thin Client Applet Cannot Contact WebLogic Server

- 12.19.2 JRockit JVM Appears to Freeze When Doing Long Array Copies

- 12.20 Monitoring Issues and Workarounds

- 12.20.1 MBean Attributes Not Explicitly Marked as @unharvestable Appear as Harvestable

- 12.20.2 Events Generated By the JVM Level Are Not Generated at Low Volume

- 12.20.3 WLDF Performance Issues Can Occur When JVM Events Are Enabled

- 12.21 Node Manager Issues and Workarounds

- 12.22 Operations, Administration, and Management Issues and Workarounds

- 12.23 Oracle Kodo Issues and Workarounds

- 12.23.1 Value Retrieved for an Empty Byte Array Field is NULL

- 12.24 Plug-ins Issues and Workarounds

- 12.24.1 apr_socket_connection Exception Occurs When Using the IIS Plug-In

- 12.25 Protocols Issues and Workarounds

- 12.26 RMI-IIOP Issues and Workarounds

- 12.26.1 Ant 1.7 rmic Task Incompatibility

- 12.27 Security Issues and Workarounds

- 12.27.1 StoreBootIdentity Works Only if the Appropriate Server Security Directory Exists

- 12.27.2 Boot Time Failure Occurs With SecurityServiceException

- 12.27.3 Authentication Failure After Upgrading a Domain From WLS 6.1

- 12.27.4 InvalidParameterException Message Generated and Displayed

- 12.27.5 Enabling Both the Authentication and Passive Attributes In SML 2.0 Service Provider Services Is an Invalid Configuration

- 12.27.6 Running the WebLogic Full Client in a Non-Forked VM

- 12.28 SNMP Issues and Workarounds

- 12.29 Spring Framework on WebLogic Server Issues and Workarounds

- 12.29.1 OpenJPA ClassFileTranformer Does Not Work When Running on JRockit

- 12.29.2 petclinic.ear Does Not Deploy on WebLogic Server

- 12.30 System Component Architecture (SCA) Issues and Workarounds

- 12.31 Upgrade Issues and Workarounds

- 12.31.1 Domains Created on WebLogic Server 10.3.1 Cannot Be Run on WebLogic Server 10.3

- 12.32 Web Applications Issues and Workarounds

- 12.32.1 Administration Console Fails to Implement session-timeout Changes

- 12.32.2 Connection Pool Connection Reserve Timeout Seconds Value is Overridden

- 12.32.3 Database Connections Become Unstable When a PoolLimitSQLException Occurs

- 12.32.4 Web Page Fails to Open When Accessing It Using the SSL Port

- 12.32.5 Unable to View the Output of a JSPX Page in Internet Explorer

- 12.32.6 Unable to View the Output of SVG files in Internet Explorer 7

- 12.33 WebLogic Server Scripting Tool (WLST) Issues and Workarounds

- 12.33.1 Property Names Containing '.' Characters Are Not Supported by loadProperties

- 12.33.2 Invalid cachedir Created by Jython Causes WLST to Error Out

- 12.34 Web Server Plug-Ins Issues and Workarounds

- 12.34.1 MOD_WLS_OHS Does Not Fail Over

- 12.35 Web Services and XML Issues and Workarounds

- 12.35.1 weblogic.wsee.jaxws.mdb.DispatchPolicy WorkManager Cannot Be Found

- 12.35.2 Multiple Resize Buffer Calls Occur

- 12.35.3 Troubleshooting Problems When Applying the WebLogic Advanced Web Services for JAX-WS Extension Template

- 12.35.4 Sparse Arrays and Partially Transmitted Arrays Are Not Supported

- 12.35.5 WSDL Compiler Does Not Generate Serializable Data Types

- 12.35.6 Use of Custom Exception on a Callback

- 12.35.7 Cannot Use JMS Transport in an Environment That Also Uses a Proxy Server

- 12.35.8 clientgen Fails When Processing a WSDL

- 12.35.9 JAX RPC Handlers in Callback Web Services Are Not Supported

- 12.35.10 Message-level Security in Callback Web Services Is Not Supported

- 12.35.11 Handling of Java Method Arguments or Return Parameters That Are JAX-RPC-style JavaBeans

- 12.35.12 IllegalArgumentException When Using a Two-Dimensional XML Object in a JWS Callback

- 12.35.13 Using SoapElement[] Results in Empty Array

- 12.35.14 FileNotFound Exception When a Web Service Invokes Another Web Service

- 12.35.15 Client Side Fails to Validate the Signature on the Server Response Message

- 12.35.16 xmlcatalog Element Entity Cannot Be a Remote File or a File in an Archive

- 12.35.17 Catalog File's public Element Is Not Supported When Using XML Catalogs

- 12.35.18 Local xmlcatalog Element Does Not Work Well

- 12.35.19 JAXRPC Client Does Not Encode the HTTP SOAPAction Header With Multi-byte Characters

- 12.35.20 External Catalog File Cannot Be Used in the xmlcatalog Element of clientgen

- 12.35.21 Exceptions When Running Reliable Messaging Under Heavy Load

- 12.35.22 ClassNotFound Exception Occurs When Using wseeclient.jar

- 12.35.23 Incomplete Configuration When Adding Advanced Web Services Component to SOA Domain

- 12.35.24 WS-AT Interoperation Issues With WebSphere and WebLogic Server

- 12.36 WebLogic Tuxedo Connector Issues and Workarounds

- 12.36.1 View Classes are not Set on a Per Connection Basis

- 12.37 Documentation Errata

- 12.37.1 Issues With Search Function in the Samples Viewer

- 12.37.2 Japanese Text Displays in Some Search Results Topics Avitek Medical Records

- 12.37.3 HTML Pages For Downloaded Libraries Do Not Display Properly

- 12.37.4 Evaluation Database Component Is Not Listed For silent.xml

- 12.37.5 Instructions for Reliable SOAP Messaging Code Example Are Incorrect

- 12.37.5.1 About the Example

- 12.37.5.2 Files Used in This Example

- 12.37.5.3 Prepare the Example

- 12.37.5.4 Run the Example

Part V Oracle WebCenter Portal

13 Oracle WebCenter Portal

- 13.1 General Issues and Workarounds

- 13.1.1 Support for Discussions Server from Jive Software

- 13.1.2 Oracle WebCenter Portal's Pagelet Producer Failover Support

- 13.1.3 Configuring a Client Security Policy for Oracle Content Server Connections

- 13.1.4 Option to Create a Portal Resource Displayed for Design-Time Task Flows

- 13.1.5 SQL Query with NCHAR Data Type Throws Exception

- 13.1.6 Setting Up WNA-Based SSO Using JDK 1.6.22 Produces an Error

- 13.1.7 Unable to Access SSL-Protected WebCenter Portal Endpoints

- 13.1.8 Configuring the REST Server Post-Installation

- 13.1.9 Resources in Framework Application Disappear after Redeployment of Application

- 13.1.10 Style Sheets Not Loaded Correctly for Sample WSRP Producer Test Pages through Oracle HTTP Server

- 13.1.11 Cannot Customize or Personalize a JSF Portlet

- 13.1.12 Fallback Support for Custom Translations

- 13.1.13 Spaces Do Not Display Correct Language When the Spaces Application is Accessed Using OAM

- 13.1.14 Announcement Publication Format can be Incorrect in Thai

- 13.1.15 Favorite Based on Seeded Page Lost When Language Preference Changed from en-US

- 13.1.16 Document Permissions Not Honored in Spaces

- 13.1.17 The Run as Servlet Link on Producer Test Page Does Not Work for JSF Portlet

- 13.1.18 Documents Service Unavailable

- 13.1.19 Granting Permissions Errors in Documents When Creating a Space

- 13.1.20 Using OpenSocial Pagelets to Post Activities to User's Activity Stream

- 13.1.21 Accessing Owners' Profile Information Using the OpenSocial API

- 13.1.22 Granting View Document Permissions to Public and Authenticated Users for a Hierarchical Space

- 13.1.23 Issues when Using the Russian or Swedish Language

- 13.2 Documentation Errata

- 13.2.1 Enabling Folders_g Component on Content Server

Part VI Oracle SOA Suite and Business Process Management Suite

14 Oracle SOA Suite, Oracle BPM Suite, and Common Functionality

15 Web Services Security and Administration

- 15.1 Using Multibyte User Credentials with wss_http_token_* Policy

- 15.2 Importing Custom Policies Before Attaching and Deploying to a Service Application

- 15.3 Performing a Bulk Upload of Policies

- 15.4 Reviewing Policy Configuration Override Values After Detaching a Client Policy

- 15.5 Removing Post-deployment Customizations

- 15.6 Reviewing Localization Limitations

- 15.7 When Using WLST to Import a Security Policy, the Same Policy May Be Repeatedly Imported

- 15.8 Identity in WSDLs Is Not Used for Enforcement with ADF DC Applications

- 15.9 JVM limitation for Kerberos Token Policy with Message Protection Policy

- 15.10 Fusion Middleware Control Does Not List Policies When Two Servers Are SSL Enabled (Two-way SSL)

- 15.11 Web Service Test Page Cannot Test Input Arguments Bound to SOAP Headers

- 15.12 When Adding SAML Issuer From Fusion Middleware Control the jps-config.xml File Is Incorrectly Updated

- 15.13 Patching of Patch Set 1 WebLogic Server Web Services Attached to Custom Polices With Patch Set 3 Oracle WSM Policy Manager

- 15.14 Custom Policy Fails When an Empty Subject Is Passed

- 15.15 Possible Limitation When Using Custom Exactly-one Policies

- 15.16 Ignore "Services Compatibility" Error for Security Policies Used Between Oracle WSM and WebLogic Server

- 15.17 Compatible Policies Not Returned When Using JDeveloper Wizard to Attach Oracle WSM Policies to Web Service Client

- 15.18 SAML Bearer Token Policies Now Signed by Default

- 15.19 Security Policies Do Not Work on Subscriber Mediator Component

- 15.20 Policy Table Might Not Show Attached Policies for Some Locales

- 15.21 Manual Step Required to Uptake Changes in Predefined Policy

- 15.22 Usage Tracking Not Enabled for WebLogic Web Service Client

- 15.23 Invalid Authorization Combination Validates Successfully

- 15.24 Additional Quotes in Fusion Middleware Control for Run-time Constraint Input from WLST

Part VII Communication Services

16 Oracle User Messaging Service

- 16.1 General Issues and Workarounds

- 16.1.1 UMS Schema Purge Script Now Available

- 16.1.2 Permission Grants for Upgraded Domains

- 16.1.3 XML File Handle Left Open after Upload Fails

- 16.1.4 Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server

- 16.1.5 User Messaging Service URLs Unavailable After Restart

- 16.1.6 User Preferences User Interface Renders Improperly

- 16.2 Configuration Issues and Workarounds

- 16.2.1 Enable Extension Driver after Upgrade

- 16.2.2 Preseeded Channel for Worklist and Pop-up Drivers Cannot be Removed

- 16.2.3 Worklist Driver Configuration

- 16.2.4 Configure Email Alerts

- 16.2.5 Migrate Custom Business Terms After PS3 Patch

- 16.2.6 Use Correct SSL Trust Store When Configuring Drivers

- 16.2.7 User Messaging Service Driver Configuration Changes Not Immediately Effective

- 16.2.8 Email Notifications Sent Even if You Do Not Change Default Parameters in driverconfig.xml

- 16.3 Documentation Errata

- 16.3.1 Wrong URL for Sample Codes in the Online Documentation

17 Oracle WebLogic Communication Services

- 17.1 General Issues and Workarounds

- 17.1.1 Active SIP Session and APP Session Count Show as -1 in Clustered Configuration

- 17.1.2 Oracle WebLogic Server Pack/Unpack Tool Does Not Function in OWLCS

- 17.1.3 Oracle WebLogic Server Cloning Tool Does Not Function in OWLCS

- 17.1.4 Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server

- 17.2 Configuration Issues and Workarounds

- 17.2.1 Launch_sash Option Error

- 17.2.2 Same User Who Installed WLS/WLSS Product Must Perform Uninstall

- 17.2.3 Uppercase Usernames Cause Reregistration and Presence Subscription Failures

- 17.2.4 Running the uninstall.sh Script in Text Mode Does Not Uninstall the Product

- 17.2.5 SIP Monitor in F5 Networks BigIP Does Not Work in UDP Mode

- 17.2.6 SIP Container Does Not Bind to IPV6 Interfaces for Listening on Windows

- 17.2.7 JAWS Unable to Read Some Install Screens

- 17.2.8 Configure VoiceXML Driver Receive URLs Correctly

- 17.3 Documentation Errata

- 17.3.1 Create a Basic SIP Domain

- 17.3.2 Create a Custom AUID with OCP (Presence)

- 17.3.3 Cannot Create a SIP Server Domain Using Default WebLogic Platform Components

- 17.3.4 Broken Documentation Links in Some (SIP Server) Translated Files

- 17.3.5 Missing (SIP Server) Online Help Regarding Security Providers

Part VIII Oracle Identity Management

18 Oracle Access Manager

- 18.1 Patch Requirements

- 18.1.1 Plain Text Credentials Exposed in Diagnostic Logs when Creating an Identity Store

- 18.2 General Issues and Workarounds

- 18.2.1 Replacing oamreg Scripts with Remote Registration Home

- 18.2.2 Incorrect SSO Agent Date/Time Shown to User

- 18.2.3 The oamreg.sh File Missing Execute Permission After Configuring

- 18.2.4 Initial Messages After Webgate Registration Are Not Shown in the User's Locale

- 18.2.5 Error While Browsing Resources Table in the Resource Type Tab

- 18.2.6 Single-Click to Open Child Node is Not Supported in the Navigation Tree

- 18.2.7 User Credential for Registration Tool Does Not Support Non-ASCII Characters on Native Server Locale

- 18.2.8 Turkish and Greek Character Issues on Oracle Access Manager Authentication Page

- 18.2.9 Oracle Access Manager Authentication Does Not Support Non-ASCII Passwords on Locales Other than UTF8

- 18.2.10 Error Message of Create Agent Shows as Server Locale

- 18.2.11 Referrals in LDAP Searches

- 18.2.12 Diagnostic Information Is Not Being Displayed on the Administration Console

- 18.2.13 Non-ASCII Resources Require OHS To Restart To Make Protection Take Effect

- 18.2.14 Non-ASCII Characters on Success/Failure URL Results in Garbled Redirect URL

- 18.2.15 Resource with Non-ASCII Characters Cannot Be Protected by an OSSO Agent

- 18.2.16 Error in Administration Server Log from Console Logins

- 18.2.17 Translation Packages Use the Term, Agents, Instead of WebGates

- 18.2.18 Application Domain Subtree in the Navigation Tree Is Not Rendered and Does Not Respond to User Actions

- 18.2.19 Error in the "Evaluate Single Sign-On Requirements" Help Topic

- 18.2.20 editWebgateAgent Command Does Not Give An Error If Invalid Value is Entered

- 18.2.21 WLST Command displayWebgate11gAgent In Offline Mode Displays the Webgate Agent Entry Twice

- 18.2.22 Message Logged at Error Level Instead of at INFO When Servers in Cluster Start

- 18.2.23 Help Is Not Available for WLST Command registeroifdappartner

- 18.2.24 User Must Click Continue to Advance in Authentication Flow

- 18.2.25 After Remote Registration: Click Refresh Domain Twice to Display Changes

- 18.2.26 OCSP-Related Fields are Not Mandatory

- 18.2.27 Database Node is Absent in the Console

- 18.2.28 Online Help Provided Might Not Be Up To Date

- 18.2.29 Agent Key Password Should Be Mandatory for Both the Console and Remote Registration Tool in Cert Mode

- 18.2.30 Oracle Access Manager Audit Report AUTHENTICATIONFROMIPBYUSER Throws a FROM Keyword Not Found Where Expected Error

- 18.2.31 Disabled: Custom Resource Types Cannot be Created

- 18.2.32 Oracle Access Manager IAMSuiteAgent Provides SSO to Most IDM domain consoles

- 18.2.33 Use of a Non-ASCII Name for a Webgate Might Impact SSO Redirection Flows

- 18.2.34 Authentication Module Lists Non-Primary Identity Stores

- 18.2.35 Unable to Stop and Start OAM Server Through Identity and Access Node in Fusion Middleware Control

- 18.2.36 ADF Applications Using ADF Security Fail to Work in Oracle Access Manager 11g

- 18.2.37 AdminServer Won't Start if the Wrong Java Path Given with WebLogic Server Installation

- 18.2.38 Changing UserIdentityStore1 Type Can Lock Out Administrators

- 18.2.39 Page Layouts and Locales

- 18.2.40 Some Pages Are Not Correctly Localized

- 18.2.41 Non-ASCII Query String Issues with Internet Explorer v 7, 8, 9

- 18.2.42 Oracle Virtual Directory with SSL Enabled

- 18.2.43 Test to Production Files Locked on Windows

- 18.2.44 Query String Not Properly Encoded

- 18.3 Configuration Issues and Workarounds

- 18.3.1 For mod-osso Value for RedirectMethod Should be "POST"

- 18.3.2 User Wrongly Directed to the Self-User Login after Logging Out of the Oracle Identity Manager Administration Console

- 18.3.3 11g Webgate Fails to Install with Compact Configuration

- 18.3.4 Auditing Does Not Capture the Information Related to Authentication Failures if a Resource is Protected Using Basic Authentication Scheme

- 18.3.5 Incompatible Msvcirt.dll Files

- 18.3.6 IPv6 Support

- 18.3.7 What to Avoid or Note in Oracle Access Manager Configuration

- 18.3.7.1 Unsupported Operations for WLST Scripts

- 18.3.7.2 Unsupported Operations for Oracle Access Manager Console and WLST

- 18.3.8 Install Guides Do Not Include Centralized Logout Configuration Steps

- 18.3.9 NULL Pointer Exception Shown in Administration Server Console During Upgrade

- 18.3.10 Using Access SDK Version 10.1.4.3.0 with Oracle Access Manager 11g Servers

- 18.3.11 Finding and Deleting Sessions Using the Console

- 18.3.12 Non-ASCII Users with Resource Protected by Kerberos Authentication Scheme

- 18.4 Oracle Security Token Service Issues and Workarounds

- 18.4.1 No Warnings Given If Required Details are Omitted

- 18.4.2 New Requester Pages, Internet Explorer v7, and Japanese Locale

- 18.4.3 Delete Button Not Disabled When Tables Have No Rows

- 18.4.4 Copying an Issuance Template Does Not Copy All Child Elements

- 18.4.5 Apply and Revert Buttons are Enabled

- 18.4.6 Only Generic Fault Errors Written to Oracle WSM Agent Logs

- 18.4.7 Server and Client Key Tab Files Must be the Same Version

- 18.4.8 Default Partner Profile Required for WS-Security

- 18.4.9 SAML Token Issued When NameID is Not Found

- 18.5 Integration and Inter-operability Issues and Workarounds

- 18.5.1 WNA Authentication Does Not Function on Windows 2008

- 18.5.2 JVM Plug-in Ignores Cookies Marked 'httponly'

- 18.6 Oracle Access Manager with Impersonation Workarounds

- 18.6.1 Impersonation Can Fail on Internet Explorer v 7, 8, 9

- 18.6.2 With Oracle Access Manager 11g ORA_FUSION_PREFS Cookie Domain is Three Dots

- 18.7 Documentation Errata

- 18.7.1 Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager with Oracle Security Token Service

- 18.7.2 Oracle Fusion Middleware Developer's Guide for Oracle Access Manager and Oracle Security Token Service

- 18.7.3 Oracle Fusion Middleware Integration Guide for Oracle Access Manager

19 Oracle Adaptive Access Manager

- 19.1 General User Interface

- 19.1.1 A Few Conditions in the Base Snapshot Are Not Translated

- 19.1.2 Alert Trigger Sources Are Not Being Displayed in Session Details Page

- 19.2 Scheduler

- 19.2.1 Job Queue Does Not Display Next Recurrence For Canceled Jobs

- 19.2.2 Pause and Cancel Job Status Is Not Displayed in the Job Instance Tab

- 19.2.3 Job Queue Process Start and End Time Does Not Follow the Browser Language Setting

- 19.2.4 Changing the Schedule Parameters Does Not Affect Next Recurrence

- 19.2.5 When Searching for an Online Job a Warning Might Appear in the Log

- 19.2.6 When the Create Job Dialog is Clicked an Error Might Display

- 19.2.7 Errors Are Seen When Creating a New Job

- 19.3 Policy Management

- 19.3.1 Some Attributes of Returned Rules Result Not Set

- 19.3.2 Search with Rule Notes Keyword is Not Working Properly

- 19.3.3 Database Error Occurs When Deleting an Action or Alert Group in a Policy Override

- 19.3.4 Exclude IP List Parameter Was Added to the User and Device Velocity Rule Conditions

- 19.4 Transactions

- 19.4.1 NullPointerException Occurs for UpdateTransaction and createTransaction APIs When Transaction is Null

- 19.5 OTP

- 19.5.1 java.lang.NullPointerException Occurs When GETOTPCODE Returns Error Response

- 19.6 Proxy

- 19.6.1 UIO ISA Proxy: Certain Filters Are Note Evaluating the Variable in Value

- 19.6.2 UIO ISA Proxy: the Send-to-Server in Response Interceptor Fails Without Error Message

- 19.6.3 Warnings are Displayed in Memcached Environment During User Login

- 19.7 Integration

- 19.7.1 NameValueProfile APIs Return Empty Values

- 19.8 Reports

- 19.8.1 OAAM BI Publisher Reports Are Not Working in BI Publisher 11g

- 19.8.2 Session Details Checkpoint Panel Order Sometimes Randomized

- 19.8.3 Alert Message Link in Session Details Page Does Not Open the Alert Details

- 19.9 Export

- 19.9.1 Export Session Is Not Exporting All Records

- 19.10 Globalization

- 19.10.1 Localization Limitations

- 19.10.2 Policy, Rule, and Action in the OAAM Dashboard Do Not Pick Up110N Value

- 19.10.3 NLS: Descriptions in Non-ASCII Characters Fails to Save Maximum Length

- 19.10.4 XMLDOMException Occurs When Saving Searches

- 19.10.5 Date Format May Not Follow the Browser Language Setting in User Details

- 19.10.6 Sort for NLS String Might Not Work Properly for Out-of-the-Box Objects

- 19.10.7 A Few Objects from the OAAM_BASE_SNAPSHOT.ZIP Appear in English Only

- 19.11 Configuration Issues and Workarounds

- 19.11.1 Specifying Timeout Session Option in WebLogic Does Not Work for OAAM

- 19.12 Documentation Errata

- 19.12.1 Incorrect File Location for sample.bharosa_location.properties

- 19.12.2 A Separate Step to Import KBA Questions Is Redundant in OAAM Setup

- 19.12.3 Rules Logging Property Setting for OAAM Offline Is Not Correct

20 Oracle Authentication Services for Operating Systems

- 20.1 What is New with Oracle Authentication Services for Operating Systems 11.1.1.3 ?

- 20.2 General Issues and Workarounds

21 Oracle Directory Integration Platform

- 21.1 General Issues and Workarounds

- 21.1.1 The Oracle Password Filter for Microsoft Active Directory is not Certified for use With Oracle Unified Directory or Oracle Directory Server Enterprise Edition

- 21.1.2 LDIF Files That Contain Non-ASCII Characters Will Cause the testProfile Command Option to Fail if the LDIF File has Native Encoding

- 21.1.3 Some Changes May Not Get Synchronized Due to Race Condition in Heavily-Loaded Source Directory

- 21.1.4 Synchronization Continues After Stopping Oracle Directory Integration Platform

- 21.1.5 File Path Separator Must Be Escaped on Windows

- 21.1.6 Certain Queries and Provisioning Profile Functionality may Fail on JDK 1.6 u 21

- 21.2 Configuration Issues and Workarounds

- 21.2.1 Do not use localhost as Oracle Internet Directory Hostname When Configuring Oracle Directory Integration Platform

- 21.2.2 You may Need to Restart the Directory Integration Platform After Running dipConfigurator Against Oracle Unified Directory

- 21.2.3 When Configuring a Profile, you may Need to Scroll Past a Section of Whitespace to View Mapping Rules

- 21.2.4 Resource Usage Charts will not Display if Multiple IDM Domains are Running on the Same Host

- 21.3 Documentation Errata

22 Oracle Entitlements Server

- 22.1 General Issues and Workarounds

- 22.1.1 Using Backslash on Oracle Internet Directory Policy Store

- 22.1.2 Performance Tuning the Oracle Database Policy Store

- 22.1.3 Action Bar Disappears When Using Internet Explorer 7

- 22.1.4 Re-created Application May Not Be Distributed in Controlled Mode

- 22.1.5 Enterprise Manager Doesn't Pick Up Newly Added Audit Events

- 22.1.6 Attributes Passed to Authorization Request Are Treated as Case Sensitive

- 22.1.7 Audit Schema Definitions are Incomplete

- 22.1.8 Java Security Module on IPv6 Client Not Supported on Windows

- 22.1.9 WebLogic Security Module Policy Distribution Configuration Issue on Windows IPv6 Hosts

- 22.1.10 Validating Attribute Names in Custom Functions

- 22.2 Configuration Issues and Workarounds

- 22.3 Documentation Errata

23 Oracle Identity Federation

- 23.1 General Issues and Workarounds

- 23.1.1 Database Table for Authentication Engine must be in Base64 Format

- 23.1.2 Considerations for Oracle Identity Federation HA in SSL mode

- 23.1.3 Incorrect Managed Server Metrics Displayed

- 23.1.4 Database Column Too Short error for IDPPROVIDEDNAMEIDVALUE

- 23.2 Configuration Issues and Workarounds

- 23.2.1 WLST Environment Setup when SOA and OIF are in Same Domain

- 23.2.2 Oracle Virtual Directory Requires LSA Adapter

- 23.2.3 Settings for Remote WS-Fed SP Must be Changed Dynamically

- 23.2.4 Required Property when Creating a WS-Fed Trusted Service Provider

- 23.2.5 Federated Identities Table not Refreshed After Record Deletion

- 23.2.6 Default Authentication Scheme is not Saved

- 23.2.7 Configuring 10g to Work with 11g Oracle Identity Federation using Artifact Profile

- 23.3 Documentation Errata

- 23.3.1 Different Passwords for Keystore and Private Key not Supported

- 23.3.2 Documentation Erratum for Deploying Oracle Identity Federation

- 23.3.3 Documentation Erratum for Configuring Security and Trust

- 23.3.4 Additional Steps for SSL Configuration

- 23.3.5 ParseException Message in Diagnostic Log

- 23.3.6 Forcing Re-authentication when Integrated with Oracle Access Manager

- 23.3.7 Supported Version of Oracle Access Manager 10g

- 23.3.8 Additional Steps for OpenID Configuration

- 23.3.9 Documentation Erratum for Oracle Identity Federation MBeans

24 Oracle Identity Manager

- 24.1 Patch Requirements

- 24.1.1 Obtaining Patches From My Oracle Support (Formerly OracleMetaLink)

- 24.1.2 Patch Requirements for Oracle Database 11g (11.1.0.7)

- 24.1.3 Patch Requirements for Oracle Database 11g (11.2.0.2.0)

- 24.1.4 Patch Requirements for Segregation of Duties (SoD)

- 24.1.5 Patch Upgrade Requirement

- 24.2 General Issues and Workarounds

- 24.2.1 Do Not Use Platform Archival Utility

- 24.2.2 SPML-DSML Service is Unsupported

- 24.2.3 Resource Object Names Longer than 100 Characters Cause Import Failure

- 24.2.4 Status of Users Created Through the Create and Modify User APIs

- 24.2.5 Status of Locked Users in Oracle Access Manager Integrations

- 24.2.6 Generating an Audit Snapshot after Bulk-Loading Users or Accounts

- 24.2.7 Browser Timezone Not Displayed

- 24.2.8 Date Format Change in the SoD Timestamp Field Not Supported

- 24.2.9 Bulk Loading CSV Files with UTF-8 BOM Encoding Not Supported

- 24.2.10 Date Type Attributes are Not Supported for the Default Scheduler Job, "Job History Archival"

- 24.2.11 Low File Limits Prevent Adapters from Compiling

- 24.2.12 Reconciliation Engine Requires Matching Rules

- 24.2.13 SPML Requests Do Not Report When Any Date is Specified in Wrong Format

- 24.2.14 Logs Populated with SoD Exceptions When the SoD Message Fails and Gets Stuck in the Queue

- 24.2.15 A Backslash (\) Cannot Be Used in a weblogic.properties File

- 24.2.16 Underscore Character Cannot Be Used When Searching for Resources

- 24.2.17 Assign to Administrator Action Rule is Not Supported by Reconciliation

- 24.2.18 Some Buttons on Attestation Screens Do Not Work in Mozilla Firefox

- 24.2.19 The maxloginattempts System Property Causes Autologin to Fail When User Tries to Unlock

- 24.2.20 "<User not found>" Error Message Appears in AdminServer Console While Setting-Up an Oracle Identity Manager-Oracle Access Manager Integration

- 24.2.21 Do Not Use Single Quote Character in Reconciliation Matching Rule

- 24.2.22 Do Not Use Special Characters When Reconciling Roles from LDAP

- 24.2.23 SoD Check During Request Provisioning Fails While Using SAML Token Client Policy When Default SoD Composite is Used

- 24.2.24 SoD Check Fails While Using Client-Side Policy in Callback Invocation During Request Provisioning

- 24.2.25 Error May Appear During Provisioning when Generic Technology Connector Framework Uses SPML

- 24.2.26 Cannot Click Buttons in TransUI When Using Mozilla Firefox

- 24.2.27 LDAP Handler May Cause Invalid Exception While Creating, Deleting, or Modifying a Role

- 24.2.28 Cannot Reset User Password Comprised of Non-ASCII Characters

- 24.2.29 Benign Exception and Error Message May Appear While Patching Authorization Policies

- 24.2.30 The DateTime Pick in the Trans UI Does Not Work Correctly in the Thai Locale

- 24.2.31 User Without Access Policy Administrators Role Cannot View Data in Access Policy Reports

- 24.2.32 Archival Utility Throws an Error for Empty Date

- 24.2.33 TransUI Closes with Direct Provisioning of a Resource

- 24.2.34 Scheduler Throws "ParameterValueTypeNotSupportedException" Instead of "RequiredParameterNotSetException"

- 24.2.35 All New User Attributes Are Not Supported for Attestation in Oracle Identity Manager 11g

- 24.2.36 LDAP GUID Mapping to Any Field of Trusted Resource Not Supported

- 24.2.37 User Details for Design Console Access Field Must Be Mapped to Correct Values When Reading Modify Request Results

- 24.2.38 Cannot Create a User Containing Asterisks if a Similar User Exists

- 24.2.39 Blank Status Column Displayed for Past Proxies

- 24.2.40 Mapping the Password Field in a Reconciliation Profile Prevents Users from Being Created

- 24.2.41 UID Displayed as User Login in User Search Results

- 24.2.42 Roles/Organizations Browse Trees Disappear

- 24.2.43 Entitlement Selection Is Not Optional for Data Gathering

- 24.2.44 Oracle Identity Manager Server Throws Generic Exception While Deploying a Connector

- 24.2.45 Create User API Allows Any Value for the "Users.Password Never Expires", "Users.Password Cannot Change", and "Users.Password Must Change" Fields

- 24.2.46 Incorrect Label in JGraph Screen for the GTC

- 24.2.47 Running the Workflow Registration Utility Generates an Error

- 24.2.48 Native Performance Pack is Not Enabled On Solaris 64-bit JVM Install

- 24.2.49 Error in the Create Generic Technology Connector Wizard

- 24.2.50 DSML Profile for the SPML Web Service is Not Deployed With Oracle Identity Manager

- 24.2.51 New Human Tasks Must Be Copied in SOA Composites

- 24.2.52 Modify Provisioned Resource Request Does Not Support Service Account Flag

- 24.2.53 Erroneous "Query by Example" Icon in Identity Administration Console

- 24.2.54 The XL.ForcePasswordChangeAtFirstLogin System Property Is No Longer Used

- 24.2.55 The tcExportOperationsIntf.findObjects(type,name) API Does Not Accept the Asterisk (*) Wilcard Character in Both Parameters

- 24.2.56 Disabled Links on the Access Policy Summary Page Opened in Mozilla FireFox

- 24.2.57 Benign Error is Generated on Editing the IT Resource Form in Advanced Administration

- 24.2.58 User Account is Not Locked in iPlanet Directory Server After it is Locked in Oracle Identity Manager

- 24.2.59 Oracle Identity Manager Does Not Support Autologin With JavaAgent

- 24.2.60 Benign Error Logged on Opening Access Policies, Resources, or Attestation Processes

- 24.2.61 User Locked in Oracle Identity Manager But Not in LDAP

- 24.2.62 Reconciliation Profile Must Not Be Regenerated Via Design Console for Xellerate Organization Resource Object

- 24.2.63 Benign Error Logged on Clicking Administration After Upgrade

- 24.2.64 Provisioning Fails Through Access Policy for Provisioned User

- 24.2.65 Benign Warning Messages Displayed During Oracle Identity Manager Managed Server Startup

- 24.2.66 Benign Message Displayed When Running the Deployment Manager

- 24.2.67 Deployment Manager Export Fails When Started Using Microsoft Internet Explorer 7 With JRE Plugin 1.6_23

- 24.2.68 User Creation Fails in Microsoft Active Directory When Value of Country Attribute Exceeds Two Characters

- 24.2.69 Deployment Manager Import Fails if Scheduled Job Entries Are Present Prior To Scheduled Task Entries in the XML File

- 24.2.70 Permission on Target User Required to Revoke Resource

- 24.2.71 Reconciliation Event Fails for Trusted Source Reconciliation Because of Missing Reconciliation Rule in Upgraded Version of Oracle Identity Manager

- 24.2.72 XML Validation Error on Oracle Identity Manager Managed Server Startup

- 24.2.73 Cannot View or Edit Adapter Mapping in the Data Object Manager Form of the Design Console

- 24.2.74 Role Memberships for Assign or Revoke Operations Not Updated on Enabling or Disabling Referential Integrity Plug-in

- 24.2.75 Deployment Manager Import Fails if Data Level for Rules is Set to 1

- 24.2.76 Reconciliation Data Displays Attributes That Are Not Modified

- 24.2.77 Benign Errors Displayed on Starting the Scheduler Service When There are Scheduled Jobs to be Recovered

- 24.2.78 Trusted Source GTC Reconciliation Mapping Cannot Display Complete Attribute Names

- 24.2.79 Benign Error Logged for Database Connectivity Test

- 24.2.80 MDS Validation Error When Importing GTC Provider Through the Deployment Manager

- 24.2.81 Encrypted User-Defined Field (UDF) Cannot be Stored with Size of 4000 Characters or More

- 24.2.82 Request Approval Fails With Callback Service Failure

- 24.2.83 Localized Display Name is Not Reconciled Via User/Role Incremental Reconciliation with iPlanet Directory Server

- 24.2.84 LDAP Role Hierarchy and Role Membership Reconciliation With Non-ASCII Characters Does Not Reconcile Changes in Oracle Identity Manager

- 24.2.85 Import of Objects Fails When All Objects Are Selected for Export

- 24.2.86 Benign Audit Errors Logged After Upgrade

- 24.2.87 Connector Upgrade Fails if Existing Data is Bigger in Size Than New Column Length

- 24.2.88 Connector Artifacts Count Increases in the Deployment Manager When File is Not Imported

- 24.2.89 Uploading JAR Files By Using the Upload JAR Utility Fails

- 24.2.90 Oracle Identity Manager Data and MT Upgrade Fails Because Change of Database User Password

- 24.2.91 Reverting Unsaved UDFs Are Not Supported in the Administration Details Page for Roles and Organizations

- 24.2.92 Resources Provisioned to User Without Checking Changes in User Status After Request is Submitted

- 24.2.93 Starting UCP Connection Pool Fails When Trying to Create User on 64-Bit Microsoft Windows With JDK 6

- 24.2.94 Config.sh Command Fails When JRockit is Installed With Data Samples and Source

- 24.2.95 Unexpected Memory Usage in Oracle Identity Manager 11g Release 1(11.1.1)

- 24.2.96 Reports Link No Longer Exists in the Administrative and User Console

- 24.2.97 Not Allowing to Delete a Role Whose Assigned User Members are Deleted

- 24.2.98 Roles and Organizations Do Not Support String UDFs of Password Type

- 24.2.99 Error on Importing Connector By Using the Deployment Manager

- 24.2.100 Manage Localizations Dialog Box Does Not Open After Modifying Roles

- 24.2.101 Not Allowing to Create User With Language-Specific Display Name Values

- 24.2.102 SoD Check Results Not Displayed for Requests Created by Users for the PeopleSoft Resource

- 24.2.103 The XL.UnlockAfter System Property and the Automatically Unlock User Scheduled Job Do Not Take Effect

- 24.2.104 Resetting Password on Account Lockout Does Not Unlock User

- 24.2.105 Starting Oracle Identity Manager and SOA Server on Some 64-bit Microsoft Windows Computers for the First Time Takes Time

- 24.2.106 Incremental and Full Reconciliation Jobs Cannot Be Run Together

- 24.2.107 Incorrect Content in the ScheduleTask Jars Loaded and Third Party Jars Tables in the MT Upgrade Report

- 24.2.108 Scroll Bar Not Available on the Select Connector Objects to Be Upgraded Page of the Connector Management - Upgrading Wizard

- 24.2.109 Adapter Import Might Display Adapter Logic if Compilation Fails Because of Incorrect Data

- 24.2.110 XIMDD Tests Fail in Oracle Identity Manager

- 24.3 Configuration Issues and Workarounds

- 24.3.1 Configuring UDFs to be Searchable for Microsoft Active Directory Connectors

- 24.3.2 Creating or Modifying Role Names When LDAP Synchronization is Enabled

- 24.3.3 ADF Issue Causes Oracle Identity Manager to Fail on the Sun JDK

- 24.3.4 Nexaweb Applet Does Not Load In an Oracle Identity Manager and Oracle Access Manager Integrated Environment

- 24.3.5 Packing a Domain With managed=false Option

- 24.3.6 Option Not Available to Specify if Design Console is SSL-Enabled

- 24.3.7 Nexaweb Applet Does Not Load in JDK 1.6.0_20

- 24.3.8 Error is Generated on Starting Servers With Sun JDK 160_24 (32-bit) on Microsoft Windows 2008

- 24.3.9 Oracle Identity Manager and Design Console Must be Installed in Different Directory Paths

- 24.4 Multi-Language Support Issues and Limitations

- 24.4.1 Multi-language Valued Attributes in SPML and Oracle Identity Manager Do Not Match

- 24.4.2 Login Names with Some Special Characters May Fail to Register

- 24.4.3 The Create Role, Modify Role, and Delete Role Request Templates are Not Available for Selection in the Request Templates List

- 24.4.4 Parameter Names and Values for Scheduled Jobs are Not Translated

- 24.4.5 Bidirectional Issues for Legacy User Interface

- 24.4.6 Localization of Role Names, Role Categories, and Role Descriptions Not Supported

- 24.4.7 Localization of Task Names in Provisioning Task Table Not Supported

- 24.4.8 Localization of Search Results of Scheduled Tasks Not Supported

- 24.4.9 Searching for User Login Names Containing Certain Turkish Characters Causes an Error

- 24.4.10 Localization of Notification Template List Values for Available Data Not Supported

- 24.4.11 Searching for Entity Names Containing German "ß" (Beta) Character Fails in Some Features

- 24.4.12 Special Asterisk (*) Character Not Supported

- 24.4.13 Translated Error Messages Are Not Displayed in UI

- 24.4.14 Reconciliation Table Data Strings are Hard-coded on Reconciliation Event Detail Page

- 24.4.15 Translated Password Policy Strings May Exceed the Limit in the Background Pane

- 24.4.16 Date Format Validation Error in Bi-Directional Languages

- 24.4.17 Mistranslation on the Create Job page

- 24.4.18 E-mail Notification for Password Expiration Cannot Be Created With Arabic Language Setting

- 24.4.19 Translated Justification is Not Displayed in Access Policy-Based Resource Provisioning Request Detail

- 24.4.20 Additional Single Quotes Displayed in GTC Reconciliation Mapping Page for French UI

- 24.4.21 Not Allowing to Enter Design Console Password When Server Locale is Set to Simple Chinese, Traditional Chinese, Japanese, or Korean

- 24.4.22 Bidirectional Text Not Supported in Nexaweb Pages

- 24.4.23 Do Not Modify Oracle Identity Manager Predefined System Properties in Non-English Locale

- 24.4.24 Error Generated When Translated String for System Property Name Exceeds Maximum Allowed Length in PTY_NAME Column

- 24.4.25 Password Notification is Not Sent if User Login Contains Special Characters

- 24.4.26 Reset Password Fails if User Login Contains Lowercase Special Characters

- 24.5 Documentation Errata

25 Oracle Identity Navigator

- 25.1 General Issues and Workarounds

- 25.1.1 Avoid Selecting Reset Page in Dashboard Edit Mode

- 25.1.2 How to Navigate Product Registration Using the Keyboard

- 25.1.3 How to Navigate Product Discovery When Using the Keyboard

- 25.1.4 Color Contrast is Inadequate for Some Labels in Edit Mode

- 25.1.5 No Help Topic in Dashboard Edit Mode

- 25.1.6 Customization Problem in Internet Explorer 7

- 25.1.7 Discovery Problem in Internet Explorer 7

- 25.1.8 How to Navigate BI Publisher Configuration When Using the Keyboard

- 25.1.9 User Missing From Common Admin Role Search Results

- 25.1.10 Unable to View Users After Log in Or Log In Fails In Oracle Identity Manager Environment

- 25.1.11 Horizontal Scroll-bar Missing in Discovery Wizard

- 25.2 Configuration Issues and Workarounds

- 25.2.1 No Oracle Icon is Visible in HTML Reports

- 25.2.2 Problems with Administration Screen When Using JAWS Screen Reader

- 25.2.3 SSO-Protected Consoles Must Be Configured by Name and Domain

- 25.3 Documentation Errata

- 25.3.1 IPv4/IPv6 Translation Issues

26 Oracle Internet Directory

- 26.1 General Issues and Workarounds

- 26.1.1 ODSM Browser Window Becomes Unusable

- 26.1.2 Bulkmodify Might Generate Errors

- 26.1.3 Turkish Dotted I Character is Not Handled Correctly

- 26.1.4 OIDCMPREC Might Modify Operational Attributes

- 26.1.5 OIDREALM Does Not Support Realm Removal

- 26.1.6 Apply Patch to Oracle Database 11.2.0.1.0 to Fix Purge Job Problem

- 26.1.7 SQL of OPSS ldapsearch Might Take High %CPU

- 26.1.8 If you Start the Replication Server by Using the Command Line, Stop it Using the Command Line

- 26.1.9 ODSM Problems in Internet Explorer 7

- 26.1.10 ODSM Bug Requires Editing of odsmSkin.css File

- 26.2 Configuration Issues and Workarounds

- 26.2.1 Re-Create Wallet After Moving Oracle Internet Directory from Test to Production

- 26.2.2 OIDMON Process Fails While Configuring Oracle Internet Directory on Microsoft Windows x64 (64-Bit)

- 26.3 Documentation Errata

- 26.3.1 Bulkdelete Deletes Entries, not Attributes

- 26.3.2 ODSM Section Should Refer to Oracle Internet Directory

- 26.3.3 Incorrect Bug Numbers in Prerequisites for Rolling Upgrade

- 26.3.4 Default orclcryptoscheme Value is SSHA

- 26.3.5 Setting Up Oracle Internet Directory SSL Mutual Authentication

- 26.3.6 ODSM Schema Tab is Available to Non-Super User

- 26.3.7 Wrong Command and Path in Appendix P of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

- 26.3.8 Missing Option to opmnctl updatecomponentregistration in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

- 26.3.9 Update Component Registration Whenever You Change Certain Instance-Specific Attributes

- 26.3.10 Incorrect LDIF File for Enabling Referential Integrity

- 26.3.11 Errors in remtool -pthput Sections

- 26.3.12 Oracle Internet Directory Wallets Must be Auto Login

- 26.3.13 List of bulkmodify Limitations is Incomplete

- 26.3.14 orclpwdmaxinactivity Attribute Should be orclpwdmaxinactivitytime

- 26.3.15 Replication Instructions in Tutorial for Identity Management are Incomplete

27 Oracle Platform Security Services

- 27.1 Configuration Issues and Workarounds

- 27.1.1 Oracle Fusion Middleware Audit Framework

- 27.1.1.1 Configuring Auditing for Oracle Access Manager

- 27.1.1.2 Audit Reports do not Display Translated Text in Certain Locales

- 27.1.1.3 Audit Reports Always Display in English

- 27.1.1.4 Creating a New Audit Schema

- 27.1.1.5 Upgrading the Audit Schema

- 27.1.2 Trailing '\n' Character in Bootstrap Key

- 27.1.3 Users with Same Name in Multiple Identity Stores

- 27.1.4 Script listAppRoles Outputs Wrong Characters

- 27.1.5 Propagating Identities over the HTTP Protocol

- 27.1.5.1 Addition to Section Propagating Identities over the HTTP Protocol

- 27.1.5.2 Correction to Section Client Application Code Sample

- 27.1.5.3 Correction to Section Keystore Service Configuration

- 27.1.5.4 Updating the Trust Service Configuration Parameters

- 27.2 Authorization Policy Manager Issues

- 27.2.1 Error Message While Searching Application Roles

- 27.2.2 Some Errors/Warnings in Authorization Policy Manager Display Server Locale

- 27.2.3 Support for Internet Protocols

- 27.2.4 Authorization Policy Manager Patch Installation Fails on 64-bit Operating Systems

- 27.3 Documentation Errata

- 27.3.1 Updated Instructions for SSL for the Identity Store Service

28 SSL Configuration in Oracle Fusion Middleware

- 28.1 General Issues and Workarounds

- 28.1.1 Replacement User Certificates for Oracle Wallets

- 28.1.2 Incorrect Message or Error when Importing a Wallet

- 28.2 Configuration Issues and Workarounds

- 28.2.1 Tools for Importing DER-encoded Certificates

- 28.2.2 Using a Keystore Not Created with WLST or Fusion Middleware Control

- 28.2.3 Components May Enable All Supported Ciphers

29 Oracle Virtual Directory

- 29.1 General Issues and Workarounds

- 29.1.1 ODSM Version Does Not Change in Enterprise Manager after Patching ODSM to 11.1.1.6.0

- 29.1.2 Oracle Virtual Directory Version 11.1.1.6.0 Start-Up Fails on Windows

- 29.1.3 ODSM Bug Requires Editing of odsmSkin.css File

- 29.1.4 Oracle Directory Services Manager Browser Window is Not Usable

- 29.1.5 Exceptions May Occur in Oracle Directory Services Manager When Managing Multiple Oracle Virtual Directory Components and One is Stopped

- 29.1.6 Identifying the DN Associated with an Access Control Point in Oracle Directory Services Manager

- 29.1.7 Issues With Oracle Virtual Directory Metrics in Fusion Middleware Control

- 29.1.7.1 Configuring Operation-Specific Plug-Ins to Allow Performance Metric Reporting in Fusion Middleware Control After Upgrading to 11g Release 1 (11.1.1)

- 29.1.8 Using a Wildcard when Performing an LDAPSEARCH on a TimesTen Database Causes an Operational Error

- 29.1.9 ODSM Version 11.1.1.4.0 Does Not Support OVD Versions 11.1.1.2.0 or 11.1.1.3.0

- 29.1.10 ODSM Version 11.1.1.5.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, or 11.1.1.4.0

- 29.1.11 ODSM Version 11.1.1.6.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, 11.1.1.4.0, or 11.1.1.5.0

- 29.1.12 Oracle Virtual Directory Issues with IPv6 Stack on Windows Platforms Using JDK6

- 29.1.13 Users with Non-ASCII Names Might Encounter Problems when Using ODSM with SSO

- 29.1.14 Creating an Attribute/Object Class Throws NPE Error

- 29.1.15 Patch Required to Enable Account Lockout Feature

- 29.1.16 ODSM Problems in Internet Explorer 7

- 29.1.17 Strings Related to New Enable User Account Lockout Feature on EUS Wizard Are Not Translated

- 29.2 Configuration Issue and Workaround

- 29.2.1 Java Virtual Machine Dumps Core With OutOfMemory Error in Oracle Virtual Directory Database

- 29.2.2 OVD Server Configuration Issue on Microsoft Windows x64 (64-bit)

- 29.3 Documentation Errata

- 29.3.1 Deploying Oracle Unified Directory with Oracle Virtual Directory

- 29.3.2 Code Example Does Not Close Connection to LDAP Server

- 29.3.3 Missing Instruction for Configuring Oracle Virtual Directory for Integration with Oracle Directory Server Enterprise Edition

Part IX Oracle Portal, Forms, Reports and Discoverer

30 Oracle Business Intelligence Discoverer

- 30.1 General Issues

- 30.1.1 Issue while Creating Discoverer schema on Oracle Database 12g Release 1

- 30.1.2 Issues with Metadata Repository and Oracle Database 10g Release 1

- 30.1.3 Compatibility Issues with Required Support Files

- 30.1.4 Serif Font Issue in Worksheets

- 30.1.5 Query Prediction Requires the Majority of the Query Time

- 30.1.6 Word Wrapping Behavior with Oracle BI Discoverer Plus and Oracle BI Discoverer Viewer

- 30.1.7 Applet Appears Behind Browser Window

- 30.1.8 Issues with Mac OS X Browser and Oracle BI Discoverer Plus

- 30.1.9 Issues with Turkish Regional Settings

- 30.1.10 Multibyte Characters Rendered as Square Boxes in Exported PDF and Other Formats

- 30.1.11 Java Plug-in Not Downloaded Automatically on Firefox

- 30.1.12 HTTP 404 Error While Accessing Discoverer on a Remote Machine

- 30.1.13 Error While Launching Discoverer Plus Applet on an IPv6 Environment

- 30.1.14 Error While Updating the Discoverer Web Services Configuration Parameter

- 30.1.15 Exception Logged for Discoverer Web-Based Applications in an Extended Domain

- 30.1.16 Issue with Discoverer Application URL in Fusion Middleware Control after a Backup Recovery

- 30.1.17 Incorrect Version Number for Discoverer in Fusion Middleware Control 11g

- 30.1.18 Oracle BI Discoverer Startup Fails after Shutdown

- 30.1.19 The Database Export and Import Utility does not Work with Applications Mode EUL

- 30.1.20 Install-level Scripts are not Updated in Existing Instances after Patching

- 30.2 Issues Specific to Oracle BI Discoverer Plus Relational

- 30.2.1 Text Appearing Truncated or Clipped

- 30.2.2 Non-ASCII Characters Not Saved Correctly in Title or Text Area

- 30.2.3 Canceling Query Causes Discoverer to Hang

- 30.2.4 Nonaggregable Values Not Displayed for Scheduled Workbooks

- 30.2.5 Migrating Oracle BI Discoverer Plus Relational Worksheets from Oracle BI Discoverer Desktop

- 30.3 Issues Specific to Oracle BI Discoverer Plus OLAP

- 30.3.1 Issues with Applet Download

- 30.3.2 Disabled Netscape and Mozilla Browsers

- 30.3.3 Tabbing Fails to Synchronize Menus

- 30.3.4 Esc Key Fails to Close Certain Dialogs

- 30.3.5 Link Tool Works Incorrectly in Some Locales

- 30.3.6 Memory Issues when Exporting Extremely Large Graphs

- 30.3.7 Issue While Printing Worksheets with Large Data Values

- 30.3.8 Issues with Titles and Text Areas

- 30.3.9 Errors with JAWS and Format Dialogs

- 30.3.10 Issue with Discoverer Plus OLAP Connections on Windows

- 30.3.11 Error when Authorizing Multiple Users to Access Discoverer Catalog

- 30.4 Issues Specific to Oracle BI Discoverer Portlet Provider

- 30.4.1 Inability to Turn Off Display of Range Min and Max as Labels

- 30.4.2 Using Oracle BI Discoverer Portlet Provider with Oracle Single Sign-On and Secure Sockets Layer (SSL) Modes

- 30.4.3 Issues with Discoverer Portlets in WebCenter

- 30.4.4 Issue while Publishing Discoverer WSRP Portlets in Portals Other than Oracle Portal and Oracle WebCenter

- 30.4.5 Issue with Portlet Titles in Discoverer WSRP Portlets Published on IBM WebSphere

- 30.4.6 Issue with Color and Date Pickers in Discoverer WSRP Portlets

- 30.4.7 Worksheet Parameter LOV is not Displayed in Discoverer WSRP Portlets on IBM WebSphere Portal

- 30.4.8 Issue with Worksheet Parameter LOV Pop-Up Window in Discoverer WSRP Portlets

- 30.5 Issues Specific to Oracle BI Discoverer Viewer

- 30.5.1 Drill Icons Cannot Be Hidden in Oracle BI Discoverer Viewer

- 30.5.2 Error Displaying Page for Multiple SSO Users

- 30.5.3 Inability to Disable the Display of Row Numbers

- 30.5.4 Issues with Oracle BI Discoverer Viewer Embedded in Frames

- 30.5.5 Issue Exporting to PDF Under Certain Circumstances

- 30.5.6 Issue When Changing Colors for Oracle BI Discoverer Viewer in Fusion Middleware Control on Mac OS X

- 30.5.7 Known Bug with JAWS Prevents Drilling Using the Enter Key

- 30.5.8 JAWS Does Not Read Asterisks that Precede Fields

- 30.5.9 Oracle BI Discoverer Viewer Pages are not Cached by Oracle Web Cache

- 30.6 Issues Specific to Oracle BI Discoverer EUL Command Line for Java

- 30.6.1 Issue with Exported Non-ASCII Data

- 30.7 Issues Specific to Oracle BI Discoverer Administrator

- 30.7.1 Issue with Installation of Video Stores Tutorial

- 30.8 Documentation Errata

- 30.8.1 Additional information for associating Oracle BI Discoverer installation with Oracle Identity Management

- 30.8.2 Missing steps in the procedure to configure Oracle Access Manager for Oracle BI Discoverer

31 Oracle Forms

- 31.1 General Issues and Workarounds

- 31.1.1 Backwards Compatibility with Earlier Releases

- 31.1.2 Oracle Forms Builder Help Menu Displays Incorrect Operating System

- 31.2 Configuration Issues and Workarounds

- 31.2.1 Non-Internet Explorer Browser Proxy Settings when Using One-Button-Run

- 31.2.2 WebUtil Client Files Allow Configuration of Destination Directory

- 31.2.3 webutil.properties Files Renamed for Different Libraries

- 31.2.4 Forms does not Work with JDK 1.6.0_12 on Client with WinRunner

- 31.2.5 JavaScript Communication Does not Work in IE for Framed HTML File

- 31.2.6 JavaScript Events Calling Forms Applications in a Safari 5 Browser Do not Work

- 31.3 Documentation Errata

- 31.3.1 Passing userid in Secure Mode

- 31.3.2 JDAPI Programming Example

32 Oracle Portal

- 32.1 Before You Begin

- 32.2 General Issues and Workarounds

- 32.2.1 Editing a Database Link Requires Password

- 32.2.2 Moving Content When Approval Is Enabled Does Not Require Approval

- 32.2.3 Firefox and Safari Browsers Do Not Display Tooltips on Oracle Portal Screens

- 32.2.4 Non-ASCII URLs Cannot be Decoded in Some Scenarios

- 32.2.5 Adding a Zip File with a Non-ASCII Character Name

- 32.2.6 Manual Changes to Oracle Portal Default Schema Objects

- 32.2.7 Oracle HTTP Server or Web Cache Does Not Start Due to Wallet Permissions

- 32.2.8 Portal Throws Discoverer Provider is Busy Error Message

- 32.2.9 Error When Creating RCU Portal Schema

- 32.2.10 Error When Adding Sample RSS Portlets to a Page

- 32.2.11 Internal Error when Using Portal Search With Oracle Text Enabled to Search for Pages

- 32.2.12 Cloning Utility Not Supported

- 32.2.13 Issue After Creating a Oracle Portal Schema

- 32.2.14 Updating Database Tables

- 32.3 Upgrade Issues and Workarounds

- 32.3.1 Upgrading Portal 10g SSL Environment to Oracle Portal 11g Release 1 (11.1.1)

- 32.4 Interoperability Issues and Workarounds

- 32.4.1 Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.3

- 32.4.2 Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.4

- 32.4.3 Creating Webproviders in the Oracle Portal 11g Release 1 (11.1.1) Midtier Interoperability with Oracle Portal Repository 10g Release

- 32.5 User Interface Issue and Workaround

- 32.6 Export and Import Issues and Workarounds

- 32.6.1 Export and Import Does Not Support Reports Server Components

- 32.6.2 Saving the Transport Set

- 32.6.3 Error when importing a page group

- 32.7 Portlet and Provider Issues and Workarounds

- 32.7.1 Issue When Accessing Page Portlet Using Federated Portal Adapter

- 32.7.2 Error in JPS Portlet After Redeployment

- 32.7.3 SSL Support for Oracle Portal Integration Solutions (Microsoft Exchange)

- 32.8 PDK Issue and Workaround

- 32.9 Globalization Support Issues and Workarounds

- 32.9.1 Text Entry Always Right to Left in BiDi Languages

- 32.9.2 Non-ASCII Character Limitations in Oracle Portal

- 32.9.3 Multibyte Characters in Log Files

- 32.10 Documentation Errata

- 32.10.1 Limit for Parameters Per Portal Page

- 32.10.2 Incorrect Database Keystore Location

33 Oracle Reports

- 33.1 General Issues and Workarounds

- 33.1.1 Mapping Users and Roles to Reports Application

- 33.1.2 Configuration Fails While Starting WLS_Reports Server

- 33.1.3 Oracle Reports Builder Fails to Open the Data Model from Object Navigator

Part X Oracle WebCenter Content

34 Oracle WebCenter Application Adapters

- 34.1 Configuration Issues and Workarounds

- 34.1.1 Credential User Must Be Administrator for Successful AXF Call Using Microsoft LDAP

35 Oracle WebCenter Content Installation and Configuration

- 35.1 Rebranding of Oracle Enterprise Content Management Suite to Oracle WebCenter Content

- 35.2 Documentation Errata

- 35.2.1 Location of Deinstaller

- 35.2.2 Managed Server Name for Oracle Information Rights Management

36 Oracle WebCenter Content: Imaging

- 36.1 General Issues

- 36.1.1 Imaging Session Time Out When Using OSSO Requires Browser Refresh

- 36.1.2 Mixed Translations On Page

- 36.1.3 Deleting More Than 100 Documents Can Cause Http 404 Errors

- 36.1.4 Time Zone Based on Time Zone of Imaging Server

- 36.1.5 Imaging Documents May Be Visible Natively Within WebCenter

- 36.1.6 Removing Full-Text Search Capabilities From Defined Applications

- 36.1.7 Application Field Limitations When Using Oracle Text Search

- 36.1.8 Records Missing from Imaging Searches

- 36.1.9 WebLogic Server Listening Address and AXF Driver Page URL Must Reference the Same Domain

- 36.1.10 Must Start NFS Locking Service When Input Agent Used with Linux Shares

- 36.1.11 DefaultSecurityGroup MBean Allows For Assigning Administrator Rights to Security Group at First Log In

- 36.1.12 Input Mapping Error When Input Definition File Includes Blank Line

- 36.1.13 Differing Behavior of Decimals When Ingested Into Number or Decimal Fields

- 36.1.14 Using Browser Forward, Back, and Refresh Navigation Not Recommended

- 36.1.15 Document Upload or Update Failure if Content Server English-US Locale Not Enabled

- 36.1.16 Document Move Failure if Content Server Not Started with English-US Locale

- 36.1.17 Clearing Java Temporary Files of Cached Files

- 36.1.18 Solution Editor Enabled Only On Imaging Systems Using an Oracle Database

- 36.2 Browser Compatibility Issues

- 36.2.1 IE: Non-ASCII Characters Not Supported in Internet Explorer for ExecuteSearch

- 36.2.2 Firefox: Version and Download Dialog Boxes Appear Behind Viewer in Advanced Mode

- 36.2.3 Internet Explorer 9: Problem With Link to Install Java SE Runtime Environment Necessary for Viewer

- 36.3 Accessibility Issues

- 36.3.1 Button Activation Behavior Different Depending on Viewer Mode

- 36.3.2 Limitations of Sticky Note Contents

- 36.3.3 Skip to Content Link Added for Keyboard Navigation

- 36.3.4 Firefox: Skip to Applet Link Added for Keyboard Navigation in Advanced Viewer Mode

- 36.3.5 Internet Explorer 7: Focus Issue on Upload Document and Preferences Pages

- 36.3.6 Name of File Selected For Import Not Displayed in Screen Reader Mode

- 36.3.7 Issues Selecting From Calendar Using Keyboard

- 36.3.8 Focus Issue in Create Searches Wizard Using Keyboard

- 36.3.9 Annotations Not Recognized By JAWS

- 36.3.10 Date Selected From Calendar Lost Using Keyboard

- 36.3.11 Some Annotation Buttons Incorrectly Read by JAWS

- 36.3.12 Internet Explorer: Long Panels Not Visible In Screen Reader

37 Oracle Information Rights Management

- 37.1 General Issues and Workarounds

- 37.1.1 Some Functionality is Disabled or Restricted in Adobe Reader X and Adobe Reader 9

- 37.1.2 Limitations of Support for Microsoft SharePoint in this Release

- 37.1.3 Lotus Notes Email Message May be Lost if Context Selection Dialog is Canceled

- 37.1.4 Save As is Blocked in Microsoft Office 2000/XP for Sealed Files if the Destination is a WebDAV Folder

- 37.1.5 No Prompt to Use Local Drafts Folder for Sealed Files in SharePoint 2010

- 37.1.6 Incorrect Initial Display of Oracle IRM Fields in Microsoft Excel Spreadsheets When Used With SharePoint

- 37.1.7 Behavior of Automatic Save and Automatic Recovery in Microsoft Office Applications and SharePoint

- 37.1.8 Support for Microsoft Windows 2000 Has Been Removed

- 37.1.9 Unreadable Error Message Text When Client and Server Locales are Different

- 37.1.10 Changes Lost if Tab Changed Before Applying the Apply Button

- 37.1.11 Some File Formats are Not Supported When Using the Microsoft Office 2007 Compatibility Pack with Microsoft Office 2003

- 37.1.12 Microsoft Word May Hang if a Sealed Email is Open During Manual Rights Check-In

- 37.1.13 Sealed Emails in Lotus Notes will Sometimes Show a Temporary File Name

- 37.1.14 No Support for Sealing Files of 2GB or Larger in Size in Oracle IRM Desktop

- 37.1.15 Inappropriate Authentication Options After Failed Login on Legacy Servers When Setting Up Search

- 37.1.16 Opening Legacy Sealed Documents in Microsoft Office 2007 May Fail on First Attempt

- 37.1.17 Log Out Link Inoperative When Using OAM 11g for SSO

- 37.1.18 Double-byte Languages Cannot be Used for Entering Data with Legacy Servers

- 37.1.19 Use of SPACE Key Instead of Return Key in Oracle IRM Server

- 37.1.20 Calendar Controls in Oracle IRM Server Not Accessible Via the Keyboard

- 37.2 Configuration Issues and Workarounds

- 37.2.1 New JPS Configuration Properties for User and Group Searches

- 37.2.2 Mandatory Patch Number 12369706 For Release 11.1.1.5.0 of Oracle IRM Server, To Fix Role Edit Bug

- 37.2.3 Installing the 64-Bit Version of Oracle IRM Desktop

- 37.2.4 Reboot Necessary to Obtain New Online Information Button

- 37.2.5 Deploying Oracle IRM Using Oracle Access Manager Version 10g

- 37.2.6 LDAP Reassociation Fails if User and Group Names are Identical

- 37.2.7 Upgrading Oracle IRM Desktop From Versions Earlier Than 5.5

- 37.2.8 Synchronizing Servers After an Upgrade of Oracle IRM Desktop

- 37.2.9 Reapplying Lost Settings After an Upgrade of Oracle IRM Desktop

- 37.2.10 Changing Oracle IRM Account When Authenticated Using Username and Password

- 37.2.11 Post-Installation Steps Required for Oracle IRM Installation Against Oracle RAC

- 37.2.12 Enabling the Oracle IRM Installation Help Page to Open in a Non-English Server Locale

- 37.3 Documentation Errata

38 Oracle WebCenter Content

- 38.1 General Issues and Workarounds

- 38.1.1 Standalone Inbound Refinery Application Executables on Windows 7

- 38.1.2 Folio Items With Content IDs Containing Multibyte Characters Do Not Display Correctly in Safari

- 38.1.3 Site Studio Does Not Support Multibyte Characters in Site IDs, Directory Names, and Page Names

- 38.1.4 Site Studio Publisher Does Not Support Multibyte Characters

- 38.1.5 Transferring Folder Archives Between Content Servers Fails If Server System Locales Do Not Match

- 38.1.6 Importing Folder Archives Fails If User Locale Did Not Match Server System Locale During Export

- 38.1.7 New Folio Page Does Not Work in French and Italian Languages

- 38.1.8 Oracle WebCenter Content Servers and IPv6 Support

- 38.1.9 Large File Check-ins May Cause Timeouts

- 38.1.10 Content Categorizer Trace Log Settings Discontinued

- 38.1.11 Using WebCenter Content with OAM Server Under Single Sign-on

- 38.1.12 Extra Lines Displayed Viewing Contribution Folders in Internet Explorer 8

- 38.1.13 WebDAV Connection Fails After Logout or Restart

- 38.1.14 LDAP Users Not Receiving Some Administrator Privileges

- 38.1.15 WinNativeConverter Requires .NET Framework

- 38.1.16 Detailed Oracle OpenOffice Configuration Settings

- 38.1.17 Clarification When Setting Classpath to OpenOffice Class Files

- 38.1.18 Inbound Refinery PDF Conversion May Differ Visually from the Original Content

- 38.1.19 Mismatching User and Server Locales Prevent Access to Oracle E-Business Suite and PeopleSoft Managed Attachment Pages in WebCenter Content

- 38.1.20 Connection Issues with Windows to WebDAV

- 38.1.21 Manual Addition of xdoruntime.ear Library for Records Management

- 38.1.22 Using HCSP Custom Elements with SSXA

- 38.1.23 Using Link Wizard with FCKEditor and Chrome

- 38.1.24 Link Wizard Display Errors When Using Chrome

- 38.1.25 Backing Up Site Studio Websites Using Chrome

- 38.1.26 DAM Video Storyboard Errors With Chrome and Safari

- 38.1.27 Issues Applying Table Styles When Using FireFox and FCK Editor

- 38.1.28 Content Information Server Is Not Supported for 11g

- 38.1.29 Window Size Using Trays with FireFox

- 38.1.30 Content Item Icon for Basket Item Appears Broken in Chrome

- 38.1.31 VB6 Component Dependency for Kofax 9

- 38.1.32 Offline Server Status Icon Overlay Not Displayed on Windows Vista and Windows 7

- 38.1.33 Opening an Older Managed File Revision Not Available in Microsoft Excel

- 38.1.34 Using URLs With SSP Include and Exclude Filters

- 38.1.35 Disabling the Folders_g Deprecation Alert

- 38.1.36 Dragging and Dropping Microsoft Office Documents in Windows Explorer

- 38.1.37 Accessing ZipRenditionStaticAccess Scheduled Job Information

- 38.1.38 Using Only Page 1 for Thumbnail Images of Documents

- 38.1.39 Check-in and Search Forms Pop Up Error Messages when UCM is in EBR Mode

- 38.1.40 View Publishing Errors Are Observed in Logs When UCM is in EBR Mode

- 38.1.41 Optimization Errors with External OracleTextSearch

- 38.1.42 Propagating the cwallet.sso Changes to Deployment Manager

- 38.1.43 UCM in EBR Mode Fails to Start when Dynamic Converter Component is Enabled

- 38.2 Configuration Issues and Workarounds

- 38.2.1 Minimum JDBC Driver Version Required for Oracle Text Search Component

- 38.2.2 Manually Disabling 8.3 File Naming for Inbound Refinery on Windows 7

- 38.2.3 Setting Security Privileges for Modifying Folders

- 38.2.4 SSXA Required DC Version for Oracle Content Server 10gR3

- 38.2.5 Content Portlet Suite (SCPS) WebCenter as Producer Targeting Libraries

- 38.2.6 Logout URL for SSO Logout Integrating with Oracle Access Manager 11g

- 38.2.7 Using the Custom Truststore with the JPS Connection to ActiveDirectory

- 38.2.8 Using WebDAV on a Windows 7 Client

- 38.2.9 Setting the Connection Pool for an External LDAP ID Store on IBM WebSphere Application Servers

- 38.2.10 File Store Provider Storage Rule "Default Storage" is not the Default

- 38.3 Documentation Errata

- 38.3.1 EnableOptimizedLatestReleaseQuerying No Longer Valid in Idoc Script

- 38.3.2 Kofax Version Certification for WebCenter Content

- 38.3.3 Content Portlet Suite (CPS) WSRP URLs for WebCenter as Producer

- 38.3.4 No Support for 8.3 File Naming on Windows

- 38.3.5 Search-Based Content Folders in Desktop Cannot Be Made Available Offline

- 38.3.6 Server Connection Registry Entries for Desktop 11gR1

- 38.3.7 Internet-Style Search Disabled in 11g

- 38.3.8 Framework Folders Component Not Enabled by Default

- 38.3.9 Maximum Role Length Incorrect in WebCenter Content Server Help

39 Oracle WebCenter Content: Records

- 39.1 General Issues and Workarounds

- 39.1.1 Role Report Output is Dependent on User Generating the Report

- 39.1.2 Items Returned When Using Screening

- 39.1.3 Oracle Text Search and Report Configuration Options

- 39.1.4 Upgrade from 10g Audit Trail Periods Missing

- 39.1.5 DB2 Databases and FOIA/PA Functionality

- 39.1.6 Sorting and Listing Retention Category Content

- 39.1.7 Using Firefox to Configure the Dashboard

- 39.1.8 Setting Security Group for Retention Items

- 39.2 Configuration Issues and Workarounds

- 39.2.1 Import FOIA Archive Error Message

- 39.2.2 Restart Required: Performance Monitoring and Reports

- 39.2.3 Audit Trail Sorting Results and Database Fulltext Search

- 39.2.4 Prefix Size Limitation When Using Offsite Storage

- 39.2.5 Enabling Email Metadata Component

- 39.2.6 Relative Web Root Must Be Changed

- 39.2.7 Configuring 10g Adapters for Version 11g

- 39.2.8 Configuring RSS Reader for Dashboard

- 39.3 Documentation Errata

- 39.3.1 Menu Name Changes Not Reflected in Documentation

- 39.3.2 Physical Content Management Services Not Documented

- 39.3.3 Additional FTP Option for Offsite Storage

Part XI Oracle Data Integrator

40 Oracle Data Integrator

- 40.1 Configuration Issues and Workarounds

- 40.1.1 Generated Templates Including a Datasource With an Oracle RAC URL Fail to Deploy

- 40.1.2 Generated Templates Including Datasources Fail to Deploy

- 40.1.3 Setting Test Queries on WLS Datasources

- 40.2 Design-Time Environment Issues and Workarounds

- 40.2.1 For File Datastores, the View Data operation always looks for global context

- 40.2.2 Quick Edit Editor deletes incorrect Joins when sorted

- 40.2.3 Quick Edit Editor displays a Source as removed regardless of the Selection made in the Warning Dialog

- 40.2.4 Inconsistent Behavior when Refreshing Load Plans

- 40.2.5 User Parameters are not Taken into Account by the Runtime Agents

- 40.2.6 Incorrect Non-ASCII File Names in Zip Export Files

- 40.2.7 Non-ASCII Characters Incorrectly Converted to Underscore Characters

- 40.3 Oracle Data Integrator Console Issues and Workarounds

- 40.3.1 Oracle Data Integrator Console Page Task Flow Resets When Another Tab Is Closed.

- 40.3.2 Enterprise Manager Logout Does Not Propagate to Oracle Data Integrator Console

- 40.4 Technologies and Knowledge Modules Issues and Workarounds

- 40.4.1 For Microsoft Excel Target Datastores, column names must be in upper case

- 40.4.2 For File Datastores, reverse-engineering process cannot be canceled

- 40.4.3 SQL Keywords are not imported when importing a Technology in Duplication Mode

- 40.4.4 SQL Exception "Unknown Token" appears when using Complex File or XML as Staging Area

- 40.4.5 Adding Subscribers fails for Consistent Set JKMs when the Model Code Contains Non-ASCII Characters

- 40.4.6 IKM and LKM SQL Incremental Update (Row by Row) fail with Non-ASCII Characters

- 40.4.7 IKM SQL Incremental Update (Row by Row) Cannot Target Japanese Tables

- 40.5 Oracle Data Profiling and Oracle Data Quality Issues and Workarounds

- 40.5.1 Unable to Connect the Client to a Data Quality Server on UNIX

- 40.5.2 Menus Are in English When Starting the Client Using a .tss File.

Part XII Oracle Business Intelligence

41 Oracle Business Intelligence

- 41.1 Patch Requirements

- 41.1.1 Obtaining Patches from My Oracle Support

- 41.2 Oracle Business Intelligence Issues and Workarounds Identified Since the Last Revision

- 41.3 Oracle Business Intelligence Issues and Workarounds that Apply Only to Release 11.1.1.3

- 41.4 Oracle Business Intelligence General Issues and Workarounds

- 41.4.1 Oracle BI Disconnected Analytics Not Included in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later

- 41.4.2 Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later

- 41.4.3 Issue with JAR File Size When Moving from a Test to a Production Environment

- 41.4.4 IBM LDAP Based Authentication is Not Supported on Linux x86-64 and Microsoft Windows x64 (64-Bit)

- 41.4.5 Oracle BI Server Fails to Start Due to Missing Connect String in tnsnames.ora File

- 41.4.6 Adobe Flash Player Version 10.1 or Later Required to View Graphs and Scorecards

- 41.4.7 The Microsoft ODBC Data Source Administrator Crashes While Closing

- 41.4.8 ODBC System DSN Set With a Wrong Driver Filepath on Microsoft Windows x64 (64-Bit)

- 41.4.9 Hyperion Financial Management Data Sources Only Available for Windows Deployments

- 41.4.10 Siteminder Not Supported with Full-Text Catalog Search

- 41.4.11 Windows Native Authentication Not Supported with Full-Text Catalog Search

- 41.4.12 Full-Text Search Not Finding BI Publisher Reports by Report Column

- 41.4.13 Hebrew Fonts May Display in the Wrong Direction on Windows

- 41.4.14 Problems Installing in Thai and Turkish Locales

- 41.4.15 Graph Subtypes Are Not Refreshed in BI Composer

- 41.4.16 Dashboards and Scorecards Whose Paths Contain Multibyte Characters Do Not Display on ADF Pages

- 41.4.17 Characters Supported in Folder Names by BI Presentation Services Not Supported by BI Publisher

- 41.4.18 Integrating with Essbase and Hyperion Financial Management Data Sources with No Shared Connection Pool

- 41.4.19 Patch Available to Hide Selected Consistency Check Warnings

- 41.4.20 Issues with WebLogic LDAP User Passwords

- 41.4.21 Configuring the GUID Attribute in the Identity Store

- 41.4.22 Messages May Be Garbled When Running WebLogic Command Files

- 41.4.23 Rendering Issues Might Occur in Presentation Services When Using Microsoft Internet Explorer 9.x

- 41.5 Oracle Business Intelligence Installation Issues and Workarounds

- 41.5.1 Error When Installing Oracle Business Intelligence Against a SQL Server Database

- 41.5.2 Scale-Out Scenarios Are Not Supported on OS with Different Patch Levels

- 41.5.3 Antivirus Software May Block the Installation in a Windows Environment

- 41.5.4 Oracle Business Intelligence Installer Stops at Administrator User Details Screen

- 41.5.5 Issues When Installing Oracle Business Intelligence on Windows 2008

- 41.5.6 Installing Oracle Business Intelligence on a Shared Drive Might Fail

- 41.5.7 Configuring DB2 to Support Multibyte Data

- 41.5.8 Using Multibyte Data Causes Issues with Microsoft SQL Server 2005/2008 Driver in Oracle BI Scheduler

- 41.5.9 Job Manager Does Not Start Due to Insufficient Permissions on Windows Operating Systems

- 41.5.10 Oracle Essbase Fails to Start on Microsoft Windows x64 (64-Bit)

- 41.5.11 Missing Locale Causes Oracle Business Intelligence Installation to Fail on UNIX

- 41.5.12 Ignore FAT File System Error Message When Performing an Enterprise Installation

- 41.5.13 Job Manager May Fail to Launch from the Start Menu

- 41.5.14 Job Manager Cannot Launch if the Client Tools Install Path Includes Multi-Byte Characters

- 41.5.15 Error Occurs When RCU is Invoked For a Second Time to Create Only MDS/Platform Schemas on IBM DB/2

- 41.6 Oracle Business Intelligence Upgrade Issues and Workarounds

- 41.6.1 General Upgrade Issues and Workarounds

- 41.6.1.1 Conditional Formatting Might Not Work After Upgrading from Oracle Business Intelligence Release 10g to Release 11g

- 41.6.2 Security-related Upgrade Issues and Workarounds

- 41.6.2.1 Warnings Might Be Reported When Upgrading an RPD with Non-English User or Group Names

- 41.6.2.2 Users or Groups With Names Containing Invalid Characters Are Not Upgraded

- 41.6.2.3 RPD Upgrade Process Fails If the 10g Administrator UserID or Password Contains any Non-Native Characters

- 41.7 Oracle Business Intelligence Installation Guidelines for 64-Bit Platforms

- 41.7.1 Prerequisites for Software Only Installation on 64-Bit Platforms

- 41.7.2 Supported Installation Types for Oracle Business Intelligence on 64-Bit Platforms

- 41.7.3 Considerations and Limitations of Enterprise Install Type for Scaling Out Existing Installations

- 41.8 Oracle Business Intelligence Analyses and Dashboards Issues and Workarounds

- 41.8.1 General Analyses and Dashboards Issues and Workarounds

- 41.8.1.1 Existing Dashboard Prompts Based on Columns Renamed in the Business Model Do Not Work

- 41.8.1.2 Gauge Views May Be Cut Off and Not Visible Under Certain Conditions

- 41.8.1.3 Numerical Units on a Dashboard Prompt Slider Might Not Be Translated Correctly

- 41.8.1.4 After Printing a Dashboard Page Using the Safari Browser on Windows, the Page No Longer Responds to Certain Left Clicks

- 41.8.1.5 Scorecard Diagrams on Dashboard Pages May Print as Tables

- 41.8.1.6 Using Maps with Column Selectors

- 41.8.1.7 Support for Rendering Small Form-Factor Graphs

- 41.8.1.8 Analyses Whose Paths Contain Latin Supplement Characters Fail to Open on Dashboard Pages

- 41.8.1.9 In Selection Steps Search for Members in Hierarchical Columns That Are Non-Text Yields No Results

- 41.8.1.10 Interactions on Right-Click Menus Are Not Translated

- 41.8.2 Actions Issues and Workarounds

- 41.8.2.1 EJBs in Action Framework Must Be Deployed to the WebLogic Managed Server

- 41.8.3 Scorecards and KPI Issues and Workarounds

- 41.8.3.1 No Results Returned When Searching in the Related Documents of Scorecards or Scorecard Components

- 41.8.3.2 Item Stale Error When Editing a Shared Scorecard in Parallel

- 41.8.4 Agents Issues and Workarounds

- 41.8.4.1 Agent Deliveries Fail with Microsoft Active Directory and Oracle Virtual Directory

- 41.8.4.2 Agent Incorrectly Delivers Content to Active Delivery Profile When Only the Home Page and Dashboard Option Is Selected

- 41.8.5 Microsoft Office Integration Issues and Workarounds

- 41.8.5.1 Using Microsoft Office 2007 with Oracle BI Add-in for Microsoft Office

- 41.8.5.2 Server Connections Are Not Automatically Shared by Microsoft Excel and PowerPoint

- 41.8.5.3 Previous Installation of Oracle BI Add-in for Microsoft Office Must Be Manually Uninstalled

- 41.8.5.4 Install a Language Pack for Non-English Languages

- 41.8.5.5 Errors in the Online Help for Oracle BI Add-In for Microsoft Office

- 41.8.5.6 Refreshing Table or Pivot Table Views with Double Columns in Page Edge Might Result in Error

- 41.8.5.7 Double Column Cascading Results in Incorrect Display Values

- 41.8.5.8 Intermittent Timeout Errors

- 41.8.5.9 Lack of Support for Vary Color By Target Area

- 41.8.5.10 Measure Column Labels May Display Incorrectly When Inserted into Microsoft Excel

- 41.8.5.11 Stacked Graphs Do Not Display Negative Values

- 41.8.5.12 Scatter Graphs with Lines Display as Default Scatter Graphs in Excel and PowerPoint

- 41.8.5.13 Graphs With Section Edges Are Not Supported in Release 11.1.1.6.0

- 41.8.5.14 Refreshing Table Views in Arabic or German Versions of Excel Result in Incorrect Data Values

- 41.8.5.15 Inserting a View With a Grand Total Column or Row into Microsoft Office May Cause Issues

- 41.8.5.16 Time Displayed in Table or Pivot View Title May Be Incorrect after Insertion

- 41.8.5.17 Graphs May Be Displayed Differently After Insertion into Microsoft Office

- 41.8.5.18 Legends in Bubble and Scatter Graphs May Display Differently After Insertion into Microsoft Office

- 41.8.5.19 Help System Does Not Work When Running Oracle BI Office for PowerPoint in Norwegian or Polish

- 41.9 Oracle Business Intelligence Mobile Issues and Workarounds

- 41.9.1 No Scrolling to View Offscreen Content If User Language is Arabic or Hebrew

- 41.9.2 Bi-directional Text Layout Not Supported by BI Mobile Client Shell UI

- 41.9.3 Mobile Device Accessibility Features May Not Work With Oracle BI Mobile Application

- 41.9.4 Failure of ODBC Data Source Administrator on Windows Server

- 41.9.5 Briefing Books Content Visible in User's Catalog Is Not Viewable in the Mobile Application

- 41.9.6 Multitasking Gestures on iPad iOS 4 and iOS 5 Are Not Supported

- 41.9.7 BI Publisher Prompts Viewed in BI Mobile Display Differently Than in the Desktop Application

- 41.10 Oracle BI Publisher Reporting and Publishing Issues and Workarounds

- 41.10.1 General Oracle BI Publisher Issues and Workarounds

- 41.10.1.1 JDBC Driver Throws Unsupported Function for setBigDecimal

- 41.10.1.2 Searching the Catalog from the Oracle BI Publisher User Interface Does Not Work When BI Publisher Is Integrated with Oracle BI Enterprise Edition

- 41.10.1.3 Data Source List in BI Publisher Administration Page Includes Data Sources That Are Not Supported

- 41.10.1.4 Menu Items Do Not Display When Using Internet Explorer 7 with a Bidirectional Language Preference

- 41.10.1.5 Data Source Definition for Microsoft SQL Server 2008 Analysis Services Does Not Get Saved

- 41.10.1.6 Issues with Viewing Some Report Formats on Apple iPad

- 41.10.1.7 BI Publisher Objects Exhibit Unexpected Behavior When Located Inside a Folder Named with a Single Quote Character

- 41.10.1.8 Components Folder Missing from SampleApp Lite Web Catalog

- 41.10.1.9 Boilerplate Templates in the Components Folder Do Not Display Table Borders Properly in Chrome Browsers

- 41.10.1.10 Local Policy Attachments (LPAs) Removed from Web Services in Release 11.1.1.5

- 41.10.1.11 Oracle BI Publisher Requires Oracle WebLogic Server to Run in en_US Locale

- 41.10.1.12 Search May Return Incorrect Number of Results

- 41.10.1.13 Schedule Report Option Does Not Appear Correctly for Non-Admin Users

- 41.10.2 Oracle BI Publisher Security Issues and Workarounds

- 41.10.2.1 Limitations for Administrator Username in LDAP Security Model

- 41.10.3 Oracle BI Publisher Delivery Manager Issues and Workarounds

- 41.10.4 Oracle BI Publisher Scheduler Issues and Workarounds

- 41.10.4.1 Scheduler Does Not Support Multibyte Characters When Schema Installed on Microsoft SQL Server

- 41.10.4.2 URL in E-mail Notification of Recurring or Future-Dated Jobs May Fail to Display Job History for the Job

- 41.10.5 Oracle BI Publisher RTF Template Issues and Workarounds

- 41.10.5.1 RTF Templates in 11g Require Number Conversion on String Expressions

- 41.10.6 Oracle BI Publisher Excel Template Issues and Workarounds

- 41.10.6.1 Limitations for Excel Template Output on Apple iPad

- 41.10.7 Oracle BI Publisher Desktop Tools Issues and Workarounds

- 41.10.7.1 Oracle BI Publisher's Template Builder for Microsoft Word Is Not Compatible with Microsoft Office Live Add-in

- 41.10.7.2 Excel Analyzer Does Not Support 64-Bit Windows Platform

- 41.10.8 Oracle BI Publisher Layout Editor Issues and Workarounds

- 41.10.8.1 Editing an XPT Layout and Clicking Return in Layout Editor Results in Exception

- 41.10.9 Oracle BI Publisher Data Model Issues and Workarounds

- 41.10.9.1 Data Model Is Not Editable When Created by Upgrade Assistant

- 41.10.9.2 After Editing a View Object Data Set, the Elements Are Duplicated

- 41.10.10 Oracle BI Publisher Report Building Issues and Workarounds

- 41.10.10.1 No Direct Conversion Between Oracle Reports and Oracle BI Publisher 11g

- 41.10.11 Oracle BI Publisher Documentation Errata

- 41.10.11.1 Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher

- 41.10.11.2 Oracle Fusion Middleware Administrator's Guide for Oracle Business Intelligence Publisher

- 41.11 Oracle Business Intelligence Metadata Repository Development Issues and Workarounds

- 41.11.1 General Metadata Repository Development Issues and Workarounds

- 41.11.1.1 Use of NQClient (BI ODBC Client) Utility Is Deprecated

- 41.11.1.2 Update Logical Table Source Modeling when Using paint.rpd for Testing

- 41.11.1.3 FIRST and LAST Aggregation Rules Cause Inconsistent Sorting for Time Dimensions

- 41.11.1.4 Oracle OLAP Jars on JavaHost Computer Must Be Updated When Using Oracle OLAP 11.2.x

- 41.11.1.5 Must Use JDBC Connection String When Importing from Oracle OLAP

- 41.11.2 Oracle BI Server Issues and Workarounds

- 41.11.2.1 Oracle Call Interface (OCI) Issue Causes Oracle BI Server Crash on Windows when Under Heavy Load and Connecting to Oracle Database 11g

- 41.11.3 Oracle BI Administration Tool Issues and Workarounds

- 41.11.3.1 Administration Tool Incorrectly Displays Option for Generate Deployment File

- 41.11.3.2 Issue with Online Import Object Checkout

- 41.11.3.3 Ignore RPD Consistency Warnings Related to Required Database Feature Changes for Oracle OLAP

- 41.11.3.4 Select Nullable Option for Root Member of Parent-Child Hierarchies from OLAP Sources

- 41.11.3.5 The Administration Tool Fails to Launch from the Start Menu

- 41.12 Oracle Business Intelligence System Administration Issues and Workarounds

- 41.12.1 General System Administration Issues and Workarounds

- 41.12.2 Configuration Issues and Workarounds

- 41.12.2.1 Removal of DefaultImageType and HardenXSS Elements

- 41.12.3 Deployment, Availability, and Capacity Issues and Workarounds

- 41.12.4 Sign-in and Security Issues and Workarounds

- 41.12.4.1 Permission Required to Open Catalog Manager in Online Mode

- 41.12.5 Oracle BI Scheduler Issues and Workarounds

- 41.13 Oracle Business Intelligence Integration and API Issues and Workarounds

- 41.13.1 General Integration Issues and Workarounds

- 41.13.2 Oracle Business Intelligence API Issues and Workarounds

- 41.14 Oracle Exalytics In-Memory Machine Issues and Workarounds

- 41.14.1 Manually Editing Properties for Full-Text Search

- 41.15 Oracle Business Intelligence Localization Issues and Workarounds

- 41.15.1 Product Localization Issues and Workarounds

- 41.15.1.1 Unable to Save Strings with Multibyte Characters to an External File Using ANSI Encoding

- 41.15.1.2 BI Publisher User Interface Components Do Not Support Supplementary Characters

- 41.15.1.3 Non-English Log Files Displayed Incorrectly in Fusion Middleware Control

- 41.15.1.4 Error Messages in BI Publisher Data Model Editor Honor Server Locale Setting

- 41.15.1.5 Incorrect Layout in Tables and Pivot Tables in PDF Files and PowerPoint Presentations When Locale for BI Server Is Arabic or Hebrew

- 41.15.1.6 Excel2007 Output in BI Publisher Does Not Honor Locale Settings for Number and Date Format

- 41.15.1.7 Excel2007 Output in BI Publisher Supports Gregorian Calendar Only

- 41.15.1.8 Template Builder for Microsoft Word Chart Wizard Does Not Format Dates

- 41.15.1.9 Number and Date Format Issues with Charts in BI Publisher Layout Templates

- 41.15.2 Help System Localization Issues and Workarounds

- 41.15.2.1 Oracle Business Intelligence Help Systems Are Not Translated

- 41.16 Oracle Business Intelligence Documentation Errata

- 41.16.1 General Oracle Business Intelligence Documentation Errata

- 41.16.2 Oracle Fusion Middleware Quick Installation Guide for Oracle Business Intelligence

- 41.16.3 Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence

- 41.16.3.1 List of Supported Oracle BI Client Tools for Microsoft Windows x64

- 41.16.3.2 Installation Guide Contains Misinformation About Installing the Client Tools

- 41.16.4 Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.5 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.5.1 Oracle BI Mobile: Embedding a Dashboard or Answers Report Link in an E-mail

- 41.16.5.2 Oracle BI Mobile: Easy Access to Dashboards

- 41.16.5.3 Information about Oracle Hyperion Smart View for Office Must Be Ignored

- 41.16.5.4 Columns from Multiple Subject Areas Included in a Single Query Must Be Compatible

- 41.16.5.5 Error in the "How Will Prompts Created in Previous Versions Be Upgraded?" Topic in Chapter 6, "Prompting in Dashboards and Analyses"

- 41.16.5.6 Content Missing from Appendix E, "User Interface Reference," "Edit Page Settings dialog" Topic, Prompt Buttons Field

- 41.16.5.7 Incorrect Default Pixel Value Specified in Chapter 6, "Prompting in Dashboards and Analyses" and Appendix E, "User Interface Reference"

- 41.16.5.8 Error in the "Actions that Invoke Operations, Functions or Processes in External Systems" Topic in Chapter 10, "Working with Actions"

- 41.16.5.9 Error in the "Show More Columns dialog" Topic in Appendix E, "User Interface Reference"

- 41.16.5.10 Error in the "New Filter dialog" Topic in Appendix E, "User Interface Reference"

- 41.16.5.11 Information on View Latest Version Feature in Error

- 41.16.6 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Mobile

- 41.16.7 Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.7.1 Important Changes to Essbase Preconfiguration Instructions

- 41.16.7.2 Manual opmn.xml Edits Needed to Use Teradata as a Data Source

- 41.16.7.3 Updates to Text for Consistency Check Warnings 39009 and 39059

- 41.16.7.4 Other Changes to List of New Consistency Check Warnings

- 41.16.7.5 Select the Virtual Private Database Option when Authenticating Against Essbase or Hyperion Financial Management Using a Shared Token

- 41.16.7.6 Manually Updating the Master MUD Repository

- 41.16.7.7 Configuration Required for Client Installations of the Administration Tool to Perform Offline Imports from Oracle OLAP and Hyperion Financial Management Data Sources

- 41.16.7.8 Database Client Installation Required for Client Installations of the Administration Tool when Importing from Oracle Database and Oracle OLAP Sources

- 41.16.7.9 Initialization Block Failure at Server Start-Up Causes Connection Pool to be Blacklisted

- 41.16.7.10 Merge Local Changes Step Does Not Lock the Master Repository

- 41.16.7.11 Information Now Available for All Import Metadata Wizard Screens

- 41.16.7.12 Remove Smart View Mention in Appendix C

- 41.16.8 Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.8.1 Event Polling Tables Must Be Created Using the Repository Creation Utility (RCU)

- 41.16.8.2 Use of ps: Prefix in Elements Is Unnecessary

- 41.16.8.3 Removal of Section 11.5, "Configuring to Download Oracle Hyperion Smart View for Office"

- 41.16.8.4 Error for Configuring the Data Source for the Full-Text Catalog Search

- 41.16.8.5 Removal of Section 19.7.2.6, "Including Links with Analyses on Dashboards"

- 41.16.8.6 MaxColumns Element Not Supported

- 41.16.8.7 Error in Section 22.3.2, "Specifying Defaults for Styles and Skins"

- 41.16.8.8 Clarification of CaseInsensitiveMode Element

- 41.16.8.9 Updates of Information About the Catalog

- 41.16.9 Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.9.1 SASchInvoke Always Prompts for the Password in 11.1.1.5

- 41.16.9.2 Setup Multiple Authentication Providers

- 41.16.9.3 Error in Code Example for Refreshing User GUIDs

- 41.16.10 Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence

- 41.16.11 Oracle Fusion Middleware Developer's Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.11.1 Error in the "Passing Business Intelligence Content with the Oracle BI EE Contextual Event Action" Topic in Chapter 1, "Embedding Business Intelligence Objects in ADF Applications"

- 41.16.12 Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition

- 41.16.13 Oracle Fusion Middleware Installation and Administration Guide for Oracle Exalytics In-Memory Machine Guide

- 41.16.14 Oracle Fusion Middleware XML Schema Reference for Oracle Business Intelligence Enterprise Edition

- 41.16.15 Oracle Business Intelligence Help System Errata

- 41.16.15.1 Incorrect Statement on Source Control Management and Multiuser Development in Administration Tool Online Help

42 Oracle Business Intelligence Applications and Data Warehouse Administration Console

- 42.1 Oracle Business Intelligence Applications Release Notes

- 42.1.1 Oracle Business Intelligence Issues and Workarounds Identified Since the Previous Revision

- 42.1.2 General Issues and Workarounds for Oracle Business Intelligence

- 42.1.2.1 About Issues For Both Oracle Fusion Transactional Business Intelligence and Oracle Business Intelligence Applications

- 42.1.2.2 CONFIGURE_RPD.PY Script Does Not Set Connection Pool for Oracle BI Applications Configuration Manager

- 42.1.3 Installation Issues and Workarounds for Oracle Business Intelligence

- 42.1.4 Upgrade Issues and Workarounds for Oracle Business Intelligence

- 42.1.5 Oracle Business Intelligence Offering/Module-specific Issues

- 42.1.5.1 Issues for Oracle Customer Data Management Analytics Offering

- 42.1.5.2 Issues for Oracle Financial Analytics Offering

- 42.1.5.3 Issues for Oracle Human Resources Analytics Offering

- 42.1.5.4 Issues for Oracle Marketing Analytics Offering

- 42.1.5.5 Issues for Oracle Partner Analytics Offering

- 42.1.5.6 Issues for Oracle Product Information Management Analytics Offering

- 42.1.5.7 Issues for Oracle Procurement and Spend Analytics Offering

- 42.1.5.8 Issues for Oracle Project Analytics Offering

- 42.1.5.9 Issues for Oracle Sales Analytics Offering

- 42.1.5.10 Issues for Oracle Supply Chain and Order Management Analytics Offering

- 42.1.6 Oracle Business Intelligence Configuration Manager and FSM Issues

- 42.1.7 Security-related Issues for Oracle Business Intelligence Applications

- 42.1.8 Oracle Business Intelligence Documentation Errata

- 42.1.8.1 General Oracle Business Intelligence Documentation Errata

- 42.1.8.2 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Applications

- 42.1.8.3 Oracle BI Applications Configuration Manager Help System

- 42.1.8.4 Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications

- 42.2 Oracle Business Intelligence Data Warehouse Administration Console (DAC) Platform Release Notes

- 42.2.1 DAC Issues and Workarounds Identified Since the Previous Revision

- 42.2.2 DAC General Issues and Workarounds

- 42.2.3 DAC Installation Issues and Workarounds

- 42.2.4 DAC Upgrade Issues and Workarounds

- 42.2.5 DAC Documentation Errata

- 42.2.5.1 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Data Warehouse Administration Console

- 42.2.5.2 DAC Client Help System

- 42.3 Patch Requirements for Oracle Business Intelligence Applications and DAC

43 Oracle Real-Time Decisions

- 43.1 Oracle RTD General Issues and Workarounds

- 43.1.1 Transient Likelihood Problems

- 43.1.2 Use Development Deployment State Only

- 43.1.3 Error Deploying Inline Services from Command Line if Inline Service Uses Certain Functions

- 43.1.4 Ensuring Unique Batch Names Across a Cluster

- 43.2 Oracle RTD Installation Issues and Workarounds

- 43.3 Oracle RTD Upgrade Issues and Workarounds

- 43.4 Oracle RTD Configuration Issues and Workarounds

- 43.5 Oracle RTD Security Issues and Workarounds

- 43.5.1 Decision Center Logout Not Redirected Correctly for Oracle Access Manager (OAM) 11g Form-Based Authentication

- 43.6 Oracle RTD Administration Issues and Workarounds

- 43.7 Oracle RTD Integration Issues and Workarounds

- 43.7.1 Java Smart Client Run Configuration Changes Required for Different Properties Files

- 43.8 Oracle RTD Decision Studio Issues and Workarounds

- 43.8.1 Mapping Array Attributes in a Multi-Level Entity Hierarchy

- 43.8.2 Issues When Trying to Enable Caching for Some Entities

- 43.8.3 Terminate Active Sessions in Cluster Works Only on Decision Server Receiving Deployment Request

- 43.9 Oracle RTD Decision Center Issues and Workarounds

- 43.10 Oracle RTD Performance Monitoring Issues and Workarounds

- 43.11 Oracle RTD Externalized Objects Management Issues and Workarounds

- 43.12 Oracle RTD Localization Issues and Workarounds

- 43.13 Oracle RTD Documentation Errata

- 43.13.1 Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions

- 43.13.2 Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions

- 43.13.2.1 External Rules Development Helper Mismatch between Code and Manual Description

- 43.13.2.2 Save Choice IDs in Inline Services Rather Than Choices

- 43.14 Oracle RTD Third-Party Software Information

- 43.14.1 Displaytag Download Location

Oracle® Fusion Middleware

Release Notes

11g Release 1 (11.1.1) for Microsoft Windows x64 (64-Bit)

E14774-32

January 2012

Oracle Fusion Middleware Release Notes, 11g Release 1 (11.1.1) for Microsoft Windows x64 (64-Bit)

E14774-32

Copyright © 2012, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Preface

This preface includes the following sections:

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

Audience

This document is intended for users of Oracle Fusion Middleware 11g.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information, see these Oracle resources:

- Oracle Fusion Middleware Documentation on Oracle Fusion Middleware Disk 1

- Oracle Fusion Middleware Documentation Library 11g Release 1 (11.1.1)

- Oracle Technology Network at http://www.oracle.com/technetwork/index.html.

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

Part I

Oracle Fusion Middleware

Part I contains the following chapters:

- Chapter 1, "Introduction"

- Chapter 2, "Installation, Patching, and Configuration"

- Chapter 3, "Upgrade"

- Chapter 4, "Oracle Fusion Middleware Administration"

- Chapter 5, "Oracle Enterprise Manager Fusion Middleware Control"

- Chapter 6, "Oracle Fusion Middleware High Availability and Enterprise Deployment"

1 Introduction

This chapter introduces Oracle Fusion Middleware Release Notes, 11g Release 1 (11.1.1). It includes the following topics:

- Section 1.1, "Latest Release Information"

- Section 1.2, "Purpose of this Document"

- Section 1.3, "System Requirements and Specifications"

- Section 1.4, "Memory Requirements"

- Section 1.5, "Certification Information"

- Section 1.6, "Downloading and Applying Required Patches"

- Section 1.7, "Licensing Information"

1.1 Latest Release Information

This document is accurate at the time of publication. Oracle will update the release notes periodically after the software release. You can access the latest information and additions to these release notes on the Oracle Technology Network at:

http://www.oracle.com/technetwork/indexes/documentation/index.html

1.2 Purpose of this Document

This document contains the release information for Oracle Fusion Middleware 11g Release 1 (11.1.1). It describes differences between Oracle Fusion Middleware and its documented functionality.

Oracle recommends you review its contents before installing, or working with the product.

1.3 System Requirements and Specifications

Oracle Fusion Middleware installation and configuration will not complete successfully unless users meet the hardware and software pre-requisite requirements before installation.

For more information, see "Review System Requirements and Specifications" in the Oracle Fusion Middleware Installation Planning Guide

1.4 Memory Requirements

Oracle Fusion Middleware memory requirements for installation, configuration, and run time are as follows:

1. Without a Database on the same server: Minimum 6 GB physical memory.

2. With a Database on the same server: Minimum 8 GB physical memory.

Note:

These minimum memory values are with the assumption that no user or operating system process is consuming any unusually high amount of memory. If such a condition exists, corresponding amount of additional physical memory will be required.

1.5 Certification Information

This section contains the following:

- Section 1.5.1, "Where to Find Oracle Fusion Middleware Certification Information"

- Section 1.5.2, "Certification Exceptions"

- Section 1.5.3, "Upgrading Sun JDK From 1.6.0_07 to 1.6.0_11"

- Section 1.5.4, "JMSDELIVERYCOUNT Is Not Set Properly"

- Section 1.5.5, "Viewer Plugin Required On Safari 4 To View Raw XML Source"

1.5.1 Where to Find Oracle Fusion Middleware Certification Information

The latest certification information for Oracle Fusion Middleware 11g Release 1 (11.1.1) is available at the Oracle Fusion Middleware Supported System Configurations Central Hub:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

1.5.2 Certification Exceptions

This section describes known issues (exceptions) and their workarounds that are associated with Oracle Fusion Middleware 11g certifications. For a list of known issues that are associated with specific Oracle Fusion Middleware 11g Release 1 (11.1.1) components, see the Release Notes for the specific Oracle Fusion Middleware 11g Release 1 (11.1.1) component.

This section contains the following topics:

- Section 1.5.2.1, "Certification Information for Oracle Fusion Middleware 11g R1 with Oracle Database 11.2.0.1"

- Section 1.5.2.2, "Excel Export Issue on Windows Vista Client"

- Section 1.5.2.3, "Oracle Forms and Oracle Reports 11g Installer Issues In Windows Vista and Windows XP"

- Section 1.5.2.4, "Restrictions on Specific Browsers"

1.5.2.1 Certification Information for Oracle Fusion Middleware 11g R1 with Oracle Database 11.2.0.1

If you choose to configure Oracle Internet Directory with Database vault, do the following:

1. Apply patch 8897382 to fix bug 8897382.

Note:

the following workaround is required only if the Oracle Fusion Middleware version is 11.1.1.1.0 (11gR1). This issue will be fixed in 11.1.1.2.0.

2. Apply the workaround for bug 8987186 by editing <OH>/ldap/datasecurity/dbv_oid_command_rules.sql file and find the following declaration:

/declare
begin
dvsys.dbms_macadm.CREATE_COMMAND_RULE(
command => 'CONNECT'
,rule_set_name => 'OID App Access'
,object_owner => 'ODS'
,object_name => '%'
,enabled => 'Y');
commit;
end;/

and change the line that is indicated in bold:

/declare
begin
dvsys.dbms_macadm.CREATE_COMMAND_RULE(
command => 'CONNECT'
,rule_set_name => 'OID App Access'
,object_owner => '%'
,object_name => '%'
,enabled => 'Y');
commit;
end;/

1.5.2.2 Excel Export Issue on Windows Vista Client

Vista prevents applets from creating files in the local file system if the User Account Control (UAC) system is turned on. You can experience this problem if you have the UAC setting enabled on Vista and if you use a component like Discoverer Plus. If you start Discoverer Plus and if you try exporting a worksheet to a specified directory, the exporting succeeds but you cannot see the exported file in the directory. The available workarounds is to disable UAC and set protection mode to OFF. Refer to Bugs 8410655 and 7328867 for additional information.

1.5.2.3 Oracle Forms and Oracle Reports 11g Installer Issues In Windows Vista and Windows XP

Only the design-time environments (Builders) are supported for Oracle Forms and Oracle Reports in Windows Vista and Windows XP.However, in the Configure Components screen in the Oracle Installer, the Server Components, Management Components and System Components are selected by default, but Developer Tools is deselected. When installing Oracle Forms Builder, or Oracle Reports Builder on Windows Vista and Windows XP computers, you must:

- Select Developer Tools, such as Oracle Forms Builder or Oracle Reports Builder. Their respective server components are automatically selected.

- Deselect all System Components and Management Components.

- Deselect the Portal and Discoverer tools. Two of the Discoverer components – Discoverer Admin and Discoverer Desktop – will be installed even if you do not select Discoverer in the Configure Components screen of the installer. This is the correct, expected behavior in 11.1.1.1.0.

For Oracle Forms, since the System Components including Oracle HTTP Server are not supported in Windows Vista and Windows XP, the following features are not supported:

1. Oracle Forms and Reports integration.

2. The creation of virtual directories.

1.5.2.4 Restrictions on Specific Browsers

1.5.2.4.1 Internet Explorer Browser Goes Blank When Adding Portlets in Oracle Webcenter

If you add portlets in Oracle Webcenter by using Internet Explorer, then the page can go blank. When it does go blank, a download message appears on the browser's status bar. However, nothing is downloaded and the browser remains blank untill you click the browser's back button. If this problem occurs, the portlets will appear only when you hit the browser's back button. This issue does not occur with Firefox.

As a workaround, click the browser's back button.

1.5.2.4.2 Unable to View the Output of a JSPX Page in Internet Explorer 7

When a JSPX page is deployed and is then accessed using Internet Explorer 7 (IE7), the XHTML source is displayed instead of the page contents. This occurs in both normal and osjp.next modes.

The workaround is to instruct application users to access the application with Firefox or Safari.

1.5.2.4.3 Unable to View the Output of SVG files in Internet Explorer 7

When a page using Scalar Vector Graphics is deployed and is then accessed using Internet Explorer 7 (IE7), the source is displayed instead of the page's graphic contents. This occurs in both normal and osjp.next modes.

The workaround for this issue is that Application developers should avoid using SVG graphics in their applications, as it is not natively supported in IE7. If they are used, a warning similar to the following should be added:

All current browsers, with the exception of Internet Explorer, support SVG files. Internet Explorer requires a plug-in to display SVG files. The plug-ins are available for free, for example, the Adobe SVG Viewer at http://www.adobe.com/svg/viewer/install/.

1.5.2.4.4 Java Plugin for Discoverer Plus Not Downloaded Automatically on Firefox

When you attempt to connect to Discoverer Plus by using the Mozilla Firefox browser on a computer that does not have Java 1.6 installed, Firefox does not download the JRE 1.6 plug-in automatically. Instead, Firefox displays the following message: "Additional plugins are required to display this page..."

The workaround is to download the JRE 1.6 plug-in by clicking the Install Missing Plugin link to install it manually.

1.5.3 Upgrading Sun JDK From 1.6.0_07 to 1.6.0_11

For information, see "Section 2.1.5.2, "Upgrading Sun JDK in the Oracle Home Directory."

1.5.4 JMSDELIVERYCOUNT Is Not Set Properly

When using AQ JMS with Oracle Database 11.2.0.1, JMXDELIVERYCOUNT is not set correctly.

The workaround is to apply patch 9932143 to Oracle Database 11.2.0.1. For more information, contact Oracle Support.

1.5.5 Viewer Plugin Required On Safari 4 To View Raw XML Source

You need a Safari plugin to view raw XML. If there is no plugin installed, you will see unformatted XML which will be difficult to read. This is because Safari applies a default stylesheet, which only displays the text nodes in the XML document.

As a workaround, go to View > View Source in the Safari menu bar to see the full XML of the metadata document. Also, selecting File > Save and choosing XML Files as the file type, will correctly save the XML metadata file with all the markup intact.

1.6 Downloading and Applying Required Patches

After you install and configure Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0), there might be cases where additional patches are required to address specific known issues.

Patches for Oracle Fusion Middleware 11g are available from My Oracle Support:

https://myoraclesupport.com/

Table 1-1 lists some of the specific Oracle Fusion Middleware patches that were available at the time these release notes were published.

For additional patching information, see Section 3.1.1, "Patches Required to Address Specific Upgrade and Compatibility Requirements".

Table 1-1 Patches Required to Fix Specific Issues with Oracle Fusion Middleware 11g

Oracle Fusion Middleware Product or Component

Bug/Patch Number

Description

Oracle SOA Suite - Oracle BPM Worklist application

9901600

Unless you apply this patch, errors appear in the log files when you access the Event Driven page in the Oracle Business Process Management Worklist application.

Oracle XDK for Java

10337609

This patch fixes the following issue.

If you use the XSU utility to insert some data into the database, and the database connection had the connection property called oracle.jdbc.J2EE13Compliant set to "true", and the target column was some kind of numeric column, then it is possible for the insert to fail with a the following error:

java.lang.NumberFormatException

1.7 Licensing Information

Licensing information for Oracle Fusion Middleware is available at:

http://oraclestore.oracle.com

Detailed information regarding license compliance for Oracle Fusion Middleware is available at:

http://www.oracle.com/technetwork/middleware/ias/overview/index.html

2 Installation, Patching, and Configuration

This chapter describes issues associated with Oracle Fusion Middleware installation, patching, and configuration. It includes the following topics:

- Section 2.1, "Installation Issues and Workarounds"

- Section 2.2, "Patching Issues and Workarounds"

- Section 2.3, "Configuration Issues and Workarounds"

- Section 2.4, "Known Issues"

- Section 2.5, "Documentation Errata"

Note:

This chapter contains issues you might encounter while installing, patching, or configuring any of the Oracle Fusion Middleware products.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

2.1 Installation Issues and Workarounds

This section describes installation issue and workarounds. It includes the following topics:

- Section 2.1.1, "Oracle SOA Suite Installation Issues"

- Section 2.1.2, "Oracle Portal, Forms, Reports and Discoverer Installation Issues"

- Section 2.1.9, "Deinstallation Issues"

- Section 2.1.10, "Installing Oracle Service Registry in the Same Domain as Oracle SOA Suite"

- Section 2.1.11, "Problems Installing in Thai and Turkish Locales"

- Section 2.1.12, "Enterprise Manager Configuration Fails with Timezone Error Message"

2.1.1 Oracle SOA Suite Installation Issues

This section contains installation issues pertaining to Oracle SOA Suite:

- Section 2.1.1.2, "Installing Oracle SOA Suite Release 11.1.1.3.0 in a Turkish Environment"

2.1.1.1 Installing Oracle SOA Suite on a Dual Stack Host with IPv4

If you install Oracle SOA Suite on a dual stack host and the SOA front end URL is only set to IPv4, Oracle BPM Worklist or asynchronous callbacks from IPv6-only clients may have problems resolving IPv4 callback URLs (and vice-versa).

The work around is to use either a split Domain Name System (DNS) or another forward proxy configuration. This enables the IPv6-only client to connect to a dual stack box through its IPv6 interface.

2.1.1.2 Installing Oracle SOA Suite Release 11.1.1.3.0 in a Turkish Environment

If you are installing Oracle SOA Suite Release 11.1.1.3.0 in a Turkish environment, there will be some functionality loss for Oracle Enterprise Manager Fusion Middleware Control.

There is no work around for this issue. Oracle recommends that you avoid installing in a Turkish environment and install in an English environment instead.

2.1.2 Oracle Portal, Forms, Reports and Discoverer Installation Issues

This section contains installation issues pertaining to Oracle Portal, Reports, Forms and Discoverer:

- Section 2.1.2.1, "Installing Oracle Portal, Forms, Reports and Discoverer on Windows with IPv6"

- Section 2.1.2.2, "Missing Shortcuts in the Oracle Portal, Forms, Reports and Discoverer Installation"

- Section 2.1.2.3, "Prerequisite Warnings During Installation"

2.1.2.1 Installing Oracle Portal, Forms, Reports and Discoverer on Windows with IPv6

If you are installing Oracle Portal, Forms, Reports and Discoverer on a Windows operating system that supports IPv6 (for example, Windows Vista or Windows 7), the components in the installation will not start if IPv6 is enabled.

Make sure that IPv6 is disabled on your Windows operating system before you install these components.

2.1.2.2 Missing Shortcuts in the Oracle Portal, Forms, Reports and Discoverer Installation

During the installation of Oracle Portal, Forms, Reports and Discoverer on any Windows operating system, if you choose to extend your domain or expand a cluster and specify a domain name other than the default "ClassicDomain," you will see a "Missing Shortcut" error when you try to start and stop the Managed Servers.

The work around for this issue is as follows:

1. From the Start menu, right-click on the shortcut that generated the error message.

2. In the shortcut tab, go to the target node.

3. Change the domain name to the correct domain name.

4. Click Apply.

2.1.2.3 Prerequisite Warnings During Installation

Vendor release updates cummulative patches and/or packages that may superseed our listed Oracle Fusion Middleware 11g Release 1 prerequisites for platforms. As long as vendor approved patches and/or packages are installed, the prerequisite warnings could be ignored and the installation completed.

Another option is to use -ignoreSysPreReqs command line additional argument to the runInstaller as:

$  Mount_Point/runInstaller -ignoreSysPreReqs other required install options

2.1.3 Oracle Web Tier Installation Issues

This section contains installation issues pertaining to Oracle Web Tier:

- Section 2.1.3.1, "Oracle SOA Suite and Oracle Application Developer Must Be Installed Before Oracle Web Tier"

- Section 2.1.3.2, "Re-Installing Oracle Web Cache if Double Backslashes (\\) Are Specified During Installation"

- Section 2.1.3.3, "Oracle Web Tier Silent Install Requires Oracle Web Cache Component Name"

2.1.3.1 Oracle SOA Suite and Oracle Application Developer Must Be Installed Before Oracle Web Tier

To ensure that the oracle_common/soa/modules/commons-cli-1.1.jar (on UNIX operating systems) or oracle_common\soa\modules\commons-cli-1.1.jar (on Windows operating systems) file is installed properly, if you plan to associate Oracle Web Tier with an existing domain, you must install Oracle Web Tier after all other products are installed.

2.1.3.2 Re-Installing Oracle Web Cache if Double Backslashes (\\) Are Specified During Installation

During the installation of Oracle Web Tier on Microsoft Windows operating systems, if you accidentally specified an installation directory using double backslash (\\) characters, you will encounter problems when you try to start Oracle Web Cache.

The work around is to re-install Oracle Web Cache without using double backslash characters in the installation location.

2.1.3.3 Oracle Web Tier Silent Install Requires Oracle Web Cache Component Name

If you are performing a silent Oracle Web Tier installation for Oracle HTTP Server, an Oracle Web Cache component name (WEBCACHE_COMPONENT_NAME parameter) must also be mentioned in the response file, even though Oracle Web Cache is not required for Oracle HTTP Server installation. Even though both component names are provided, as long as CONFIGURE_WEBCACHE is set to false then only Oracle HTTP Server will be installed and configured.

There is no work around for this issue.

2.1.4 Oracle Identity Management Installation Issues

This section contains installation issues pertaining to Oracle Identity Management:

- Section 2.1.4.1, ""Null" Dialog Box Appears When Installing Oracle Identity Management to FAT32 File System on Windows"

- Section 2.1.4.2, "WebLogic Administration Server Must Be Running When Extending Oracle Identity Management Domains"

- Section 2.1.4.3, "Do Not Install Patch 9824531 During the Setup of OIM and OAM Integration"

- Section 2.1.4.4, "Welcome Screen of Oracle Entitlements Server Installer Not Translated"

- Section 2.1.4.5, "Additional Information When Using a Java Security Module with Oracle Entitlements Server"

2.1.4.1 "Null" Dialog Box Appears When Installing Oracle Identity Management to FAT32 File System on Windows

If you install the Oracle Home directory to a File Allocation Table 32 (FAT32) file system during Oracle Identity Management installation, a pop-up dialog box containing the following text appears on the Specify Installation Location screen:

null

null

null

The following is the dialog box text that is hidden by the erroneous "null null null" message:

The Windows FAT file system allows any user to create, modify and delete all files
on the file system. Oracle recommends use of NTFS on windows operating systems
because it preserves permission restrictions on files. Do you want to Continue?

To work around this issue, click Yes on the dialog box to continue the installation, or click No to cancel the installation.

2.1.4.2 WebLogic Administration Server Must Be Running When Extending Oracle Identity Management Domains

When you install Oracle Identity Management, you have several options for choosing how the Oracle Identity Management components are installed in relation to an Oracle WebLogic Server administration domain. If you select the Extend Existing Domain option on the installer's Select Domain screen, Oracle Identity Management components are installed in an existing Oracle WebLogic Server administration domain.

To install Oracle Identity Management components in an existing administration domain using the Extend Existing Domain option, the Oracle WebLogic Administration Server instance must be running.

2.1.4.3 Do Not Install Patch 9824531 During the Setup of OIM and OAM Integration

In the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, Step 10 in the section titled "Setting Up Integration Between OIM and OAM Using the Domain Agent" instructs users about installing Patch 9824531.

Do not install this patch.

Note that you must download and install the following patches instead of Patch 9824531:

- Patch 9674375

- Patch 9817469

- Patch 9882205

You can download these patches from My Oracle Support.

2.1.4.4 Welcome Screen of Oracle Entitlements Server Installer Not Translated

When you are installing Oracle Entitlements Server in a non-English environment, the text on the Welcome screen does not appear in the selected language. This is a known problem that will be addressed in a future release.

2.1.4.5 Additional Information When Using a Java Security Module with Oracle Entitlements Server

The section, "Using the Java Security Module" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, describes how to configure and use a Java security module with Oracle Entitlements Server.

In addition to the information provided in the installation guide, consider the following additional information when configuring the security module:

When a Security Module is configured as a proxy client, set the authentic.identity.cache.enabled system property to true. The configuration is based on the type of Security Module being used and is done for the JVM in which the Web Services or RMI Security Module remote proxy is executing.

Specifically:

- If the Security Module is a WebLogic Server Security Module, the system property -Dauthentic.identity.cache.enabled=true should be appended to the JAVA_OPTIONS environment variable in the setDomainEnv.sh script on Unix or the setDomainEnv.cmd script on Windows.

- If the Security Module is a Java Security Module, the system property -Dauthentic.identity.cache.enabled=true should be added to the program being protected by the Java Security Module.

2.1.5 JDK and JRE Installation Issues

This section contains installation issues pertaining to JDKs and JREs during installation:

- Section 2.1.5.1, "Specifying the JRE Location if Installing with Automatic Updates"

- Section 2.1.5.2, "Upgrading Sun JDK in the Oracle Home Directory"

- Section 2.1.5.3, "Out of Memory Errors When Using JDK 6 Update 23"

2.1.5.1 Specifying the JRE Location if Installing with Automatic Updates

If you are installing one of the following Oracle Fusion Middleware products:

- Oracle SOA Suite

- Oracle WebCenter Portal

- Oracle Service Bus

- Oracle WebCenter Content

- Oracle Data Integrator

- Oracle Identity and Access Management

And you will choose to configure automatic updates on the Install Software Updates screen by selecting Download and install updates from My Oracle Support you must specify the location of a JRE on your system by using the -jreLoc parameter from the command line when you start the installer.

If you do not use the -jreLoc parameter and instead wait for the installer to prompt you for a JRE location, an exception will be seen during the installation.

2.1.5.2 Upgrading Sun JDK in the Oracle Home Directory

Certain installations, including Oracle Identity Management, Oracle Portal, Forms, Reports and Discoverer, and Oracle Web Tier will install a Sun JDK in the Oracle home directory. This version of the Sun JDK may be lower in version than what is specified in the Oracle Fusion Middleware Certification Document:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

This JDK is used internally and should not be used to deploy Oracle SOA, Oracle WebCenter Portal, or any custom J2EE applications.

If you want a single JDK version deployed for all types of applications, you can upgrade the Sun JDK to a higher version (as specified in the Oracle Fusion Middleware Certification document) using the following steps:

1. Shut down all processes.

2. Back up your existing JDK.

3. Install a new JDK in the same location as your existing JDK.

4. Restart all processes.

2.1.5.3 Out of Memory Errors When Using JDK 6 Update 23

If you are experiencing out-of-memory errors when using JDK 6 Update 23, consider the following.

In JDK 6 Update 23, the escape analysis feature was enabled by default. Escape analysis is used when optimizing the code run inside the JVM. Due to a bug in escape analysis the memory footprint increased which could lead to OutOfMemoryErrors being thrown when the application runs out of memory.

The workaround for this issue is to add the following JVM argument when you start your application:

-XX:-DoEscapeAnalysis

A fix for this issue is being prepared and will be rolled into the next scheduled regular update release of the Oracle JDK.

You can identify JDK 6 Update 23 by using the java -version command, as follows:

java -version
java version "1.6.0_24"
Java(TM) SE Runtime Environment (build 1.6.0_24-b50)
Java HotSpot(TM) Server VM (build 19.1-b02, mixed mode)

2.1.6 Oracle Universal Installer Issues

This section contains installation issues pertaining to the product installers:

- Section 2.1.6.1, "Installer Produces Errors When Checking for Software Updates on My Oracle Support"

- Section 2.1.6.2, "Running the Installer From C:\Documents and Settings When C:\Documents Also Exists"

2.1.6.1 Installer Produces Errors When Checking for Software Updates on My Oracle Support

On the Install Software Updates screen, if you select the Search My Oracle Support for Updates option, provide the proper user credentials, and then click Search for Updates, the following error is seen in the installation log file:

java.net.NoRouteToHostException: No route to host

The work around is to use the Search Local Directory for Updates option on the Install Software Update screen and select a patch that has already been downloaded and is available locally. Patches can be downloaded manually from My Oracle Support or they can be obtained from your Oracle Support representative.

2.1.6.2 Running the Installer From C:\Documents and Settings When C:\Documents Also Exists

If you have downloaded the setup.exe installer in the C:\Document and Settings directory, and there is also the C:\Documents directory already present on your system, the installer will not start as it will attempt to locate files in C:\Documents.

The work around is to either remove or rename the C:\Documents directory.

2.1.7 Database and Schema Installation Issues

This section contains installation issues pertaining to databases and schemas:

- Section 2.1.7.1, "Problems with the Oracle Home Directory Being Overwritten on Windows"

- Section 2.1.7.2, "Database Connection Failure During Schema Creation When Installing Oracle Internet Directory"

- Section 2.1.7.3, "Command to Drop Tablespaces and Data Files Does Not Drop Data Files from the File System"

2.1.7.1 Problems with the Oracle Home Directory Being Overwritten on Windows

If you are installing Oracle Fusion Middleware on a Windows system, and that system already contains an Oracle database, then you may encounter issues where the ORACLE_HOME global environment variable used by the database is overwritten by the Oracle Fusion Middleware product installation.

To view the global environment variable, select System Properties > Advanced > Environment variables > System Variables and check the value of ORACLE_HOME. From here, you can set the value of ORACLE_HOME to the location of the desired product.

2.1.7.2 Database Connection Failure During Schema Creation When Installing Oracle Internet Directory

If the installation of Oracle Internet Directory fails due to timeout or connection failure when connecting to a database for schema creation, you can try to reset the timeout parameter in the rcu.properties file. This file is located in the IDM_Home/rcu/config directory on UNIX operating systems. On Windows operating systems, this file is located in the IDM_Home\rcu\config directory.

Open the rcu.properties file in a text editor, search for the property JDBC_LOGIN_TIMEOUT, and set its value to 30.

2.1.7.3 Command to Drop Tablespaces and Data Files Does Not Drop Data Files from the File System

On Windows operating systems, the command used to drop tablespaces and data files does not drop data files from the file system.

This is a known problem specific to Oracle databases running on Windows operating systems.

2.1.8 Error Messages and Exceptions Seen During Installation

This section contains installation issues pertaining to error messages and exceptions seen during installation:

- Section 2.1.8.1, "JRF Startup Class Exceptions May Appear in Oracle WebLogic Managed Server Logs After Extending Oracle Identity Management Domain"

- Section 2.1.8.2, "Sun JDK and Oracle Configuration Manager Failures in the Installation Log File"

2.1.8.1 JRF Startup Class Exceptions May Appear in Oracle WebLogic Managed Server Logs After Extending Oracle Identity Management Domain

After extending an Oracle Identity Management domain, you may see exception messages related to JRF Startup Class in the managed server log files. For example:

Failed to invoke startup class "JRF Startup Class",
oracle.jrf.PortabilityLayerException: Fail to retrieve the property for the Common
Components Home.
oracle.jrf.PortabilityLayerException: Fail to retrieve the property for the Common
Components Home.

You can safely ignore these exception messages—there is no loss in functionality.

2.1.8.2 Sun JDK and Oracle Configuration Manager Failures in the Installation Log File

Upon completing of an Oracle Web Tier, Oracle Identity Management, or Oracle Portal, Forms, Reports and Discoverer installation, the following errors may be seen in the installtime_and_date.log file:

[2009-11-04T21:15:13.959-06:00] [OUI] [NOTIFICATION] [] [OUI] [tid: 16]
[ecid: 0000IJ2LeAeFs1ALJa5Eif1Aw^9l000007,0] OUI-10080:The pre-requisite for
the component Sun JDK 1.6.0.14.08  has failed.

[2009-11-04T21:15:13.960-06:00] [OUI] [NOTIFICATION] [] [OUI] [tid: 16]
[ecid: 0000IJ2LeAeFs1ALJa5Eif1Aw^9l000007,0] OUI-10080:The pre-requisite for
the component Oracle Configuration Manager 10.3.1.2.0  has failed.

These messages occur because the Sun JDK and Oracle Configuration Manager are not installed in the oracle_common directory. You can safely ignore these messages.

2.1.9 Deinstallation Issues

This section contains issues pertaining to product deinstallation:

- Section 2.1.9.1, "Proper Deinstallation for Reinstallation in the Event of a Failed Installation"

- Section 2.1.9.2, "Verify PATH Before Starting Classic Installation on Microsoft Windows x64 (64-Bit)"

- Section 2.1.9.3, "Deinstallation Does Not Remove WebLogic Domains"

2.1.9.1 Proper Deinstallation for Reinstallation in the Event of a Failed Installation

In the event that an installation fails, and you want to deinstall the failed installation and then reinstall the software to the same location, you must do the following:

1. Make sure that all the managed servers in the failed installation are shut down. You must verify this in the Administration Console; the word "SHUTDOWN" must appear next to the managed server name.

2. Deinstall the binaries in the Oracle home directory using the deinstaller in the ORACLE_HOME\oui\bin directory.

3. Delete all the managed servers from the failed installation in the config.xml file by using the Administration Console or WLST.

4. Delete all directories in the DOMAIN_HOME\servers directory:

This procedure will enable you to reinstall the software to the same location, using the same managed server names.

2.1.9.2 Verify PATH Before Starting Classic Installation on Microsoft Windows x64 (64-Bit)

Before starting Classic Application Server installation, any reference to Program Files (x86) must be removed from the PATH environment variable. On echoing PATH on the command prompt, Program Files (x86) should not be present.

2.1.9.3 Deinstallation Does Not Remove WebLogic Domains

There may be certain scenarios where you will need to remove WebLogic Domains that you have created. The Oracle Universal Installer is used to remove Oracle Instances and Oracle home directories only; it does not remove WebLogic Domains.

If you need to remove a WebLogic Domain, you must do so manually. Please refer to your Oracle WebLogic Server documentation for more information.

2.1.10 Installing Oracle Service Registry in the Same Domain as Oracle SOA Suite

When installing Oracle Service Registry 11g in the same Weblogic Domain as Oracle SOA Suite 11g Release 11.1.1.2.0 or Release 11.1.1.3.0, you may see the following error message on the WebLogic Server console when Oracle Service Registry is starting up:

java.lang.LinkageError: loader constraint violation in interface itable
initialization:....

To work around this issue:

1. Make sure Oracle Service Registry is installed on a different Managed Server from Oracle SOA Suite.

2. Download patch 9499508 and follow the instructions in the README file included with the patch:

1. Go to My Oracle Support.

http://support.oracle.com

2. Click on the Patches & Updates tab.

3. In the Patch Search area, search for patch 9499508.

4. Download the patch.

3. Edit the setDomainEnv.sh file and, for Oracle Service Registry Server, remove fabric.jar from classpath:

if [ "${SERVER_NAME}" != "osr_server1" ] ; then
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
else
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
fi

When installing Oracle Service Registry 11g in the same Weblogic Domain as Oracle SOA Suite 11g Release 11.1.1.3.0, you may see the following error message when accessing the Oracle Service Registry console:

ClassCastException
java.lang.ClassCastException:org.systinet.uddi.client.serialization.UDDIFaultSerializer

To work around this error, edit the setDomainEnv.sh file and remove oracle.soa.fabric.jar from the classpath when running the Oracle Service Registry Managed Server. To do this:

1. Make a backup of the MW_HOME/user_projects/domains/soa_domain_name/bin/setDomainEnv.sh file.

2. Edit the setDomainEnv.sh file and replace the following line:

POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"

with the following:

if [ "${SERVER_NAME}" != "<your_osr_server_name>" ] ;
then
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
else
POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
fi

3. Restart the Oracle Service Registry Managed Server.

If you have multiple Oracle Service Registry Managed Servers in the domain, each Managed Server must be added to the condition. For example, if you have two Oracle Service Registry Managed Servers named WLS_OSR1 and WLS_OSR2:

case "$SERVER_NAME" in
.
'WLS_OSR1')
.
echo "Setting WLS_OSR1 CLASSPATH..."

POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;

.
'WLS_OSR2')
.
echo "Setting WLS_OSR2 CLASSPATH..."

POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;
.
*)
.
echo "Setting default SOA CLASSPATH..."

POST_CLASSPATH="${SOA_ORACLE_HOME}/soa/modules/oracle.soa.fabric_11.1.1/oracle.soa.fabric.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.adapter_11.1.1/oracle.soa.adapter.jar
${CLASSPATHSEP}${SOA_ORACLE_HOME}/soa/modules/oracle.soa.b2b_11.1.1/oracle.soa.b2b.jar
${CLASSPATHSEP}${POST_CLASSPATH}"
exit;;
.
esac

2.1.11 Problems Installing in Thai and Turkish Locales

Turkish and Thai users are recommended to install and run Oracle Fusion Middleware using the English locale. Oracle Fusion Middleware does support Turkish and Thai locales as clients.

2.1.12 Enterprise Manager Configuration Fails with Timezone Error Message

There is a problem with the timezone detection algorithm on some versions of Windows. When the database is installed on some systems that have a fresh installation of Windows, the configuration of Enterprise Manager fails with a message that indicates that an "America/Rio_Branco" timezone has been detected.

The work around is to reset the timezone to the desired value, then re-install your Oracle Fusion Middleware product.

2.2 Patching Issues and Workarounds

This section describes patching issues and their workarounds. It includes the following topics:

- Section 2.2.1, "Oracle SOA Suite Patching Issues"

- Section 2.2.2, "Oracle WebCenter Portal Patching Issues"

- Section 2.2.3, "Oracle Identity Management Patching Issues"

- Section 2.2.4, "System Component Patching Issues"

- Section 2.2.5, "Version Numbers Not Displaying Correctly After Patching"

- Section 2.2.6, "Issues with Displays During or After Patching"

- Section 2.2.7, "Error When Accessing the Oracle Portal Home Page"

- Section 2.2.8, "Warnings When Running upgradeOpss()"

- Section 2.2.9, ""Patch Already Installed" Warning Message in Log File"

- Section 2.2.10, "Manual Step for ODI-BAM Users After Installing 11.1.1.4.0 Patch Set"

- Section 2.2.11, "Applications Generate javax.xml.bind.JAXBException Runtime Errors After Installing 11.1.1.4.0 Patch Set"

2.2.1 Oracle SOA Suite Patching Issues

This section contains patching issues pertaining to Oracle SOA Suite products:

- Section 2.2.1.1, "Exception Seen When Extending Your Existing Oracle SOA Suite Domain with Oracle Business Process Management Suite"

- Section 2.2.1.2, "Exception Seen When Undeploying any SOA Composite with Range-Based Dimension Business Indicators"

- Section 2.2.1.3, "Running Oracle Business Process Management Suite with Microsoft SQL Server 2008 Database"

- Section 2.2.1.4, "Update to Oracle SOA Suite Release 11.1.1.3.0 Does Not Remove the b2b.r1ps1 Property"

- Section 2.2.1.5, "Manual Steps for Migrating Oracle UMS and Oracle MDS"

- Section 2.2.1.6, "Monitored BPEL Processes Generate Warning Messages in Log File After Applying 11g Release 1 (11.1.1.4.0) Patch Set"

- Section 2.2.1.7, "Oracle Rules Error in Administration Server Log Files After Patching an 11g Release 1 (11.1.1.2.0) Domain"

- Section 2.2.1.8, "Incorrect Instance State of Composite Applications After Applying the Latest Patch Set"

2.2.1.1 Exception Seen When Extending Your Existing Oracle SOA Suite Domain with Oracle Business Process Management Suite

The following intermittent exception may be seen in cases where you have upgraded your Oracle SOA Suite software to release 11.1.1.3.0 with the Patch Set Installer, and are extending your existing domain to include Oracle Business Process Management Suite:

javax.ejb.EJBTransactionRolledbackException: EJB Exception: ; nested exception
is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9128_SOAINFRA.BPM_CUBE_ROLE_FK1) violated -
child record found.
Error Code: 2292
Call: DELETE FROM BPM_CUBE_PROCESS WHERE (PROCESSID = ?)
bind => [247]
Query: DeleteObjectQuery(CubeProcess(domain:default, composite:counter_extended,
revision:1.0, name:Process, hasNametab:true));
nested exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9128_SOAINFRA.BPM_CUBE_ROLE_FK1) violated -
child record found

This is a harmless exception. To avoid seeing this exception, do the following:

1. Connect to your databsae as the SOA schema user.

2. Drop the BPM_CUBE_ROLE_FK1 constraint by executing the following:

ALTER TABLE BPM_CUBE_ROLE DROP CONSTRAINT BPM_CUBE_ROLE_FK1;

3. Recreate the BPM_CUBE_ROLE_FK1 constraint by executing the following:

ALTER TABLE BPM_CUBE_ROLE ADD CONSTRAINT BPM_CUBE_ROLE_FK1 FOREIGN KEY @
(ProcessId) REFERENCES BPM_CUBE_PROCESS(ProcessId) ON DELETE CASCADE;

4. Restart the Oracle SOA Managed Server.

2.2.1.2 Exception Seen When Undeploying any SOA Composite with Range-Based Dimension Business Indicators

The following intermittent exception may be seen in cases where you have upgraded your Oracle SOA Suite software to release 11.1.1.3.0 with the Patch Set Installer, and have undeployed SOA composites that have range-based dimension business indicators:

javax.ejb.EJBTransactionRolledbackException: EJB Exception: ; nested
exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9967_SOAINFRA.BPM_CUBE_NAMETAB_RANGE_FK1)
violated - child record found

Error Code: 2292
Call: DELETE FROM BPM_CUBE_NAMETAB WHERE ((EXTENSIONID = ?) AND (NAMETABID =
?))
bind => [0, 603]
Query:
DeleteObjectQuery(oracle.bpm.analytics.cube.persistence.model.CubeNametab@b7b8
2a); nested exception is: javax.persistence.PersistenceException: Exception
[EclipseLink-4002] (Eclipse Persistence Services - 2.0.2.v20100323-r6872):
org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-02292: integrity constraint (DB9967_SOAINFRA.BPM_CUBE_NAMETAB_RANGE_FK1)
violated - child record found

This exception is harmless and can be safely ignored. To avoid seeing this exception, do the following:

1. Connect to your databsae as the SOA schema user.

2. Drop the BPM_CUBE_NAMETAB_RANGE_FK1 constraint by executing the following:

ALTER TABLE BPM_CUBE_NAMETAB_RANGE  DROP CONSTRAINT BPM_CUBE_NAMETAB_RANGE_FK1;

3. Recreate the BPM_CUBE_NAMETAB_RANGE_FK1 constraint by executing the following:

ALTER TABLE BPM_CUBE_NAMETAB_RANGE ADD CONSTRAINT BPM_CUBE_NAMETAB_RANGE_FK1
FOREIGN KEY @ (ProcessId, NametabId, ExtensionId) REFERENCES
BPM_CUBE_NAMETAB (ProcessId, NametabId, ExtensionId) ON DELETE CASCADE;

4. Restart the Oracle SOA Managed Server.

2.2.1.3 Running Oracle Business Process Management Suite with Microsoft SQL Server 2008 Database

If you have patched your existing Oracle SOA Suite installation with the Patch Set Installer to include Oracle Business Process Management Suite and you are using a Microsoft SQL Server 2008 database, the following procedure is required after you have patched your software:

1. Login to the Administration Console.

2. In the "Connection Pools" tab, add the following property in the "Properties" section for the mds-owsm and mds-soa data sources:

ReportDateTimeTypes=false

2.2.1.4 Update to Oracle SOA Suite Release 11.1.1.3.0 Does Not Remove the b2b.r1ps1 Property

After you update your Release 11.1.1.2.0 software to Release 11.1.1.3.0, and login to the Oracle Enterprise Manager Console and navigate to the b2b Properties screen, the b2b.r1ps1 property (used to enable Release 11.1.1.2.0 features such as DocProvisioning and TransportCallout) is still visible. This property is removed for Release 11.1.1.3.0.

To remove this property, use the MBean browser remove property operation in Fusion Middleware Control. For more information, see "Configuring B2B Operations" in Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

2.2.1.5 Manual Steps for Migrating Oracle UMS and Oracle MDS

If you migrate your database schemas from Release 11.1.1.1.0 to Release 11.1.1.2.0 with the BAM Alone option:

ant master-patch-schema -DpatchMaster.Componentlist=BAM

The Oracle BAM server will not start and you will receive UMS and MDS exceptions. After executing above command, if no errors are seen in the log files and if the version in schema_version_registry is changed to 11.1.1.2.0 for Oracle BAM, then the following commands must be executed to manually migrate Oracle UMS and MDS:

ant master-patch-schema -DpatchMaster.Componentlist=MDS
ant master-patch-schema -DpatchMaster.Componentlist=UMS

Then, start the Oracle BAM server after running these commands.

2.2.1.6 Monitored BPEL Processes Generate Warning Messages in Log File After Applying 11g Release 1 (11.1.1.4.0) Patch Set

If you deployed BPEL processes that are instrumented with monitors, then Oracle BAM might generate warning messages in the SOA diagnotic log file after you apply the 11g Release 1 (11.1.1.4.0) patch set.

This is because a new business indicator data object field ("LATEST") was added for Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0).

To avoid the warning message and to take advantage of the new data object field, redeploy the BPEL process after you apply the 11g Release 1 (11.1.1.4.0) patch set.

For more information about the LATEST data object field, see "Understanding Business Indicator Data Objects" in the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

2.2.1.7 Oracle Rules Error in Administration Server Log Files After Patching an 11g Release 1 (11.1.1.2.0) Domain

If you are applying the latest Oracle Fusion Middleware 11g patch set to an 11g Release 1 (11.1.1.2.0) Oracle home, then you might see the following error in the Administration Server log files:

<Unresolved optional package references (in META-INF/MANIFEST.MF):
[Extension-Name: oracle.rules, referenced from:
/app/orasoa/product/soa11g/middleware/user_projects
/domains/soadev/servers/AdminServer/tmp/_WL_user/emai/xalnv4]
Make sure the referenced optional package has been deployed as a library.>

You will see this error if deployed a Oracle SOA Suite composite applciation to the domain previous to applying the patch set. This because, starting with Oracle Fusion Middleware 11g Release 1 (11.1.1.3.0), the Rules library (oracle.rules) must be targeted to the Administration Server, as well as to the SOA managed servers.

To avoid this message:

1. Use the Oracle WebLogic Server Administration Console to select the oracle.rules shared library and target it to the Administration Server as well as to the SOA managed servers in the domain.

2. Redeploy the application to the domain using Oracle JDeveloper 11g Release 1 (11.1.1.3.0) or later.

2.2.1.8 Incorrect Instance State of Composite Applications After Applying the Latest Patch Set

If you deployed any composite applications in Oracle SOA Suite 11g Release 1, and then you apply the latest 11g Release 1 patch set, then you might find that the instance state of some of your composite applications appears incorrect.

For example, if any of your composite applications were in a "recovery required" state before you applied the patch set, then those composite applications may be identified as completed when you view them on the Dashboard tab of the SOA Composite page in Fusion Middleware Control.

In these cases, you can ignore the "completed" indicator. The instances are actually still running and will be treated as such by other operations, such as a purge operation.

After you install the patch set, you should analyze each of these instances to determine whether they shoul be completed, aborted, or left to continue.

For more information about monitoring the state of SOA Composite applications, see "Monitoring SOA Composite Applications" in the Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle BPM Suite.

2.2.2 Oracle WebCenter Portal Patching Issues

This section contains patching issues pertaining to Oracle WebCenter Portal products:

- Section 2.2.2.1, "Granting Access to Network-Related Packages for the Oracle Portal Schema"

- Section 2.2.2.2, "Some WebCenter Portal Applications Show Old Version Number"

- Section 2.2.2.3, "Problem Using WebCenter Portal: Spaces Customizations with .jsp Pages After Installing the 11.1.1.6.0 Patch Set"

- Section 2.2.2.4, "Errors When Updating Oracle WebCenter Portal Using WLST Commands"

2.2.2.1 Granting Access to Network-Related Packages for the Oracle Portal Schema

While running the Patch Set Assistant to upgrade the schema for Oracle Portal 11g Release 1 (11.1.1.4.0) in an environment where Oracle Single Sign-On 10.1.4.3 is running against Oracle Internet Directory 11g and Oracle Database 11.2.0.2, the following exception is encountered:

ORA-24247: network access denied by access control list (ACL)

To address this issue when executing network-related packages, access must be granted to the user using these packages. You must create the ACL for the ORASSO schema user, and assign it to the OID host. Then, you must run the wdbigra.sql script, which gives the required grants to Oracle Portal schema.

1. Grant the ACL for the PORTAL schema user and assign it for the OID host.
Connect as sys as sysdba and assign the ACL as in the example below, where oid.us.oracle.com is the OID hostname and the DEV_PORTAL is the Oracle Portal schema specified for the installation:

DECLARE
acl_path VARCHAR2(4000);

BEGIN

SELECT acl INTO acl_path FROM dba_network_acls
WHERE host = 'oid.us.oracle.com' AND lower_port IS NULL AND upper_port IS NULL;
dbms_output.put_line('acl_path = '|| acl_path);
dbms_output.put_line('ACL already Exists. Checks for Privilege and add the Privilege');
IF DBMS_NETWORK_ACL_ADMIN.check_privilege(acl_path,'DEV_PORTAL','connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.add_privilege (
acl => acl_path,
principal => 'DEV_PORTAL',
is_grant => TRUE,
privilege => 'connect');
END IF;
END;
/
COMMIT;

When no ACL has been assigned for the OID host, create the ACL:

EXCEPTION
WHEN no_data_found THEN

DBMS_NETWORK_ACL_ADMIN.create_acl (
acl => 'sso_oid.xml',
description => 'ACL for SSO to connect to OID',
principal => 'ORASSO',
is_grant => TRUE,
privilege => 'connect');

DBMS_NETWORK_ACL_ADMIN.assign_acl (
acl => 'sso_oid.xml',
host => 'oid.us.oracle.com');
END;
/
COMMIT;

Use the following SQL command to verify that the ACL was created:

select * from dba_network_acls;

2. Modify the values of the host and schema in the wdbigra.sql file, located in the ORACLE_HOME/upgrade/portal/admin/plsql/wwv (on UNIX operating systems) or ORACLE_HOME\upgrade\portal\admin\plsql\wwv (on Windows operating systems) directory.
Change the following:

host varchar2(1)        := '*';
schema varchar2(2000)   := upper('&&1');

To the following:

host varchar2(1)        := '&OID_HOST';
schema varchar2(2000)   := upper('&PORTAL_SCHEMA');

3. Run the wdbigra.sql script to give the grants to the Oracle Portal schema.
The script will prompt you for the following:

- The value for the oid_host.
Specify the host where Oracle Internet Directory is running (for example, examplehost.exampledomain.com).

- The value for the portal_schema.
Specify the prefix and schema name (for example, DEV_PORTAL).

2.2.2.2 Some WebCenter Portal Applications Show Old Version Number

After applying the patch for Oracle WebCenter Portal, some applications still show the version number from previous releases.

There is no work around for this issue.

2.2.2.3 Problem Using WebCenter Portal: Spaces Customizations with .jsp Pages After Installing the 11.1.1.6.0 Patch Set

If you extended WebCenter Portal: Spaces 11g Release 1 (11.1.1.2.0) or Release 1 (11.1.1.3.0) with your own customizations, then before you upgrade, you must ensure that the customization shared library uses .jspx pages and not .jsp pages.

After you upgrade to WebCenter Portal: Spaces 11.1.1.6.0, custom site templates will not render if they use .jsp pages.

Note that if you followed the white paper Customizing Site Templates in WebCenter Spaces to develop your custom site templates, then your pages should already be .jspx pages.

2.2.2.4 Errors When Updating Oracle WebCenter Portal Using WLST Commands

If you are updating Oracle WebCenter Portal using WLST commands, you may see some error messages as described in this section. These errors can be safely ignored provided that when the command completes there is some text indicating the successful completion of the command.

When running the upgradeWebCenterDomain WLST command, you may see the following error message:

Error: addTemplate() failed. Do dumpStack() to see details.

When running the upgradeWebCenterPermissions command, you may see the following error message:

Command FAILED, Reason: JPS-04204: Cannot revoke permissions.

2.2.3 Oracle Identity Management Patching Issues

This section contains patching issues pertaining to Oracle Identity Management products:

- Section 2.2.3.1, "Installer Does Not Detect Existing Oracle Home"

- Section 2.2.3.2, "Uploading Third Party JAR Files to the Database"

- Section 2.2.3.3, "Updating Oracle Identity Management with LDAP Sync Enabled Generates XML Errors"

- Section 2.2.3.4, "Access Policy With Approval Does Not Work After Patch"

- Section 2.2.3.5, "OID and OVD Saved Connections Not Available After Patch From Release 11.1.1.2.0 or 11.1.1.3.0"

- Section 2.2.3.6, "Error When Running the upgradeOpss() Command When Upgrading Oracle Identity Management"

- Section 2.2.3.7, "Errors in the Log Files After Patching Oracle Identity Management to Release 11.1.1.4.0"

- Section 2.2.3.8, "Warning Message When Migrating Oracle Identity Federation from Release 11.1.1.1.0 to Release 11.1.1.2.0"

- Section 2.2.3.9, "Benign Errors Logged When Patching Oracle Identity Management 11.1.1.2.0 Installation to 11.1.1.3.0"

- Section 2.2.3.10, "Exception Seen When Starting Oracle Identity Management Server"

2.2.3.1 Installer Does Not Detect Existing Oracle Home

If you are upgrading to Oracle Identity Management to Release 11.1.1.6.0 from Release 11.1.1.4.0, the installer does not detect the existing Oracle home directory for upgrade in the following environments:

- On 64-bit Windows operating systems, using the Traditional Chinese, Simplified Chinese, or Korean locales.

- On 64-bit Linux operating systems, using the Non UTF-8 locale for Japanese, Korean, Simplified Chinese and Traditional Chinese.

This is caused because the English word "Optional" gets translated in the MW_HOME/oracle_common/inventory/ContentsXML/comps.xml (on UNIX operating systems) or MW_HOME\oracle_common\inventory\ContentsXML\comps.xml (on Windows operating systems) file.

There are two work arounds for this issue:

1. Manually specify the Oracle Identity Management Oracle home directory you want to update, and then continue with the upgrade installation.

2. Find all occurances of the translated word and replace them with the English word "Optional" in the comps.xml file and then run the installer after you are finished making the changes. The word "Optional" appears with the following two parameters in the comps.xml file:

DEP_GRP_NAME="Optional"
EXT_NAME="Optional"

Note:

The comps.xml file is an important file used by the Oracle Universal Installer so it is important that you do not make any errors while editing this file. You should make a backup copy of this file before you make any changes.

2.2.3.2 Uploading Third Party JAR Files to the Database

During the update of Oracle Identity and Access Management to Release 11.1.1.5.0, third party JAR files (for example, ldapbp.jar which is required for connector functionality) that are present in the file system are not uploaded to database by the upgrade process. You must manually upload these JAR files to the database using the UploadJars.sh (on UNIX operating systems) or UploadJars.bat (on Windows operating systems) utility.

For more information, see the "Upload JAR and Resource Bundle Utilities" chapter in Oracle Fusion Middleware Developer's Guide for Oracle Identity Manager.

2.2.3.3 Updating Oracle Identity Management with LDAP Sync Enabled Generates XML Errors

During the update of Oracle Identity Manager to from Release 11.1.1.3.0 to Release 11.1.1.5.0, the following XML error is generated if LDAP Sync is enabled on Windows operating systems:

XML-22110: (Fatal Error) Invalid StreamResult set in TransformerHandler.
oracle.iam.oimupgrade.exceptions.OIMUpgradeException: Error in writing document EventHandlers.xml

To work around this issue:

1. Edit the ORACLE_OIM_HOME\server\bin\dwps1upgrade.properties file and set the oim.ps1.seedoespolicies property to false:

oim.ps1.seedoespolicies.patch=false;

All other properties should be set to true.

2. Create a log directory (for example, logDir) in ORACLE_OIM_HOME\server\bin.

3. Go to the IAM_11.1.1.5.0_Home\server\bin directory and run the DW2PS1Upgrade.bat script.
For the following command line prompt:

##Enter your Log location directory

Specify the relative path of the log directory created in Step 2 (for example, logDir). Do not specify the absolute path to the log directory.

4. Edit the ORACLE_OIM_HOME\server\bin\dwps1upgrade.properties file again, but this time set the oim.ps1.seedoespolicies property to true and all other properties to false:

oim.ps1.seedoespolicies.patch=true;

This will allow you to upgrade the policies for Oracle Entitlements Server only.

5. Go to the IAM_11.1.1.5.0_Home\server\bin directory and run the DW2PS1Upgrade.bat script again.
For the following command line prompt:

##Enter your Log location directory

Specify the absolute path of the log directory created in Step 2 (for example, logDir) if you are using the same directory, or you can create a new directory and specify the absolute path to the new directory.

2.2.3.4 Access Policy With Approval Does Not Work After Patch

In Release 11.1.1.5.0, the following new policies are introduced for Oracle Entitlements Server (OES):

- SelfServiceUserManagementPolicies.xml

- UserManagementPolicies.xml

Because of this change, a request for approval is not generated when a new policy with approval is added.

To work around this issue, add the "Request Administrator" role to the "Access Policy Based Provisioning" request template:

1. Login to "Advance Console."

2. Go to Request Templates on the Configuration tab.

3. Search for and and open the "Access Policy Based Provisioning" request template.

4. Go to the Template User Roles tab on the Template Details page.

5. From the left pane in "Available Roles," search for and assign the "Request Administrators" role.
The assigned role will appear in the right pane under "Selected Roles."

6. Save the request template.

2.2.3.5 OID and OVD Saved Connections Not Available After Patch From Release 11.1.1.2.0 or 11.1.1.3.0

If you are patching Oracle Internet Directory (OID) or Oracle Virtual Directory (OVD) from Releases 11.1.1.2.0 or 11.1.1.3.0 to Release 11.1.1.4.0 or later, your saved connection in Releases 11.1.1.2.0 or 11.1.1.3.0 will not be available after the patch.

If you are patching from Release 11.1.1.3.0 or later, then your saved connections in OID and OVD will be available.

There is no work around for this issue.

2.2.3.6 Error When Running the upgradeOpss() Command When Upgrading Oracle Identity Management

During the upgrade of Oracle Identity Manager 11.1.1.3.0 to 11.1.1.5.0, you are asked to run the upgradeOpss WLST (online) command to update Oracle Platform Security Services (OPSS).

The following message will be visible on the console when you run the upgradeOpss command:

WLS ManagedService is not up running. Fall back to use system properties for configuration.
date_and_time oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstPolicy <init>
WARNING: No identity store associate with policy store found.
Upgrade of jps configuration and security stores is done.

This message is harmless and can be safely ignored.

2.2.3.7 Errors in the Log Files After Patching Oracle Identity Management to Release 11.1.1.4.0

After patching and configuring Oracle Identtiy Management to Release 11.1.1.4.0, the following errors are seen in the wls_oif1-diagnostics.log file when Single Sign-On is used for Oracle Identity Federation:

[2010-08-05T13:05:30.754-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174]
[oracle.security.fed.model.config.Configuration] [tid:
[ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid:
42ef6c66fe18f3ad:291f353a:12a43da27c1:-8000-0000000000000021,0] [APP:
OIF#11.1.1.2.0] [arg: certvalidationtimeout] Property was not found:
certvalidationtimeout.
.
[2010-08-05T13:05:37.174-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174]
[oracle.security.fed.model.config.Configuration] [tid:
[ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid:
42ef6c66fe18f3ad:291f353a:12a43da27c1:-8000-0000000000000021,0] [APP:
OIF#11.1.1.2.0] [arg: schemavalidationenabled] Property was not found:
schemavalidationenabled

[2010-08-06T17:09:23.861-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174]
[oracle.security.fed.model.config.Configuration] [tid:
[ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid:
f6d9b81289e40cee:42d4f595:12a49b7af7a:-8000-000000000000086f,0] [APP:
OIF#11.1.1.2.0] [arg: certpathvalidationenabled] Property was not found:
certpathvalidationenabled.

[2010-08-06T17:11:27.173-07:00] [wls_oif1] [INCIDENT_ERROR] [FED-10174]
[oracle.security.fed.model.config.Configuration] [tid:
[ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid:
f6d9b81289e40cee:42d4f595:12a49b7af7a:-8000-00000000000009a0,0] [APP:
OIF#11.1.1.2.0] [arg: httpheaderattrcollector] Property was not found:
httpheaderattrcollector.

There errors are harmless and can be safely ignored.

To avoid seeing these errors, run the oif-upgrade-11.1.1.2.0-11.1.1.4.0.py script after you have patched your software to 11.1.1.4.0 as described in "Updating Configuration Properties in Oracle Identity Federation" in the Oracle Fusion Middleware Patching Guide.

2.2.3.8 Warning Message When Migrating Oracle Identity Federation from Release 11.1.1.1.0 to Release 11.1.1.2.0

When you are using the Patch Assistant migration scripts to migrate Oracle Identity Federation from Release 11.1.1.1.0 to Release 11.1.1.2.0, you may see the following error message:

WLSTException: Error occured while performing addHelpCommandGroup : Error
getting resource bundle: : Can't find bundle for base name
oifWLSTResourceBundle, locale en_US

This message is harmless and can be safely ignored.

2.2.3.9 Benign Errors Logged When Patching Oracle Identity Management 11.1.1.2.0 Installation to 11.1.1.3.0

You may see some benign error messages in installation log files, such as the following, after you patch an Oracle Identity Management 11.1.1.2.0 installation to 11.1.1.3.0:

External name..INVALID_ORACLE_DIRECTORY_MSG_STRING

In doFinish method checking for inventory lock...InstallProgressPage

Next page is a progress page and the inventory lock is false

/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/install/root.log': Operation not permitted

/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmb': Operation not permitted

/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmhs': Operation not permitted

/bin/chmod: changing permissions of /scratch/aime1/Oracle/Middleware/oracle_ps2/bin/nmo': Operation not permitted

inventoryLocation: /scratch/aime1/oraInventory

Mode:init

Such messages can be ignored.

2.2.3.10 Exception Seen When Starting Oracle Identity Management Server

After updating Oracle Identity Management to Release 11.1.1.5.0, the following exception may be seen when starting Oracle Identity Management Server:

java.lang.ClassNotFoundException: ADP ClassLoader failed to load:com.thortech.xl.schedule.tasks.tcTskScheduledProvision

This error is harmless and can be safely ignored.

2.2.4 System Component Patching Issues

This section contains patching issues pertaining to Oracle Fusion Middleware system components:

- Section 2.2.4.1, "Redeploy System Components to Ensure Proper Deinstallation"

2.2.4.1 Redeploy System Components to Ensure Proper Deinstallation

After you have patched your system component software (Oracle Portal, Forms, Reports and Discoverer, Oracle Identity Management, or Oracle Web Tier) and started all services, you must manually redeploy your system components if you are extending your existing domain. To do so, follow the instructions in "Redeploying System Components for Extend Domain Scenarios" in the Oracle Fusion Middleware Patching Guide.

If you do not redeploy your system components, you will encounter problems when you attempt to remove them.

2.2.5 Version Numbers Not Displaying Correctly After Patching

This section contains the following:

- Section 2.2.5.1, "MDS Schema Version Number is Incorrect"

- Section 2.2.5.2, "Oracle BI Components Show Incorrect Version Number After Patching"

2.2.5.1 MDS Schema Version Number is Incorrect

If you are running Fusion Middleware products that use the Metadata Services schema (MDS) and your Fusion Middleware products are older than Release 11.1.1.4.0, the schema version number for the MDS schema in Enterprise Manager will be the previous release number, even if you have updated the MDS schema to Release 11.1.1.4.0.

In order for the MDS schema version number to appear correctly, both the schema and the Fusion Middleware product software must be up to date with the most recent version.

2.2.5.2 Oracle BI Components Show Incorrect Version Number After Patching

After you patch your existing Oracle Business Intelligence (BI) software to Release 11.1.1.4.0, some Oracle BI components (for example, Oracle BI Publisher or Oracle RTD) will still show the version number from your previous release when viewed using Oracle Enterprise Manager.

There is no work around for this issue.

2.2.6 Issues with Displays During or After Patching

This section contains the following:

- Section 2.2.6.1, "Pages in Oracle Enterprise Manager and Oracle Directory Services Manager do not Display Correctly"

2.2.6.1 Pages in Oracle Enterprise Manager and Oracle Directory Services Manager do not Display Correctly

After upgrading to 11g Release 1 (11.1.1.6.0), if you encounter problems with pages in Oracle Enterprise Manager (EM) or Oracle Directory Services Manager (ODSM) not being displayed correctly, do the following before starting all the servers in the domain:

1. Add the value -XX:-UseSSE42Intrinsics to the DOMAIN_HOME/bin/setDomainEnv.sh (on UNIX operating systems) or DOMAIN_HOME\bin\setDomainEnv.cmd (on Windows operating systems) file as follows:
Find the following section of code:

if [ "${JAVA_VENDOR}" = "Sun" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_DEV_ARGS} ${MEM_MAX_PERM_SIZE}"
export MEM_ARGS
fi

if [ "${JAVA_VENDOR}" = "HP" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_MAX_PERM_SIZE}"
export MEM_ARGS
fi

if [ "${JAVA_VENDOR}" = "Apple" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_MAX_PERM_SIZE}"
export MEM_ARGS
fi

And change it to:

if [ "${JAVA_VENDOR}" = "Sun" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_DEV_ARGS} ${MEM_MAX_PERM_SIZE} -XX:-UseSSE42Intrinsics"
export MEM_ARGS
fi

if [ "${JAVA_VENDOR}" = "HP" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_MAX_PERM_SIZE} -XX:-UseSSE42Intrinsics"
export MEM_ARGS
fi

if [ "${JAVA_VENDOR}" = "Apple" ] ; then
MEM_ARGS="${MEM_ARGS} ${MEM_MAX_PERM_SIZE} -XX:-UseSSE42Intrinsics"
export MEM_ARGS
fi

2. For Oracle EM, remove the .css file from the following directory:
On UNIX operating systems:

DOMAIN_HOME/servers/AdminServer/tmp/_WL_user/em/random_dir/public/adf/styles/cache

On Windows operating systems:

DOMAIN_HOME\servers\AdminServer\tmp\_WL_user\em\random_dir\public\adf\styles\cache

3. For ODSM, remove the .css file from the following directory:
On UNIX operating systems:

DOMAIN_HOME/servers/wls_ods1/tmp/_WL_user/odsm_release/random_dir/public/adf/styles/cache

On Windows operating systems:

DOMAIN_HOME\servers\wls_ods1\tmp\_WL_user\odsm_release\random_dir\public\adf\styles\cache

4. Clear your browser cache to remove any browser clients that visited the sites using the .css file you just removed.

5. Start or restart all the servers in the domain.

2.2.7 Error When Accessing the Oracle Portal Home Page

If you are upgrading to Oracle Portal 11g Release 1 (11.1.1.6.) from any previous release, the following error message is displayed in the browser when accessing the Oracle Portal home page:

XML Parsing Error: syntax error
Location: http://exampleserver.exampledomain:port/portal/pls/portal/dev_portal.home
Line Number 1, Column 1:An error occurred while processing the request. Try refreshing your browser. If the problem persists contact the site administrator
^

This occurs because the Web Cache invalidation password stored in Web Cache and the password stored in the Portal repository are not the same.

To resolve this issue:

1. Reset the Oracle Web Cache invalidator password in the Administration repository:

1. Log in to Enterprise Manager in the domain where Web Cache is running:

http://administration_server_host:administration_server_port/em

2. From the navigation section on the left, open "Web Tier" then click on the Web Cache instance name.

3. Find the drop-down menu on the right-hand side of the page under the Web Cache instance name, then select Administration > Password from the menu.

4. Specify a new invalidation password.

5. Restart Oracle Web Cache.

2. Reset the Oracle Web Cache invalidator password in the Oracle Portal repository:

1. Log in to Enterprise Manager in the domain where Oracle Portal is running:

http://administration_server_host:administration_server_port/em

2. From the navigation section on the left, open "Portal" then click on the Oracle Portal Managed Server name.

3. Find the drop-down menu on the right-hand side of the page under the Oracle Portal instance name, then select Settings > Wire Configuration from the menu.

4. Specify a new invalidation password - the same password you specified in the Administration repository.

Note:

the "Invalidation User" user name should be same as the user name used on the Oracle Web Cache side.

5. Click Apply.
There is a known issue at this point - refer to "Resolving JDBC Errors in Oracle Reports and Oracle Portal" in the Oracle Fusion Middleware Patching Guide for more information.

6. Delete the Oracle Portal File Cache in the ORACLE_INSTANCE/portal/cache (on UNIX operating systems) or ORACLE_INSTANCE\porta\/cache (on Windows operating systems) directory.

7. Restart Oracle Web Cache and the Oracle Portal Managed Server.

2.2.8 Warnings When Running upgradeOpss()

When running the upgradeOpss() WLST command to upgrade configurations and stores to Release 11.1.1.4.0, the following error messages may be seen:

oracle.security.jps.internal.tools.utility.destination.apibased.JpsDstPolicy
migrateData
WARNING: cannot migrate a global grant. Reason
oracle.security.jps.service.policystore.PolicyStoreException: Found 2 permissions
in the store matching: ([PermissionEntry:class=java.util.PropertyPermission
target=weblogic.Name resourceType=null actions=read,PERMISSION, name=null,
uniqueName=null, guid=null]
[jaznGranteeDn=orclguid=AC171BF0E72711DEBF9CCF0B93FB22A1,cn=Grantees,
cn=JAASPolicy,cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod}),
[PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name
resourceType=null actions=read,PERMISSION, name=8228FD8036F711DEAF24DB7D80B2D07C,
uniqueName=orclguid=8228FD8036F711DEAF24DB7D80B2D07C,cn=Permissions,cn=JAASPolicy,
cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod,
guid=8228FD8036F711DEAF24DB7D80B2D07C]
[jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaas
policy,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}1
[PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name
resourceType=null actions=read,PERMISSION, name=8228FD8036F711DEAF24DB7D80B2D07C,
uniqueName=orclguid=8228FD8036F711DEAF24DB7D80B2D07C,cn=Permissions,cn=JAASPolicy,
cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod,
guid=8228FD8036F711DEAF24DB7D80B2D07C]
[jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy
,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}
[PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name
resourceType=null actions=read,PERMISSION, name=AC198CF0E72711DEBF9CCF0B93FB22A1,
uniqueName=orclguid=AC198CF0E72711DEBF9CCF0B93FB22A1,cn=Permissions,cn=JAASPolicy,
cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod, guid=AC198CF0E72711DEBF9CCF0B93FB22A1]
[jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy
,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}
[jaznGranteeDn=orclguid=ac171bf0e72711debf9ccf0b93fb22a1,cn=grantees,cn=jaaspolicy
,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}2
[PermissionEntry: class=java.util.PropertyPermission target=weblogic.Name
resourceType=null actions=read,PERMISSION, name=AC198CF0E72711DEBF9CCF0B93FB22A1,
uniqueName=orclguid=AC198CF0E72711DEBF9CCF0B93FB22A1,cn=Permissions,cn=JAASPolicy,
cn=systempolicy,cn=webcenter,cn=JPSContext,cn=jpsroot_webcenter_IR14_prod,
guid=AC198CF0E72711DEBF9CCF0B93FB22A1]
[jaznGranteeDn=orclguid=822505e036f711deaf24db7d80b2d07c,cn=grantees,cn=jaaspolicy
,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_
prod}[jaznGranteeDn=orclguid=ac171bf0e72711debf9ccf0b93fb22a1,cn=grantees,cn=jaas
policy,cn=systempolicy,cn=webcenter,cn=jpscontext,cn=jpsroot_webcenter_ir14_prod}

These messages are harmless and can be safely ignored.

2.2.9 "Patch Already Installed" Warning Message in Log File

In a scenario where you have a product that is already patched to version 11.1.1.3.0 in a Middleware home, and then you attempt to patch a second product to the same version in the same Middleware home, a warning message similar to the following will appear in the installtimestamp.out file:

Attempting to install 1 patches
Mar 3, 2010 1:00:07 PM [THREAD: Thread-1]
com.bea.cie.paf.internal.attach.PatchManagerImpl install
WARNING: Warning:  Patch already installed: PBY8

Patch installation success
Patch installation success
Success..
[SOARootService.getRootActions] autoPortsDetect =null
[SOARootService.getRootActions] privilegedPorts =null

This warning message can be safely ignored.

2.2.10 Manual Step for ODI-BAM Users After Installing 11.1.1.4.0 Patch Set

If you are integrating Oracle Data Integrator (ODI) with Oracle Business Activity Monitoring, you should import a new version of the following knowledge module after you install the Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) patch set:

BAM_ORACLE_HOME/bam/ODI/knowledge modules/KM_RKM Oracle BAM.xml

For more information, see "Importing and Replacing Knowledge Modules" in the Oracle Fusion Middleware Developer's Guide for Oracle Data Integrator.

This new module includes bugs fixes and improvements made for the Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) .

2.2.11 Applications Generate javax.xml.bind.JAXBException Runtime Errors After Installing 11.1.1.4.0 Patch Set

If any of the applications you deployed on Oracle Fusion Middleware 11g Release 1 (11.1.1.2.0) or Release 1 (11.1.1.3.0) include EclipseLink-JAXB classes that have no-arg constructors missing, then after you install Release 1 (11.1.1.4.0), the application might generate the following exceptions during runtime:

javax.xml.bind.JAXBException

To avoid this error:

1. Modify the classes and add default no-arg constructors where necessary.

2. Compile and redeploy your project to the newly patched Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) domain.

Below is an example of a typical no-arg constructor:

public class PriceQuote implements Serializable
{
// Make sure you have constructor with no arguments
public PriceQuote() }
}
}

2.3 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 2.3.1, "Oracle SOA Suite Configuration Issues"

- Section 2.3.2, "Oracle Identity Management Configuration Issues"

- Section 2.3.3, "Configuration Wizard Issues"

- Section 2.3.4, "Repository Creation Utility Issues"

- Section 2.3.5, "Pack and Unpack Issues"

- Section 2.3.7, "Setting the PATH Environment Variable for Oracle Configuration Manager"

- Section 2.3.6, "Configuration Issues Working With Clusters"

- Section 2.3.8, "Oracle WebCenter Portal wc-post-install.py Script Not Supported for Oracle RAC Datasources"

- Section 2.3.9, "FileNotFoundException When Cloning on Windows"

- Section 2.3.10, "Changing the Listen Address of a Managed Server"

- Section 2.3.11, "Domain Extension Overwrites JDBC Data Source Name"

- Section 2.3.12, "Rerouting to Original URL After SSO Authentication in Firefox and Safari Browsers"

- Section 2.3.13, "Deleting the Browser Cache in Browsers"

- Section 2.3.14, "WebLogic Administration Server Fails to Start Due to Memory Issues"

2.3.1 Oracle SOA Suite Configuration Issues

This section contains information pertaining to Oracle SOA Suite configuration:

- Section 2.3.1.1, "SOAINFRA Schema Contains Invalid Objects"

- Section 2.3.1.2, "Exception Seen for Oracle SOA Suite with WebSphere Application Server"

2.3.1.1 SOAINFRA Schema Contains Invalid Objects

When the 11g Release 1 (11.1.1.6.0) version of the prefix_SOAINFRA schema is created either by running RCU or the Patch Set Assistant, there are still some invalid objects that exist within the SOA schema.

To work around this issue, complie the prefix_SOAINFRA schema. For example, if the SOA schema user on your system is DEV_SOAINFRA:

exec dbms_utility.compile_schema('DEV_SOAINFRA')

If you choose not to run this command to make the objects valid, the objects will also become valid once they are accessed during runtime.

2.3.1.2 Exception Seen for Oracle SOA Suite with WebSphere Application Server

When running Oracle SOA Suite on IBM WebSphere application server, the following exception is seen after logging in to Fusion Middleware Control, expanding Application Deployments on the left side and then clicking on any of the applications under it:

[date_and_time] 0000003f OHWHelpProvid E   unable to create global
configuration
[date_and_time] 00000044 OHWHelpProvid E   critical error in OHW
configuration

oracle.help.web.config.parser.ConfigParseException: error finding
configuration file at:
at oracle.help.web.config.parser.OHWParser._openConnection(Unknown
Source)
at oracle.help.web.config.parser.OHWParser.getGlobalConfiguration(Unknown Source)
at oracle.help.web.rich.helpProvider.OHWHelpProvider.getHelpTopic(Unknown Source)
.
.
.

This exception is harmless and can be safely ignored.

2.3.2 Oracle Identity Management Configuration Issues

This section contains information pertaining to Oracle Identity Management configuration:

- Section 2.3.2.1, "Oracle Identity Federation oif-upgrade-11.1.1.2.0-11.1.1.6.0.py Script is not run on Remote Machines"

- Section 2.3.2.2, "Errors Logged to Managed Server Log Files When Extending a 11.1.1.3.0 Oracle Identity Management Domain on a Remote System"

- Section 2.3.2.3, "Log Messages Appearing on Console During Oracle Identity Management Schema Creation"

- Section 2.3.2.4, "Configuring Oracle Identity Management When WebLogic Node Manager is Running"

- Section 2.3.2.5, "Configuring OID with Oracle Data Vault"

- Section 2.3.2.6, "OIDMON Does Not Start After Configuring Oracle Internet Directory on Windows"

- Section 2.3.2.7, "Password Requirements for Oracle Internet Directory Administrator"

- Section 2.3.2.8, "Error Message When Configuring Oracle Identity Federation"

2.3.2.1 Oracle Identity Federation oif-upgrade-11.1.1.2.0-11.1.1.6.0.py Script is not run on Remote Machines

For all new 11g Release 1 (11.1.1.6.0) Oracle Identity Federation installations where Oracle Identity Federation is not configured on the same machine as the Administration Server, you must run the oif-upgrade-11.1.1.2.0-11.1.1.6.0.py script on the remote machine to complete the configuration process.

When you runn this script, you will need to specify location of the remote machine where the Oracle Identity Federation Managed Server is running. You only need to do this for one Managed Server even if you have multiple Managed Servers in your domain.

Instructions for running this script can be found in "Updating Configuration Properties in Oracle Identity Federation" in Oracle Fusion Middleware Patching Guide.

2.3.2.2 Errors Logged to Managed Server Log Files When Extending a 11.1.1.3.0 Oracle Identity Management Domain on a Remote System

When extending a 11.1.1.3.0 (patched) domain on a remote system, you may see a Null Pointer exception message, such as the following, in the Managed Server log files after installation:

0000IW5hUxgDc_Y5HrDCif1Bm1sl000000,0] [APP: DMS Application#11.1.1.1.0]
initialization error[[java.lang.NullPointerException
at java.io.File.<init>(File.java:222)
at oracle.dms.impl.util.AdmlLocator.<init>(AdmlLocator.java:59)
at oracle.dms.app.DmsSpy.init(DmsSpy.java:86)
at weblogic.servlet.internal.StubSecurityHelper$ServletInitAction.run(StubSecurityHelper.java:283)

To work around this issue, do the following:

1. Stop the instance running on the second system.

2. Stop the Managed Server on the second system.

3. Stop the instance running on the first system.

4. Stop Managed Servers on the first system.

5. Stop the Administration Server on the first system.

6. Start the instance, the Administration Server, and then Managed Servers on the first system manually from the command line.

7. Start the instance and then Managed Servers on the second system manually from the command line.

For information about starting and stopping Oracle Fusion Middleware, see the "Starting and Stopping Oracle Fusion Middleware" chapter in the Oracle Fusion Middleware Administrator's Guide.

2.3.2.3 Log Messages Appearing on Console During Oracle Identity Management Schema Creation

During the creation of the Oracle Identity Management (OIM) schema, some log messages will appear in the RCU console window. These log messages are specific to Quartz, which is used by Oracle Identity Management, and can be safely ignored.

If there are any errors encoutered during the loading of this Quartz-specific data, the errors will be written to the RCU log files. Refer to Oracle Fusion Middleware Repository Creation Utility User's Guide for more informaiton about the RCU log files.

2.3.2.4 Configuring Oracle Identity Management When WebLogic Node Manager is Running

To configure Oracle Identity Management, using either the Install and Configure option or the Configuration Wizard, when the WebLogic Node Manager utility is running from the same Middleware home directory where Oracle Identity Management is installed, the StartScriptEnabled parameter in the nodemanager.properties file must be set to true. For example: StartScriptEnabled=true

To configure Oracle Identity Management when the StartScriptEnabled parameter is set to false, you must:

1. Set the StartScriptEnabled parameter to true.

2. Stop, then restart the Node Manager utility.

3. Configure Oracle Identity Management using either the Install and Configure option or the Configuration Wizard.

Note:

The nodemanager.properties file is located in the WL_HOME/common/nodemanager/ directory.

2.3.2.5 Configuring OID with Oracle Data Vault

If you choose to configure Oracle Internet Directory (OID) with Oracle Data Vault:

1. Apply patch 8897382 (see the README file in the patch for instructions).

2. In the ORACLE_HOME/ldap/datasecurity/dbv_oid_command_rules.sql (on UNIX operating systems) or ORACLE_HOME\ldap\datasecurity\dbv_oid_command_rules.sql (on Windows operating systems) file, find the following code:

/declare
.
begin
.
dvsys.dbms_macadm.CREATE_COMMAND_RULE(
command => 'CONNECT'
,rule_set_name => 'OID App Access'
,object_owner => 'ODS'
,object_name => '%'
,enabled => 'Y');
.
commit;
.
end;/

3. Change the following line:

,object_owner => 'ODS'

to:

,object_owner => '%'

2.3.2.6 OIDMON Does Not Start After Configuring Oracle Internet Directory on Windows

On Windows platforms, when configuring Oracle Internet Directory using either the installer's Install and Configure option or the Configuration Wizard, OIDMON will not start if the total length of all environment variables, such as ORACLE_HOME, JAVA_HOME, PATH, and so on, exceeds 4,000 characters.

If you see an oidmon.exe application error message while configuring Oracle Internet Directory, or if the installer's log files indicate that OIDMON could not start, you may have encountered this issue.

To work around this issue, reduce the length of environment variables so that the total length of all variables is less than 4,000 characters and then attempt to configure Oracle Internet Directory again.

2.3.2.7 Password Requirements for Oracle Internet Directory Administrator

When configuring Oracle Internet Directory, using either the installer's Install and Configure option or the Configuration Wizard, you must enter and confirm the Administrator Password.

The following is a list of the requirements for the Oracle Internet Directory Administrator Password. The password must contain:

- At least 5 characters

- No more than 30 characters

- At least one number

- Only alpha-numeric characters, underscore ( _ ), dollar sign ( $ ), and pound/hash ( # )

Note:

If the password you enter does not satisfy these requirements, the following error message appears:

INST-07037: Administrator Password field value contains one or more
invalid characters or the value is not in proper format.

2.3.2.8 Error Message When Configuring Oracle Identity Federation

During the configuration of Oracle Identity Federation (OIF), the following error message regarding key store and password may be seen in the configuration log file:

[app:OIF module:/fed path:/fed spec-version:2.5
version:11.1.1.1.0]: Failed while destroying servlet: usermanager.
java.lang.RuntimeException: The server could not initialize properly:
oracle.security.fed.sec.util.KeySourceException: Invalid/unsupported
key store or incorrect password. Please verify that the password is correct
and the store is a valid PKCS#12 PFX wallet or Java KeyStore file.

This error message can be safely ignored if OIF is running properly.

2.3.3 Configuration Wizard Issues

This section contains issues pertaining to the Oracle Fusion Middleware Configuration Wizard:

- Section 2.3.3.1, "Starting the Configuration Wizard From a New Window"

- Section 2.3.3.2, "Specify Security Updates Screen Does Not Appear in the Configuration Wizard"

2.3.3.1 Starting the Configuration Wizard From a New Window

When you start the Configuration Wizard from a terminal window, make sure that it is a new terminal window to ensure that there are no environment variables set to incorrect locations from a previous configuration or installation session.

2.3.3.2 Specify Security Updates Screen Does Not Appear in the Configuration Wizard

If you use silent installation (response file) to configure Oracle Identity Management, security updates (through Oracle Configuration Manager) are not configured. However, the ocm.rsp file is created in the Oracle home directory. If you run the Configuration Wizard GUI from the Oracle home, you will not see the Specify Security Updates Screen because of the presence of the ocm.rsp file.

To work around this issue, delete the ocm.rsp file from the Oracle home and run the Configuration Wizard to see the Specify Security Updates screen.

2.3.4 Repository Creation Utility Issues

This section contains issues pertaining to Repository Creation Utility:

- Section 2.3.4.1, "Schemas Are Not Visible After Upgrade of Oracle Identity Management"

- Section 2.3.4.2, "RCU Summary Screen Issues"

2.3.4.1 Schemas Are Not Visible After Upgrade of Oracle Identity Management

After upgrading Oracle Identity Management from Release 10g (10.1.4.3) to 11g Release 1 (11.1.1), the Oracle Directory Service schemas (ODS and ODSSM) are not visible in the Repository Creation Utility (RCU).

The reason for this is because RCU is not used during the upgrade process, and RCU only recognizes schemas that are created by RCU. Refer to Oracle Fusion Middleware Repository Creation Utility User's Guide for more information.

2.3.4.2 RCU Summary Screen Issues

If you are dropping the Identity Management schemas and you select both Oracle Internet Directory (ODS) and Oracle Identity Federation (OIF) to be dropped, the RCU summary screen may not be displayed and an exception may be thrown in the console.

To work around this issue, select and drop one component at a time instead of selecting them both and dropping them together.

When other components are selected for a drop schema operation, the summary screen may display inaccurate information. However, the selected schemas will be successfully dropped from the database in spite of the erroneous information on the summary screen.

To work around this issue, select and drop only one component at a time.

2.3.5 Pack and Unpack Issues

This section contains issues pertaining to packing and unpacking a domain:

- Section 2.3.5.1, "Ensure There Are No Missing Products When Using unpack.sh or unpack.cmd"

- Section 2.3.5.2, "Running unpack.sh or unpack.cmd on a Different Host"

- Section 2.3.5.3, "Starting Managed Servers on Remote System After Packing and Unpacking Domain"

2.3.5.1 Ensure There Are No Missing Products When Using unpack.sh or unpack.cmd

Oracle SOA Suite, Oracle WebCenter Portal, and Application Developer all contain the pack.sh and unpack.sh (on UNIX systems) or pack.cmd and unpack.cmd (on Window systems) commands in their respective ORACLE_HOME/common/bin (on UNIX systems) or ORACLE_HOME\common\bin (on Windows systems) directories.

The pack.sh and pack.cmd scripts are used to create a template archive (.jar) file that contains a snapshot of either an entire domain or a subset of a domain. The unpack.sh and unpack.cmd scripts are used to create a full domain or a subset of a domain used for a Managed Server domain directory on a remote system.

The unpack.sh and unpack.cmd commands will fail if any installed products are missing from the system where you are running the unpack.sh or unpack.cmd command.

2.3.5.2 Running unpack.sh or unpack.cmd on a Different Host

If you are running the unpack.sh (on UNIX) or unpack.cmd (on Windows) command to unpack a domain on a remote host, the Oracle home location and the Middleware home location on the remote host should match the locations on the host where the pack was performed.

Below is a valid example:

Host 1:
MW_HOME = /user/home/Middleware
ORACLE_HOME =/user/home/Middleware/Oracle_SOA1

@ Host 2:
MW_HOME = /user/home/Middleware
ORACLE_HOME =/user/home/Middleware/Oracle_SOA1

The example below is NOT valid because the Oracle homes do not match:

Host 1:
MW_HOME = /user/home/Middleware
ORACLE_HOME =/user/home/Middleware/Oracle_SOA1

@ Host 2:
MW_HOME = /user/home/Middleware
ORACLE_HOME =/user/home/Middleware/SOA_Home

The example below is NOT valid because the Middleware homes do not match:

Host 1:
MW_HOME = /user/home/Middleware
ORACLE_HOME =/user/home/Middleware/Oracle_SOA1

@ Host 2:
MW_HOME = /user/home/MWHome
ORACLE_HOME =/user/home/Middleware/Oracle_SOA1

Host 1:
MW_HOME = C:\Oracle\Middleware
ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1

@ Host 2:
MW_HOME = C:\Oracle\Middleware
ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1

The example below is NOT valid because the Oracle homes do not match:

Host 1:
MW_HOME = C:\Oracle\Middleware
ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1

@ Host 2:
MW_HOME = C:\Oracle\Middleware
ORACLE_HOME = C:\Oracle\Middleware\SOA_Home

The example below is NOT valid because the Middleware homes do not match:

Host 1:
MW_HOME = C:\Oracle\Middleware
ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1

@ Host 2:
MW_HOME = C:\Oracle\MWHome
ORACLE_HOME = C:\Oracle\Middleware\Oracle_SOA1

2.3.5.3 Starting Managed Servers on Remote System After Packing and Unpacking Domain

After you unpack a domain on a remote system using the unpack command, complete the following steps:

1. Start Node Manager on the remote system. This action creates a nodemanager.properties file on your system in the MW_HOME/wlserver_10.3/common/nodemanager directory (on UNIX). On Windows, this file is created in the MW_HOME\wlserver_10.3\common\nodemanager directory.

2. Stop Node Manager.

3. Open the nodemanager.properties file in a text editor and set the StartScriptEnabled property to true.

4. Start the Node Manager on the remote system before starting the Managed Server on the remote system through the Oracle WebLogic Administration Console.

2.3.6 Configuration Issues Working With Clusters

This section contains issues pertaining to clusters and your WebLogic Server domain:

- Section 2.3.6.1, "Extend Domain and Expand Cluster Scenarios with Remote Systems"

- Section 2.3.6.2, "Unable to Extend an Existing Domain by Selecting Only Oracle Directory Integration Platform Without Cluster"

- Section 2.3.6.3, "Expand Cluster Requires Changes to the emd.properties File"

2.3.6.1 Extend Domain and Expand Cluster Scenarios with Remote Systems

In scenarios where you are using the Fusion Middleware Configuration Wizard to extend a domain or expand a cluster with remote systems, you must make sure that both the source and destination Middleware home and Oracle home directories are identical.

2.3.6.2 Unable to Extend an Existing Domain by Selecting Only Oracle Directory Integration Platform Without Cluster

Selecting only Oracle Directory Integration Platform without cluster in a session followed by creating cluster and extending domain on the same system fails.

In this domain configuration scenario, ensure that you install and configure Oracle Directory Services Manager on the same system where you extending the domain to configure Oracle Directory Integration Platform.

2.3.6.3 Expand Cluster Requires Changes to the emd.properties File

After running the Oracle Fusion Middleware Configuration Wizard to expand a cluster, the EMD_URL parameter in the INSTANCE_HOME/EMAGENT/EMAGENT/sysman/config/emd.properties (on UNIX) or INSTANCE_HOME\EMAGENT\EMAGENT\sysman\config\emd.properties (on Windows) file contains the values shown below:

EMD_URL=http://localhost.localdomain:port/emd/main

You must edit this parameter and replace localhost and localdomain with the actual host and domain information of your environment. For example, using 5160 as the port number:

EMD_URL=http://examplehost.exampledomain.com:5160/emd/main

2.3.7 Setting the PATH Environment Variable for Oracle Configuration Manager

In order for Oracle Configuration Manager to work properly on Windows operating systems, make sure the PATH environment variable is set to C:\windows\system32.

2.3.8 Oracle WebCenter Portal wc-post-install.py Script Not Supported for Oracle RAC Datasources

The wc-post-install.py script can not be used in an environment with Oracle RAC datasources (gridlink or multi-datasource).

To work around this issue:

1. Edit the WC_ORACLE_HOME/bpm/process_spaces/wc-post-install.py script and comment out all lines containing setDatasource in the file by adding a hash (#) character to the beginning of the line.

2. Use the WebCenter Portal Console and manually configure the following datasources:

- mds-soa

- mds-soa0

- mds-soa1

- SOADataSource

- SOADataSource0

- SOADataSource1

3. Run the wc-post-install.py script.

2.3.9 FileNotFoundException When Cloning on Windows

When you run the applyClone command on Windows operating systems, a java.io.FileNotFoundException is thrown to the console.

This exception can be safely ignored and the applyClone operation will be successfully completed.

2.3.10 Changing the Listen Address of a Managed Server

When you run the Configuration Wizard after installing Oracle Identity Management or Oracle Portal, Forms, Reports and Discoverer, the listen address for WebLogic Managed Servers is left blank by default (to listen to all network interfaces). If you change the listen address to the actual host name, the Managed Server stops listening from outside the system.

It is recommended that you either leave the listen address blank, or specify the IP address of the host rather than using the host name.

2.3.11 Domain Extension Overwrites JDBC Data Source Name

When a WebLogic Domain with JDBC resources is extended to either Oracle SOA Suite or Oracle WebCenter Portal, the JDBC data source name will be changed. This behavior is commonly observed in cases where WebLogic Server version lower than 9.x is upgraded to a version higher than 9.x and then extended to Oracle SOA Suite or Oracle WebCenter Portal.

To work around this issue, you must manually edit the JDBC data source names.

2.3.12 Rerouting to Original URL After SSO Authentication in Firefox and Safari Browsers

When configuring Oracle Portal, Forms, Reports and Discoverer, when both Oracle HTTP Server and Oracle Web Cache are selected for configuration, re-routing (back to the original URL) after Single Sign-On (SSO) authentication does not work in Firefox and Safari browsers when the initial request comes from Oracle HTTP Server.

The work arounds are to either use the Internet Explorer browser, or manually modify the INSTANCE_HOME\config\OHS\instance_name\httpd.conf file and change the ServerName entry to include the port number. For example:

ServerName examplehost.exampledomain.com

should be changed to:

ServerName examplehost.exampledomain.com:port

Replace port with the actual port number.

2.3.13 Deleting the Browser Cache in Browsers

Make sure you clear your browser cache files; otherwise, the objects on your screen (for example, in Oracle Enterprise Manager) may not be refreshed to the latest version, or if you added a new object then it may not appear.

2.3.14 WebLogic Administration Server Fails to Start Due to Memory Issues

On Windows 32-bit operating systems, the WebLogic Administration Server may fail to start, as it cannot allocate sufficient memory despite the availability of free memory.

As a workaround, complete the following steps:

1. Open the setSOADomainEnv.cmd file, located in your <Domain_Home>\bin directory, in a text editor.

2. Update the PORT_MEM_ARGS entry as follows:
set PORT_MEM_ARGS=-Xms512m -Xmx1024m

3. Save the file and close.

2.4 Known Issues

This section describes known issues. It includes the following topics:

- Section 2.4.1, "Forms and Reports Builder Not Supported"

2.4.1 Forms and Reports Builder Not Supported

Forms and Reports Builder is not suported on Linux x86-64, Solaris Operating System (SPARC 64-Bit), AIX Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, and Microsoft Windows x64 (64-Bit) platforms. It is supported on Linux x86 and Microsoft Windows (32-Bit) platforms only.

2.5 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 2.5.1, "Updating OIM Configuration to Use Oracle HTTP Server 10g WebGate"

- Section 2.5.2, "Missing Logout Configuration Steps in the Oracle Identity Management Installation Guide"

2.5.1 Updating OIM Configuration to Use Oracle HTTP Server 10g WebGate

Step 4 in the Section 22.8 "Optional: Updating Oracle Identity Manager Configuration" in the chapter "Migrating from Domain Agent to Oracle HTTP Server 10g Webgate for OAM" requires you to update the OIM Configuration when the OAM URL or agent profile changes. This section is in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

To update Oracle Identity Manager configuration, complete the following steps:

1. Export the oim-config.xml file from metadata by running <IDM_Home>/server/bin/weblogicExportMetadata.sh (on UNIX), and export the file - /db/oim-config.xml. On Windows operating systems, you can use the weblogicExportMetadata.bat file located in the same directory.

2. Update the file to use Oracle HTTP Server 10g Webgate by updating following element under the <ssoConfig> tag:
<webgateType>javaWebgate</webgateType> to <webgateType>ohsWebgate10g</webgateType>

3. Import oim-config.xml back to metadata by running <IDM_Home>/server/bin/weblogicImportMetadata.sh on UNIX. On Windows, use the weblogicImportMetadata.bat located in the same directory.

4. Log in to Oracle Enterprise Manager using your WebLogic Server administrator credentials.

5. Click Identity and access > oim > oim(version). Right-click and select System MBean Browser. The System MBean Browser page is displayed.

6. Under Application Defined MBeans, select oracle.iam > Server:oim_server1 > Application: oim > XMLConfig > config.

7. Replace the front-end URL with the URL of Oracle HTTP Server. This should be the same Oracle HTTP Server that was used before installing Oracle HTTP Server 10g Webgate for Oracle Access Manager. Complete the following steps:

1. Under XMLConfig MBean, move to XMLConfig.DiscoveryConfig.

2. Update OimFrontEndURL with the URL of Oracle HTTP Server.

3. Click Apply.

8. Restart the OIM server.

2.5.2 Missing Logout Configuration Steps in the Oracle Identity Management Installation Guide

Steps to perform logout configuration after updating the OIM Server Configuration are missing from the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

You must perform logout configuration after updating the OIM Server configuration, as described in the Section 22.6 "Updating OIM Server Configuration" in the chapter "Migrating from Domain Agent to Oracle HTTP Server 10g Webgate for OAM".

Note:

Ensure that you have set up integration between Oracle Identity Manager and Oracle Access Manager, as described in the topic "Integration Between OIM and OAM" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

After updating OIM Server configuration, you must perform logout configuration as follows:

1. Copy the logout.html file from the <IDM_HOME>/oam/server/oamsso directory to the <10gWebgateInstallation>/access/oamsso directory.

2. Edit the SERVER_LOGOUTURL variable in the logout.html file to point to the host and port of the Oracle Access Manager Server. Follow the instructions in the logout.html file.

3. If the http.conf file of the web server includes the following entries, remove the entries from the http.conf file:

<LocationMatch "/oamsso/*">
Satisfy any
</LocationMatch>

3 Upgrade

This chapter describes issues associated with upgrading your environment and your applications to Oracle Fusion Middleware 11g. It includes the following topics:

- Section 3.1, "General Issues and Workarounds"

- Section 3.2, "General Issues and Workarounds for Migrating from 11.1.1.1.0"

- Section 3.3, "Documentation Errata for Upgrade"

Note:

This chapter contains issues you might encounter while upgrading any of the Oracle Fusion Middleware products.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

3.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 3.1.1, "Patches Required to Address Specific Upgrade and Compatibility Requirements"

- Section 3.1.2, "Unable to Read Composite Model Error During SOA Application Upgrade"

- Section 3.1.3, "Oracle BAM Upgrade Issues"

- Section 3.1.4, "Error When Upgrading Oracle Internet Directory Due to Invalid ODS Schema"

- Section 3.1.5, "Restore From Backup Required If Upgrade Fails During a Colocated Oracle Internet Directory and Oracle Directory Integration Platform Upgrade"

- Section 3.1.6, "Cannot Verify Oracle Forms Services Upgrade When Oracle HTTP Server is Running On a Separate Host"

- Section 3.1.7, "WebCenter Security Upgrade Release Notes"

- Section 3.1.8, "Oracle B2B Upgrade Release Notes"

- Section 3.1.9, "Problem Accessing the Welcome Pages in Oracle HTTP Server After Upgrade"

- Section 3.1.10, "Misleading Error Message When Upgrading Oracle Internet Directory"

- Section 3.1.11, "Additional Steps Required When Redeploying the SOA Order Booking Sample Application on Oracle Fusion Middleware 11g"

- Section 3.1.12, "Additional Steps Required When Upgrading Human Taskflow Projects"

- Section 3.1.13, "Stopping Oracle Virtual Directory Processes During Upgrade"

- Section 3.1.14, "Providing Input to Upgrade Assistant Screens When Oracle Internet Directory Upgrade Fails"

- Section 3.1.15, "Upgrading Oracle Access Manager Middle Tier"

- Section 3.1.16, "Inaccurate Results When Running the Upgrade Assistant Verify Feature"

- Section 3.1.17, "Missing jdk_version.log File When Launching Upgrade Assistant"

- Section 3.1.18, "Test Suites in Oracle SOA Suite 10g Projects Not Upgraded to 11g"

3.1.1 Patches Required to Address Specific Upgrade and Compatibility Requirements

In general, Oracle assumes that you are running the latest Oracle Application Server 10g patch sets before you begin the upgrade to Oracle Fusion Middleware 11g.

In addition, in some specific cases, you must apply an additional software patches to your Oracle Application Server 10g components before you start the upgrade process. These patches are designed to address specific interoperability issues that you might encounter while upgrading your Oracle Application Server 10g environment to Oracle Fusion Middleware 11g.

Table 3-1 lists the specific patch sets required to address specific upgrade and compatibility requirements for Oracle Fusion Middleware 11g.

For more information, refer to the following sections:

- Section 3.1.1.1, "Obtaining Patches and Support Documents From My Oracle Support (Formerly OracleMetaLink)"

- Section 3.1.1.2, "Upgrading the Oracle BAM Schema on Oracle Database 11g on Microsoft Windows"

Table 3-1 Patches Required to Address Specific Upgrade and Compatibility Requirements

Patch Set Number

Description and Purpose

Additional Information

8404955

Before you can perform the Oracle B2B schema upgrade, you must apply this required patch to the Oracle Application Server Integration B2B 10g Release 2 (10.1.2) middle tier.

This patch set is required in order to enable the Java command that you use to export the trading partner agreements, as described in the following step.

"Task 6b: If Necessary, Upgrade the B2B Schema" in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

8451592

If your Oracle BAM 10g schema is stored in Oracle Database 11g (10.1.0.7) on a Microsoft Windows 32-bit computer, then you must apply this patch to the database before using the Upgrade Assistant to upgrade the schema to 11g.

Section 3.1.1.2, "Upgrading the Oracle BAM Schema on Oracle Database 11g on Microsoft Windows"

5746866

If the database that hosts your Oracle Application Server 10g schemas is an Oracle Database 10g (10.1.0.x) database, then make sure that this database patch (or database patch 5126270) has been applied to the 10g (10.1.0.x) database before you upgrade the database to the required Oracle Database 10g (10.2.0.4).

Note that database patch 5746866 includes patch 5126270.

"Upgrading to Oracle Database 10g Release 2 (10.2.0.4)" in the Oracle Fusion Middleware Upgrade Planning Guide

7685124

Apply this patch against Oracle Secure Enterprise Search (10.1.8.3.0) before you attempt to use Oracle Secure Enterprise Search with Oracle Portal 11g.

"Oracle Secure Enterprise Search" in the Oracle Fusion Middleware Administrator's Guide for Oracle Portal

Section 32.4, "Interoperability Issues and Workarounds."

8372141

Apply this patch on your Oracle Application Server 10g Release 3 (10.1.3.4) environment to enable interoperability between Oracle SOA Suite 10g Release 3 (10.1.3.4) and Oracle BPEL Process Manager 11g.

This patch is also referred to as the Oracle SOA Suite 10g Release 3 (10.1.3.4) Cumulative MLR #7.

"Applying Patch Sets to Address Specific Upgrade Interoperability Issues" in the Oracle Fusion Middleware Upgrade Planning Guide

"Upgrading Oracle SOA Suite Client Applications" in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

6522654

Apply this patch to your Oracle Database before you attempt to upgrade your Oracle BAM schema.

If you do not apply this patch to your Oracle Database 10g (10.2.0.3), 10g (10.2.0.4), or Oracle Database 11g (11.1.0.7) before performing the schema upgrade, you will likely see the following error:

BAM MRUA: SCHEMA UPGRADE FAILED SQLException: ORA-39002: invalid operation

The description for this patch on My Oracle Support is "USING DATA PUMP THROUGH DBLINK CAUSED DATA CORRUPTION FOR CLOB VALUES".

"Task 6c: If Necessary, Upgrade the BAM Schema" in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

Section 3.1.3.1, "Datapump Export for Oracle BAM Upgrade Plug-in Fails in Oracle Database 10g (10.2.0.3), 10g (10.1.2.0.4), and Oracle Database 11g (11.1.0.7)"

7675269

Apply this patch to prevent the occurrence of an ORA-01591 error in an Oracle Real Application Clusters (Oracle RAC) 11g (11.1.0.7) database.

This error can occur for rows locked by transactions which were in the middle of two-phase commit.

The description of this patch on My Oracle Support is "ODAC 2008:RAC NODE AFFINITY: DISTRIBUTED TXN ABORTS WITH ORA-01591."

"Upgrading and Preparing Your Databases" in the Oracle Fusion Middleware Upgrade Planning Guide

8291981

Apply this patch to correct a problem where Metadata Repository (MDS) queries against an Oracle Database 11g (11.1.0.7) database do not find all of the results (documents or elements) that they should.

The description of this patch on My Oracle Support is: "SELECT INCORRECT RESULTS: SOME RESULTS NOT FOUND".

"Managing the MDS Repository" in the Oracle Fusion Middleware Administrator's Guide

9007079

Apply this bundled patch to your Oracle Database 11g (11.1.0.7) Real Application Clusters (Oracle RAC) environment to address three known issues while using the Oracle RAC database with Oracle Fusion Middleware Oracle SOA Suite components.

See the Readme file for the patch for a list of the bugs addressed by the patch.

The description of this patch on My Oracle Support is: "MERGE REQUEST FOR 8886255 AND 7675269".

"Oracle Real Application Clusters and Fusion Middleware" in the Oracle Fusion Middleware High Availability Guide.

8607693

Apply this patch to your Oracle Real Application Clusters (Oracle RAC) 11g (11.1.0.7) database to prevent an error that can occur if an XA transaction branch was being asynchronously rolled back by two or more sessions.

The description of this patch on My Oracle Support is: "STRESS SOA - ORA-00600: INTERNAL ERROR CODE, ARGUMENTS: [504] (Oracle AC)".

"Oracle Real Application Clusters and Fusion Middleware" in the Oracle Fusion Middleware High Availability Guide.

7682186

Apply this patch to your Oracle Real Application Clusters (Oracle RAC) 11g (11.1.0.7) database to prevent an issue that results in an ORA-600 error.

Behavior includes CR-inconsistencies between index and the block, or incorrect results in an Oracle RAC multi-node global transaction environment.

The description of this patch on My Oracle Support is: "ORA-600[KDSGRP1] SIGNALLED DURING BUGOLTP-XA WORKLOAD".

"Oracle Real Application Clusters and Fusion Middleware" in the Oracle Fusion Middleware High Availability Guide.

3.1.1.1 Obtaining Patches and Support Documents From My Oracle Support (Formerly OracleMetaLink)

To obtain a patch, log in to My Oracle Support (formerly OracleMetaLink), click Patches and Updates, and search for the patch number:

http://support.oracle.com/

To obtain a support note or document, log in to My Oracle Support and enter the support note number in the Quick Find search field at the top of the My Oracle Support window and search the Knowledge Base for the note number.

3.1.1.2 Upgrading the Oracle BAM Schema on Oracle Database 11g on Microsoft Windows

Bug 8533981

If the Oracle Database you use to host your Oracle BAM schema is an Oracle Database 11g database, then you must apply the required patches to upgrade your database to Oracle Database 11g (10.1.0.7).

In addition, if the database is running on a Microsoft Windows 32-bit computer, then you must also apply patch 8451592 to the Oracle Database 11g (10.1.0.7) database before you can run the Upgrade Assistant to upgrade the Oracle BAM schema to 11g.

Patch 8451592 is also referred to as Oracle Database Server Version 11.1.0.7 Patch 11.

Important:

You must perform the steps described in Section 3.3.5, "Post Installation Instructions" of the Oracle Database Server Version 11.1.0.7 Patch 11 Bundle Patch Update Note, which explain in detail how to run the catcpu.sql script.
If you do not run the catcpu.sql script after applying the database patch, then the Oracle BAM schema upgrade will fail.

The patch update note is available by clicking the View Readme button when you locate the patch in My Oracle Support. It is also included in the downloaded ZIP file that contains the patch files.

For more information about upgrading the Oracle BAM schema, see the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF.

3.1.2 Unable to Read Composite Model Error During SOA Application Upgrade

The Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF describes how Oracle JDeveloper 11g will automatically upgrade specific features of your Oracle SOA Suite 10g applications to 11g.

However, if you see the following error while upgrading your application in JDeveloper 11g, then you can safely ignore the error. Your application will be upgraded, but you will need to create a new SOA-SAR deployment profile after the application upgrade. And use this newly created profile for deploying SOA composite:

SEVERE: Unable to read composite model for project project_name

For more information, see 43.2, "Deploying a Single SOA Composite in Oracle JDeveloper," in the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

3.1.3 Oracle BAM Upgrade Issues

The following sections provide information about specific issues related to upgrading Oracle BAM 10g to Oracle BAM 11g:

- Section 3.1.3.1, "Datapump Export for Oracle BAM Upgrade Plug-in Fails in Oracle Database 10g (10.2.0.3), 10g (10.1.2.0.4), and Oracle Database 11g (11.1.0.7)"

- Section 3.1.3.2, "Dependent Alerts Do Not Upgrade Correctly"

- Section 3.1.3.3, "Problem Upgrading a Report that Contains Calculated Fields"

- Section 3.1.3.4, "Calculated Fields Reference the Field ID Rather Than Field Names After Upgrade to Oracle BAM 11g"

- Section 3.1.3.5, "Using the Oracle BAM 11g Samples After Upgrade from Oracle BAM 10g"

3.1.3.1 Datapump Export for Oracle BAM Upgrade Plug-in Fails in Oracle Database 10g (10.2.0.3), 10g (10.1.2.0.4), and Oracle Database 11g (11.1.0.7)

Before you upgrade the Oracle BAM 11g schema to 11g, you must first apply patch 6522654 to your Oracle Database 10g (10.2.0.3), 10g (10.1.2.0.4), and Oracle Database 11g (11.1.0.7).

If you do not apply this patch, then you will likely experience the following error during Oracle BAM schema upgrade:

BAM MRUA: SCHEMA UPGRADE FAILED SQLException: ORA-39002: invalid operation

For more information, see Section 3.1.1, "Patches Required to Address Specific Upgrade and Compatibility Requirements".

3.1.3.2 Dependent Alerts Do Not Upgrade Correctly

When an alert in Oracle BAM 10g is dependent upon another alert, the dependent alert keeps a reference to the parent alert with a GUID reference. When such an alert is exported from 10g it will contain a GUID reference to the parent alert, and import to an Oracle BAM 11g system is not successful.

The following modification to the exported alert definition file can be used as a workaround for import to an Oracle BAM 11g system.

Edit the exported file contents of the dependent alert from the Oracle BAM 10g system, and modify the following element containing reference to parent alert.

Change this:

&lt;param name=&quot;RuleID&quot; order=&quot;0&quot;&gt;
//private:weblogic/Rule/624567ffe84de34c-6e6bdbaa120eb7f6ea6-8000
&lt;/param&gt;

To this:

&lt;param name=&quot;RuleID&quot; order=&quot;0&quot;&gt;
ParentAlertName
&lt;/param&gt;

In other words, the GUID reference for parent alert must be replaced by the parent alert's name.

3.1.3.3 Problem Upgrading a Report that Contains Calculated Fields

If you created a report in Oracle BAM 10g or in Oracle BAM 11g Release 1 (11.1.1.1.0) and the report contains calculated fields that use using datetime type fields, then the Calculations tab displays this error in Oracle BAM 11g Release 1 (11.1.1.2.0):

BAM-01610: INVALID FILTER EXPRESSION

More specifically, this error occurs when the calculation is an expression for equality check against a datetime field in String format. For example, for a datetime field such as Last Modified, the following calculation does not work:

If {Last Modified}=="7/18/2002 1:33:10 PM"

Before you can upgrade the report, you must remove the calculated fields.

3.1.3.4 Calculated Fields Reference the Field ID Rather Than Field Names After Upgrade to Oracle BAM 11g

After upgrading to Oracle BAM 11g Release 1 (11.1.1.2.0), any calculated fields in your reports will reference fields by the field ID, rather than the field name.

Specifically, after upgrade, the field name referenced in the expression will be converted to use the field id (for example, _Num_Sold).

For example, the field reference might appear as follows after the upgrade:

If({_Num_Sold}==5000)
Then("met")
Else("notmet")

Note that the calculated fields will continue to work after the upgrade and after this automatic conversion.

3.1.3.5 Using the Oracle BAM 11g Samples After Upgrade from Oracle BAM 10g

When you install Oracle BAM 11g, the installer copies a set of sample applications to the Oracle SOA Suite Oracle home. Refer to the following sections for more information about using these samples after upgrading to Oracle BAM 11g from Oracle BAM 10g:

- Section 3.1.3.5.1, "General Information About the Oracle BAM Samples"

- Section 3.1.3.5.2, "Removing Any 10g Sample Applications Before Configuring the Oracle BAM 11g Samples"

For information about using the Oracle BAM 11g after migrating from Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0), see Section 3.2.8, "Using the Oracle BAM 11g Prepackaged Samples After Migrating from 11.1.1.1.0".

3.1.3.5.1 General Information About the Oracle BAM Samples

The Oracle Fusion Middleware installer copies the Oracle BAM samples to the following location in the Oracle SOA Suite Oracle home:

SOA_ORACLE_HOME/bam/samples/bam/

Instructions for configuring and using the samples, as well as updated samples, can be found at the following URL on the Oracle Technology Network (OTN):

http://www.oracle.com/technology/products/integration/bam/collateral/samples11g.html

The instructions explain how to use the propert setup script to configure the demos in your Oracle BAM 11g environment. You can also find individual readme file for each demo within each sample directory.

3.1.3.5.2 Removing Any 10g Sample Applications Before Configuring the Oracle BAM 11g Samples

Before you use the instructions on OTN to set up the Oracle BAM 11g samples, remove any data objects, reports, or alerts associated with any existing 10g samples.

For example, be sure to remove any artifacts associated with the Oracle BAM 10g Call Center and Atherton demos before you run the setup scripts.

3.1.4 Error When Upgrading Oracle Internet Directory Due to Invalid ODS Schema

If you receive an error when using the Upgrade Assistant to upgrade the Oracle Internet Directory schema from 10g Release 2 (10.1.2.3) to 11g, then verify that the ODS 10g schema is valid.

To view the status of the Oracle Application Server 10g schemas in your database, use the following SQL command:

SELECT comp_id, version, status FROM app_registry;

If the output from this command shows that the ODS schema is INVALID, then use the instructions in the following My Oracle Support document to install and configure Referential Integrity:

730360.1, "Referential Integrity in Oracle Internet Directory Version 10.1.2.3"

After performing the instructions in the support document, then retry the Oracle Internet Directory schema upgrade.

3.1.5 Restore From Backup Required If Upgrade Fails During a Colocated Oracle Internet Directory and Oracle Directory Integration Platform Upgrade

If you are using the Upgrade Assistant to upgrade both Oracle Internet Directory and Oracle Directory Integration Platform, consider the following.

If the Oracle Internet Directory upgrade fails, then before you can run the Upgrade Assistant again, you must restore your Oracle Internet Directory 10g backup before you can run the Upgrade Assistant again. Otherwise, the Upgrade Assistant will not attempt to upgrade Oracle Directory Integration Platform.

3.1.6 Cannot Verify Oracle Forms Services Upgrade When Oracle HTTP Server is Running On a Separate Host

If you use the Upgrade Assistant to upgrade an Oracle Forms Services instance that does not include a local instance of Oracle HTTP Server, then the Verify feature of the Upgrade Assistant cannot verify that the upgrade was successful. Instead of reporting that the upgrade was successful, the Verify feature will report that the server is unavailable. This verification error may not be valid if the Oracle HTTP Server is installed and configured on a different host than the Oracle Forms Services instance.

3.1.7 WebCenter Security Upgrade Release Notes

The following bugs/release notes relate to security changes for Custom WebCenter applications upgrading from 10.1.3.x:

- Section 3.1.7.1, "RowSetPermission check fails with compatibility flag set"

- Section 3.1.7.2, "Grants not migrated properly if application contains grants without permissions"

- Section 3.1.7.3, "Shared/public credentials not found after external application deployed"

3.1.7.1 RowSetPermission check fails with compatibility flag set

In 10.1.3, the ADF framework performed rowset, attribute, and method permission checks in addition to page permission checks. If a 10.1.3 application grants 'read' permission on the rowset and attribute and 'invoke' permission on the method for all users, then the application will behave as expected in 11R1 without any additional setup.

However, if the 10.1.3 application was designed to allow only certain users to view the rowset, attribute, or invoke method, then a special flag needs to be set to support this style of security. If this flag is not set, then anyone who has page access can view attributes and rowsets and invoke methods since in 11R1 the permission check is performed only on pages and taskflows. The flag must be set for each application in the adf-config.xml file.

<sec:adf-security-child xmlns="http://xmlns.oracle.com/adf/security/config">
<JaasSecurityContext
initialContextFactoryClass=
"oracle.adf.share.security.JAASInitialContextFactory"
jaasProviderClass=
"oracle.adf.share.security.providers.jps.JpsSecurityContext"
authorizationEnforce="true"/>
<contextEnv name="oracle.adf.security.metadata" value="false"/>
<CredentialStoreContext
credentialStoreClass=
"oracle.adf.share.security.providers.jps.CSFCredentialStore"
credentialStoreLocation="../../src/META-INF/jps-config.xml"/>
</sec:adf-security-child>

3.1.7.2 Grants not migrated properly if application contains grants without permissions

Grants are not migrated properly if a 10.1.3 application contains grants without any permissions. Developers should inspect the app-jazn-data.xml file in the 10.1.3 workspace and remove any grants that have empty permission set prior to performing the migration.

3.1.7.3 Shared/public credentials not found after external application deployed

If you have secured your 10.1.3 application, ensure there are no duplicate JaasSecurityContext and CredentialStoreContext elements in the application's adf-config.xml file prior to migration.In the following example, the first JaasSecurityContext element is empty and should be removed (see "Remove entry" in the XML snippet below).

<adf-config-child xmlns="http://xmlns.oracle.com/adf/security/config">
<CredentialStoreContext
credentialStoreClass=
"oracle.adf.share.security.providers.jazn.JAZNCredentialStore"
credentialStoreDefaultUser="anonymous"
credentialStoreLocation="./credential-store.xml"/>
<JaasSecurityContext/> <!--Remove entry-->
<JaasSecurityContext
initialContextFactoryClass=
"oracle.adf.share.security.JAASInitialContextFactory"
jaasProviderClass=
"oracle.adf.share.security.providers.jazn.JAZNSecurityContext"
authorizationEnforce="true"/>
</adf-config-child>

3.1.8 Oracle B2B Upgrade Release Notes

The following release notes apply when you are upgrading Oracle B2B 10g to Oracle B2B 11g:

- Section 3.1.8.1, "Service Name Is Required When Using ebMS with Oracle B2B"

- Section 3.1.8.2, "Converting Wallets to Keystores for Oracle B2B 11g"

- Section 3.1.8.3, "Oracle B2B UCCnet Documents Not Upgraded to 11g"

- Section 3.1.8.4, "Errors in the Upgrade Log Files Even When Oracle B2B Schema Upgrade is Successful"

3.1.8.1 Service Name Is Required When Using ebMS with Oracle B2B

Because the Service Name parameter is required when using the ebMS protocol in Oracle B2B 11g, you may need to provide a value for this field after importing 10g data.

With the agreement in the draft state, update the field on the Partners > Documents tab. When you select a document definition that uses the ebMS protocol, the Document Type > ebMS tab appears in the Document Details area. The Service Name field is on this tab.

3.1.8.2 Converting Wallets to Keystores for Oracle B2B 11g

After upgrading to Oracle B2B 11g, use the orapki pkcs12_to_jks option to replace the entire keystore. Convert the wallet to a keystore as follows:

1. Back up the original keystore.

2. Use the orapki wallet pkcs12_to_jks option to convert to the keystore.

3. Use keytool -list to list the aliases and verify.

4. Use keytool -importkeystore to import the converted keystore to the backup of the original keystore (as done in Step 1)

3.1.8.3 Oracle B2B UCCnet Documents Not Upgraded to 11g

OracleAS Integration B2B provides support for UCCnet under the Custom Document option. UCCnet is a service that enables trading partners to exchange standards-compliant data in the retail and consumer goods industries.

Note, however, that UCCnet documents are not upgraded automatically to Oracle B2B 11g. For information about using UCCnet documents in Oracle B2B 11g, see "Using the UCCnet Document Protocol" in the Oracle Fusion Middleware User's Guide for Oracle B2B.

3.1.8.4 Errors in the Upgrade Log Files Even When Oracle B2B Schema Upgrade is Successful

When you use Oracle Fusion MiddlewareUpgrade Assistant upgrade the Oracle B2B schema, some errors might appear in the upgrade log files even if the Oracle B2B schema upgrade is successful.

For example, you might see an error, such as the following:

oracle.jrf.UnknownPlatformException: JRF is unable to determine the current
application server platform

As long as the Upgrade Assistant reports that the upgrade was sucessful, these errors can be safely ignored. They will be addressed in a future release.

For more information about troubleshooting upgrade issues, including how to use the upgrade log files, see "General Troubleshooting Guidelines" in the Oracle Fusion Middleware Upgrade Planning Guide.

For more information about the Oracle B2B schema upgrade, see "If Necessary, Upgrade the B2B Schema," in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF.

3.1.9 Problem Accessing the Welcome Pages in Oracle HTTP Server After Upgrade

After you upgrade to Oracle HTTP Server 11g, the DirectoryIndex directive in the httpd.conf set to index.html. As a result, if you go to the recommended URL to view the Oracle Fusion Middleware Welcome pages you instead see the "hello world" sample application page.

To address this issue:

1. Edit the httpd.conf file in the following location:

ORACLE_INSTANCE/config/OHS/ohs_component_name/

2. Locate the DirectoryIndex directive in the httpd.conf file and change index.html to welcome-index.html.

3. Restart the Oracle HTTP Server instance.

3.1.10 Misleading Error Message When Upgrading Oracle Internet Directory

When upgrading to Oracle Internet Directory 11g, you might notice an error message in the Upgrade Assistant (Example 3-1). This error message indicates that some managed processes failed to start.

You can safely ignore this message, as long as the Upgrade Assistant messages also indicates that all components were upgraded successfully. This error occurs when the Upgrade Assistant attempts to start the Oracle Enterprise Manager agent and the agent is already running.

Example 3-1 Error Message When Upgrading Oracle Internet Directory

-----------------------------------------------------------
Starting Destination Components
Starting OPMN and managed processes in the destination Oracle instance.
->UPGAST-00141: startup of 11g OPMN managed processes failed.
Starting WebLogic managed server wls_ods1
Clicked OK to continue
Upgrade Progress 100%
All components were upgraded successfully.
------------------------------------------------------------

3.1.11 Additional Steps Required When Redeploying the SOA Order Booking Sample Application on Oracle Fusion Middleware 11g

Appendix A of the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF provides an example of how to use Oracle JDeveloper 11g upgrade and redeploy a complex application on Oracle Fusion Middleware 11g.

However, after you install Oracle Fusion Middleware 11g (11.1.1.3.0), you must perform the following additional tasks before you can successfully compile and deploy the application with Oracle JDeveloper 11g:

1. Before you open and upgrade the application with Oracle JDeveloper 11g, edit the original web.xml and replace the <web-app> element with the following:

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5" xmlns="http://java.sun.com/xml/ns/javaee">

2. Follow the steps in Appendix A of the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF to open the SOA Order Booking application in Oracle JDeveloper 11g and to upgrade the projects within the application.

3. When you get to Section A.8.10, "ApproveOrderTaskForm," open the web.xml and verify that it contains a <servlet> element and <servlet_mapping> element for the WFTTaskUpdate servlet.
If such an element does not exist in the web.xml file, then edit the web.xml file and add the elements shown in Example 3-2.

4. Continue with the rest of the instructions for deploying the project.

Example 3-2 Servlet Elements to Add to the SOA Order Booking web.xml File

<servlet>
<servlet-name>
WFTaskUpdate
</servlet-name>
<servlet-class>
oracle.bpel.services.workflow.worklist.servlet.WFTaskUpdate
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>
WFTaskUpdate
</servlet-name>
<url-pattern>
/WFTaskUpdate
</url-pattern>
</servlet-mapping>

3.1.12 Additional Steps Required When Upgrading Human Taskflow Projects

By default, if you deploy an upgraded Oracle SOA Suite 10g Release 3 (10.1.3) application that includes a Human Taskflow project on Oracle Fusion Middleware 11g (11.1.1.3.0), you will not be able to view the taskflow details.

To work around this problem, perform the following additional steps when you are deploying an application with a Human Taskflow project:

1. Before you open and upgrade the application with Oracle JDeveloper 11g, edit the original web.xml and replace the <web-app> element with the following:

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5" xmlns="http://java.sun.com/xml/ns/javaee">

2. After you open and upgrade the application in Oracle JDeveloper 11g, do the following:

1. In Oracle JDeveloper 11g, deploy the application to an EAR file.

2. Expand the EAR file on disk, and then expand the packaged WAR file on disk.
For example:

jar -xvf ear_file_name.ear
jar -xvf war_file_name.war

3. Open the web.xml file in the WEB-INF directory of the WAR file and comment out the following entry:

<!--servlet-mapping>
<servlet-name>jsp</servlet-name>
<url-pattern>*.jsp</url-pattern>
</servlet-mapping-->

4. Repackage WAR and subsequently the EAR.
For example:

jar -cvf war_file_name.war *
jar -cvf ear_file_name.ear *

5. Deploy the EAR using the WebLogic Administration Console.
Note that is important that you use the Oracle WebLogic Server Administration Console to deploy the application and not Oracle JDeveloper 11g. This is because Oracle JDeveloper forces a rebuild of the applciation and your changes will be overwritten.

3.1.13 Stopping Oracle Virtual Directory Processes During Upgrade

When upgrading Oracle Virtual Directory to 11g, you must manually stop Oracle Virtual Directory processes if multiple Oracle Virtual Directory processes are running. When you attempt to stop Oracle Virtual Directory, only the last process that started will stop. If multiple Oracle Virtual Directory processes are running, you must use the kill -9 command to stop the processes before upgrading to Oracle Virtual Directory 11g.

3.1.14 Providing Input to Upgrade Assistant Screens When Oracle Internet Directory Upgrade Fails

If Oracle Internet Directory upgrade fails during the Examine phase in the upgrade process, do not modify the input you entered in the screens. Instead, dismiss the Upgrade Assistant wizard and the upgrade process again.

3.1.15 Upgrading Oracle Access Manager Middle Tier

When running the Upgrade Assistant to upgrade the Oracle Single Sign-On 10g to Oracle Access Manager 11g, you must run the Upgrade Assistant from the same machine where your Oracle Access Manager Managed Server is running.

3.1.16 Inaccurate Results When Running the Upgrade Assistant Verify Feature

For some upgrade scenarios, the Oracle Fusion Middleware Upgrade Assistant provides a Verify feature that attempts to analyze the upgraded 11g environment. When you run the Verify feature, the Upgrade Assistant automatically reports any problems it finds with the upgraded environment.

However, there are cases where the Verify feature incorrectly identifies a problem. For example, when single sign-on is enabled, the Verify feature might report that it cannot access specific URLs for the upgraded components.

In these cases, you should enter the URL directly into a Web browser to verify the URL. In those cases, the URL might indeed be valid and you can ignore the errors generated by the Verify feature.

3.1.17 Missing jdk_version.log File When Launching Upgrade Assistant

When you start the Oracle Fusion Middleware Upgrade Assistant to begin an upgrade of the Oracle Identity and Access Management products, the Upgrade Assistant might display an error message in the terminal window that indicates that the following file is missing:

temp\jdk_version.log

If you see this error, quit the Upgrade Assistant and manually create the following directory before running the Upgrade Assistant:

ORACLE_HOME/upgrade/temp

In this example, ORACLE_HOME is the directory where Oracle Identity and Access Manager product is installed.

3.1.18 Test Suites in Oracle SOA Suite 10g Projects Not Upgraded to 11g

When you upgrade your Oracle SOA Suite 10g projects to Oracle SOA Suite 11g, test suites defined in your Oracle JDeveloper projects will not be upgraded to 11g. In most cases, you will have to modify or recreate your test suites in Oracle JDeveloper 11g.

For more information, refer to the following:

- "Correcting Problems With Oracle BPEL Process Manager Test Suites" in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

- "Automating Testing of SOA Composite Applications" in the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite

3.2 General Issues and Workarounds for Migrating from 11.1.1.1.0

This section describes general issue and workarounds that apply only if you are starting with Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0) and you are using the instructions in Appendix B, "Using Patch Assistant to Migrate from 11g Release 1 (11.1.1.1.0) to Release 1 (11.1.1.2.0)" in the Oracle Fusion Middleware Patching Guide.

This section includes the following topics:

- Section 3.2.1, "Stopping the 11.1.1.2.0 Domain"

- Section 3.2.2, "Editing the patchMaster.properties File"

- Section 3.2.3, "Patching the Schema for Oracle Internet Directory"

- Section 3.2.4, "Changing the patchmaster.ValidationErrorContinue Property"

- Section 3.2.5, "Changing the Default Setting for Validation Tasks"

- Section 3.2.6, "Severe Error When Running the execute-sql-rcu Macro"

- Section 3.2.7, "Machine Names Do Not Appear in the Oracle WebLogic Server Administration Console"

- Section 3.2.8, "Using the Oracle BAM 11g Prepackaged Samples After Migrating from 11.1.1.1.0"

3.2.1 Stopping the 11.1.1.2.0 Domain

While stopping the 11.1.1.2.0 domain by using the ant master-stop-domain-new command, you may see the following exceptions if the Administration Server and the Managed Servers are down:

java.net.ConnectException: Connection refused: connect; No available router to destination.

The admin server and the managed servers should be up while running the command.

3.2.2 Editing the patchMaster.properties File

When specifying values in the patchMaster.properties file on Windows, ensure that / is used for file delimiters. You can use \ as an escape character. When a \ is used in the patchMaster.properties file, Patch Assistant warns you of the existence of the character and prompts if the patch operation should be continued ["y"/"n"]. If you do not desire prompting and have ensured the integrity of the patchMaster.properties file, then run the ant commands with the -noinput option.

3.2.3 Patching the Schema for Oracle Internet Directory

While patching the schema for Oracle Internet Directory, ensure that you specify only OID as the parameter for the patchMaster.Componentlist property in the patchMaster.properties file.

3.2.4 Changing the patchmaster.ValidationErrorContinue Property

By default, the patchMaster.ValidationErrorContinue file appears as patchmaster.ValidationErrorContinue. When you run this property, an error occurs.

Therefore, if you are using this property, replace the default property with patchMaster.ValidationErrorContinue before running Patch Assistant.

3.2.5 Changing the Default Setting for Validation Tasks

Patch Assistant validates the properties specified in the patchMaster.properties file. Additionally it performs the following validation tasks:

- Verify whether the potential source, target home, and instance paths exist.

- Verify locations to discover it they are an instance, home, and so on.

- Validate individual migration task. For example, if you are migrating a domain, then schema-based properties are not required. If the schema-based properties are specified, be sure to set the complete and proper set of schema-based properties.

- Attempts to recognize exceptions to specific components. For example, if Oracle Internet Directory is solely specified as the component being patched, then the property patchMaster.Schemaprefix is not necessary. However, if other components are being patched, then it is assumed that patchMaster.Schemaprefix is a necessary part of schema property validation.

If you want to continue with the Patch Assistant task after a validation error occurs, then you can open the patchMaster.properties file (Located in your patchMaster directory) in a text editor, and change the value to true for the patchMaster.ValidationErrorContinue property (The default value is false). Alternatively, you can use the Ant command-line utility to override the properties set in the patchMaster.properties file. You must specify the required property on the command line as follows:

ant-DpatchMaster.ValidationErrorContinue

3.2.6 Severe Error When Running the execute-sql-rcu Macro

When running the execute-sql-rcu macro, you may see the following error message, while the SQL script is still running:

[java] SEVERE: Error while registering Oracle JDBC Diagnosability MBean.
[java] java.security.AccessControlException: access denied (javax.management.MBeanTrustPermission register)

To resolve this error, you must grant the register permission by adding the following syntax to the java.policy file (Located at JAVA_HOME/jre/lib/security in UNIX and JAVA_HOME\jre\lib\security in Windows):

.
grant codeBase "file:${PATCH-MASTER-HOME}/lib/*.jar" {
permission javax.management.MBeanTrustPermission "register";
};

Note:

Ensure that you replace {PATCH-MASTER-HOME} with your home path.

3.2.7 Machine Names Do Not Appear in the Oracle WebLogic Server Administration Console

After running Patch Assistant, you cannot see the list of machines (Machine-0 and Machine-1) configured during 11.1.1.1.0 and 11.1.1.2.0, in the Oracle WebLogic Server Administration Console. After migrating to 11.1.1.2.0, you must re-enter the machine names using the Oracle WebLogic Server Administration Console. For more information, see Create and configure machines topic in the Oracle Fusion Middleware Oracle WebLogic Server Administration Console Online Help.

3.2.8 Using the Oracle BAM 11g Prepackaged Samples After Migrating from 11.1.1.1.0

If you are using the Oracle BAM 11g sample applications, refer to the following sections for information about using the samples after migrating from Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0) to Release 1 (11.1.1.2.0):

- Section 3.2.8.1, "Configuring the Oracle BAM 11g Samples After Migrating from 11.1.1.1.0"

- Section 3.2.8.2, "Using the Foreign Exchange Sample After Migrating from 11.1.1.1.0"

For more information about the Oracle BAM 11g samples, see Section 3.1.3.5.1, "General Information About the Oracle BAM Samples".

3.2.8.1 Configuring the Oracle BAM 11g Samples After Migrating from 11.1.1.1.0

After you migrate from Oracle Fusion Middleware 11g Release 1 (11.1.1.1.0) to 11g Release 1 (11.1.1.2.0), be sure to run the proper setup script for setting up samples. Specifically, you must run the recreate script instead of the setup script.

For more information, see the readme file for each of the Oracle BAM 11g samples.

3.2.8.2 Using the Foreign Exchange Sample After Migrating from 11.1.1.1.0

After you run the recreate script to set up the Foreign Exchange sample after migrating from 11.1.1.1.0, you might experience the following error when you open the report (Shared Reports/Demos/Foreign Exchange):

The "Trade Volume" has an error:
CACHEEXCEPTION_NULL_NULL_NULL
Message:BAM-01274: The field ID 1 is not recognized.

To fix this problem, perform the following steps:

1. Open Active Studio.

2. Open the report:

Shared Reports/Demos/Foreign Exchange/SLAViolation Report

3. Click Edit.

4. Select the Trade Volume view and click Edit View.

5. In the Fields tab under Group By, select the field GroupBy.

6. Go to the Surface Prompts tab.

7. From the Display in drop-down menu, in select View Title.

8. Click Apply and save the report.

Visit the Oracle BAM samples page on OTN regularly to obtain updated samples and more information about the Oracle BAM sample applications.

3.3 Documentation Errata for Upgrade

This section provides documentation errata for the following guides:

- Section 3.3.1, "Documentation Errata for the Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF"

- Section 3.3.2, "Documentation Errata for the Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management"

- Section 3.3.3.1, "Clarification of Post-Upgrade Tasks for SSL-Enabled Oracle HTTP Server"

3.3.1 Documentation Errata for the Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF

This section contains documentation errata for the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF:

- Section 3.3.1.1, "Errors in Additional Steps for Upgrading Technology Adapter Headers"

- Section 3.3.1.2, "FrameworkFolders Not Enabled by Default on Content Server"

3.3.1.1 Errors in Additional Steps for Upgrading Technology Adapter Headers

In the section, "Additional Steps When Upgrading Technology Adapter Headers" in the Oracle Fusion Middleware Upgrade Guide for Oracle SOA Suite, WebCenter, and ADF, note the following:

- In the subsection, "Example Steps to Perform After Upgrading to Oracle Mediator," the example shown should appear as follows:

<copy target="$out.property.jca.aq.HeaderDocument" expression="'&lt;?xml
version = &quot;1.0&quot; standalone= &quot;yes&quot;?>&lt;tns:Header
xmlns:tns=&quot;http://xmlns.oracle.com/pcbpel/adapter/aq/outbound/">
<tns:PayloadHeader>&lt;MSG_ID>&lt;
/MSG_ID>&lt;INREPLYTO_MSG_ID>&lt;
/INREPLYTO_MSG_ID>&lt;FROM_PARTY>GlobalChips&lt;
/FROM_PARTY>&lt;TOPARTY>Acme&lt;
/TO_PARTY>&lt;ACTION_NAME>&lt;/ACTION_NAME>&lt;DOCTYPE_NAME>ORDERS&lt;
/DOCTYPE_NAME>&lt;DOCTYPE_REVISION>D98A&lt;
/DOCTYPE_REVISION>&lt;MSG_TYPE>1&lt;
/MSG_TYPE>&lt;PAYLOAD>&lt;
/PAYLOAD>&lt;/tns:PayloadHeader>&lt;/tns:Header>'"/>

- In the subsection, "Example Steps to Perform After Upgrading to Oracle BPEL Process Manager," Example 14-1, "Assign Block When Upgrading Adapter Headings" should appear as follows:

<assign name="assign header">
<copy>
<from expression="'&lt;?xml version = &quot;1.0&quot;standalone = &quot;yes&quot;?>&lt;tns:Header
xmlns:tns=&quot;http://xmlns.oracle.com/pcbpel/adapter/aq/Inbound/">
<tns:PayloadHeader>&lt;MSG_ID>12345&lt;
/MSG_ID>&lt;INREPLYTO_MSG_ID>54321&lt;
/INREPLYTO_MSG_ID>&lt;FROM_PARTY>Acme&lt;
/FROM_PARTY>&lt;TO_PARTY>GlobalChips&lt;
/TO_PARTY>&lt;ACTION_NAME>contentType:application/octet-stream;
filename:abc.xml&lt;
/ACTION_NAME>&lt;DOCTYPE_NAME>850&lt;
/DOCTYPE_NAME>&lt;DOCTYPE_REVISION>4010&lt;
/DOCTYPE_REVISION>&lt;MSG_TYPE>1&lt;/MSG_TYPE>&lt;PAYLOAD>&lt;
/PAYLOAD>&lt;/tns:PayloadHeader>&lt;/tns:Header>'"/>
<to variable="headerVariable"/>
</copy>
</assign>

3.3.1.2 FrameworkFolders Not Enabled by Default on Content Server

In section "Upgrading to Oracle WebCenter Content Server 11g", step 3 incorrectly states the following:

"When you upgrade Oracle Content Server 10g to Oracle WebCenter Content Server 11g, FrameworkFolders is enabled out of the box."

The FrameworkFolders component is not enabled out of the box. If you are using WebCenter Portal, Folders_g must be used as the Foldering component, and not FrameworkFolders.

3.3.2 Documentation Errata for the Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management

This section describes documentation errata. It includes the following topics:

- Section 3.3.2.1, "Error in Procedure for Identifying Additional Oracle Internet Directory Instances"

- Section 3.3.2.2, "Error in Oracle Virtual Directory Releases Supported"

3.3.2.1 Error in Procedure for Identifying Additional Oracle Internet Directory Instances

In the section, "Recreating Any Non-Default Oracle Internet Directory Instances," in the Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management, step 1 describes how to identify any additional, non-default Oracle Internet Directory instances you have created.

However, the procedure fails to indicate that the command provided will display a list of the default instances, as well as any non-default instances. Be sure to review the output of the command in Step 1 and identify only the Oracle Internet Directory instances that were not created by default, during the Oracle Internet Directory installation procedure.

If you have not created any non-default Oracle Internet Directory instances, then there is no need to perform the steps in the section, "Recreating Any Non-Default Oracle Internet Directory Instances."

3.3.2.2 Error in Oracle Virtual Directory Releases Supported

In Table 2-2, "Oracle Virtual Directory Releases Supported By This Guide," the "Description or Notes" section states:

This version of Oracle Identity Federation was available as part of Oracle Application Server 10g (10.1.4.0.1). It was installed using a separate installation procedure and installation guide.

It should say:

This version of Oracle Virtual Directory was available as part of Oracle Application Server 10g (10.1.4.0.1). It was installed using a separate installation procedure and installation guide.

3.3.3 Documentation Errata for the Oracle Fusion Middleware Upgrade Guide for Java EE

This section contains documentation errata for the Oracle Fusion Middleware Upgrade Guide for Java EE. It contains the following sections:

- Section 3.3.3.1, "Clarification of Post-Upgrade Tasks for SSL-Enabled Oracle HTTP Server"

3.3.3.1 Clarification of Post-Upgrade Tasks for SSL-Enabled Oracle HTTP Server

Section 7.5.2, "Verifying and Updating the Oracle HTTP Server and Oracle Web Cache Ports After Upgrade" in the Oracle Fusion Middleware Upgrade Guide for Java EE provides information about additional post-upgrade steps you must perform for Oracle HTTP Server in some situations.

Specifically, if you decide to use the new ports defined for your Oracle Fusion Middleware 11g installation, rather than ports used for your Oracle Application Server 10g installation, then you should verify the listening ports, origin servers, site definitions, and site-to-server mapping settings, and make changes if appropriate.

This section fails to mention that you should perform this task even if the Oracle HTTP Server instance and Oracle Web Cache instance reside in the same Oracle home and you upgrade them together.

For example, if you have enabled end-to-end SSL in your 10g environment, then you must edit the ssl.conf file in the upgraded Oracle home to ensure that the ServerName entry in the Oracle HTTP Server 11g ssl.conf file is correct. Locate the ssl.conf file in the Oracle Fusion Middleware 11g Oracle home, and verify that the ServerName directive is set to the 11g Oracle Web Cache host and listening port:

For example:

ServerName staeb56.us.oracle.com:443

4 Oracle Fusion Middleware Administration

This chapter describes issues associated with Oracle Fusion Middleware administration. It includes the following topics:

- Section 4.1, "General Issues and Workarounds"

- Section 4.2, "Configuration Issues and Workarounds"

- Section 4.3, "Documentation Errata for the Oracle Fusion Middleware Administrator's Guide"

Note:

This chapter contains issues you might encounter while administering any of the Oracle Fusion Middleware products.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

4.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 4.1.1, "Clarification About Path for OPMN"

- Section 4.1.2, "Fusion Middleware Control May Return Error in Mixed IPv6 and IPv4 Environment"

- Section 4.1.3, "Deploying JSF Applications"

- Section 4.1.4, "Limitations in Moving from Test to Production"

- Section 4.1.5, "Limitations in Moving Oracle Business Process Management from Test to Production Environment"

- Section 4.1.6, "Message Returned with Incorrect Error Message Level"

4.1.1 Clarification About Path for OPMN

OPMN provides the opmnctl command. The executable file is located in the following directories:

- ORACLE_HOME/opmn/bin/opmnctl: The opmnctl command from this location should be used only to create an Oracle instance or a component for an Oracle instance on the local system. Any opmnctl commands generated from this location should not be used to manage system processes or to start OPMN.
On Windows, if you start OPMN using the opmnctl start command from this location, OPMN and its processes will terminate when the Windows user has logged out.

- ORACLE_INSTANCE/bin/opmnctl: The opmnctl command from this location provides a per Oracle instance instantiation of opmnctl. Use opmnctl commands from this location to manage processes for this Oracle instance. You can also use this opmnctl to create components for the Oracle instance.
On Windows, if you start OPMN using the opmnctl start command from this location, it starts OPMN as a Windows service. As a result, the OPMN parent process, and the processes which it manages, persist after the MS Windows user has logged out.

4.1.2 Fusion Middleware Control May Return Error in Mixed IPv6 and IPv4 Environment

If your environment contains both IPv6 and IPv4 network protocols, Fusion Middleware Control may return an error in certain circumstances.

If the browser that is accessing Fusion Middleware Control is on a host using the IPv4 protocol, and selects a control that accesses a host using the IPv6 protocol, Fusion Middleware Control will return an error. Similarly, if the browser that is accessing Fusion Middleware Control is on a host using the IPv6 protocol, and selects a control that accesses a host using the IPv4 protocol, Fusion Middleware Control will return an error.

For example, if you are using a browser that is on a host using the IPv4 protocol and you are using Fusion Middleware Control, Fusion Middleware Control returns an error when you navigate to an entity that is running on a host using the IPv6 protocol, such as in the following situations:

- From the Oracle Internet Directory home page, you select Directory Services Manager from the Oracle Internet Directory menu. Oracle Directory Services Manager is running on a host using the IPv6 protocol.

- From a Managed Server home page, you click the link for Oracle WebLogic Server Administration Console, which is running on IPv6.

- You test Web Services endpoints, which are on a host using IPv6.

- You click an application URL or Java application which is on a host using IPv6.

To work around this issue, you can add the following entry to the /etc/hosts file:

nnn.nn.nn.nn  myserver-ipv6 myserver-ipv6.example.com

In the example, nnn.nn.nn.nn is the IPv4 address of the Administration Server host, myserver.example.com.

4.1.3 Deploying JSF Applications

Some JSF applications may experience a memory leak due to incorrect Abstract Window Toolkit (AWT) application context classloader initialization in the Java class library. Setting the oracle.jrf.EnableAppContextInit system property to true will attempt eager initialization of the AWT application context classloader to prevent this leak from occurring. By default, this property is set to false.

4.1.4 Limitations in Moving from Test to Production

Note the following limitations in moving from test to production:

- If your environment includes Oracle WebLogic Server which you have upgraded from one release to another (for example from 10.3.4 to 10.3.5), the pasteConfig scripts fails with the following error:

Oracle_common_home/bin/unpack.sh line29:
WL_home/common/bin/unpack.sh No such file or directory

To work around this issue, edit the following file:

MW_HOME/utils/uninstall/WebLogic_Platform_10.3.5.0/WebLogic_Server_10.3.5.0_Core_Application_Server.txt file

Add the following entries:

/wlserver_10.3/server/lib/unix/nodemanager.sh
/wlserver_10.3/common/quickstart/quickstart.cmd
/wlserver_10.3/common/quickstart/quickstart.sh
/wlserver_10.3/uninstall/uninstall.cmd
/wlserver_10.3/uninstall/uninstall.sh
/utils/config/10.3/setHomeDirs.cmd
/utils/config/10.3/setHomeDirs.sh

- When you are cloning Oracle Virtual Directory, the Oracle instance name in the source environment cannot be the same as the Oracle instance name in the target environment. The Oracle instance name in the target must be different than the name in the source.

- After you clone Oracle Virtual Directory from one host to another, you must add a self-signed certificate to the Oracle Virtual Directory keystore and EM Agent wallet on Host B. Take the following steps:

1. Set the ORACLE_HOME and JAVA_HOME environment variables.

2. Delete the existing self-signed certificate:

$JAVA_HOME/bin/keytool -delete -alias serverselfsigned
-keystore ORACLE_INSTANCE/config/OVD/ovd_component_name/keystores/keys.jks
-storepass OVD_Admin_password

3. Generate a key pair:

$JAVA_HOME/bin/keytool -genkeypair
-keystore ORACLE_INSTANCE/config/OVD/ovd_component_name/keystores/keys.jks
-storepass OVD_Admin_password -keypass OVD_Admin_password -alias serverselfsigned
-keyalg rsa -dname "CN=Fully_qualified_hostname,O=test"

4. Export the certificate:

$JAVA_HOME/bin/keytool -exportcert
-keystore ORACLE_INSTANCE/config/OVD/ovd_component_name/keystores/keys.jks
-storepass OVD_Admin_password -rfc -alias serverselfsigned
-file ORACLE_INSTANCE/config/OVD/ovd_component_name/keystores/ovdcert.txt

5. Add a wallet to the EM Agent:

ORACLE_HOME/../oracle_common/bin/orapki wallet add
-wallet ORACLE_INSTANCE/EMAGENT/EMAGENT/sysman/config/monwallet
-pwd EM_Agent_Wallet_password -trusted_cert
-cert ORACLE_INSTANCE/config/OVD/ovd_component_name/keystores/ovdcert.txt

6. Stop and start the Oracle Virtual Directory server.

7. Stop and start the EM Agent.

- The copyConfig operation fails if you are using IPv6 and the Managed Server listen address is not set.
To work around this problem, set the Listen Address for the Managed Server in the Oracle WebLogic Server Administration Console. Navigate to the server. Then, on the Settings for server page, enter the Listen Address. Restart the Managed Servers.

- When you are moving Oracle Platform Security and you are using an LDAP store, the LDAP store on the source environment must be running and it must be acccessible from the target during the pasteConfig operation.

4.1.5 Limitations in Moving Oracle Business Process Management from Test to Production Environment

Note the following limitations when moving Oracle Business Process Management from a test environment to a production environment:

- When you move Oracle Business Process Management from a test environment to a production environment as described in the Task "Move Oracle Business Process Management to the New Production Environment" in the Oracle Fusion Middleware Administrator's Guide, Oracle Business Process Management Organization Units are not imported.
To work around this issue, you must re-create the Organization Units in the production environment. In addition, if any Organization associations with the Calendar rule for the Role exist in the test environment, you must re-create them, using the Roles screen.

For information, see "Working with Organizations" in the Oracle Fusion Middleware Modeling and Implementation Guide for Oracle Business Process Management.

- Oracle recommends that you move artifacts and data into a new, empty production environment. If the same artifacts are present or some data has been updated on the production environment, the procedure does not update those artifacts.

- If Oracle Service Bus is part of the same domain as Oracle SOA Suite, you cannot use the test-to-production procedures described in "Moving Oracle SOA Suite to a Production Environment" in the Oracle Fusion Middleware Administrator's Guide. you can either install Oracle Service Bus in a different domain, or manually create the production environment.

4.1.6 Message Returned with Incorrect Error Message Level

In Fusion Middleware Control, when you select a metadata repository, the following error messages are logged:

Partitions is NULL
Partitions size is 0

These messages are logged at the Error level, which is incorrect. They should be logged at the debug level, to provide information.

4.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 4.2.1, "Must Stop Oracle SOA Suite Managed Server Before Stopping soa-infra"

- Section 4.2.2, "Configuring Fusion Middleware Control for Windows Native Authentication"

- Section 4.2.3, "Fusion Middleware Control Does Not Keep Column Preferences in Log Viewer Pages"

- Section 4.2.4, "Topology Viewer Does Not Display Applications Deployed to a Cluster"

- Section 4.2.5, "Changing Log File Format"

- Section 4.2.6, "SSL Automation Tool Configuration Issues"

4.2.1 Must Stop Oracle SOA Suite Managed Server Before Stopping soa-infra

Using Fusion Middleware Control, if you stop a Oracle SOA Suite Managed Server before you stop soa-infra, then you start the Managed Server, the soa-infra application is not restarted automatically. If you try to restart the soa-infra, you will received an error. When you encounter the problem, you cannot close the dialog box in the browser, so you cannot take any further actions in Fusion Middleware Control.

To avoid this situation, you should stop the Managed Server, which stops all applications, including the soa-infra application. To start the Managed Server and the soa-infra, start the Managed Server.

To close the browser dialog box, enter the following URL in your browser:

http://host:port/em

4.2.2 Configuring Fusion Middleware Control for Windows Native Authentication

To use Windows Native Authentication (WNA) as the single sign-on mechanism between Fusion Middleware Control and Oracle WebLogic Server Administration Console, you must make changes to the following files:

- web.xml

- weblogic.xml

These files are located in the em.ear file. You must explode the em.ear file, edit the files, then rearchive the em.ear file. Take the following steps (which assume that while the front end is on Windows, the em.ear file is on UNIX):

1. Set the JAVA_HOME environment variable. For example:

setenv JAVA_HOME /scratch/Oracle/Middleware/jrockit_160_05_R27.6.2-20

2. Change to the directory containing the em.ear, and explode the file. For example:

cd /scratch/Oracle/Middleware/user_projects/applications/domain_name
JAVA_HOME/bin/jar xvf em.ear em.war
JAVA_HOME/bin/jar xvf em.war WEB-INF/web.xml
JAVA_HOME/bin/jar xvf em.war WEB-INF/weblogic.xml

3. Edit web.xml, commenting out the first login-config block and uncommenting the login-config block for WNA. (The file contains information about which block to comment and uncomment.) When you have done this, the portion of the file will appear as in the following example:

<!--<login-config>
<auth-method>CLIENT-CERT</auth-method>
</login-config>
-->
<!--
the following block is for Windows Native Authentication, if you are using
WNA, do the following:
1. uncomment the following block
2. comment out the previous <login-config> section.
3. you also need to uncomment a block in weblogic.xml
-->
<login-config>
<auth-method>CLIENT-CERT,FORM</auth-method>
<form-login-config>
<form-login-page>/faces/targetauth/emasLogin</form-login-page>
<form-error-page>/login/LoginError.jsp</form-error-page>
</form-login-config>
</login-config>
<security-constraint>
.
.
.
<security-role>
<role-name>Monitor</role-name>
</security-role>

4. Edit weblogic.xml, uncommenting the following block. (The file contains information about which block to uncomment.) When you have done this, the portion of the file will appear as in the following example:

<!--
the following block is for Windows Native Authentication, if you are using
WNA, uncomment the following block.
-->
<security-role-assignment>
<role-name>Admin</role-name>
<externally-defined/>
</security-role-assignment>
.
.
.
<security-role-assignment>
<role-name>Deployer</role-name>
<externally-defined/>
</security-role-assignment>

5. Rearchive the em.ear file. For example:

JAVA_HOME/bin/jar uvf em.war WEB-INF/web.xml
JAVA_HOME/bin/jar uvf em.war WEB-INF/weblogic.xml
JAVA_HOME/bin/jar uvf em.ear em.war

4.2.3 Fusion Middleware Control Does Not Keep Column Preferences in Log Viewer Pages

In Fusion Middleware Control, you can reorder the columns in the pages that display log files and log file messages. However, if you navigate away from the page and then back to it, the columns are set to their original order.

4.2.4 Topology Viewer Does Not Display Applications Deployed to a Cluster

In Fusion Middleware Control, the Topology Viewer does not display applications that are deployed to a cluster.

4.2.5 Changing Log File Format

When you change the log file format note the following:

- When you change the log file format from text to xml, specify the path, but omit the file name. The new file will be named log. xml.

- When you change the log file format from xml to text, specify both the path and the file name.

4.2.6 SSL Automation Tool Configuration Issues

The following issues have been observed when using the SSL Automation tool:

- The script creates intermediate files that contain passwords in clear text. If the script fails, these files might not be removed. After a script failure, delete all files under the rootCA directory.

- If Oracle Internet Directory password policy is enabled, passwords entered for wallet or keystore fail if they violate the policy.

- Before you run the script, you must have JDK 1.6 installed and you must have JAVA_HOME set in your environment.

- If the Oracle Virtual Directory configuration script fails, check the run log or enable debug for the shell script to view specific errors. If the error message looks similar to this, rerun the script with a new keystore name:

WLSTException: Error occured while performing cd : Attribute
oracle.as.ovd:type=component.listenersconfig.sslconfig,name=LDAP SSL
Endpoint,instance=%OVD_INSTANCE%,component=ovd1 not found

4.3 Documentation Errata for the Oracle Fusion Middleware Administrator's Guide

This section describes documentation errata for the Oracle Fusion Middleware Administrator's Guide.

In the section "Moving Oracle Business Intelligence to an Existing Target Environment When There Are Few Patches to Apply", the procedure is incorrect in the task "(Optional) Refresh Global Unique Identifiers (GUIDs)". Note the following:

- Step 3 includes an example of modifying the instanceconfig.xml file to instruct Presentation Services to refresh GUIDs on restart. The step should read:
Modify the instanceconfig.xml file to instruct Presentation Services to refresh GUIDs on restart. Edit the file and find the following section:

<Catalog>
<UpgradeAndExit>false</UpgradeAndExit>
</Catalog>

Comment out the <UpgradeAndExit> line and add an extra line in this section as in the following example:

<Catalog>
<!--UpgradeAndExit>false</UpgradeAndExit-->
<UpdateAccountGUIDs>UpdateAndExit</UpdateAccountGUIDs>
</Catalog>

- Step 6 should read:
Comment out the line added in Step 3 and remove the commenting from the original line so that it reads as shown in the following example:

<Catalog>

<UpgradeAndExit>false</UpgradeAndExit>

<!--UpdateAccountGUIDs>UpdateAndExit</UpdateAccountGUIDs-->
</Catalog>

5 Oracle Enterprise Manager Fusion Middleware Control

This chapter describes issues associated with Fusion Middleware Control. It includes the following topics:

- Section 5.1, "General Issues and Workarounds"

- Section 5.2, "Documentation Errata"

Note:

This chapter contains issues you might encounter while using Fusion Middleware Control to manage any of the Oracle Fusion Middleware products.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

5.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topic:

- Section 5.1.1, "Product Behavior After a Session Timeout"

- Section 5.1.2, "Fixing Errors Displayed When Selecting the TopLink Sessions Command in Fusion Middleware Control"

- Section 5.1.3, "Verifying the DISPLAY Variable to Correct Problems Displaying Graphics"

- Section 5.1.4, "Incomplete Information Available on the MDS Configuration Page"

- Section 5.1.5, "Exceptions When Starting Oracle Web Cache After Accessing Configuration Pages from Oracle Enterprise Manager Fusion Middleware Control"

- Section 5.1.6, "Table Display Problems When Using Some Language Variants"

- Section 5.1.7, "Problems When Internet Explorer 7 is Configured to Open Pop-Up Windows in a New Tab."

- Section 5.1.8, "Additional Fusion Middleware Control Release Notes"

- Section 5.1.9, "Problem with Performance Charts After Moving a Chart Region"

- Section 5.1.10, "Memory Issue When Configuring SOA on Microsoft Windows x64 (64-Bit)"

- Section 5.1.11, "Display Problems When Running JDK 160_18 on Intel Systems that Support the SSE4.2 Instruction Set"

- Section 5.1.12, "Adobe Flash Plugin Required When Displaying Fusion Middleware Control in the Apple Safari Browser"

- Section 5.1.13, "Unable to Access Fusion Middleware Control After Installing the Oracle Identity Management 11.1.1.4.0 Patch Set"

- Section 5.1.14, "Error Message on Deleting the Shared Folder After Scale-Out"

5.1.1 Product Behavior After a Session Timeout

For security purposes, your sessions with the Fusion Middleware Control will time out after a predefined period of inactivity, and you will be asked to log in to the console again. In most cases, you are returned to the page you had displayed before the session timed out.

However, in some circumstances, such as when you are using the Fusion Middleware Control deployment wizards, you will not be returned the same location in the product after you log in. In those cases, you will have to navigate to the specific Fusion Middleware Control page you were using before the session timed out.

5.1.2 Fixing Errors Displayed When Selecting the TopLink Sessions Command in Fusion Middleware Control

In Fusion Middleware Control, you can view the Oracle TopLink management pages by selecting TopLink Sessions from the Application Deployment menu.

However, if you receive an error message when you select this command, you can remedy the problem by adding one or both of the following MBean system properties, as follows

On Windows operating systems:

rem set JAVA_OPTIONS=%JAVA_OPTIONS% -Declipselink.register.dev.mbean=true
rem set JAVA_OPTIONS=%JAVA_OPTIONS% -Declipselink.register.run.mbean=true

On UNIX operating systems:

JAVA_OPTIONS="${JAVA_OPTIONS} -Declipselink.register.dev.mbean=true"
JAVA_OPTIONS="${JAVA_OPTIONS} -Declipselink.register.run.mbean=true"

For more information, see the following URL on the Eclipse WIKI Web site:

http://wiki.eclipse.org/Integrating_EclipseLink_with_an_Application_Server_(ELUG)#How_to_Integrate_JMX

5.1.3 Verifying the DISPLAY Variable to Correct Problems Displaying Graphics

The graphics subsystem for the Fusion Middleware Control generates some of its graphics on demand, and if the DISPLAY environment variable is set, Fusion Middleware Control tries to open the specified DISPLAY environment.

If Fusion Middleware Control fails to start due to graphics errors, check to see whether the DISPLAY environment variable is set to a proper DISPLAY environment.

If the DISPLAY environment variable is set incorrectly, unset the DISPLAY environment variable. Then restart Fusion Middleware Control.

5.1.4 Incomplete Information Available on the MDS Configuration Page

After deploying a Oracle SOA Suite application that requires Oracle Metadata Services (MDS), in some rare circumstances, you may find that the MDS configuration page for the application does not contain complete information about the MDS repository.

To address this problem, use the Metadata Repositories page to register the repository again. For more information, see "Create and Register an MDS Repository" in the Fusion Middleware Control online help.

5.1.5 Exceptions When Starting Oracle Web Cache After Accessing Configuration Pages from Oracle Enterprise Manager Fusion Middleware Control

To start, stop, or restart Oracle Web Cache from Fusion Middleware Control, from the Web Cache menu, you can choose Control, and then Start Up, Shut Down, or Restart.

If you select Shut Down, and then Start Up on a configuration page, Fusion Middleware Control may return exception errors. If these errors occur in your environment, perform the operations from Web Cache Home page.

5.1.6 Table Display Problems When Using Some Language Variants

When you use Fusion Middleware Control in some non-English language environments, some of the tables on the component home pages display incorrectly. For example, some rows of the table appear to be merged and without content.

These issues can be safely ignored, since no data on the pages is hidden. The table cells that appear incorrectly do not contain performance data or other information.

5.1.7 Problems When Internet Explorer 7 is Configured to Open Pop-Up Windows in a New Tab

If you configure Microsoft Internet Explorer 7 so it always displays pop-up windows in a new browser tab, then you may experience problems using Fusion Middleware Control. For example, in some cases, Enteprise Manager content displays in a new tab as expected, but Fusion Middleware Control stops responding to mouse clicks. The only way to continue working is to close the tab.

To avoid this problem, use the Internet Options dialog box in Internet Explorer to disable the option for displaying pop-up windows in a new tab.

5.1.8 Additional Fusion Middleware Control Release Notes

Refer to Chapter 4, "Oracle Fusion Middleware Administration" for additional Fusion Middleware Control release notes.

Additional Fusion Middleware Control release notes are also included in the component chapters of the Release Notes.

5.1.9 Problem with Performance Charts After Moving a Chart Region

Oracle Enterprise Manager Fusion Middleware Control provides performance charts on many of the component home pages. For example, it provides charts that display the current response and load metrics, as well as the CPU and memory usage.

If you move one of these charts to a new location on the home page, then sometimes the Table View link (which provides a tabular view of the data) does not work properly and the chart might stop refreshing automatically.

To fix this problem, click the refresh icon at the top, right corner of the page to refresh the page.

5.1.10 Memory Issue When Configuring SOA on Microsoft Windows x64 (64-Bit)

This is a known issue in Release 11.1.1.3.0 only. On configuring the SOA domain with Sun JDK, Admin Server and Managed Server fail to start showing the following error in the Managed server logs:

Error occurred during initialization of VM
Could not reserve enough space for object heap
Could not create the Java virtual machine

On configuring the SOA domain with JRockit JDK, Admin Server and Managed Server start but on logging in to Oracle Enterprise Manager, it shows an error and displays an incorrect status.

To work around this issue, change the memory size in setSOADomainEnv.cmd file by performing the following steps:

- Put the following text in a comment using REM command:

REM set PORT_MEM_ARGS=-Xms768m -Xmx1536m //

- Add the following line to reduce heap size:

set PORT_MEM_ARGS=-Xms512m -Xmx1024m //

5.1.11 Display Problems When Running JDK 160_18 on Intel Systems that Support the SSE4.2 Instruction Set

Some of the newer Intel-based computers support the SSE4.2 instruction set. If you are using the 160_18 version of the Java Development Kit (JDK) on one of these computers, then you might see some display issues in the Oracle Enterprise Manager Fusion Middleware Control.

This is related to the following issue on the Sun Developer Network (SDN):

http://bugs.sun.com/view_bug.do?bug_id=6875866

In particular, when using Fusion Middleware Control, you might experience some font size and alignment issues, and an error similar to the following appears in the server log file:

Servlet failed with Exception
java.lang.StringIndexOutOfBoundsException: String index out of range

To remedy this problem:

1. Locate and open the setDomainEnv configuration file in your Oracle WebLogic Server domain home.
For example:

For example:

DOMAIN_HOME\bin\setDomainEnv.cmd

2. Add the following to the JAVA_OPTIONS entry in the setDomainEnv file and save your changes:

-XX:-UseSSE42Intrinsics

For example:

JAVA_OPTIONS="${JAVA_OPTIONS} ${JAVA_PROPERTIES}
-Dwlw.iterativeDev=${iterativeDevFlag} -Dwlw.testConsole=${testConsoleFlag}
-Dwlw.logErrorsToConsole=${logErrorsToConsoleFlag} -XX:-UseSSE42Intrinsics"

3. Locate the following directory in your Oracle WebLogic Server domain home:

DOMAIN_HOME\servers\AdminServer\tmp\_WL_user\em\jmb4hf\public\adf\styles\cache\

4. Delete the style sheets (.css) files from the directory.

5. Restart the Oracle WebLogic Server domain.

6. Clear the cache in your Web browser.

5.1.12 Adobe Flash Plugin Required When Displaying Fusion Middleware Control in the Apple Safari Browser

To use the Apple Safari browser to display Fusion Middleware Control, you must have the Adobe Flash browser plugin installed.

If you experience problems displaying graphics or other Fusion Middleware Control elements, download and install a newer version of the plugin from the Adobe Web site.

5.1.13 Unable to Access Fusion Middleware Control After Installing the Oracle Identity Management 11.1.1.4.0 Patch Set

After you install the Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0) patch set, you might experience problems when accessing the Fusion Middleware Control pages used to manage the Oracle Identity Management components.

Specifically, an error similar to the following appears in the Administration Server log files:

[ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid:
0000In^zrbUF8DQ6ubU4UH1D1qXF00000s,0] [APP: em] [[
oracle.adf.controller.ControllerException: ADFC-00025: The ADF controller has
not been successfully initalized.

If you experience this problem, restart the Administration Server. After the restart, you should be able to log in and access the Fusion Middleware Control pages.

5.1.14 Error Message on Deleting the Shared Folder After Scale-Out

If Oracle Essbase is configured, then the Shared Folder Path field is displayed in the Essbase Agents region on the Failover page of the Availability tab for the Business Intelligence node in Fusion Middleware Control.

You use the Shared Folder Path field when setting up a highly available Essbase deployment. The field specifies a shared location for Essbase configuration files, security files, and all applications and corresponding databases.

If you remove an existing value in the Shared Folder Path field and attempt to apply the change without specifying a replacement value, then the following error message is displayed:

OBI_SYSMAN_1261, "You must not delete the shared folder after a previous scaleout"

To continue, either specify a valid path to the shared location in the Shared Folder Path field, or discard the change.

5.2 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 5.2.1, "Search Unavailable for Some Embedded Administrator's Guides"

- Section 5.2.2, "Patching Section in the Fusion Middleware Control Online Help is Not Supported"

5.2.1 Search Unavailable for Some Embedded Administrator's Guides

Search is unavailable for the following embedded administrator's guides in the Fusion Middleware Control help system:

- Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation

- Oracle Fusion Middleware System Administrator's Guide for Content Server for installations with Oracle Enterprise Content Management Suite

5.2.2 Patching Section in the Fusion Middleware Control Online Help is Not Supported

The Fusion Middleware Control online help system includes the contents of the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition. In the Fusion Middleware Control online help, this guide includes Section 17.11, which describes patching the Oracle BI Presentation Catalog. This functionality is not supported in Release 11.1.1.5. The section is not included in the version of the guide that ships with Oracle BI EE or that is posted on the Oracle Technology Network.

6 Oracle Fusion Middleware High Availability and Enterprise Deployment

This chapter describes issues associated with Oracle Fusion Middleware high availability and enterprise deployment. It includes the following topics:

- Section 6.1, "General Issues and Workarounds"

- Section 6.2, "Configuration Issues and Workarounds"

- Section 6.3, "Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS"

- Section 6.4, "Documentation Errata"

Note:

This chapter contains issues you might encounter while configuring any of the any of the Oracle Fusion Middleware products for high availability or an enterprise deployment.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

6.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 6.1.1, "Secure Resources in Application Tier"

- Section 6.1.2, "mod_wl Not Supported for OHS Routing to Managed Server Cluster"

- Section 6.1.3, "Only Documented Procedures Supported"

- Section 6.1.4, "SOA Composer Generates Error During Failover"

- Section 6.1.5, "Accessing Web Services Policies Page in Cold Failover Environment"

- Section 6.1.6, "Considerations for Oracle Identity Federation HA in SSL Mode"

- Section 6.1.7, "Online Help Context May be Lost When Failover Occurs in High Availability Environment"

- Section 6.1.8, "ASCRS Cannot be Used to Create a Database Resource for the Oracle Database Console Service on Windows"

- Section 6.1.9, "Changes to Rulesets May Not be Persisted During an Oracle RAC Instance Failover"

- Section 6.1.10, "Manual Retries May be Necessary When Redeploying Tasks During an Oracle RAC Failover"

- Section 6.1.11, "Timeout Settings for SOA Request-Response Operations are Not Propagated in a Node Failure"

- Section 6.1.12, "Scale Out and Scale Up Operations Fail"

- Section 6.1.13, "Harmless SQLIntegrityConstraintViolationException Can be Received in a SOA Cluster"

- Section 6.1.14, "WebLogic Cluster WS-AT Recovery Can Put a Server into a 'Warning' State"

- Section 6.1.15, "Very Intensive Uploads from I/PM to UCM May Require Use of IP-Based Filters in UCM Instead of Hostname-Based Filters"

- Section 6.1.16, "Worklist Application May Throw Exception if Action Dropdown Menu is Used During a Failover"

- Section 6.1.17, "ClassCastExceptions in a SOA Cluster for the SOA Worklist Application"

- Section 6.1.18, "Use srvctl in 11.2 Oracle RAC Databases to Set Up AQ Notification and Server-side TAF"

- Section 6.1.19, "Oracle I/PM Input Files May Not be Processed Correctly During an Oracle RAC Failover"

- Section 6.1.20, "Failover Is Not Seamless When Creating Reports in Oracle BI Publisher"

- Section 6.1.21, "Failed to Load Error Appears in Layout View When Oracle BI Publisher Managed Server is Failed Over"

- Section 6.1.22, "When Scheduling an Oracle BI Publisher Job, a Popup Window Appears After Managed Server Failover"

- Section 6.1.23, "Cannot Save Agent When Oracle Business Intelligence Managed Server Fails Over"

- Section 6.1.24, "Set an Extra Property After Configuring a Virtual IP and Whole Server Migration for a BI Cluster"

- Section 6.1.25, "Installing Additional Oracle Portal, Forms, Reports, and Discoverer Instances After Upgrading Oracle Single Sign-On 10g to Oracle Access Manager 11g"

- Section 6.1.26, "JMS Instance Fails In a BI Publisher Cluster"

- Section 6.1.27, "Null Pointer Exception Error Window Opens during Approving Task When Failover Occurs"

6.1.1 Secure Resources in Application Tier

It is highly recommended that the application tier in the SOA Enterprise Deployment topology and the WebCenter Enterprise Deployment topology is protected against anonymous RMI connections. To prevent RMI access to the middle tier from outside the subset configured, follow the steps in "Configure connection filtering" in the Oracle WebLogic Server Administration Console Online Help. Execute all of the steps, except as noted in the following:

1. Do not execute the substep for configuring the default connection filter. Execute the substep for configuring a custom connection filter.

2. In the Connection Filter Rules field, add the rules that will allow all protocol access to servers from the middle tier subnet while allowing only http(s) access from outside the subnet, as shown in the following example:

nnn.nnn.0.0/nnn.nnn.0.0  * * allow
0.0.0.0/0 * * allow t3 t3s

6.1.2 mod_wl Not Supported for OHS Routing to Managed Server Cluster

Oracle Fusion Middleware supports only mod_wls_ohs and does not support mod_wl for Oracle HTTP Server routing to a cluster of managed servers.

6.1.3 Only Documented Procedures Supported

For Oracle Fusion Middleware high availability deployments, Oracle strongly recommends following only the configuration procedures documented in the Oracle Fusion Middleware High Availability Guide and the Oracle Fusion Middleware Enterprise Deployment Guides.

6.1.4 SOA Composer Generates Error During Failover

During failover, if you are in a SOA Composer dialog box and the connected server is down, you will receive an error, such as Target Unreachable, 'messageData' returned null.

To continue working in the SOA Composer, open a new browser window and navigate to the SOA Composer.

6.1.5 Accessing Web Services Policies Page in Cold Failover Environment

In a Cold Failover Cluster (CFC) environment, the following exception is displayed when Web Services policies page is accessed in Fusion Middleware Control:

Unable to connect to Oracle WSM Policy Manager.
Cannot locate policy manager query/update service. Policy manager service
look up did not find a valid service.

To avoid this, implement one the following options:

- Create virtual hostname aliased SSL certificate and add to the key store.

- Add "-Dweblogic.security.SSL.ignoreHostnameVerification=true" to the JAVA_OPTIONS parameter in the startWeblogic.sh or startWeblogic.cmd files

6.1.6 Considerations for Oracle Identity Federation HA in SSL Mode

In a high availability environment with two (or more) Oracle Identity Federation servers mirroring one another and a load balancer at the front-end, there are two ways to set up SSL:

- Configure SSL on the load balancer, so that the SSL connection is between the user and the load balancer. In that case, the keystore/certificate used by the load balancer has a CN referencing the address of the load balancer.
The communication between the load balancer and the WLS/Oracle Identity Federation can be clear or SSL (and in the latter case, Oracle WebLogic Server can use any keystore/certificates, as long as these are trusted by the load balancer).

- SSL is configured on the Oracle Identity Federation servers, so that the SSL connection is between the user and the Oracle Identity Federation server. In this case, the CN of the keystore/certificate from the Oracle WebLogic Server/Oracle Identity Federation installation needs to reference the address of the load balancer, as the user will connect using the hostname of the load balancer, and the Certificate CN needs to match the load balancer's address.
In short, the keystore/certificate of the SSL endpoint connected to the user (load balancer or Oracle WebLogic Server/Oracle Identity Federation) needs to have its CN set to the hostname of the load balancer, since it is the address that the user will use to connect to Oracle Identity Federation.

6.1.7 Online Help Context May be Lost When Failover Occurs in High Availability Environment

In a high availability environment, if you are using online help and a failover occurs on one of the machines in your environment, your context in online help may be lost when the application is failed over.

For example, the online help table of contents may not remember the topic that was selected prior to the failover, or the last online help search results may be lost.

No data is lost, and your next online help request after the failover will be handled properly.

6.1.8 ASCRS Cannot be Used to Create a Database Resource for the Oracle Database Console Service on Windows

In Patch Set 2 of the Oracle Fusion Middleware 11g Release 1 (11.1.1) release, a new feature was added to Application Server Cluster Ready Services (ASCRS) to enable users to create an ASCRS database resource for the Oracle Database Console service. Using ASCRS to create an ASCRS database resource is described in the "Creating an Oracle Database Resource" section of the "Using Cluster Ready Services" chapter in the Oracle Fusion Middleware High Availability Guide.

This feature works on UNIX, because the Oracle Database Console can be CFC enabled on UNIX.

However, on Windows, there is no CFC support for the Oracle Database Console service. Therefore, you cannot use ASCRS to create a database resource for the Oracle Database Console service on Windows.

6.1.9 Changes to Rulesets May Not be Persisted During an Oracle RAC Instance Failover

When you update rulesets (used in Human Workflow or BPEL) through the Worklist configuration UI or the SOA Composer application during an Oracle RAC instance failover, the new rule metadata may not get persisted to the database. In this case, you will need to perform a manual retry. However, you can continue to use the older version of metadata without any errors.

6.1.10 Manual Retries May be Necessary When Redeploying Tasks During an Oracle RAC Failover

When redeploying tasks with large number of rules during an Oracle RAC instance failover, a manual retry may be needed by the end user occasionally.

6.1.11 Timeout Settings for SOA Request-Response Operations are Not Propagated in a Node Failure

In an active-active Oracle SOA cluster, when a node failure occurs, the timeout settings for request-response operations in receive activities are not propagated from one node to the other node or nodes. If a failure occurs in the server that scheduled these activities, they must be rescheduled with the scheduler upon server restart.

6.1.12 Scale Out and Scale Up Operations Fail

The scale out and scale up operations performed on your environment after re-associating the local file based WLS LDAP store with an external LDAP store will fail. To avoid this failure, follow the steps below before performing a scale up or scale out operation.

1. Edit the setDomainEnv.sh file located under the DOMAIN_HOME/bin directory and add the "-Dcommon.components.home=${COMMON_COMPONENTS_HOME}" and "-Djrf.version=11.1.1" variables to the file.

2. These variables should be added to the "EXTRA_JAVA_PROPERTIES". For example:

EXTRA_JAVA_PROPERTIES="-Ddomain.home=${DOMAIN_HOME}
-Dcommon.components.home=${COMMON_COMPONENTS_HOME} -Djrf.version=11.1.1
.
.
.

3. Save the file and proceed with the scale out or scale up operation.

6.1.13 Harmless SQLIntegrityConstraintViolationException Can be Received in a SOA Cluster

The following SQLIntegrityConstraintViolationException can be received in a SOA cluster:

[TopLink Warning]: 2010.04.11 14:26:53.941--UnitOfWork(275924841)--Exception
[TOPLINK-4002] (Oracle TopLink - 11g Release 1 (11.1.1.3.0):
Internal Exception: java.sql.SQLIntegrityConstraintViolationException:
ORA-00001: unique constraint (JYIPS2RC4B49_SOAINFRA.SYS_C0035333) violated
.
.
.

This is not a bug. In a cluster environment, when the messages for the same group arrive on both the nodes, one node is bound to experience this exception for the first message. The application is aware of this exception and handles it properly. It does not break any functionality.

This exception can also come on a single node after you restart the server and send the message for the existing group. Again, this exception will be experienced on the very first message.

In summary, this exception is within the application design and does not impact any functionality. It is for this reason that you do not see this exception logged as severe in the soa-diagnostic logs.

Toplink does, however, log it in its server logs.

6.1.14 WebLogic Cluster WS-AT Recovery Can Put a Server into a 'Warning' State

In certain WebLogic cluster process crash scenarios, WS-AT recovery results in stuck threads that put the server into a warning state. WS-AT data recovery is successful in these cases despite the fact that the logs show failed state messages, due to the fact that commit acks are not being processed correctly for this scenario (this issue does not occur when the scenario involves the rollback of the transaction). While the server may continue to function in this warning state, the threads remain stuck until the transaction abandonment timeout, which defaults to 24 hours, is reached. The workaround is to restart the server, which removes the stuck threads and warning state. A patch for this issue can be obtained from Oracle Support.

6.1.15 Very Intensive Uploads from I/PM to UCM May Require Use of IP-Based Filters in UCM Instead of Hostname-Based Filters

The "Adding the I/PM Server Listen Addresses to the List of Allowed Hosts in UCM" section in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Enterprise Content Management Suite and the "Adding the I/PM Server Listen Addresses to the List of Allowed Hosts in UCM" section in the Oracle Fusion Middleware High Availability Guide describe how to add hostname-based filters for Oracle I/PM managed server listen addresses to the list of allowed hosts in Oracle UCM.

When using hostname-based filters in Oracle UCM (config.cfg file) a high latency/performance impact may be observed in the system for very intensive uploads of documents from Oracle I/PM to Oracle UCM. This is caused by the reverse DNS lookup that is required in Oracle UCM to allow the connections from Oracle I/PM servers. Using hostname-based filters is recommended in preparation for configuring the system for Disaster Protection and to restore to a different host (since the configuration used is IP-agnostic when using hostname-based filters). However if the performance of the uploads needs to be improved, users can use instead IP-based filters. To do this:

1. Edit the file /u01/app/oracle/admin/domainName/ucm_cluster/config/config.cfg and remove or comment out:

SocketHostNameSecurityFilter=localhost|localhost.mydomain.com|ecmhost1vhn1|ecmhost2vhn1

AlwaysReverseLookupForHost=Yes

2. Add the IP addresses (listen address) of the WLS_IPM1 and WLS_IPM2 managed servers (ECMHOST1VHN1 and ECMHOST2VHN1, respectively) to the SocketHostAddressSecurityFilter parameter list as follows:

SocketHostAddressSecurityFilter=127.0.0.1|0:0:0:0:0:0:0:1|X.X.X.X|Y.Y.Y.

where X.X.X.X and Y.Y.Y.Y are the listen addresses of WLS_IPM1 and WLS_IPM2 respectively. Notice that 127.0.0.1 also needs to be added as shown above.

3. Restart the UCM servers.

6.1.16 Worklist Application May Throw Exception if Action Dropdown Menu is Used During a Failover

If you use the Oracle Business Process Management Suite Worklist application Actions dropdown menu to take action on a task while a failover is in progress, an exception similar to the following may be thrown:

<oracle.adf.view.rich.component.fragment.UIXInclude> <ADF_FACES-10020> <Tear
down of include component context failed due to an unhandled e
xception.
java.util.NoSuchElementException
at java.util.ArrayDeque.removeFirst(ArrayDeque.java:251)
at java.util.ArrayDeque.pop(ArrayDeque.java:480)
at
oracle.adfinternal.view.faces.context.ApplicationContextManagerImpl.popContext
Change(ApplicationContextManagerImpl.java:66)
.
.
.

In this case, the approval or rejection of the task does not go through.

To work around this problem, use either of these approaches:

- Instead of using the Actions dropdown menu to take action on the task, use the TaskForm to take action.

- Do a refresh after the error message. Then take the action again using the Actions dropdown menu.

6.1.17 ClassCastExceptions in a SOA Cluster for the SOA Worklist Application

ClassCastExceptions may arise in a SOA cluster for the Oracle SOA Worklist application (java.lang.ClassCastException: oracle.adf.model.dcframe.DataControlFrameImpl is reported in the logs). As a result, the Worklist application state may not be replicated to other managed servers in the cluster. The Worklist application and the corresponding user sessions will be usable after the exception is thrown, but any failovers to other servers in the cluster will not succeed.

There is no workaround to this problem.

To solve this problem, download the patch for bug 9561444, which solves the problem. Follow these steps:

1. To obtain the patch, log into My Oracle Support (formerly OracleMetaLink) at the following URL:
http://support.oracle.com

2. Click the Patches & Updates tab.

3. In the Patch Search section, enter 9561444 in the Patch ID or number is field, and enter your platform in the field after the and Platform is field.

4. Click Search.

5. On the Patch Search page, click the patch number in the Patch ID column. This causes the page content to change to display detailed information about the patch.

6. Click Download to download the patch.

6.1.18 Use srvctl in 11.2 Oracle RAC Databases to Set Up AQ Notification and Server-side TAF

Because of a known issue in 11.2 Oracle RAC databases, it is required to use srvctl to set up AQ notification and server-side TAF. Using DBMS_SQL packages will not work as expected.

Here is an example use of srvctl:

srvctl modify service -d orcl -s orclSVC -e SELECT -m BASIC -w 5 -z 5 -q TRUE

In the example:

orcl - Database Name

orclSVC - Service Name used by middleware component

SELECT - Failover type

BASIC - Failover method

5 - Failover delay

5 - Failover retry

TRUE - AQ HA notifications set to TRUE

Please refer to the Oracle 11.2 Oracle database documentation for detailed information about this command usage.

6.1.19 Oracle I/PM Input Files May Not be Processed Correctly During an Oracle RAC Failover

With Oracle I/PM and Oracle UCM file processing, some files may not get loaded in UCM properly during an Oracle RAC instance failover.

The incoming files to be processed by Oracle I/PM are put into an input folder. Oracle I/PM processes the files in the input folder and then puts them into Oracle UCM, which is backed by an Oracle RAC database. Sometimes when an Oracle RAC instance failure occurs, the retry may not happen correctly and the incoming files do not get processed. These unprocessed files show up in an error folder. These unprocessed files can manually be put back into the input folder and processed.

6.1.20 Failover Is Not Seamless When Creating Reports in Oracle BI Publisher

If you create a report in Oracle BI Publisher, and a Managed Server is failed over before the report is saved, the failover might not be seamless. For example, when you attempt to save the report, the system might not be responsive.

If this occurs, click one of the header links, such as Home or Catalog, to be redirected to the Oracle BI Publisher login page. Then, log in and create and save the report again.

6.1.21 Failed to Load Error Appears in Layout View When Oracle BI Publisher Managed Server is Failed Over

In the Oracle BI Publisher layout editor, when a Managed Server is failed over, opening or creating a Web-based layout can cause the following error to appear:

Failed to load: object_name
Please contact the system administrator.

To work around this issue, close the message and click one of the header links, such as Home or Catalog, to be redirected to the login page.

6.1.22 When Scheduling an Oracle BI Publisher Job, a Popup Window Appears After Managed Server Failover

When scheduling a job in Oracle BI Publisher, after a Managed Server fails over, a large popup window appears when you click Submit that shows the HTML source for the login page.

To work around this issue, close the message window and click one of the header links, such as Home or Catalog, to be redirected to the login page. You will need to re-create the report job again.

6.1.23 Cannot Save Agent When Oracle Business Intelligence Managed Server Fails Over

If you create an agent in the Oracle Business Intelligence Web interface, and a Managed Server fails over before you save the agent, an error occurs when you try to save the agent.

To work around this issue, log out, then log back in to Oracle Business Intelligence and create the agent again.

6.1.24 Set an Extra Property After Configuring a Virtual IP and Whole Server Migration for a BI Cluster

Bug 10017729 and 10014701

On Windows, after you enable a virtual IP and set up whole server migration for an Oracle Business Intelligence cluster, if you attempt to access Analytics or Business Intelligence Publisher, your access attempt fails and you receive these error messages:

Unable to Sign In
An error occurred during authentication. Try again later or contact your system administrator.

To work around this issue:

In the setDomainEnv.cmd file on all managed servers, set the oracle.bi.management.config.urlStrategy property to the value "ASK_WEBLOGIC". For example, make these entries in the setDomainEnv.cmd file:

# This extra property causes WebLogic to look at the localhost instead of the
# virtual IP
set EXTRA_JAVA_PROPERTIES=%EXTRA_JAVA_PROPERTIES%
-Doracle.bi.management.config.urlStrategy=ASK_WEBLOGIC

Note that the two lines above that specify the ASK_WEBLOGIC property must be on a single line in the setDomainEnv.cmd file.

6.1.25 Installing Additional Oracle Portal, Forms, Reports, and Discoverer Instances After Upgrading Oracle Single Sign-On 10g to Oracle Access Manager 11g

This issue occurs with Oracle Portal, Forms, Reports, and Discoverer 11g environments that have been upgraded from using Oracle Single-Sign On 10g to Oracle Access Manager 11g for authentication.

When performing subsequent Oracle Portal, Forms, Reports, and Discoverer 11g installations against the same environment where the initial Oracle Portal, Forms, Reports, and Discoverer 10g installation was upgraded to Oracle Access Manager, there are some requirements that must be met.

- For each subsequent Oracle Portal, Forms, Reports, and Discoverer 11g installation, you must maintain the original Oracle Single Sign-On 10g instance and keep it actively running--in addition to new Oracle Access Manager 11g instance--while the additional Oracle Portal, Forms, Reports, and Discoverer 11g installations are performed.
This is necessary because Oracle Portal, Forms, Reports, and Discoverer 11g cannot be installed directly against Oracle Access Manager 11g.

- After the subsequent classic installs are completed, the Oracle Single Sign-On 10g to Oracle Access Manager 11g upgrade procedure must be performed again. For more information, see "Upgrading Your Oracle Single Sign-On Environment" in the Oracle Fusion Middleware Upgrade Guide for Oracle Identity Management.
This procedure upgrades the new Oracle Portal, Forms, Reports, and Discoverer 11g instance to Oracle Access Manager 11g.

Note that these considerations apply only in an environment with Multiple Oracle Portal, Forms, Reports, and Discoverer 11g middle tiers that are installed or added to a your environment after the initial upgrade from Oracle Single Sign-On 10g to Oracle Access Manager 11g.

6.1.26 JMS Instance Fails In a BI Publisher Cluster

On rare occasions, a JMS instance is missing from a BI Publisher Scheduler cluster.

To resolve this issue, restart the BI Publisher application from the WebLogic Server Administration Console.

To restart your BI Publisher application:

1. Log in to the Administration Console.

2. Click Deployments in the Domain Structure window.

3. Select bipublisher(11.1.1).

4. Click Stop.

5. After the application stops, click Start.

6.1.27 Null Pointer Exception Error Window Opens during Approving Task When Failover Occurs

When failover occurs, a Null Pointer Exception error window may open the second time you click Approve task during the operational approval task. (The Null Pointer Exception error window always opens during failover.) The Null Pointer Exception window does not interrupt any processes and approval succeeds.

6.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 6.2.1, "jca.retry.count Doubled in a Clustered Environment"

- Section 6.2.2, "Cluster Time Zones Must Be the Same"

- Section 6.2.3, "Cookie Persistence Setting on Load Balancer May Result in Intermittent Timeouts in accessing Portal on Windows platforms"

- Section 6.2.4, "Fusion Middleware Control May Display Incorrect Status"

- Section 6.2.5, "Accumulated BPEL Instances Cause Performance Decrease"

- Section 6.2.6, "Extra Message Enqueue when One a Cluster Server is Brought Down and Back Up"

- Section 6.2.7, "Duplicate Unrecoverable Human Workflow Instance Created with Oracle RAC Failover"

- Section 6.2.8, "Configuration Files Missing after Planned Administration Server Node Shutdown or Reboot"

- Section 6.2.9, "No High Availability Support for SOA B2B TCP/IP"

- Section 6.2.10, "WebLogic Administration Server on Machines with Multiple Network Cards"

- Section 6.2.11, "Additional Parameters for SOA and Oracle RAC Data Sources"

- Section 6.2.12, "Message Sequencing and MLLP Not Supported in Oracle B2B HA Environments"

- Section 6.2.13, "Credentials not Propagated for Transport Protocols in B2B"

- Section 6.2.14, "Create a Protected Resource for Oracle Identity Navigator"

- Section 6.2.15, "Use Fully-Qualified Hostnames when Configuring Front-end Hosts in High Availability Configurations"

- Section 6.2.16, "Managed Server goes into Suspended Status After Oracle RAC Failover"

- Section 6.2.17, "Primary/Secondary Configuration Section of the Availability Tab is Not Visible"

- Section 6.2.18, "Server Start Parameters Not Getting Set After Scaling Out the Oracle Business Intelligence Managed Server"

- Section 6.2.19, "Ensuring the Oracle HTTP Server Lock File is on a Local Drive"

- Section 6.2.20, "Recreating OSSO Agents that Point to the Load Balancer URL"

- Section 6.2.21, "Use Lower-Case Letters for GridLink Data Source RAC Service Name"

- Section 6.2.22, "Additional Steps Needed for Oracle RTD Request Forwarding to Work Correctly"

6.2.1 jca.retry.count Doubled in a Clustered Environment

In a clustered environment, each node maintains its own in-memory Hasmap for inbound retry. The jca.retry.count property is specified as 3 for the inbound retry feature. However, each node tries three times. As a result, the total retry count becomes 6 if the clustered environment has two nodes.

6.2.2 Cluster Time Zones Must Be the Same

All the machines in a cluster must be in the same time zone. WAN clusters are not supported by Oracle Fusion Middleware high availability. Even machines in the same time zone may have issues when started by command line. Oracle recommends using Node Manager to start the servers.

6.2.3 Cookie Persistence Setting on Load Balancer May Result in Intermittent Timeouts in accessing Portal on Windows platforms

Cookie Persistence on the load balancer is not required for an Oracle Portal active-active setup. Any inadvertent setting of cookie Persistence to 'active cookie insert' on certain hardware load balancers for Portal deployments on Windows results in intermittent timeouts while accessing Oracle Portal.

6.2.4 Fusion Middleware Control May Display Incorrect Status

In some instances, Oracle WebLogic Fusion Middleware Control may display the incorrect status of a component immediately after the component has been restarted or failed over.

6.2.5 Accumulated BPEL Instances Cause Performance Decrease

In a scaled out clustered environment, if a large number of BPEL instances are accumulated in the database, it causes the database's performance to decrease, and the following error is generated: MANY THREADS STUCK FOR 600+ SECONDS.

To avoid this error, remove old BPEL instances from the database.

6.2.6 Extra Message Enqueue when One a Cluster Server is Brought Down and Back Up

In a non-XA environment, MQSeries Adapters do not guarantee the only once delivery of the messages from inbound adapters to the endpoint in case of local transaction. In this scenario, if an inbound message is published to the endpoint, and before committing the transaction, the SOA server is brought down, inbound message are rolled back and the same message is again dequeued and published to the endpoint. This creates an extra message in outbound queue.

In an XA environment, MQ Messages are actually not lost but held by Queue Manager due to an inconsistent state. To retrieve the held messages, restart the Queue Manager.

6.2.7 Duplicate Unrecoverable Human Workflow Instance Created with Oracle RAC Failover

As soon as Oracle Human Workflow commits its transaction, the control passes back to BPEL, which almost instantaneously commits its transaction. Between this window, if the Oracle RAC instance goes down, on failover, the message is retried and can cause duplicate tasks. The duplicate task can show up in two ways - either a duplicate task appears in worklistapp, or an unrecoverable BPEL instance is created. This BPEL instance appears in BPEL Recovery. It is not possible to recover this BPEL instance as consumer, because this task has already completed.

6.2.8 Configuration Files Missing after Planned Administration Server Node Shutdown or Reboot

The following information refers to Chapter 10, "Managing the Topology," of the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite.

When performing a planned stop of the Administration Server's node (rebooting or shutting down the Admin Server's machine), it may occur that the OS NFS service is disabled before the Administration Server itself is stopped. This (depending on the configuration of services at the OS level) can cause the detection of missing files in the Administration Server's domain directory and trigger their deletion in the domain directories in other nodes. This can result in the framework deleting some of the files under domain_dir/fmwconfig/. This behavior is typically not observed for unplanned downtimes, such as machine panic, power loss, or machine crash. To avoid this behavior, shutdown the Administration Server before performing reboots or, alternatively, use the appropriate OS configuration to set the order of services in such a way that NFS service is disabled with later precedence than the Administration Server's process. See your OS administration documentation for the corresponding required configuration for the services' order.

6.2.9 No High Availability Support for SOA B2B TCP/IP

High availability failover support is not available for SOA B2B TCP/IP protocol. This effects primarily deployments using HL7 over MLLP. For inbound communication in a clustered environment, all B2B servers are active and the address exposed for inbound traffic is a load balancer virtual server. Also, in an outage scenario where an active managed server is no longer available, the persistent TCP/IP connection is lost and the client is expected to reestablish the connection.

6.2.10 WebLogic Administration Server on Machines with Multiple Network Cards

When installing Oracle WebLogic Server on a server with multiple network cards, always specify a Listen Address for the Administration Server. The address used should be the DNS Name/IP Address of the network card you wish to use for Administration Server communication.

To set the Listen Address:

1. In the Oracle WebLogic Server Administration Console, select Environment, and then Servers from the domain structure menu.

2. Click the Administration Server.

3. Click Lock and Edit from the Change Center to allow editing.

4. Enter a Listen Address.

5. Click Save.

6. Click Activate Changes in the Change Center.

6.2.11 Additional Parameters for SOA and Oracle RAC Data Sources

In some deployments of SOA with Oracle RAC, you may need to set additional parameters in addition to the out of the box configuration of the individual data sources in an Oracle RAC configuration. The additional parameters are:

1. Add property oracle.jdbc.ReadTimeout=300000 (300000 milliseconds) for each data source.
The actual value of the ReadTimeout parameter may differ based on additional considerations.

2. If the network is not reliable, then it is difficult for a client to detect the frequent disconnections when the server is abruptly disconnected. By default, a client running on Linux takes 7200 seconds (2 hours) to sense the abrupt disconnections. This value is equal to the value of the tcp_keepalive_time property. To configure the application to detect the disconnections faster, set the value of the tcp_keepalive_time, tcp_keepalive_interval, and tcp_keepalive_probes properties to a lower value at the operating system level.

Note:

Setting a low value for the tcp_keepalive_interval property leads to frequent probe packets on the network, which can make the system slower. Therefore, the value of this property should be set appropriately based on system requirements.

For example, set tcp_keepalive_time=600 at the system running the WebLogic Server managed server.

Also, you must specify the ENABLE=BROKEN parameter in the DESCRIPTION clause in the connection descriptor. For example:

dbc:oracle:thin:@(DESCRIPTION=(enable=broken)(ADDRESS_LIST=(ADDRESS=(PRO
TOCOL=TCP)(HOST=node1-vip.mycompany.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_
NAME=orcl.us.oracle.com)(INSTANCE_NAME=orcl1)))

As a result, the data source configuration appears as follows:

<url>jdbc:oracle:thin:@(DESCRIPTION=(enable=broken)(ADDRESS_LIST=(ADDRESS=(PRO
TOCOL=TCP)(HOST=node1-vip.us.oracle.com)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=orcl.us.oracle.com)(INSTANCE_NAME=orcl1)))</url>
<driver-name>oracle.jdbc.xa.client.OracleXADataSource</driver-name>
<properties>
<property>
<name>oracle.jdbc.ReadTimeout</name>
<value>300000</value>
</property>
<property>
<name>user</name>
<value>jmsuser</value>
</property>
<property>
<name>oracle.net.CONNECT_TIMEOUT</name>
<value>10000</value>
</property>
</properties>

6.2.12 Message Sequencing and MLLP Not Supported in Oracle B2B HA Environments

Message sequencing and MLLP are not supported in Oracle B2B high availability (HA) environments.

6.2.13 Credentials not Propagated for Transport Protocols in B2B

The Oracle FMW credential store maintains usernames and passwords that you define for Transport protocols. If you use the default file store for these credentials, changes you make to usernames and passwords do not propagate across nodes. You must use a central LDAP for these credentials to be synchronized across nodes in a cluster, as described in, and required by, the Oracle Fusion Middleware High Availability Guide and Enterprise Deployment Guides.

6.2.14 Create a Protected Resource for Oracle Identity Navigator

To create a protected resource for Oracle Identity Navigator, log in to the Oracle Access Manager console at http://admin.mycompany.com/oamconsole using the oamadmin account. Then proceed as follows:

1. From the Navigation window expand: Application Domains > IDMDomainAgent.

2. Click Resources.

3. Click Create on the tool bar below the Browse tab).
Enter the following information:

- Type: http

- Host Identifier: IDMDomain

- Resource URL: /oinav

4. Click Apply.

5. From the Navigation window expand: Application Domains > IDMDomainAgent >Authentication Policies.

6. Click Protected HigherLevel Policy.

7. Click Edit on the tool bar below the Browse tab.

8. In the Resources box, click +.

9. From the list, select the resource /oinav.

10. Click Apply.

11. From the Navigation window expand: Application Domains > IDMDomainAgent >Authorization Policies.

12. Click Protected Resource Policy.

13. Click Edit on the tool bar below the Browse tab.

14. In the Resources box, click +.

15. From the list, select the resource /oinav

16. Click Apply.

6.2.15 Use Fully-Qualified Hostnames when Configuring Front-end Hosts in High Availability Configurations

Oracle recommends using the full name of the host, including the domain name, when configuring front-end hosts in Oracle Fusion Middleware high availability configurations. Use the host's full name instead of using only the host name.

For example, if myhost is the name of a frontend host in a high availability configuration, set the frontend host URL to the fully-qualified hostname, such as myhost.mycompany.com as DNS or local host name resolution files (for example, /etc/hosts) define.

6.2.16 Managed Server goes into Suspended Status After Oracle RAC Failover

The Managed Server wls_ods(x) can enter a suspended status in the following situations:

- A database connection in the data source is wrong or not complete.

- The host is not a fully-qualified host for the database.

To correct the status of the Managed Server wls_ods(x):

1. Under the data source, verify that the database connection is correct and complete with the domain.

2. Under the data source, verify that the host name for the database is a fully- qualified hostname with the domain.

3. Verify the connection by selecting the Test button.

6.2.17 Primary/Secondary Configuration Section of the Availability Tab is Not Visible

During the system component scale out process, the Primary/Secondary Configuration section in the Availability tab of the Capacity Management page in Fusion Middleware Control may not be visible in the browser. This issue occurs when you perform the scale out process using Microsoft Internet Explorer version 7.0.5730.11.

To avoid this issue, do not use the browser Microsoft Internet Explorer version 7.0.5730.11 to scale out; use another browser such as Google Chrome.

6.2.18 Server Start Parameters Not Getting Set After Scaling Out the Oracle Business Intelligence Managed Server

After scaling out Oracle Business Intelligence, Server Start parameters are not getting set correctly. To work around this issue, update the Server Start parameters for the scaled out BI Managed Server to include the following:

-Dserver.group=obi arguments

6.2.19 Ensuring the Oracle HTTP Server Lock File is on a Local Drive

If you configure an Oracle instance for Oracle HTTP Server 11g on shared storage, such as NAS, NFS, or SAN storage, you must ensure that the lock file is created on a local drive instead of the shared drive. If you do not do this, Oracle HTTP Server might experience performance problems. Perform these steps to point the LockFile directive at a local file system:

1. Stop the OHS instances on WEBHOST1 and WEBHOST2.

2. Open the file ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf in a text editor.

3. Find the LockFile directive, configured under both the prefork and worker MPM configuration blocks in the httpd.conf file. It looks like this:

LockFile ORACLE_INSTANCE/diagnostics/logs/COMPONENT_TYPE/COMPONENT_NAME/http_lock

4. Change the LockFile directive under the appropriate MPM configuration to point to a local file system, for example:

LockFile /local_disk/path/http_lock

5. Restart Oracle HTTP Server.

6. Verify that the http_lock file exists in the directory specified by the LockFile directive.

6.2.20 Recreating OSSO Agents that Point to the Load Balancer URL

A high availability Classic environment typically has a load balancer in front of the Classic OHS instances. When you configure a classic instance with OAM 11g, the Configuration Wizard automatically configures an OSSO agent. The OSSO agent contains the individual Classic OHS instance URL. In a high availability cluster consisting of two Classic instances, the Configuration Wizard automatically configures two OSSO agents. Each OSSO agent contains the URL information of one Classic Webtier instance URL.

In a high availability cluster, you must recreate an OSSO agent that points to the load balancer URL.

To recreate an OSSO agent that points to the load balancer URL:

1. From the OAM console, click New OSSO Agent to open the OSSO Wizard application.

2. Enter the following information:

- Name: Enter any name

- Token Version: Use the default setting, v3.0

- Base URL: Enter the load balancer URL, for example http://haqaedg04.us.oracle.com:7788

- Admin ID: Leave blank

- Admin Inf: Leave blank

- Host Identifier: Keep default value from the Name field.

- Auto Create Policies: Check this setting to enable it.

3. Copy the osso.conf file of the new OSSO agent from the OAM server to the Classic Web Instances config directory.

6.2.21 Use Lower-Case Letters for GridLink Data Source RAC Service Name

When you create a GridLink data source in the Configuration Wizard, you must verify that the service name on the database uses lowercase letters only and is a qualified domain name. For example, <mydbservice>.us.oracle.com. The Service Name field is in the Configure GridLink RAC Component Schema screen.

Note:

The Oracle RAC Service name is defined on the database; it is not a fixed name. Oracle recommends that you register/add the RAC service name with the database domain name, for example, us.oracle.com

6.2.22 Additional Steps Needed for Oracle RTD Request Forwarding to Work Correctly

Due to an Oracle RTD issue related to request forwarding, the frontend URL must be the same as the backend URL for deployments that include Oracle RTD. To set the frontend URL for Oracle RTD, perform the steps listed in the following procedures at the point indicated in the Oracle Business Intelligence EDG task flow.

After performing the steps listed in Section 5.7, "Setting the Listen Address for bi_server1 Managed Server," set the frontend URL for the bi_server1 Managed Server, as follows:

1. Log in to the Administration Console.

2. In the Change Center, click Lock & Edit.

3. Expand the Environment node in the Domain Structure window.

4. Click Servers. The Summary of Servers page is displayed.

5. Select bi_server1 in the Names column of the table. The settings page for bi_server1 is displayed.

6. Click the Protocols tab.

7. Click the HTTP tab.

8. Set the Frontend Host field to APPHOST1VHN1 (your bi_server1 Listen address).

9. Click Save, then click Activate Changes.

After performing the steps listed in Section 6.4.1, "Setting the Listen Address for the bi_server2 Managed Server," set the frontend URL for the bi_server2 Managed Server, as follows:

1. Log in to the Administration Console.

2. In the Change Center, click Lock & Edit.

3. Expand the Environment node in the Domain Structure window.

4. Click Servers. The Summary of Servers page is displayed.

5. Select bi_server2 in the Names column of the table. The settings page for bi_server2 is displayed.

6. Click the Protocols tab.

7. Click the HTTP tab.

8. Set the Frontend Host field to APPHOST2VHN1 (your bi_server2 Listen address).

9. Click Save, then click Activate Changes.

6.3 Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS

If JMS messages and transaction logs are stored on an NFS-mounted directory, Oracle strongly recommends that you verify the behavior of a server restart after abrupt machine failures. Depending on the NFS implementation, different issues can arise post failover/restart.

To verify server restart behavior, abruptly shut down the node that hosts WebLogic servers while the servers are running.

- If you configured the server for server migration, it should start automatically in failover node after the failover period.

- If you did not configure the server for server migration, you can manually restart the WebLogic Server on the same host after the node completely reboots.

If Oracle WebLogic Server does not restart after abrupt machine failure, the following error entry may appear in server log files:

<MMM dd, yyyy hh:mm:ss a z> <Error> <Store> <BEA-280061> <The persistent
store "_WLS_server_soa1" could not be deployed:
weblogic.store.PersistentStoreException: java.io.IOException:
[Store:280021]There was an error while opening the file store file
"_WLS_SERVER_SOA1000000.DAT"
weblogic.store.PersistentStoreException: java.io.IOException:
[Store:280021]There was an error while opening the file store file
"_WLS_SERVER_SOA1000000.DAT"
at weblogic.store.io.file.Heap.open(Heap.java:168)
at weblogic.store.io.file.FileStoreIO.open(FileStoreIO.java:88)
...
java.io.IOException: Error from fcntl() for file locking, Resource
temporarily unavailable, errno=11

This error occurs when the NFSv3 system does not release locks on the file stores. WebLogic Server maintains locks on files that store JMS data and transaction logs to prevent data corruption that can occur if you accidentally start two instances of the same managed server. Because the NFSv3 storage device doesn't track lock owners, NFS holds the lock indefinitely if a lock owner crashes. As a result, after abrupt machine failure followed by a restart, subsequent attempts by WebLogic Server to acquire locks may fail.

If it is not reasonably possible to tune locking behavior in your NFS environment, use one of the following solutions to unlock the logs and data files:

- Use the WebLogic Server Administration Console to disable WebLogic file locking mechanisms for the default file store, a custom file store, a JMS paging file store, and a Diagnostics file store. To do this, see Considerations for Using File Stores on NFS in the Oracle Fusion Middleware High Availability Guide.

- Manually unlock the logs and JMS data files and start the servers by creating a copy of the locked persistence store file and using the copy for subsequent operations. See the following section Unlocking Logs and Data Files Manually.

Unlocking Logs and Data Files Manually

Manually unlock the logs and JMS data files and start the servers by creating a copy of the locked persistence store file and using the copy for subsequent operations. To create a copy of the locked persistence store file, rename the file then copy it back to its original name. The following sample steps assume that transaction logs are stored in the /shared/tlogs directory and JMS data is stored in the /shared/jms directory.

cd /shared/tlogs
mv _WLS_SOA_SERVER1000000.DAT _WLS_SOA_SERVER1000000.DAT.old
cp _WLS_SOA_SERVER1000000.DAT.old _WLS_SOA_SERVER1000000.DAT
cd /shared/jms
mv SOAJMSFILESTORE_AUTO_1000000.DAT SOAJMSFILESTORE_AUTO_1000000.DAT.old
cp SOAJMSFILESTORE_AUTO_1000000.DAT.old SOAJMSFILESTORE_AUTO_1000000.DAT
mv UMSJMSFILESTORE_AUTO_1000000.DAT UMSJMSFILESTORE_AUTO_1000000.DAT.old
cp UMSJMSFILESTORE_AUTO_1000000.DAT.old UMSJMSFILESTORE_AUTO_1000000.DAT

With this solution, the WebLogic file locking mechanism continues to protect against accidental data corruption if multiple instances of the same servers are accidently started. However, you must restart the servers manually after abrupt machine failures. File stores create multiple consecutively numbered.DAT files when they store large amounts of data. You may need to copy and rename all files when this occurs.

6.4 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 6.4.1, "Documentation Errata for the Fusion Middleware High Availability Guide"

- Section 6.4.2, "Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter"

- Section 6.4.3, "Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management"

- Section 6.4.4, "Documentation Errata for the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence"

- Section 6.4.5, "Documentation Errata Affecting Multiple Enterprise Deployment Guides"

6.4.1 Documentation Errata for the Fusion Middleware High Availability Guide

This section contains Documentation Errata for Oracle Fusion Middleware High Availability Guide.

It includes the following topic:

- Section 6.4.1.1, "Latest Requirements and Certification Information"

6.4.1.1 Latest Requirements and Certification Information

Several manuals in the Oracle Fusion Middleware 11g documentation set have information on Oracle Fusion Middleware system requirements, prerequisites, specifications, and certification information.

- The latest information on Oracle Fusion Middleware system requirements, prerequisites, specifications, and certification information can be found in the following documents on Oracle Technology Network:
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

This document contains information related to hardware and software requirements, minimum disk space and memory requirements, and required system libraries, packages, or patches.

- Oracle Fusion Middleware Certification information at:
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

This document contains information related to supported installation types, platforms, operating systems, databases, JDKs, and third-party products.

6.4.2 Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter

This section contains Documentation Errata for Oracle Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter.

It includes the following topics:

- Section 6.4.2.1, "Link to Section 8.1.3 is Missing"

- Section 6.4.2.2, "Additional Information for Discussions Forum Mulitcast to Unicast Conversion"

- Section 6.4.2.3, "Additional Discussion Connection Properties Explained in Administration Guide"

6.4.2.1 Link to Section 8.1.3 is Missing

In Section 8.1, "Configuring the Discussion Forum Connection" of the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter, the link to section 8.1.3, "Creating a Discussions Server Connection for WebCenter From EM" is missing.

6.4.2.2 Additional Information for Discussions Forum Mulitcast to Unicast Conversion

In section 6.14, "Converting Discussions Forum from Multicast to Unicast" of the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter, the following information is missing from Step 3:

Step 3: Repeat steps 1 and 2 for WLS_Services2, swapping WCHost1 for WCHost2, and WCHost2 for WCHost1 as follows:

-Dtangosol.coherence.wka1=WCHost2 -Dtangosol.coherence.wka2=WCHost1
-Dtangosol.coherence.localhost=WCHost2 -Dtangosol.coherence.wka1.port=8089
-Dtangosol.coherence.wka2.port=8089

6.4.2.3 Additional Discussion Connection Properties Explained in Administration Guide

For additional Discussions Server connection properties associated with the procedure in Section 8.1.3 "Creating a Discussions Server Connection for WebCenter From EM" of the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter, refer to section 12.3.1, "Registering Discussions Servers Using Fusion Middleware Control," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

6.4.3 Documentation Errata for the Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management

This section contains documentation errata for Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management.

It includes the following topics:

- Section 6.4.3.1, "Set -DDomainRegistrationEnabled=true when Starting Node Manager"

- Section 6.4.3.2, "Ignore Empty Section in the Oracle Virtual Directory Chapter"

6.4.3.1 Set -DDomainRegistrationEnabled=true when Starting Node Manager

The November 2010 edition of Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management failed to mention that, prior to starting the Node Manager that controls the WebLogic Administration Server, you must set -DDomainRegistrationEnabled=true. For example:

export JAVA_OPTIONS=-DDomainRegistrationEnabled=true

6.4.3.2 Ignore Empty Section in the Oracle Virtual Directory Chapter

In the November 2010 edition of Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Identity Management, Section 8.1.1 in Chapter 11, "Extending the Domain with Oracle Virtual Directory is an empty section." Please ignore it.

6.4.4 Documentation Errata for the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence

This section contains documentation errata for Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence.

It includes the following topics:

Section 6.4.4.1, "Additional Step Must be Performed After Setting the Location of the BI Publisher Configuration Folder"

Section 6.4.4.2, "Corrections to the Setting the Location of the Shared Oracle BI Presentation Catalog Section"

6.4.4.1 Additional Step Must be Performed After Setting the Location of the BI Publisher Configuration Folder

After restarting Oracle BI Publisher when specifying the location of the configuration folder, as described in Section 6.5.3.1, "Setting the Location of the Shared Oracle BI Publisher Configuration Folder," you must copy the XML configuration file for Oracle BI Publisher from the Managed Server to the Administration Server location. Oracle BI Publisher reads its configuration from the Administration Server central location rather than from the Managed Server's configuration directory when the Managed Servers are restarted.

To do this, on APPHOST1, copy the file xmlp-server-config.xml from:

ORACLE_BASE/admin/domain_name/mserver/domain_name/config/bipublisher

to:

ORACLE_BASE/admin/domain_name/aserver/domain_name/config/bipublisher

6.4.4.2 Corrections to the Setting the Location of the Shared Oracle BI Presentation Catalog Section

The "Setting the Location of the Shared Oracle BI Presentation Catalog" section of the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence should be replaced by the following section:

Each Presentation Services instance loads the Oracle BI Presentation Catalog from the catalog location specified in Fusion Middleware Control.

Perform the following steps:

1. Copy your existing (locally published) Oracle BI Presentation Catalog to the shared location. An example of a locally published catalog is:

ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent/
coreapplication_obipsn/catalog/SampleAppLite

You must perform this step before designating the Catalog Location from Fusion Middleware Control.

If you plan to use the SampleAppLite catalog mentioned as an example in this section as the shared catalog, make sure to copy it from APPHOST1.

2. Log in to Fusion Middleware Control.

3. Expand the Business Intelligence node in the Farm_domain_name window.

4. Click coreapplication.

5. Click Deployment, then click Repository.

6. Click Lock and Edit Configuration.

7. Specify the Catalog Location for the shared Oracle BI Presentation Catalog.
In a Windows environment, specify a UNC path name.

8. Click Apply.

9. Click Activate Changes.

6.4.5 Documentation Errata Affecting Multiple Enterprise Deployment Guides

This section describes documentation errata that affects multiple Enterprise Deployment Guides. Any Enterprise Deployment Guide that have the documentation errata issue discussed in the release notes below should be updated as specified in that release note.

It includes these topics:

- Section 6.4.5.1, "Sections on Configuring Oracle Coherence for SOA Composites Need Fixes"

- Section 6.4.5.2, "Updates are Needed to Steps for Testing Server Migration"

- Section 6.4.5.3, "Steps for Updating Data Sources for Server Migration Need Updates"

- Section 6.4.5.4, "Clarification of the Procedure for Configuring the Analytics Collectors"

- Section 6.4.5.5, "Correction to Table 2-2, "Ports Used""

- Section 6.4.5.6, "Note Missing from Configure Cluster Screens Step in Extend Domain for SOA Chapter"

6.4.5.1 Sections on Configuring Oracle Coherence for SOA Composites Need Fixes

Several Enterprise Deployment Guide manuals have a "Configuring Oracle Coherence for Deploying Composites" section that includes a Note like the following:

Note:

The Coherence cluster used for deployment uses port 8088 by default. This port can be changed by specifying the -Dtangosol.coherence.wkan.port startup parameter.

This Note should read as follows:

Note:

The Coherence cluster used for deployment uses port 8088 by default. This port can be changed by specifying a different port (for example, 8089) with the -Dtangosol.coherence.wkan.port and -Dtangosol.coherence.localport startup parameters. For example:
WLS_SOA1 (enter the following into the Arguments field on a single line, without a carriage return):

-Dtangosol.coherence.wka1=soahost1vhn1
-Dtangosol.coherence.wka2=soahost2vhn1
-Dtangosol.coherence.localhost=soahost1vhn1
-Dtangosol.coherence.localport=8089
-Dtangosol.coherence.wka1.port=8089
-Dtangosol.coherence.wka2.port=8089

WLS_SOA2 (enter the following into the Arguments field on a single line, without a carriage return):

-Dtangosol.coherence.wka1=soahost1vhn1
-Dtangosol.coherence.wka2=soahost2vhn1
-Dtangosol.coherence.localhost=soahost2vhn1
-Dtangosol.coherence.localport=8089
-Dtangosol.coherence.wka1.port=8089
-Dtangosol.coherence.wka2.port=8089

6.4.5.2 Updates are Needed to Steps for Testing Server Migration

Several Enterprise Deployment Guide manuals have one or more subsections that describe how to test server migration.

The following Note should appear at the end of every section on testing server migration:

Note:

After a server is migrated, to fail it back to its original node/machine, stop the managed server from the Oracle WebLogic Administration Console and then start it again. The appropriate Node Manager will start the managed server on the machine to which it was originally assigned.

6.4.5.3 Steps for Updating Data Sources for Server Migration Need Updates

Several Enterprise Deployment Guide manuals have one or more subsections that describe how to update the data sources used for leasing when you configure server migration.

The following text appears in the instructions on how to update data sources for leasing as part of server migration configuration:

Use Supports Global Transactions, One-Phase Commit, and specify a service name for your database

That text should appear as follows:

Data sources do not require support for global transactions. Therefore, do not use any type of distributed transaction emulation/participation algorithm for the data source (do not choose the Supports Global Transactions option, or the Logging Last Resource, Emulate Two-Phase Commit, or One-Phase Commit options of the Supports Global Transactions option), and specify a service name for your database.

6.4.5.4 Clarification of the Procedure for Configuring the Analytics Collectors

Section 6.4.16, "Configuring the Analytics" in the Oracle Fusion Middleware High Availability Guide contains content that indicates that you must configure an analytic collector cluster. In fact, there is no need to configure the collectors themselves. Instead, the procedure in this section explains how to configure the Oracle WebCenter Spaces servers to communicate with the analytic collectors.

Further, for Oracle Fusion Middleware 11g Release 1 (11.1.1.4.0), clustered analytics collectors are not supported for collecting WebCenter events.

6.4.5.5 Correction to Table 2-2, "Ports Used"

In Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence, Chapter 2, "Database and Environment Preconfiguration," Table 2-2 lists the ports used in the Oracle Business Intelligence topology. The following additional information should be included in the table above the row containing "Database Access:"

- Type: Database access for BI Server and BI Publisher JDBC Data Sources

- Firewall: FW1

- Port and Port Range: Listening port for client connections to the listener.

- Protocol/Application: SQL*Net

- Inbound/Outbound: Both

- Other Considerations and Timeout Guidelines: Timeout depends on all database content and on the type of process model used for BI.

Note:

This issue was fixed in the E15722-03 revision of Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence.

6.4.5.6 Note Missing from Configure Cluster Screens Step in Extend Domain for SOA Chapter

The following note is missing from Step 13 of the section titled "Extending the Domain for SOA Components using the Configuration Wizard."

Note:

For asynch request/response interactions over direct binding, the SOA composites must provide their jndi provider URL for the invoked service to look up the beans for callback.
If soa-infra config properties are not specified, but the WebLogic Server Cluster address is specified, the cluster address from the JNDI provider URL is used. This cluster address can be a single DNS name which maps to the clustered servers' IP addresses or a comma separated list of server ip:port. Alternatively, the soa-infra config property JndiProviderURL/SecureJndiProviderURL can be used for the same purpose if explicitly set by users.

This note also applies to Section 11.3, "Running the Configuration Wizard on SOAHOST1 to Extend a SOA Domain to Include Oracle Service Bus" in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite.

7 Oracle Fusion Middleware on IBM WebSphere

This chapter describes issues you might encounter when you install and configure supported Oracle Fusion Middleware products on IBM WebSphere. It includes the following topics:

- Section 7.1, "General Issues and Workarounds"

- Section 7.2, "Configuration Issues and Workarounds"

Note:

This chapter contains issues you might encounter while installing, configuring, or managing any of the Oracle Fusion Middleware products on IBM WebSphere.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.

7.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 7.1.1, "Accessibility Mode for User Messaging Preferences is Ignored on an IBM WebSphere Application Server"

- Section 7.1.2, "Adding Shared Libraries to Deploy a Task Form from Oracle JDeveloper"

- Section 7.1.3, "Setting Cookie Paths for Oracle SOA Suite Applications"

- Section 7.1.4, "Deploying a SOA Composite Application to a SOA Cluster"

- Section 7.1.5, "Cannot Deploy a SOA Bundle File from Oracle Enterprise Manager Fusion Middleware Control"

- Section 7.1.6, "One-and-Only-One Event Subscriptions Are Not Supported"

- Section 7.1.7, "Deployed Task Form Startup Failure in IBM WebSphere Administration Console"

- Section 7.1.8, "Oracle BPM Worklist Displays as Undefined in Administration Console"

- Section 7.1.9, "Dashboard Tab May Display Completed SOA Composite Instance States as Running"

- Section 7.1.10, "Two-Way SSL Configuration with Oracle SOA Suite Is Not Supported"

- Section 7.1.11, "Multiple Fault Recovery Failure with the Recover With Options Dialog"

- Section 7.1.12, "IBM WebSphere Application Server - ND Installation Requires a Server Restart"

- Section 7.1.13, "Test Emulations of Asynchronous BPEL Processes Fail"

- Section 7.1.14, "SETMANAGEDCONNECTION() Fails with ILLEGALSTATEEXCEPTION for the AQ Adapter"

- Section 7.1.15, "Invalid PolicySet Error When Accessing a Deployed Oracle Fusion Middleware Application on IBM WebSphere"

- Section 7.1.16, "Cannot Stop or Start Oracle Internal Applications From Fusion Middleware Control on IBM WebSphere"

- Section 7.1.17, "For the JMS Adapter, Instances Become Recoverable Even Without Failover"

- Section 7.1.18, "HTTP 500 Error Accessing Spaces Workflow Notifications in the Worklist Task Flow"

7.1.1 Accessibility Mode for User Messaging Preferences is Ignored on an IBM WebSphere Application Server

On an IBM WebSphere Application Server instance, the Screen Reader for accessibility mode will not be set even if you have selected the Screen Reader mode from the drop-down list on the User Messaging Preferences login screen.

As a workaround, set the accessibility mode on the User Messaging Preferences login screen as follows:

1. Go to Oracle UMS User Messaging Preferences UI:

http://host:port/sdpmessaging/userprefs-ui

2. Enter a valid user name and password.

3. In the Accessibility Mode drop-down list, select Standard, and click Login.

4. After logging in, click the Settings link at the top right corner of the User Messaging Preferences page.

5. From the Accessibility Mode options, select Screen Reader.

6. Click the Home link to go to the User Messaging Preferences page. The Screen Reader mode will be enabled.

Note:

The Settings options in UMS User Messaging Preferences is session based. If you log out or close the browser, you will lose the accessibility mode settings. You will need to reset the settings after each login.

7.1.2 Adding Shared Libraries to Deploy a Task Form from Oracle JDeveloper

When you deploy a SOA composite application with a task flow from Oracle JDeveloper to the SOA server on IBM WebSphere, the application cannot be started correctly due to a ClassNotFound error. The shared library of the application is empty.

As a workaround, perform the following steps:

1. Go to IBM WebSphere Administration Console.

2. Select Applications > Application Types > WebSphere Enterprise Applications > task_form_name > Shared library references.

3. Manually add adf.oracle.domain_1.0_11.1.1.2.0 and oracle.jsp.next_11.1.1_11.1.1.

4. Restart the application.

7.1.3 Setting Cookie Paths for Oracle SOA Suite Applications

By default, applications deployed on IBM WebSphere have their cookie path set to "/". This default setting means that all applications on the same IBM WebSphere cell share the same session identifier. Therefore, as you move between applications, the session identifier value for the previous application is overwritten.

For example, if you access Oracle SOA Composer (/soa/composer), then access Oracle Enterprise Manager (/em), and then return to Oracle SOA Composer (/soa/composer), you are prompted to log in again because the previous session identifier value is overwritten at the point at which you log in to Oracle Enterprise Manager.

Section "Setting Cookie Paths for WebCenter Portal Application Modules Post Deployment" of the Oracle Fusion Middleware Third-Party Application Server Guide describes how to specify unique cookie paths for each application. This action enables you to avoid session invalidation as you move between applications.

In Step 4 of that section, where you click Manage Modules in IBM WebSphere Administrative Console to select the modules to manage, and Step 5, where you specify the cookie path, note the following Oracle SOA Suite details to specify.

Target Server

Application Name

Modules

Cookie Path

soa_server1

composer
(Oracle SOA Composer)

soa-composer-was.war

/soa/composer

worklistapp
(Oracle BPM Worklist)

worklist-was.war

/integration/worklistapp

bam_server1

oracle-bam
(Oracle BAM)

bam-web.war

/OracleBAM

soa_server1/bam_server1

usermessagingserver
(Oracle User Messaging Server)

sdpmessaginguserprefs-ui-web.war

/sdpmessaging/userprefs-ui

OracleAdminServer

em
(Oracle Enterprise Manager)

em.war

/em

After performing these tasks, you must restart the target servers (soa_server1, bam_server1, and OracleAdminServer).

7.1.4 Deploying a SOA Composite Application to a SOA Cluster

When you deploy a SOA composite application from Oracle JDeveloper, you cannot select the application server to which to deploy. Instead, the application is deployed to the Deployment Manager by default.

As a workaround, log in to the IBM WebSphere Administration Console, uninstall the application from the Deployment Manager, and reinstall the application to the SOA cluster by using the generated .ear file.

7.1.5 Cannot Deploy a SOA Bundle File from Oracle Enterprise Manager Fusion Middleware Control

You cannot deploy a SOA bundle file from Oracle Enterprise Manager Fusion Middleware Control. As a workaround, use the wsadmin command line shell.

For example, assume vacationapproval.zip is a SOA bundle file that includes three SOA composite applications.

wsadmin> soa.sca_deployComposite("http://myhost.us.oracle.com:7001",
"/tmp/vacationapproval.zip")

For more information about wsadmin commands, see Section "Oracle SOA Suite wsadmin and WLST Command Differences" of the Oracle Fusion Middleware Third-Party Application Server Guide.

7.1.6 One-and-Only-One Event Subscriptions Are Not Supported

Business events are published to the Event Delivery Network (EDN). EDN provides support for delivering events to one-and-only-one subscribers, in which the event is sent to the subscriber in its own global (that is, JTA) transaction. However, one-and-only-one subscriptions are not supported when using EDN with IBM WebSphere Server.

As a workaround, change the one and only one consistency level of the event subscription to guaranteed in the Create Mediator dialog.

Note:

This change downgrades the consistency level. Therefore, a system failure may cause an event to be delivered more than once because there is no global transaction. If the subscriber fails to process the event, the event is not resent.

7.1.7 Deployed Task Form Startup Failure in IBM WebSphere Administration Console

When you attempt to start a deployed task form application in the IBM WebSphere Administration Console, it fails. You receive an error message similar to the following:

Was2Form failed to start. Check the logs for server dmgr on node
DefaultCellManager01 for details.
ErrorAn error occurred while starting Was2Form. Check the logs for server
dmgr on node DefaultCellManager01 for more information.

As a workaround, perform the following steps:

1. Deploy the task flow in Oracle JDeveloper at the application level, instead of the project level. This generates the EAR file.

2. Undeploy the task flow from the IBM WebSphere Administration Console. Save directly to the master configuration to synchronize changes to all nodes.

3. Deploy the EAR file generated in step 1 through the IBM WebSphere Administration Console.

1. Go to Websphere Enterprise Applications > Install > Pick EAR from Locale file system.

2. Click Next (use the default options).

3. On step 2 of the deploy page "Map modules to servers," select all modules, highlight only the SOA server (for example, soa_server1), and click Apply.

4. On step 3, "Map virtual hosts for Web modules," select the WAR file.

5. At the end, save directly to the master configuration again.

4. Select the EAR file to start it.

7.1.8 Oracle BPM Worklist Displays as Undefined in Administration Console

If you configure an Oracle SOA Suite cluster or single server environment on IBM WebSphere, you may receive an error when accessing Oracle BPM Worklist indicating that it is undefined. If you log in to IBM WebSphere Administration Console, and select Applications > WebSphere enterprise applications > worklistapp > Shared library references, and see that only one row (worklistapp) is displayed when two rows should display (worklistapp and worklist-was.war), you must perform the following steps.

- Uninistall Oracle BPM Worklist (known as worklistapp in the IBM WebSphere Administration Console).

- Re-install Oracle BPM Worklist.

To uninistall Oracle BPM Worklist:

1. Log in to the IBM WebSphere Administration Console.

2. From the panel on the left hand side, select Applications > Application Type > WebSphere enterprise applications.

3. Select the check box for worklistapp from the Enterprise Applications list.

4. Click the Stop button to stop worklistapp.

5. Select worklistapp again.

6. Click the Uninstall button, and click OK.

7. Select Review from the Save and Review options.

8. Select Synchronize changes with nodes, and click Save.

9. Wait until configuration synchronization is complete, then click OK.

10. Confirm that worklistapp is now removed (uninstalled) from Enterprise Applications.

To re-install Oracle BPM Worklist:

1. If not already there, navigate to Applications > Application Type > WebSphere enterprise applications.

2. Click Install.

3. Select the Remote file system option:

1. Click Browse > DefaultCellDepMgrNode.

2. Click the root directory (/), and go to your ORACLE_HOME.

3. Navigate to soa/applications.

4. Select worklist-was.ear, and click OK.

4. Select the default Fast Path, and click Next.

5. Select the installation options:

1. Change the name Oracle BPM Worklist to worklistapp, and click Next.

6. Map the modules to the servers:

1. Select the check boxes for the two modules (jar and war).

2. From the Clusters and servers list, select server=soa_server1 or the server or cluster on which Oracle SOA Suite is installed.

3. Click Apply.

4. Confirm that the two modules now have the correct server value (for example, soa_server1) in the server column.

5. Click Next.

7. Map the virtual hosts for the web modules:

1. Select the one web module.

2. Click Next.

8. On the Summary screen, review the information, and click Finish.
Output displays on the screen, and you are prompted to save or review your local changes.

9. Select Review.

10. Save your workspace changes:

1. Click Synchronize changes with Nodes.

2. Verify that Total changed documents is 29 (if not, there may be an error).

3. Click Save.

11. Wait until configuration synchronization is complete, then click OK.
The worklistapp is now installed and ready to be started.

12. Verify that the worklistapp is present in the Enterprise Applications list.

13. Select worklistapp, and click Start.

14. Confirm that the Application Status is up.

15. Test that Oracle BPM Worklist in accessible by visiting the following URL:

http://host:port/integration/worklistapp

7.1.9 Dashboard Tab May Display Completed SOA Composite Instance States as Running

The Dashboard tab of a SOA composite application in Oracle Enterprise Manager Fusion Middleware Control may show the state of an instance as running even though the instance has actually completed. In this scenario, verify the actual instance state on the Flow Trace page.

7.1.10 Two-Way SSL Configuration with Oracle SOA Suite Is Not Supported

Two-way SSL configuration on IBM WebSphere is not supported. Therefore, there is no support for Oracle Web Service Manager (OWSM) two-way security policies that are SSL-configured. Note that one-way SSL is supported (for example, in which you create an SSL-configured SOA service that invokes another SOA service).

7.1.11 Multiple Fault Recovery Failure with the Recover With Options Dialog

If you click Recover With Options on the Fault and Rejected Messages tab of a SOA composite application, and attempt to recover all faults by selecting Recover All in the Recover With Options dialog, the faults are not recovered and display as pending. The problem only occurs with the Recover With Options dialog. Individual instance recovery and selecting multiple instances for recovery works correctly.

7.1.12 IBM WebSphere Application Server - ND Installation Requires a Server Restart

If you install IBM WebSphere Application Server - Network Deployment (ND) for use with Oracle SOA Suite, you must restart the server for JCA adapter binding components to be active. Otherwise, JNDIs are not active, and you receive the following error message:

Non Recoverable System Fault :
BINDING.JCA-12563 Exception occured when binding was invoked. Exception
occured during invocation of JCA binding: "JCA Binding execute of Reference
operation 'Write' failed due to: JCA Binding Component connection issue. JCA
Binding Component is unable to create an outbound JCA (CCI) connection.
File_MEDComposite:WriteMed [ Write_ptt::Write(body) ] : The JCA Binding
Component was unable to establish an outbound JCA CCI connection due to the
following issue: BINDING.JCA-12510 JCA Resource Adapter location error.
. . .
. . .

7.1.13 Test Emulations of Asynchronous BPEL Processes Fail

You cannot create test emulations involving asynchronous BPEL processes in a SOA composite application on IBM WebSphere. During test execution, this results in an CannotInstantiateObjectException exception error.

7.1.14 SETMANAGEDCONNECTION() Fails with ILLEGALSTATEEXCEPTION for the AQ Adapter

When running Oracle AQ Technology Adapter cases on the WebSphere Platform, you might encounter the following error:

javax.resource.spi.ResourceAllocationException: setManagedConnection: illegal state exception. State = STATE_ACTIVE_FREE MCW = 28392839

To follow-up on this exception, IBM PMR # 69026,756 has been created

7.1.15 Invalid PolicySet Error When Accessing a Deployed Oracle Fusion Middleware Application on IBM WebSphere

When you deploy an application using Oracle Fusion Middleware on IBM WebSphere, you might receive the following runtime error:

oracle.fabric.common.PolicyEnforcementException: PolicySet Invalid:
WSM-06102 PolicyReference The policy reference URI
oracle/wss_username_token_service_policy is not valid

To workaround this issue, perform the following steps:

1. Open the policy-accessor-config.xml file, which can found at the following location:

WAS_HOME/profiles/Dmgr01/config/cells/DefaultCell/fmwconfig/

2. Locate the policy-accessor properties and uncomment the following properties and set the value of each property as shown:

<property name="active.protocol">
remote
</property>
<property name="java.naming.provider.url">
corbaloc:iiop:hostname:rmi.port
</property>

In this example, replace hostname and rmi.port to identify the host and RMI port where the policy manager is running.

No restart is required. By default, the new version of the policy-accessor-config.xml is loaded every 10 mins. However, if you want to pick up the changes immediately, then you can restart the server.

7.1.16 Cannot Stop or Start Oracle Internal Applications From Fusion Middleware Control on IBM WebSphere

When running Oracle Enterprise Manager Fusion Middleware Control on IBM WebSphere, you might experience errors if you attempt to stop or start the internal Oracle applications that are displayed under the Internal Applications folder in the target navigation pane.

The applications listed here are internal Oracle applications. You should not start or stop these applications from Fusion Middleware Control. If you must stop or start these applications, then start or stop the managed servers that host the internal applications.

7.1.17 For the JMS Adapter, Instances Become Recoverable Even Without Failover

When the SOA JMS adapter is installed on WebSphere and is communicating with the IBM WebSphere Default JMS Messaging provider, you must set the property Persistent message reliability to Assured persistent rather than Reliable persistent; otherwise, an incorrect setting can result in loss of messages.

Also, occasionally when the failover scenario does not occur, you can see situations that include an error (transaction timing out, or the closing of JMS session) from the IBM WebSphere JMS, making instances become recoverable. If this happens, you need to manually recover the instances from the Oracle Enterprise Manager.

7.1.18 HTTP 500 Error Accessing Spaces Workflow Notifications in the Worklist Task Flow

If Spaces workflows fail to register several shared libraries at deployment time, you may see the following HTTP 500 error when you access Spaces workflow notifications, such as a space membership invitation, from a Worklist task flow in the Spaces application:

Error 500: javax.servlet.ServletException: SRVE0207E: Uncaught initialization exception created by servlet

The associated BPEL server log entry for this error in /IBM/WebSphere/AppServer/profiles/Server1/logs/soa_server1/soa_server1/SystemOut.log is:

java.lang.IllegalStateException: Application was not properly initialized at startup, could not find Factory: javax.faces.context.FacesContextFactory

To resolve the error, navigate to the application (WebCenterWorklistDetailApp) in the Admin Console and include the missing shared library references (oracle.jsp.next_11.1.1_11.1.1 and adf.oracle.domain_1.0_11.1.1.2.0):

1. Go to IBM WebSphere Administration Console.

2. Select Applications > Application Types > WebSphere Enterprise Applications > WebCenterWorklistDetailApp > Shared library references.

3. Manually add adf.oracle.domain_1.0_11.1.1.2.0 and oracle.jsp.next_11.1.1_11.1.1.

4. Restart the application.

Note:

The same issue can occur for other applications, such as usermessagingsca-ui-worklist. If this is the case, follow similar steps to resolve the issue. See also, Section 7.1.2, "Adding Shared Libraries to Deploy a Task Form from Oracle JDeveloper".

7.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 7.2.1, "Error Configuring a Cell When IBM WebSphere Installed on Windows 2003 and 2008"

- Section 7.2.2, "Configuring Coherence for a SOA Cluster on IBM WebSphere"

- Section 7.2.3, "Limitations When Configuring Oracle Business Activity Monitoring for High Availability on IBM WebSphere"

- Section 7.2.4, "Requests Received by IBM HTTP Server (IHS) Are Routed to the Fusion Middleware Welcome Page"

- Section 7.2.5, "Registering WSRP/JPDK Producers in an IBM WebSphere Application Server Instance"

7.2.1 Error Configuring a Cell When IBM WebSphere Installed on Windows 2003 and 2008

When IBM WebSphere is installed on Windows 2003 or Windows 2008, the following error sometimes displays when you attempt to create a cell:

WebSphere Profile Update Failed!
No Changes Were Saved To The WebSphere Profile
Profile Location: x:\mydir\APPSER~1\profiles\Dmgr02
Reason Exception saving changes to WebSphere configuration

The issue is due to the Jython libraries shipped with IBM WebSphere. As a workaround:

1. Locate and edit the file:

WAS_HOME\optionalLibraries\jython\Lib\javaos.py

2. Locate the function: _getOsType

3. Edit the _osTypeMap variable to return "nt" as the default.

_osTypeMap = (
( "nt", r"(nt)|(Windows NT)|(Windows NT 4.0)|(WindowsNT)|"
r"(Windows 2000)|(Windows XP)|(Windows CE)" ),
( "dos", r"(dos)|(Windows 95)|(Windows 98)|(Windows ME)" ),
( "mac", r"(mac)|(MacOS.*)|(Darwin)" ),
( "None", r"(None)" ),
( "nt", r"(.*)" ), # default - posix seems to vary mast widely
)

4. Save the changes.

7.2.2 Configuring Coherence for a SOA Cluster on IBM WebSphere

When you configure a SOA cluster on IBM WebSphere, you must configure Oracle Coherence with the host names and other required cluster properties.

For Oracle WebLogic Server environments, refer to the Oracle Coherence configuration information "Configuring Oracle Coherence for Deploying Composites" in the Oracle Fusion Middleware High Availability Guide.

When configuring a SOA Cluster on IBM WebSphere, you perform a similar set of tasks, using the following instructions that are specific to IBM WebSphere:

1. Login to the IBM WebSphere Administrative Console.

2. Navigate to the Java Virtual Machine Custom Properties page:
Servers > soa_server_name > Java and Process Management > Process Definition > Java Virtual Machine > Custom Properties

3. Add the following properties:

- For a multicast cluster:

tangosol.coherence.clusteraddress
tangosol.coherence.clusterport

- For a unicast cluster:

tangosol.coherence.wka1 (= host1)
tangosol.coherence.wka2 (= host2)
tangosol.coherence.localhost = (host?)
tangosol.coherence.wka1.port
tangosol.coherence.wka2.port
tangosol.coherence.localport

7.2.3 Limitations When Configuring Oracle Business Activity Monitoring for High Availability on IBM WebSphere

When you install and configure Oracle BAM on IBM WebSphere, you cannot configure the Oracle BAM servers in the high availability, two-node configuration as described "Configuring High Availability for Oracle BAM" in the Oracle Fusion Middleware High Availability Guide.

Instead, when configuring Oracle BAM on IBM WebSphere, you must use a cold failover configuration. For more information, see "Active-Passive Topologies for Oracle Fusion Middleware High Availability" in the Oracle Fusion Middleware High Availability Guide.

7.2.4 Requests Received by IBM HTTP Server (IHS) Are Routed to the Fusion Middleware Welcome Page

When using Fusion Middleware products on IBM WebSphere ND with an IBM @ HTTPServer (IHS) front end, requests coming in to the Content Server may instead be routed to the Fusion Middleware Welcome page that is running on the cell's Administration Server (OracleAdminServer).

For requests to be properly routed to the Content Server, perform the following steps after fully configuring the cell.

Refer to IBM's Network Deployment documentation for detailed information about editing, propagating, and regenerating the plugin-cfg.xml file:

1. Disable automatic propagation of the plugin-cfg.xml file.
For example:

IBM/HTTPServer/plug-in/config/webserver1/plugin-cfg.xml

2. Manually regenerate plugin-cfg.xml.

3. Manually edit plugin-cfg.xml to remove any entries that may cause requests to be routed to OracleAdminServer.

4. Manually propagate plugin-cfg.xml to the IHS Web server plugin.

If you update the cell after performing these steps, you might see this issue again. If so, then repeat these configuration steps.

7.2.5 Registering WSRP/JPDK Producers in an IBM WebSphere Application Server Instance

Users are not able to register WSRP/JPDK Producers in Oracle WebCenter Portal's Pagelet Producer Console in an IBM WebSphere Application Server instance. To resolve this issue, follow the steps below to add the necessary role (AppConnectionManager) to the Pagelet Producer application.

1. Open WebSphere Admin Console.

2. Under WebSphere Applications Deployment, right-click pagelet-producer and select Security and Application Roles.

3. Click Application stripe and select pagelet-producer.

4. In the Starts with field, enter AppConnectionManager and click Search. Select the AppConnectionManager role and click Edit.

5. Under Members, click Add to open a dialog that allows you to search for principals and assign the necessary users or groups to the role. Select the required user(s) and click OK to close the dialog.

6. Click OK to save the application settings.

7. Restart the WC_Portlet managed server (the updated security settings do not take effect until the server is restarted).

Part II

Oracle Development Tools

Part II contains the following chapters:

- Chapter 8, "Oracle JDeveloper and Oracle Application Development Framework (ADF)"

- Chapter 9, "Oracle TopLink"

8 Oracle JDeveloper and Oracle Application Development Framework (ADF)

The latest known issues associated with Oracle JDeveloper and Application Developer Framework (ADF) are available on the Oracle Technology Network (OTN) at: http://www.oracle.com/technetwork/developer-tools/jdev/index-101256.html.

For more information and technical resources for Oracle JDeveloper and Application Developer Framework (ADF), visit the product center on the Oracle Technology Network at: http://www.oracle.com/technetwork/developer-tools/jdev/overview/index.html.

The script content on this page is for navigation purposes only and does not alter the content in any way.

9 Oracle TopLink

This chapter describes issues associated with Oracle TopLink. It includes the following topics:

- Section 9.1, "General Issues and Workarounds"

9.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topic:

- Section 9.1.1, "TopLink Object-Relational Issues"

- Section 9.1.2, "TopLink Workbench Issues"

- Section 9.1.3, "Oracle Database Extensions with TopLink"

- Section 9.1.4, "Allowing Zero Value Primary Keys"

- Section 9.1.5, "Managed Servers on Sybase with JCA Oracle Database Service"

- Section 9.1.6, "Logging Configuration with EclipseLink Using Container Managed JPA"

- Section 9.1.7, "Grid Cache requires CacheLoader"

9.1.1 TopLink Object-Relational Issues

This section contains information on the following issues:

- Section 9.1.1.1, "Cannot set EclipseLink log level in WLS System MBean Browser"

- Section 9.1.1.2, "Incorrect outer join SQL on SQLServer2005"

- Section 9.1.1.3, "UnitOfWork.release() not Supported with External Transaction Control"

- Section 9.1.1.4, "Returning Policy for UPDATE with Optimistic Locking"

- Section 9.1.1.5, "JDBC Drivers returning Timestamps as Strings"

- Section 9.1.1.6, "Unit of Work does not add Deleted Objects to Change Set"

9.1.1.1 Cannot set EclipseLink log level in WLS System MBean Browser

Use Oracle Enterprise Manager to set the EclipseLink log level; do not use the WLS System MBean Browser to complete this action.

9.1.1.2 Incorrect outer join SQL on SQLServer2005

TopLink generates incorrect outer join for SQL Server v2005. The outer join syntax generated is correct for earlier versions of this database. To work around this limitation, reconfigure the database compatibility (refer to the SQLServer documentation for details). Alternatively, you can use a custom TopLink database platform.

9.1.1.3 UnitOfWork.release() not Supported with External Transaction Control

A unit of work synchronized with a Java Transaction API (JTA) will throw an exception if it is released. If the current transaction requires its changes to not be persisted, the JTA transaction must be rolled back.

When in a container-demarcated transaction, call setRollbackOnly() on the EJB/session context:

@Stateless
public class MySessionBean
{    @Resource
SessionContext sc;

public void someMethod()
{
...
sc.setRollbackOnly();
}
}

When in a bean-demarcated transaction then you call rollback() on the UserTransaction obtained from the EJB/session context:

@Stateless
@TransactionManagement(TransactionManagementType.BEAN)
public class MySessionBean implements SomeInterface
{
@Resource
SessionContext sc;

public void someMethod()
{
sc.getUserTransaction().begin();
...
sc.getUserTransaction().rollback();
}
}

9.1.1.4 Returning Policy for UPDATE with Optimistic Locking

The returning policy, which allows values modified during INSERT and UPDATE to be returned and populated in cached objects, does not work in conjunction with numeric version optimistic locking for UPDATE. The value returned for all UPDATE operations is 1 and does not provide meaningful locking protection.

Do not use a returning policy for UPDATE in conjunction with numeric optimistic locking.

The use of returning policy for INSERT when using optimistic locking works correctly.

9.1.1.5 JDBC Drivers returning Timestamps as Strings

TopLink assumes that date and time information returned from the server will use Timestamp. If the JDBC driver returns a String for the current date, TopLink will throw an exception. This is the case when using a DB2 JDBC driver.

To work around this issue, consider using a driver that returns Timestamp (such as COM.ibm.db2.jdbc.app.DB2Driver) or change the policy to use local time instead of server time.

Another option is to use a query re-director on the ValueReadQuery used by the platform:

ValueReadQuery vrq = new ValueReadQuery(
"SELECT to_char(sysdate, 'YYYY-MM-DD HH:MM:SS.SSSSS') FROM DUAL"
);
vrq.setRedirector(new TSQueryRedirector());
...
class TSQueryRedirector implements QueryRedirector
{
public Object invokeQuery(DatabaseQuery query, Record arguments, Session session)
{
String value = (String)session.executeQuery(query);
return ConversionManager.getDefaultManager().convertObject(
value, java.sql.Timestamp.class
);
}
}

9.1.1.6 Unit of Work does not add Deleted Objects to Change Set

When accessing the change set of a Unit of Work to determine what has changed, objects that are pending deletion (such as uow.deleteObject( ) and uow.deleteAllObjects( )) will not be returned from the result set.

The objects pending deletion are only available through the Unit of Work getDeletedObjects call.

9.1.2 TopLink Workbench Issues

This section contains information on the following issues:

- Section 9.1.2.1, "User Interface Issue"

- Section 9.1.2.2, "Accessibility"

- Section 9.1.2.3, "Running the TopLink Workbench on Windows OS"

9.1.2.1 User Interface Issue

When running TopLink Mapping Workbench using JDK 1.7, dialogs with a group box containing check boxes or radio buttons may display duplicated or truncated group box titles. There is no loss of functionality, and you should proceed as usual.

9.1.2.2 Accessibility

Due to an issue with Sun JDK 1.6, if NullPointExecption error dialog is generated when saving a file, the error dialog window is not in focus.

9.1.2.3 Running the TopLink Workbench on Windows OS

Due to an issue with certain configurations and versions of Windows operating systems, users that launch the TopLink Workbench with the workbench.cmd file may receive a dialog that states: Could not find the main class. This occurs because the classpath specified contains a directory path which has periods in it. The workaround is to rename the offending directory or change the classpath to use directory paths which do not contain periods.

9.1.3 Oracle Database Extensions with TopLink

This section contains information on the following issue:

- Section 9.1.3.1, "Template JAR for Spatial and XDB Support in Oracle WebLogic Server"

9.1.3.1 Template JAR for Spatial and XDB Support in Oracle WebLogic Server

To fully support Oracle Spatial and Oracle XDB mapping capabilities (in both standalone Oracle WebLogic Server and the Oracle JDeveloper integrated WebLogic Server), you must use the toplink-spatial-template.jar and toplink-xdb-template.jar to extend the WebLogic Server domain to support Oracle Spatial and XDB, respectively.

To extend your WebLogic Server domain:

1. Download the toplink-spatial-template.jar (to support Oracle Spatial) and toplink-xdb-template.jar (to support Oracle XDB) files from:

- http://download.oracle.com/otn/java/toplink/111110/toplink-spatial-template.jar

- http://download.oracle.com/otn/java/toplink/111110/toplink-xdb-template.jar

2. Use Table 9-1, "To Support Oracle Spatial" or Table 9-2, "To Support Oracle XDB" to determine which files to copy.

Table 9-1 To Support Oracle Spatial

Copy this file

From...Foot 1

To...Foot 2

sdoapi.jar

<ORACLE_DATABASE_HOME>/md/jlib

<WEBLOGIC_HOME>/server/lib

Footnote 1 These are the default locations. Your actual location may vary depending on your specific environment, installed options, and version.

Footnote 2 When using Oracle JDeveloper integrated WebLogic Server, the <WEBLOGIC_HOME> is located within the <JDEVELOPER_HOME> directory.

Table 9-2 To Support Oracle XDB

Copy this file

From...Foot 1

To...Foot 2

xdb.jar

<ORACLE_DATABASE_HOME>/rdbms/jlib

<WEBLOGIC_HOME>/server/lib

xml.jar

<ORACLE_DATABASE_HOME>/lib

<WEBLOGIC_HOME>/server/lib

xmlparserv2.jar

<ORACLE_DATABASE_HOME>/lib

<WEBLOGIC_HOME>/server/lib

ori18n-mapping.jarFoot 3

<ORACLE_DATABASE_HOME>/jlib

<WEBLOGIC_HOME>/server/lib

Footnote 1 These are the default locations. Your actual location may vary depending on your specific environment, installed options, and version.

Footnote 2 When using Oracle JDeveloper integrated WebLogic Server, the <WEBLOGIC_HOME> is located within the <JDEVELOPER_HOME> directory.

Footnote 3 Use orai18n-mapping.jar for Oracle Database 11.2 and higher.

Note:

Although the actual JAR file may be named differently in your From directory, the file must be named as shown, when copied to the To directory.

3. Launch the Config Wizard (<WEBLOGIC_HOME>/common/bin/config.sh (or .bat).

4. Select Extend an existing WebLogic domain.

5. Browse and select your WebLogic Server domain.
When using JDeveloper with integrated WebLogic Server, the typical WebLogic Server domain location may be similar to:

- In Windows environments: %APPDATA%\JDeveloper\systemXX.XX.XX.XX\DefaultDomain
where XX.XX.XX.XX is the unique number of the product build.

For Windows platforms, you must enable the Show hidden files and folders folder option.

- In non-Windows environments, the default location is under the current user's default home directory: <$Home>/DefaultDomain

Refer to the Oracle JDeveloper documentation for details.

6. Select Extend my domain using an existing extension template.

7. Browse and select the required template JAR (toplink-spatial-template.jar for Oracle Spatial, toplink-xdb-template.jar for Oracle XDB).

8. Complete the remaining pages of the wizard.

9.1.4 Allowing Zero Value Primary Keys

By default, EclipseLink interprets zero as null for primitive types that cannot be null (such as int and long) causing zero to be an invalid value for primary keys. You can modify this setting by using the allow-zero-id property in the persistence.xml file. Valid values are:

- true – EclipseLink interprets zero values as zero. This permits primary keys to use a value of zero.

- false (default) – EclipseLink interprets zero as null.

Refer the EclipseLink User's Guide at http://wiki.eclipse.org/EclipseLink/UserGuide for more information.

9.1.5 Managed Servers on Sybase with JCA Oracle Database Service

When using a JCA service with the Oracle Database adapter in a cluster to perform database operations on a Sybase database, the managed nodes in the cluster process the messages and may attempt to perform duplicate operations.

Because supported versions of Sybase do not support Oracle TopLink record locking, Sybase allows the duplicate operation attempts.

9.1.6 Logging Configuration with EclipseLink Using Container Managed JPA

By default, EclipseLink users in container managed JPA will use the Oracle WebLogic Server logging options to report all log messages generated by EclipseLink. Refer to "Configuring WebLogic Logging Services" in Oracle® Fusion Middleware Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.

To use the EclipseLink native logging configuration, add the following property to your persistence.xml file:

<property name="eclipselink.logging.logger" value="DefaultLogger"/>

9.1.7 Grid Cache requires CacheLoader

An oracle.eclipselink.coherence.integrated.EclipseLinkJPACacheLoader must be configured for entities configured as Grid Cache to ensure the necessary TopLink Grid wrapper class is generated.

Part III

Web Tier

Part III contains the following chapters:

- Chapter 10, "Oracle HTTP Server"

- Chapter 11, "Oracle Web Cache"

10 Oracle HTTP Server

This chapter describes issues associated with Oracle HTTP Server. It includes the following topic:

- Section 10.1, "Configuration Issues and Workarounds"

10.1 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topic:

- Section 10.1.1, "OHS Fails to Start When mod_perl is Enabled on Microsoft Windows x64 (64-Bit) 2008"

- Section 10.1.2, "Oracle HTTP Server Fails To Load mod_wls module on Windows 64-Bit Server Systems"

10.1.1 OHS Fails to Start When mod_perl is Enabled on Microsoft Windows x64 (64-Bit) 2008

In 11.1.1.5.0 release, Oracle HTTP Server (OHS) installation is successful with OHS start and stop working fine on Microsoft Windows x64 (64-Bit) 2008. But OHS fails to start when mod_perl is enabled by copying

%ORACLE_INSTANCE%\config\OHS\ohs1\disabled\mod_perl.conf

to

%ORACLE_INSTANCE%\config\OHS\ohs1\moduleconf

The console shows the following error:

Process (index=1,uid=2032669523,pid=6444) time out while waiting for a managed
process to start.

To work around this issue, perform the following steps:

1. Complete Oracle Fusion Middleware 11g R1 Patch Set 1 (11.1.1.2.0) and 11g R1 Patch Set 4 (11.1.1.5.0) installation.

2. Go to My Oracle Support:

https://support.oracle.com

3. Click the Patches & Updates tab.

4. Enter patch 12316692 in the Patch Name or Number field, under Patch Search.

5. Click Search.

6. Download and apply the patch by following the instructions in the README file included with the patch.

10.1.2 Oracle HTTP Server Fails To Load mod_wls module on Windows 64-Bit Server Systems

On x64 edition systems of Microsoft Windows Server 2003 R2 and Microsoft Windows Server 2008 R2, Oracle HTTP Server fails to load the mod_wl_ohs module if the MatchExpression property is provided within the IfModule weblogic_module block of the mod_wl_ohs.conf file.

To workaround this issue, comment out the MatchExpression property inside the IfModule weblogic_module block.

For example

<IfModule weblogic_module>
WebLogicHost <hostname>
WebLogicPort ....
Debug ON
WLLogFile .......
# MatchExpression *.*
</IfModule>

11 Oracle Web Cache

This chapter describes issues associated with Oracle Web Cache. It includes the following topics:

- Section 11.1, "Configuration Issues and Workarounds"

- Section 11.2, "Documentation Errata"

11.1 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 11.1.1, "Reset the Random Password Generated When Installing Oracle Portal, Forms, Reports, and Discoverer"

- Section 11.1.2, "Running Oracle Web Cache Processes as a Different User Is Not Supported"

11.1.1 Reset the Random Password Generated When Installing Oracle Portal, Forms, Reports, and Discoverer

For enhanced security, no default hard-coded passwords are used for managing Oracle Web Cache.

When you install the Oracle Web Tier installation type, the Oracle Universal Installer prompts you to choose a password. The Web Cache Administrator page of the Oracle Universal Installer prompts you to enter a password for the administrator account. The administrator account is the Oracle Web Cache administrator authorized to log in to Oracle Web Cache Manager and make configuration changes through that interface.

When you install Oracle Portal, Forms, Reports, and Discoverer, the prompt for the administrator password is missing. Instead, the Oracle Portal, Forms, Reports and Discoverer install type uses a random value chosen at install time.

Regardless of the installation type, before you begin configuration, change the passwords for these accounts to a secure password. If you are configuring a cache cluster, all members of the cluster must use the same password for the administrator account.

To change the password, use the Passwords page of Fusion Middleware Control, as described in "Configuring Password Security" in the Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache.

11.1.2 Running Oracle Web Cache Processes as a Different User Is Not Supported

Running Oracle Web Cache as a user other than the installed user through the use of the webcache_setuser.sh setidentity command is not supported.

Specifically, you cannot change the user ID with the following sequence:

1. Change the process identity of the Oracle Web Cache processes in the Process Identity page using Oracle Web Cache Manager (Properties > Process Identity).

2. Use the webcache_setuser.sh script as follows to change file and directory ownership:

webcache_setuser.sh setidentity user_ID

user_ID is the user you specified in the User ID field of the Process Identity page.

3. Restart Oracle Web Cache using opmnctl.
Oracle Web Cache will start and then immediately shut down.

In addition, messages similar to the following are displayed in the event log:

[2009-06-02T21:22:46+00:00] [webcache] [ERROR:1] [WXE-13212] [logging] [ecid: ]
Access log file /scratch/webtier/home/instances/instance1/diagnostics/logs/WebCache/webcache1/access_log could not be opened.
[2009-06-02T21:22:46+00:00] [webcache] [WARNING:1] [WXE-13310] [io] [ecid: ]
Problem opening file /scratch/webtier/home/instances/instance1/config/WebCache/webcache1/webcache.pid (Access Denied).
[2009-06-02T21:22:46+00:00] [webcache] [ERROR:1] [WXE-11985] [esi] [ecid: ]
Oracle Web Cache is unable to obtain the size of the default ESI fragment page
/scratch/webtier/home/instances/instance1/config/WebCache/webcache1/files/esi_fragment_error.txt.
[2009-06-02T21:22:46+00:00] [webcache] [WARNING:1] [WXE-11905] [security]
[ecid: ] SSL additional information: The system could not open the specified file.

For more information about the webcache_setuser.sh script, see "Running webcached with Root Privilege" in the Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache.

11.2 Documentation Errata

This section provides clarifications for errors in Oracle Web Cache documentation. It includes the following topics:

- Section 11.2.1, "Procedure to Enable Generation of Core Dump"

- Section 11.2.2, "Clarification About Support for CRLs"

- Section 11.2.3, "Clarifications About Configuring the CRL Location"

11.2.1 Procedure to Enable Generation of Core Dump

Information about enabling generation of core dump is not available in the Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache.

To enable generation of a core dump when Oracle Web Cache is shut down, add CORE="YES" to the TRACEDUMP element in the $INSTANCE_HOME/config/WebCache/webcache_name/webcache.xml file.

The updated TRACEDUMP element would look like the following:

<TRACEDUMP FILENAME=file_name CORE="YES"/>

The core dump file with the specified name is created in the $INSTANCE_HOME/config/WebCache/webcache_name directory.

11.2.2 Clarification About Support for CRLs

Section 5.1.1.2.2, "Certificate" of the Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache states the following:

"Although the Oracle HTTP Server supports OpenSSL certificate revocation lists, Oracle Web Cache does not."

This statement is incorrect. Oracle Web Cache does support CRLs.

11.2.3 Clarifications About Configuring the CRL Location

Section 5.5.3, "Configuring Certificate Revocation Lists (CRLs)" of the Oracle Fusion Middleware Administrator's Guide for Oracle Web Cache has the following incorrect statements:

- Incorrect statement: "Fusion Middleware Control or Oracle Web Cache Manager do not provide support for client certificate validation with Certificate Revocation Lists (CRLs). You can configure this support by manually editing the webcache.xml file."
Clarification: This statement is incorrect. You can enable and configure support for CRLs by using the Oracle Web Cache Manager, as follows:

1. Go to the Listen Ports page.

2. Select the HTTPS port for which you want to configure CRL settings, and click Edit Selected.
The Edit/Add Listen Port dialog box is displayed.

3. Select the Certificate Revocation List Enabled option.

4. In the CRL Path field, specify the fully qualified path to the directory in which the CRLs are stored. For example, /home/crl.

5. In the CRL File field, specify the fully qualified path and filename of the CRL file. For example, /home/oracle/crl/CA/crl.

- Incorrect statement: Step 4 of the procedure to configure certificate validation using CRLs: "Configure CRL file location by adding the SSLCRLPATH and SSLCRLFILE parameters to the HTTPS LISTEN directive."
Clarification: This statement is incorrect. You must add either SSLCRLPATH or SSLCRLFILE to the HTTPS LISTEN directive, not both.

Part IV

Oracle WebLogic Server

Part IV contains the following chapters:

- Chapter 12, "Oracle WebLogic Server"

12 Oracle WebLogic Server

This chapter describes issues associated with Oracle WebLogic Server. It includes the following topics:

- Section 12.1, "General Issues and Workarounds"

- Section 12.2, "Administration Console Issues and Workarounds"

- Section 12.3, "Apache Beehive Support Issues and Workarounds"

- Section 12.4, "Configuration Issues and Workarounds"

- Section 12.5, "Connector (Resource Adapter) Issues and Workarounds"

- Section 12.6, "Console Extensions Issues and Workarounds"

- Section 12.7, "Core Server and Core Work Manager Issues and Workarounds"

- Section 12.8, "Deployment Issues and Workarounds"

- Section 12.9, "EJB Issues and Workarounds"

- Section 12.10, "Examples Issues and Workarounds"

- Section 12.11, "HTTP Publish/Subscribe Server Issues and Workarounds"

- Section 12.12, "Installation Issues and Workarounds"

- Section 12.13, "Java EE Issues and Workarounds"

- Section 12.14, "JDBC Issues and Workarounds"

- Section 12.15, "JMS Issues and Workarounds"

- Section 12.16, "JNDI Issues and Workarounds"

- Section 12.17, "JSP and Servlet Issues and Workarounds"

- Section 12.18, "JTA Issues and Workarounds"

- Section 12.19, "Java Virtual Machine (JVM) Issues and Workarounds"

- Section 12.20, "Monitoring Issues and Workarounds"

- Section 12.21, "Node Manager Issues and Workarounds"

- Section 12.22, "Operations, Administration, and Management Issues and Workarounds"

- Section 12.23, "Oracle Kodo Issues and Workarounds"

- Section 12.24, "Plug-ins Issues and Workarounds"

- Section 12.25, "Protocols Issues and Workarounds"

- Section 12.26, "RMI-IIOP Issues and Workarounds"

- Section 12.27, "Security Issues and Workarounds"

- Section 12.28, "SNMP Issues and Workarounds"

- Section 12.29, "Spring Framework on WebLogic Server Issues and Workarounds"

- Section 12.30, "System Component Architecture (SCA) Issues and Workarounds"

- Section 12.31, "Upgrade Issues and Workarounds"

- Section 12.32, "Web Applications Issues and Workarounds"

- Section 12.33, "WebLogic Server Scripting Tool (WLST) Issues and Workarounds"

- Section 12.34, "Web Server Plug-Ins Issues and Workarounds"

- Section 12.35, "Web Services and XML Issues and Workarounds"

- Section 12.36, "WebLogic Tuxedo Connector Issues and Workarounds"

- Section 12.37, "Documentation Errata"

Note:

For a list of bugs that are fixed in WebLogic Server 11g Release 1 (10.3.6), enter the following document ID in the Search Knowledge Base field. You must enter the entire document ID.
1302753.1

12.1 General Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.1.1, "Multi-Byte Characters Display Incorrectly in Filenames When Using Safari"

- Section 12.1.2, "Oracle WebLogic Server Version Number"

- Section 12.1.3, "Oracle ojdbc14.jar File Has Been Changed to ojdbc6.jar"

- Section 12.1.4, "Strong Password Enforcement May Cause Issues With WLST Offline Scripts"

- Section 12.1.5, "In Turkish Locale, MDS Initialization Fails"

- Section 12.1.6, "Availability of Sun JDK 6 U24-B50 for 10.3.5.0 Oracle WLS Generic Installation"

12.1.1 Multi-Byte Characters Display Incorrectly in Filenames When Using Safari

When using the Safari browser to download content, if a filename contains multi-byte characters, the characters are displayed as '------' in the filename.

Workaround

Set UseHeaderEncoding to true on the Managed Server. Use the following WLST commands to do so:

connect("admin_name", "admin_password", "t3://localhost:port")
edit()
startEdit()
cd("Servers/server_name/WebServer/server_name")
set("UseHeaderEncoding", "true")
save()
activate()
exit()

12.1.2 Oracle WebLogic Server Version Number

Oracle Fusion Middleware 11g contains Oracle WebLogic Server 11g. The version number of Oracle WebLogic Server is 10.3.6.

12.1.3 Oracle ojdbc14.jar File Has Been Changed to ojdbc6.jar

The Oracle ojdbc14.jar file has been changed to ojdbc6.jar, for use with JDK 5 or 6. As a result, any explicit references you make to ojdbc14.jar must be changed to ojdbc6.jar.

12.1.4 Strong Password Enforcement May Cause Issues With WLST Offline Scripts

With the implementation of strong password enforcement (8 character minimum with one numeric or special character) in this release of WebLogic Server, existing scripts could potentially encounter issues.

Workaround

Use either of the following workarounds to bypass the new password restrictions.

- Set the BACKWARD_COMPAT_PW_CHECK environment variable to true.

- Include the -Dbackward.compat.pw.check=true option when invoking WLST.

Oracle recommends that you change passwords to comply with the new password requirements, as this variable and option will be removed in a future release of WebLogic Server.

12.1.5 In Turkish Locale, MDS Initialization Fails

Any applications that use an MDS repository cannot be deployed or run with the JAXB version bundled with WebLogic Server as null values are returned for attributes named id.

Workaround

Start the server in English locale.

12.1.6 Availability of Sun JDK 6 U24-B50 for 10.3.5.0 Oracle WLS Generic Installation

Sun JDK 1.6.0.24-b50 version is required for Oracle WebLogic Server 10.3.5.0 (PS4) generic installation on Linux x86-64, Microsoft Windows x64 (64-Bit), and Oracle Solaris platforms.

The mentioned version of JDK is not available for download from the Oracle Web site:

http://www.oracle.com/technetwork/indexes/downloads/index.html

Complete the following steps to download the required JDK version:

1. Go to My Oracle Support:

https://support.oracle.com

2. Click the Patches & Updates tab.

3. Enter patch 12346791 in the Patch Name or Number field, under Patch Search.

4. Click Search.

5. Select and download the patch for the required platform by following the instructions in the README file included with the patch.

12.2 Administration Console Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.2.1, "Cached JDBC Information is not Displayed"

- Section 12.2.2, "Pressing Browser Back Button Discards Context"

- Section 12.2.3, "Unsupported Work Manager Configurations Can Be Created"

- Section 12.2.4, "Server Status Table Reflects Inconsistent Information"

- Section 12.2.5, "Exceptions When Defining a Security Policy for an EJB"

- Section 12.2.6, "Administration Console Does Not Always Reflect External Changes Made in a Deployment Plan"

- Section 12.2.7, "Oracle OCI Driver Support"

- Section 12.2.8, "Data Takes a Long Time to Display on the Metric Browser Tab"

12.2.1 Cached JDBC Information is not Displayed

Information about cached JDBC statements is not displayed on the JDBC Monitoring pages.

12.2.2 Pressing Browser Back Button Discards Context

After a page flow completes in the Administration Console, it forwards to a different page, typically a table.

Pressing the browser Back button at this point results in an attempt to load the last JSP file in the completed assistant. At this point, all of the context for this assistant is discarded.

Workaround

Oracle recommends that you do not use the browser Back button to step back into an assistant once changes are cancelled or finished, and that you do not go back to a previous step in an assistant. Instead, use the navigation links and buttons in the Administration Console.

12.2.3 Unsupported Work Manager Configurations Can Be Created

The Administration Console permits the creation of Work Manager configurations that are not supported and do not function as intended. Incorrect Work Manager configurations may result in a number of exceptions being recorded in the server logs, most commonly 'Validation problems were found' exceptions while parsing deployment descriptors.

Workaround

Follow the guidelines described in the online help for Work Manager configurations. Specifically, you can only assign one request class to any given Work Manager, and that request class must be of the same or a broader scope than the Work Manager. You should not assign an application-scoped request class to a global Work Manager, and you should not create more than one application-scoped request class for an application-scoped Work Manager.

Correcting the Work Manager configurations to match the documented constraints resolves these issues.

12.2.4 Server Status Table Reflects Inconsistent Information

The Server Status table on the Cluster: Monitoring: Summary page includes two default columns: Primary and Secondary Distribution Names. These fields do not always reflect all of the replication statistics that are collected and displayed on the Cluster: Monitoring: Failover page, depending on the replication scenario.

Please refer to the Cluster: Monitoring: Failover page for definitive information.

12.2.5 Exceptions When Defining a Security Policy for an EJB

When defining security policies in the Administration Console for an EJB deployment that references types defined in a separate library deployment, exceptions can be observed if that library deployment is not available to the Console.

Workaround

All library deployments should be targeted at the WebLogic Server Administration Server as well as any Managed Servers needed to support referencing applications. This will ensure that when defining policies, the Console will have access to those library deployments so that referenced types can be class-loaded as needed.

12.2.6 Administration Console Does Not Always Reflect External Changes Made in a Deployment Plan

The Administration Console does not always reflect external changes made in a deployment plan. If a change is made in a deployment plan outside of the Console (for example, using Workshop, editing the plan text files directly, or updating a deployment with a new plan using WLST or webLogic.Deployer) while a Console user is also viewing that deployment plan, the Console user will not see those changes.

Workaround

Navigate to a configuration page for a different deployment, then navigate back to the original deployment again.

12.2.7 Oracle OCI Driver Support

The Oracle OCI driver is no longer explicitly listed as a preconfigured driver type in the Administration Console.

Workaround

The Oracle OCI driver remains a supported driver for application data connectivity, consistent with prior releases of Oracle WebLogic Server. However, users must now specify all required configuration properties manually, including the data base username.

12.2.8 Data Takes a Long Time to Display on the Metric Browser Tab

When using Internet Explorer 7 (IE 7) to display data on the Metric Browser tab of the Monitoring Dashboard, it takes an unusually long time for the data to display, and during this time, the page is unresponsive. The amount of time it takes to display data on this tab depends on the size of the domain.

Workaround

If you need to display data on the Monitoring Dashboard > Metric Browser tab, open the Administration Console in a supported web browser other than IE 7, such as Internet Explorer 8 or greater, Firefox 3 or greater, or Safari 4 or greater.

12.3 Apache Beehive Support Issues and Workarounds

There are no known Apache Beehive Support issues in this release of WebLogic Server.

12.4 Configuration Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.4.1, "ASProvWorkflowException Occurs When Creating a WebLogic Domain"

- Section 12.4.2, "Use the -Dfile.encoding Property When Running WLST in a Non-English Locale"

- Section 12.4.3, "Configuration Tools Can Fail If WebLogic Installation Path Contains Spaces"

12.4.1 ASProvWorkflowException Occurs When Creating a WebLogic Domain

In rare cases, if your installation environment contains existing JAVA_OPTIONS prior to starting a Fusion Middlware product installation, these may cause an ASProvWorkflowException, preventing the domain from being created.

Workaround

Prior to starting the Fusion Middleware product installation, clear the existing JAVA_OPTIONS. If you have an applicagtion in the environment that use these JAVA_OPTIONS, the applications may not work after clearing the options. In this case, save the existing JAVA_OPTIONS to a text file and investigate alternatives for running your other application.

12.4.2 Use the -Dfile.encoding Property When Running WLST in a Non-English Locale

WLST can be run with localized messages by setting the desired locale. You should be aware of the following issue when running WLST in a non-English locale.

On Windows operating systems, if a DOS command window's active code page is different from the system's local (ANSI) code page, you must add the -Dfile.encoding=<DOS window's active code page> property to the WLST process when starting WLST via a DOS command window. This changes the default character set for the Java process. For example:

- The active code page for a DOS window is 850. This can be achieved by issuing the chcp command in the WLST command window.

- The system's local (ANSI) code page is 1250. You can determine the system's local code page by viewing the value of the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\NLS\CodePage\ACP key in the Windows registry. Files that are created by standard Windows editing tools (such as Notepad or Wordpad) are encoded in this way.

In this situation, you can start WLST as follows:

set WLST_PROPERTIES="-Dfile.encoding=cp850"

$WL_HOME%\wlserver_10.3\common\bin\wlst.cmd

12.4.3 Configuration Tools Can Fail If WebLogic Installation Path Contains Spaces

On some Microsoft Windows platforms, the WebLogic configuration tool commands (including wlst, config, pack, and unpack) can fail if the WebLogic installation path contains a space. In this case, the command may fail with a java.lang.ClassNotFoundException, where the class is derived from the portion of the installation path after the space. The commands fail when short file name generation has been disabled in the Windows registry.

Workaround

You must enable short name generation in the Windows registry in order for spaces to be properly handled by the configuration tools. To enable short name generation:

1. Run regedit.

2. Navigate to the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem folder.

3. Double-click NtfsDisable8dot3NameCreation and set its value to 0.

4. Reboot for the change to take effect.

12.5 Connector (Resource Adapter) Issues and Workarounds

There are no known Connector (Resource Adapter) issues in this release of WebLogic Server.

12.6 Console Extensions Issues and Workarounds

There are no known Extensions issues in this release of WebLogic Server.

12.7 Core Server and Core Work Manager Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.7.1, "Threads Become Stuck While Waiting to Get a Connection"

- Section 12.7.2, "Using IPv6-Formatted Addresses"

- Section 12.7.3, "Server Cannot Be Started After a Whole Server Migration"

- Section 12.7.4, "Object State is not Retained After Renaming Field"

- Section 12.7.5, "Forcing Unicast Messages To Be Processed in Order"

- Section 12.7.6, "Servers Configured to Listen on a Host Name Are Listening on a Different Host Name After Startup"

12.7.1 Threads Become Stuck While Waiting to Get a Connection

When a machine that is hosting one of the Managed Servers is abruptly shut down, a network cable is pulled, or its network interface card has issues, and any server attempts communication with that managed server, threads become stuck waiting to get a connection.

Workaround

This can currently be resolved by using a private flag:

-Dweblogic.client.SocketConnectTimeoutInSecs

and setting an appropriate timeout value that will release the thread attempting to make the connection and allow the request to fail quickly.

12.7.2 Using IPv6-Formatted Addresses

When using an IPv6-formatted address for WebLogic Server, the URL should include square brackets ('[' and ']') for the host address. Otherwise, WLST may fail to connect to the running server.

Workaround

Add square brackets to the host address. For example:

t3://[fe80:0:0:0:203:baff:fe2f:59e5]:9991

12.7.3 Server Cannot Be Started After a Whole Server Migration

If the WebLogic Server Administration Server is down when a Whole Server Migration occurs for a clustered server, and the server migrates to a machine on which it was never run before, the server cannot be started on the new machine.

Workaround

Use one of the following workarounds for this issue:

- Ensure that the Administration Server is up when the server migration is being performed.

- Use a shared disk/NFS for all the migratable servers in the cluster.

12.7.4 Object State is not Retained After Renaming Field

When FastSwap is enabled in a J2EE application, you can make certain types of changes to Java classes during development and expect to see the change without re-deploying, with all instance states of the Java object being retained.

One type of change that does NOT retain the object state is that when a field name is changed, it is treated as follows:

- the field with old name is deleted

- the field with new name is added

Thus, in this case, any state in the old field is not carried over to the renamed field.

Using the Workshop or FastSwap ant task, you may see a FastSwap operation completed successfully message, even when an instance field name change causes a value reset.

Workaround

You should expect an instance value to be reset when you change a field name.

12.7.5 Forcing Unicast Messages To Be Processed in Order

The following conditions can cause very frequent JNDI updates, and as a result, JMS subscribers may encounter a java.naming.NameNotFoundException:

1. Unicast messaging is being used for cluster communication.

2. The JMS topic connection is set with setReconnectPolicy("all").

3. JMS durable subscribers on topic are created and removed very frequently.

Workaround

To fix this issue, a new property, MessageOrderingEnabled, has been added to the ClusterMBean. This property forces unicast messages to be processed in strict order. By default, this property is not enabled. To enable the property, add the following line manually to the <cluster> element in config.xml.

<message-ordering-enabled>true</message-ordering-enabled>

12.7.6 Servers Configured to Listen on a Host Name Are Listening on a Different Host Name After Startup

When using a host name to specify configuring the listen address on the WebLogic Server Administration Server or a Managed Server, machines that are configured with multiple Ethernet cards may listen on a different host name after startup. For example:

- The machine has 3 Ethernet cards

- Card 1 is mapped to hostname1-s (DNS registered host name)

- Card 2 is mapped to hostname1-i (DNS registered host name)

- Card 3 is mapped to hostname1 (actual node's host name)

- You configure the server to listen on hostname1

- After starting the server, it is listening on hostname1-s because Windows resolves the actual node's host name to the first enabled Ethernet card address

Workaround

Use one of the following three workarounds for this issue:

1. Use the IP address, instead of the host name, as the listen address of the WebLogic Server Administration Server. On Managed Servers, use the IP address as the listen address, or configure the actual physical host name to the first Ethernet card in the machine.

2. Add the following entry to the C:\Windows\system32\drivers\etc\hosts file on the machine:
<ip_address> <hostname>

3. Change the order of the network cards in the machine so that the card with the actual node's host name is Card 1.

12.8 Deployment Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.8.1, "security-permission Element is not Available in weblogic-application.xml"

- Section 12.8.2, "Extraneous String Values Interpreted as File Specification"

- Section 12.8.3, "java.lang.NoClassDefFoundError is Displayed"

- Section 12.8.4, "The restore Method Does Not Update the DConfig Bean With Plan Overrides"

- Section 12.8.5, "config-root <directory> not found Warning Is Displayed When Applying a Plan"

- Section 12.8.6, "Deployment Task Fails When a Large Application File Is Deployed"

12.8.1 security-permission Element is not Available in weblogic-application.xml

The security-permission element is available in the weblogic.xml and weblogic-ejb-jar.xml deployment descriptors, but is not available in the weblogic-application.xml descriptor. Therefore, in an Enterprise application, you can only apply security policies to JAR files that are EJBs or Web applications.

12.8.2 Extraneous String Values Interpreted as File Specification

The weblogic.Deployer tool interprets any extraneous string values between command-line arguments as a file specification. For example, if you enter the command:

java weblogic.Deployer -activate -nostage true -name myname -source c:\myapp\mymodule

the tool attempts to activate a file specification named true, because the -nostage option takes no arguments and true is an extraneous string value.

12.8.3 java.lang.NoClassDefFoundError is Displayed

While using the WebLogic Server Administration Console with applications or EJBs deployed on a Managed Server that depend on a deployed library, you may encounter a java.lang.NoClassDefFoundError.

Workaround

The WebLogic Server Administration Console needs access to any shared library deployments so that Java data types and annotations can be processed. Therefore, all shared library deployments should always be targeted to the WebLogic Server Administration Server in addition to any Managed Servers or clusters.

12.8.4 The restore Method Does Not Update the DConfig Bean With Plan Overrides

The restore method does not correctly update the DConfig Bean with the plan overrides. For example, given the following steps:

DeployableObject dObject =
WebLogicDeployableObject.createDeployableObject(new File(appName));
DeploymentConfiguration dConfig =
WebLogicDeploymentManager.createConfiguration(dObject);
dConfig.restore(new FileInputStream(new File(plan)));

the plan does not correctly override the DConfig Bean.

Workaround

Specify the plan when initializing the configuration for the application. For example:

helper = SessionHelper.getInstance(
SessionHelper.getDisconnectedDeploymentManager());
helper.setApplication(app);
helper.setPlan(new File(plan));
helper.initializeConfiguration();

12.8.5 config-root <directory> not found Warning Is Displayed When Applying a Plan

If you use the Administration Console to make configuration changes to an application, a deployment plan will be generated. If external descriptors are generated as part of the deployment plan, they are placed in the config root plan directory. This directory will be set in the deployment plan 'config-root' attribute.

If no external descriptors are required, the config root directory will not be created, and a warning is displayed when you apply the deployment plan. This results in the following warning in the server output:

<Warning <WWebLogicDescriptorWL> <BEA-2156000><"config-root" C:\deployments\plan was not found>.

Workaround

Create the plan directory manually.

12.8.6 Deployment Task Fails When a Large Application File Is Deployed

When a large application file is deployed using the upload option, the deployment task fails with the following error:

java.lang.OutOfMemoryError: Java heap space

To resolve this issue, a new system property, weblogic.deploy.UploadLargeFile, has been added. If you see this issue, include this flag in the java command you use to launch a deployment client.

If you are using the WebLogic Server patch releases 9.2 MP2, 9.2 MP3,10.0 MP1, 10.0 M2, 10.3, 10.3.1, 10.3.2, 10.3.3, or 10.3.4 this flag is not needed.

12.9 EJB Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.9.1, "Primary Key in Oracle Table is CHAR"

- Section 12.9.2, "No Available Annotation That Enables Creation of a Clusterable Timer"

- Section 12.9.3, "Kodo's MappingTool Cannot Generate Schemas"

- Section 12.9.4, "Extensions to the JPA Metadata Model Can Only Be Specified Via Annotations"

- Section 12.9.5, "Lookup Method Injection Not Supported by Spring"

- Section 12.9.6, "Deserializing a JDO PersistenceManagerFactory in a Managed Environment May Fail"

- Section 12.9.7, "Indexes Not Always Created During Schema Creation"

- Section 12.9.8, "OpenJPA throws an exception when @Id fields are also annotated as @Unique"

- Section 12.9.9, "Cache Hit and Miss Counts May Rise Unexpectedly"

- Section 12.9.10, "Open JPA Tries to Create a Table Even if the Table Exists"

- Section 12.9.11, "EJB Applications Fail During Serialization"

- Section 12.9.12, "Non-Transactional Message-Driven Bean Container Can Fail to Provide Reproducible Behavior For Foreign Topics"

12.9.1 Primary Key in Oracle Table is CHAR

The primary key in an Oracle table is a CHAR but the query field in the SQL table is a VARCHAR2.

Workaround

Change the database schema from CHAR to VARCHAR2. Using CHAR as a primary key is not recommended for the Oracle database.

12.9.2 No Available Annotation That Enables Creation of a Clusterable Timer

There is no annotation for EJB3 beans or Ejbgen that enables creation of a clusterable timer.

Workaround

Create a weblogic-ejb-jar.xml file and put the <timer-implementation> element and corresponding values into the file.

12.9.3 Kodo's MappingTool Cannot Generate Schemas

Kodo's MappingTool cannot generate schemas for classes that use BLOBs in their primary key. BLOBs can be used in a primary key, but the schema must be defined manually. Note that support for BLOB columns in primary keys is not mandated by either the JDO or JPA specifications.

12.9.4 Extensions to the JPA Metadata Model Can Only Be Specified Via Annotations

Extensions to the JPA metadata model can only be specified via annotations, and not via a structure similar to the orm.xml file defined by the specification.

Workaround

To specify Kodo-specific metadata for your object model, either:

- use the Kodo-specific annotations, or

- convert your XML-based metadata to the JDO metadata format, which does support XML specification of extensions.

12.9.5 Lookup Method Injection Not Supported by Spring

The Weblogic Spring injection extension model doesn't support lookup method injection.

12.9.6 Deserializing a JDO PersistenceManagerFactory in a Managed Environment May Fail

Deserializing a JDO PersistenceManagerFactory in a managed environment may fail. The exception states that the javax.jdo.PersistenceManagerFactoryClass property is missing. Note that serializing a PersistenceManagerFactory should not generally be necessary in a managed environment.

12.9.7 Indexes Not Always Created During Schema Creation

Indexes declared at the class level are not always created during schema creation.

Workaround

Create the indexes manually after running the schema generation tools.

12.9.8 OpenJPA throws an exception when @Id fields are also annotated as @Unique

OpenJPA throws an exception when @Id fields are also annotated as @Unique in some databases. Database primary keys are unique by definition. Some databases implement this by creating a unique index on the column.

Workaround

Do not specify both @Id and @Unique on a single field.

12.9.9 Cache Hit and Miss Counts May Rise Unexpectedly

The cache hit and miss counts may rise unexpectedly when manipulating entities without version data. The extra cache access occurs when the EntityManager closes and all contained entities are detached. Entities without version fields appear to the system to be missing their version data, and the system responds by checking their version in the cache before detachment.

Workaround

Entities with version fields or other version strategies do not cause extra cache access.

12.9.10 Open JPA Tries to Create a Table Even if the Table Exists

When using the MySQL database, and OpenJPA is configured to automatically run the mapping tool at runtime and create tables within the default schema (for example):

<property name='openjpa.jdbc.SynchronizeMappings' value='buildSchema'/>
<property name='openjpa.jdbc.Schema' value='MySQL database name' />

OpenJPA will try to create the table even if the table already exists in the database. A PersistenceException will be thrown to indicate that the table already exists and the table creation statement fails.

Workaround

To avoid this problem, if you are using the MySQL database, don't configure OpenJPA to automatically run the mapping tool at runtime and specify the default schema at the same time.

12.9.11 EJB Applications Fail During Serialization

EJB applications that use IIOP and send JPA entities from the server to the client will fail during deserialization if the entities are Serializable (but not Externalizable) and do not declare a writeObject() method.

Workaround

Add a writeObject() method to such entity classes. The write object can be trivial:

private void
writeObject(java.io.ObjectOutputStream out)
throws IOException {
out.defaultWriteObject();
}

12.9.12 Non-Transactional Message-Driven Bean Container Can Fail to Provide Reproducible Behavior For Foreign Topics

When using multi-threaded processing for non-transactional topic Message-Driven Beans (MDBs) that specify a foreign topic (non-WebLogic) JMS, the MDB container can fail to provide reproducible behavior. For example, if a runtimeException is thrown in the onmessage() method, the container may still acknowledge the message.

Workaround

Set the max-beans-in-free-pool attribute to 1 in the deployment descriptor.

12.10 Examples Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.10.1, "Security Configuration in medrec.wls.config"

- Section 12.10.2, "HTML File not Created for StreamParser.java File"

- Section 12.10.3, "Warning Message Appears When Starting Medrec or Samples Domain"

12.10.1 Security Configuration in medrec.wls.config

The medrec.wls.config target in SAMPLES_HOME/server/medrec/setup/build.xml has a known issue with respect to security configuration.

12.10.2 HTML File not Created for StreamParser.java File

The ../xml/stax example contains two files with the same root but different extensions: StreamParser.java and StreamParser.jsp. The samples viewer build, however, creates just one corresponding HTML file, rather than two for each type of file. In this case only the StreamParser.jsp file has an equivalent HTML file; the StreamParser.java file does not.

The problem occurs because of a setting in the build.xml file that controls the behavior of java2html to generate the files for the documentation.

When using java2html, the useShortFileName="true" parameter crops off the file extensions for the source files to create the file names for the HTML output files. If two files have the same name and different file extensions, whichever HTML file is generated last will overwrite previous ones.

Workaround

Set the useShortFileName parameter to "false". This setting generates HTML files with the file extensions included in the name. The drawback to this solution is that every link that points to the HTML output file needs to be revised, regardless of whether the files in question were affected by the bug.

12.10.3 Warning Message Appears When Starting Medrec or Samples Domain

When you start the medrec or samples domains, you may see a warning message similar to this:

<Warning> <WorkManager> <BEA-002919> <Unable to find a WorkManager with name
weblogic.wsee.mdb.DispatchPolicy. Dispatch policy
weblogic.wsee.mdb.DispatchPolicy will map to the default WorkManager for the
application bea_wls_async_response>

This warning message appears in the standard output of the Console while starting a WebLogic Server sample application with an asynchronous Web Service deployed.

Workaround

The warning is harmless and can be ignored.

12.11 HTTP Publish/Subscribe Server Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.11.1, "Authentication and Authorization of the Local Client is not Supported"

- Section 12.11.2, "Event Messages Published by Local Clients Cannot Be Received"

- Section 12.11.3, "Event Messages Published By Local Clients Do Not Go Through Filters"

12.11.1 Authentication and Authorization of the Local Client is not Supported

The HTTP Publish/Subscribe server does not support authentication and authorization of the local client. The local client has full permissions to operate on channels of the HTTP Publish/Subscribe server, which means the local client can create/delete channels and publish/subscribe events from channels.

12.11.2 Event Messages Published by Local Clients Cannot Be Received

In a clustering environment, event messages published by a local client on a server can be received only by subscribed clients connected to the same server. These messages cannot be received by subscribed clients connected to other servers in the cluster.

12.11.3 Event Messages Published By Local Clients Do Not Go Through Filters

Event messages published to a channel by a local client will not go through the Message Filters configured to that channel.

12.12 Installation Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.12.1, "Sybase JDBC Drivers Not Downloaded with Upgrade Installation"

- Section 12.12.2, "Improper Rollback to Previous Installation May Occur After Exiting an Upgrade Installation Prematurely"

- Section 12.12.3, "WebLogic Server Installer Fails With Insufficient Disk Space Error"

- Section 12.12.4, "WebLogic Server Home Cannot Be the Same as the Middleware Home"

- Section 12.12.5, "WebLogic Server Installation Fails When Installed Using Network Drive"

12.12.1 Sybase JDBC Drivers Not Downloaded with Upgrade Installation

The Oracle WebLogic Server 11g Release 1 installer does not download the Sybase JDBC drivers. When you try to upgrade an existing WebLogic Server 10.3 installation using the latest installer, it does not remove the Sybase JAR files from the original installation. The installer upgrades only the weblogic.jar file.

The Sybase JAR files (jconn2.jar, jconn3.jar, and jConnect.jar) in the /server/lib or /server/ext/jdbc/sybase directories are removed from the manifest classpath in the upgraded weblogic.jar file. Therefore, if the classpath of a WebLogic Server application does not include Sybase JAR files and only includes weblogic.jar then after the upgrade installation, the application will throw a ClassNotFoundException.

To work around this issue, explicitly add Sybase JAR files in the WebLogic Server application classpath.

12.12.2 Improper Rollback to Previous Installation May Occur After Exiting an Upgrade Installation Prematurely

When using an Upgrade installer or Smart Update to upgrade an existing WebLogic Server 10.3.x installation to WebLogic Server 10.3.4, if you abort the upgrade before completion, the installation should automatically roll back to the prior installation. This may not always occur, resulting in an unusable installation.

12.12.3 WebLogic Server Installer Fails With Insufficient Disk Space Error

The WebLogic Server installer can fail with an insufficient disk space error, even when there is a large amount of available disk space on the file system or disk.

Workaround

Use the -Dspace.detection property in the installation command to disable the available space check. For example:

java -Xmx1024M -Dspace.detection=false -jar installer_file_name -mode=silent -silent_xml=silent.xml

or

wls1034_linux.bin -Dspace.detection=false

12.12.4 WebLogic Server Home Cannot Be the Same as the Middleware Home

You cannot use the Middleware home directory as the WebLogic Server home directory. For example, if the Middleware home directory is C:\Oracle\Middleware, you cannot specify C:\Oracle\Middleware as the home directory for WebLogic Server. Doing so has the potential to cause serious issues with the Configuration Wizard, Template Builder, and possibly other WebLogic Server tools.

Workaround

Install WebLogic Server in a directory other than the Middleware home directory. For example, if the Middleware home directory is C:\Oracle\Middleware, it is permissible to install WebLogic Server in C:\Oracle\Middleware\wlserver or C:\Oracle\wlserver.

12.12.5 WebLogic Server Installation Fails When Installed Using Network Drive

The installation of WebLogic Server would fail when the installer is accessed from another machine in the network throwing an error message:

com.bea.plateng.wizard.installer.utils.SelfExtract - Error accessing jar

Workaround

Perform either of the following:

1. Map the installer location that is present in the network machine to the local machine drive and then install.
Steps to map the drive are:

1. Right click on My Computer and select the Map Network Drive option.

2. Select a drive and browse and select the Network path of the machine where the installer is present.

3. Click on Finish.

Then the installation could be done using the command java -XX:MaxPermSize=1024m -jar Y:\wls1031_generic.jar where Y: is the local mapped drive.

2. Copy the WLS installer from the network drive to the local machine folder and point it to the location while installing.
For example:

java -XX:MaxPermSize=1024m -jar c:\Installer\wls1031_generic.jar

12.13 Java EE Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.13.1, "FastSwap May Relax the Access Modifiers of Fields and Methods"

- Section 12.13.2, "FastSwap Does Not Support Redefinition of the Entity Bean and ejbClass"

- Section 12.13.3, "Classpath Order Is Not Guaranteed When There Are Multiple JARs in an EAR File"

12.13.1 FastSwap May Relax the Access Modifiers of Fields and Methods

FastSwap may relax the access modifiers of fields and methods. Private and protected members may be made public at runtime. This changes the behavior of reflection and may affect reflection-based frameworks such as Struts.

12.13.2 FastSwap Does Not Support Redefinition of the Entity Bean and ejbClass

FastSwap does not support redefinition of the Entity bean and ejbClass (Session/MDB). Therefore, any updates to entity classes will cause redefinition errors.

Workaround

After updating an entity class, redeploy the application.

12.13.3 Classpath Order Is Not Guaranteed When There Are Multiple JARs in an EAR File

When you have an EAR file containing separate JAR files, and two or more of those JAR files have a class with the same name, it is not possible to predict from which of those JAR files WebLogic Server will instantiate the class. This is not an issue if the classes are the same, but if they are different implementations, the results are unpredictable.

Workaround

Currently there is no known workaround for this issue.

12.14 JDBC Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.14.1, "Call To setTransactionIsolation() May Fail When Using the JDBC Driver for MS SQLServer"

- Section 12.14.2, "An Attempt to Access a Remote 10.3.2 or Later WLS Data Source Fails"

12.14.1 Call To setTransactionIsolation() May Fail When Using the JDBC Driver for MS SQLServer

When using the JDBC driver for MS SQLServer, a call to setTransactionIsolation() may fail in a transactional context if getTransactionIsolation() is called first.

12.14.2 An Attempt to Access a Remote 10.3.2 or Later WLS Data Source Fails

A new system property, -Dweblogic.jdbc.remoteEnabled, has been added to JDBC in Oracle WebLogic Server 10.3.2. For compatibility with prior releases of WebLogic Server, the default setting of this property is true. When this property is set to false, remote JDBC access is turned off, and such access results in an exception.

Remote access may occur explicitly in an application, or implicitly during a global (XA/JTA) transaction with a participating non-XA data source that is configured with the LLR, 1PC or Emulate XA global transaction option. The following enumerates the cases when an exception will be thrown, and work-arounds for each case (if any).

An exception occurs in the following cases. A workaround (if any) for a given case is provided.

- When a stand-alone client application uses any type of data source.

- When an application that is hosted on WebLogic Server uses any type of data source, and the data source is not configured (targeted) locally. A potential workaround is to target the data source locally.

- When accessing a same named non-XA data source with a transaction option of LLR, 1PC or Emulate XA on multiple WebLogic Server instances in the same global transaction. In this case, there are two potential work-arounds:

- Change data sources to use XA instead (this may lower performance), or

- For the 1PC/emulateXA types, change the application to ensure the data source is accessed from a single server.

- When accessing a non-XA data source with the LLR transaction option on a server that is different than the transaction coordinator. For server-initiated transactions, the coordinator location is chosen based on the first participating resource in the transaction. In this case, there are two potential work-arounds: (a) change the data source to use XA instead (this may lower performance); or (b) change the application to ensure data source access on the transaction coordinator, as described in "Optimizing Performance with LLR" in Oracle Fusion Middleware Programming JTA for OracleWebLogic Server. The latter may not be possible in some cases; for example, when an MDB application receives messages from a remote WebLogic JMS server, the transaction coordinator will always be the WebLogic server that's hosting the JMS server, but it may not be possible to move the MDB application to the same WebLogic server.

- Change the data source to use XA instead (this may lower performance), or

- Change the application to ensure data source access on the transaction coordinator, as described in "Optimizing Performance with LLR" in Oracle Fusion Middleware Programming JTA for Oracle WebLogic Server. This workaround may not be possible in some cases. For example, when an MDB application receives messages from a remote WebLogic JMS server, the transaction coordinator will always be the WebLogic Server instance that is hosting the JMS server, but it may not be possible to move the MDB application to the same WebLogic Server instance.

12.15 JMS Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.15.1, "Deployment Descriptor Validation Fails"

- Section 12.15.2, "Exception When Multiple Producers Use the Same Client SAF Instance"

- Section 12.15.3, "Multi-byte Characters are not Supported in Store File and Directory Names"

- Section 12.15.4, "Generation of the Default UOO Name Has Changed"

- Section 12.15.5, "Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS"

- Section 12.15.6, "JMS Message Consumers Will Not Always Reconnect After a Service Migration"

- Section 12.15.7, "Forcing Unicast Messages To Be Processed in Order"

12.15.1 Deployment Descriptor Validation Fails

Deployment descriptor validation fails when descriptor validation is enabled, and an EAR file contains only JMS modules.

Workaround

Make sure that there is at least one J2EE specification-compliant module in the EAR.

12.15.2 Exception When Multiple Producers Use the Same Client SAF Instance

When multiple JMS producers use the same JMS Client SAF instance (within a single JVM), depending on the timing of the JMS SAF client creation, you might receive the following exception:

Error getting GXA resource [Root exception is weblogic.jms.common.JMSException:
weblogic.messaging.kernel.KernelException: Error getting GXA resource]

Workaround

When using multiple JMS SAF client producers, try introducing a small delay between the creation of each new client.

12.15.3 Multi-byte Characters are not Supported in Store File and Directory Names

There is no support for multi-byte characters in WebLogic Store file and directory names. For instance, when the WebLogic Server name has multi-byte characters, the default store cannot be created, and WebLogic Server will not boot.

Workaround

Create WebLogic Server instances without multi-byte characters in the path name and use that path name for the default store configuration. Do not use multi-byte characters in the Weblogic Server name.

12.15.4 Generation of the Default UOO Name Has Changed

WebLogic Server 10.3.4 contains a fix for configurations that set a default unit-of-order (UOO) on a JMS regular destination, distributed destination, or template. This fix ensures that the default unit-of-order name stays the same even after a restart of the destination's host JMS server. The default UOO name is now based on the domain, JMS server, and destination names.

12.15.5 Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS

Oracle strongly recommends verifying the behavior of a server restart after abrupt machine failures when the JMS messages and transaction logs are stored on an NFS mounted directory. Depending on the NFS implementation, different issues can arise post failover/restart. For more information, see Section 6.3, "Testing Abrupt Failures of WebLogic Server When Using File Stores on NFS."

12.15.6 JMS Message Consumers Will Not Always Reconnect After a Service Migration

JMS message consumers will not always reconnect after a service migration when an application's WLConnection.getReconnectPolicy() attribute is set to all. If the consumers do not get migrated, either an exception is thrown or onException will occur to inform the application that the consumer is no longer valid.

Workaround

The application can refresh the consumer either in the exception handler or through onException.

12.15.7 Forcing Unicast Messages To Be Processed in Order

Certain conditions can cause very frequent JNDI updates, and as a result, JMS subscribers may encounter a java.naming.NameNotFoundException. For more information, see Section 12.7.5, "Forcing Unicast Messages To Be Processed in Order."

12.16 JNDI Issues and Workarounds

There are no known JNDI issues in this release of WebLogic Server.

12.17 JSP and Servlet Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.17.1, "Deployment Plans Cannot Be Used To Override Two Descriptors"

- Section 12.17.2, "Spring Dependency Injection Not Supported on JSP Tag Handlers"

- Section 12.17.3, "503 Error When Accessing an Application With a Valid sessionid"

12.17.1 Deployment Plans Cannot Be Used To Override Two Descriptors

Deployment plans cannot be used to override the following two descriptors during deployment of a Web application or a Web module: WEB-INF/classes/META-INF/persistence.xml and WEB-INF/classes/META-INF/persistence-configuration.xml. Deployment plans can otherwise be used to override any descriptor.

Workaround

Package WEB-INF/classes/META-INF/persistence.xml and WEB-INF/classes/META-INF/persistence-configuration.xml (if present) along with related class files into a JAR file. The JAR file must then be placed in the WEB-INF/lib directory of the Web application or Web module. A deployment plan can be used to override the two descriptors in such a JAR file.

12.17.2 Spring Dependency Injection Not Supported on JSP Tag Handlers

With the Spring extension model enabled, WebLogic Server 10.3 or later does not support Spring Dependency Injection (DI) on JSP tag handlers for performance reasons.

Currently, WebLogic Server supports Spring DI on most Web components, for example, servlets, filters and listeners. Spring DI is not, however, presently supported on JSP tag handlers for performance reasons.

12.17.3 503 Error When Accessing an Application With a Valid sessionid

When a session is persistent and an older version of a servlet context is retired, accessing the application with a valid sessionid will cause a 503 error.

For example, the session-persistent type of a versioned Web application is 'file'. A user can access the application successfully. Later, version 2 of the application is redeployed and version 1 is retired. If the same user accesses the application, they will get a 503 error.

12.18 JTA Issues and Workarounds

There are no known JTA issues in this release of WebLogic Server.

12.19 Java Virtual Machine (JVM) Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.19.1, "1.4 Thin Client Applet Cannot Contact WebLogic Server"

- Section 12.19.2, "JRockit JVM Appears to Freeze When Doing Long Array Copies"

12.19.1 1.4 Thin Client Applet Cannot Contact WebLogic Server

Due to a known Sun Microsystems VM bug (513552), a 1.4 Thin Client Applet cannot contact WebLogic Server 9.0 or later. This is because the VM does not distinguish correctly between a client and a server connection. The VM creates a server-type connection and caches it. It then attempts to make a client-type connection, finds the cached connection and tries to use that, but then encounters an error because clients are not allowed to use server connections.

12.19.2 JRockit JVM Appears to Freeze When Doing Long Array Copies

The JRockit JVM appears to freeze when doing long array copies as part of unlimited forward rolling. This can happen when multiple server reboots occur due to Out Of Memory conditions.

Workaround

When booting the servers, include the following JRockit JVM flag:

-XXrollforwardretrylimit:-1

export IBM_JAVA_OPTIONS="-Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"

12.20 Monitoring Issues and Workarounds

This section describes the following issue and workaround:

- Section 12.20.1, "MBean Attributes Not Explicitly Marked as @unharvestable Appear as Harvestable"

- Section 12.20.2, "Events Generated By the JVM Level Are Not Generated at Low Volume"

- Section 12.20.3, "WLDF Performance Issues Can Occur When JVM Events Are Enabled"

12.20.1 MBean Attributes Not Explicitly Marked as @unharvestable Appear as Harvestable

The @unharvestable tag is not being honored at the interface level. If MBean attributes are not explicitly marked as @unharvestable, they are considered to be harvestable and will appear as harvestable in the WebLogic Administration Console.

Workaround

You can explicitly mark MBean attributes as @unharvestable.

12.20.2 Events Generated By the JVM Level Are Not Generated at Low Volume

In WebLogic Server 10.3.3, the default WLDF diagnostic volume setting was Off. As of WebLogic Server 10.3.4, the default diagnostic volume setting is Low Volume, and events generated by the JVM level are not being generated at the Low Volume setting in WebLogic Server 10.3.4 (JVM-level events were generated at the Low Volume setting in WebLogic Server 10.3.3). The JVM-level events are still generated at the High Volume and Medium Volume settings in WebLogic Server 10.3.4.

Workaround

Use one of the following workarounds to cause the JVM-level events to be generated:

- Increase the WLDF diagnostic volume to the Medium or High level.

- Use JRMC, JRCMD, or the JRockit command line settings to activate a separate flight recording in the WebLogic Server instance. By doing so, JVM will cause JVM events to be present at all WLDF diagnostic volume settings (Off, Low, Medium, and High).

12.20.3 WLDF Performance Issues Can Occur When JVM Events Are Enabled

When JVM events are enabled, WLDF performances issues may occur in the following situations:

- If there are no other JRockit flight recordings enabled, performance can degrade when the WLDF diagnostic volume is set to Medium or High level.

- If other JRockit flight recordings are enabled, performance can degrade at all WLDF diagnostic volume levels (Off, Low, Medium, and High).

12.21 Node Manager Issues and Workarounds

There are no known Node Manager issues in this release of WebLogic Server.

12.22 Operations, Administration, and Management Issues and Workarounds

There are no known Operations, Administration, and Management issues in this release of WebLogic Server.

12.23 Oracle Kodo Issues and Workarounds

This section describes the following Oracle Kodo issue and workaround:

- Section 12.23.1, "Value Retrieved for an Empty Byte Array Field is NULL"

12.23.1 Value Retrieved for an Empty Byte Array Field is NULL

When trying to persist an empty byte array field within an entity to a Sybase or Oracle database, the value gets stored as a NULL rather than as bytes. As a result, when retrieving the value, NULL is returned.

This is a limitation of the Sybase and Oracle drivers, which convert the empty byte array to a NULL while storing it in the database. The issue happens with Weblogic JDBC drivers as well as the proprietary Sybase and Oracle drivers.

12.24 Plug-ins Issues and Workarounds

This section describes the following issues for various WebLogic Server plug-ins:

- Section 12.24.1, "apr_socket_connection Exception Occurs When Using the IIS Plug-In"

12.24.1 apr_socket_connection Exception Occurs When Using the IIS Plug-In

Under the following circumstances, the IIS plug-in may not work, resulting in an apr_socket_connection error:

1. Both the IIS and Weblogic Server instances are on the same machine.

2. IPv6 is enabled on the machine, but the machine is not in an IPv6 environment (that is, the IPv6 interface is enabled but is not working).

3. The listen address of the WebLogic Server instance is set to the simple host name.

4. Either the directive WebLogicHost or WebLogicCluster is set to the simple host name for the IIS instance.

12.25 Protocols Issues and Workarounds

There are no known Protocols issues in this release of WebLogic Server.

12.26 RMI-IIOP Issues and Workarounds

This section describes the following issue and workaround:

- Section 12.26.1, "Ant 1.7 rmic Task Incompatibility"

12.26.1 Ant 1.7 rmic Task Incompatibility

Calls to the Ant version 1.7 rmic task automatically add a -vcompat flag, which is not compatible with rmic for Oracle WebLogic Server.

Workaround

Use either of the following workarounds if your rmic call is of the form:

rmic classname="com.bea.crmsimulation.legacyra.LegacyAdapter"
base="${module_location}/core-legacy-ra/classes"
classpath="${core.classes}" compiler="weblogic" />

- Add a stubversion

<rmic classname="com.bea.crmsimulation.legacyra.LegacyAdapter"
base="${module_location}/core-legacy-ra/classes"
classpath="${core.classes}" compiler="weblogic"
stubversion="1.2"/>

- Remove the compiler flag

<rmic classname="com.bea.crmsimulation.legacyra.LegacyAdapter"
base="${module_location}/core-legacy-ra/classes"
classpath="${core.classes}"

12.27 Security Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.27.1, "StoreBootIdentity Works Only if the Appropriate Server Security Directory Exists"

- Section 12.27.2, "Boot Time Failure Occurs With SecurityServiceException"

- Section 12.27.3, "Authentication Failure After Upgrading a Domain From WLS 6.1"

- Section 12.27.4, "InvalidParameterException Message Generated and Displayed"

- Section 12.27.5, "Enabling Both the Authentication and Passive Attributes In SML 2.0 Service Provider Services Is an Invalid Configuration"

- Section 12.27.6, "Running the WebLogic Full Client in a Non-Forked VM"

12.27.1 StoreBootIdentity Works Only if the Appropriate Server Security Directory Exists

The option -Dweblogic.system.StoreBootIdentity works only if the appropriate server security directory exists. This directory is usually created by the Configuration Wizard or upgrade tool.

However, the appropriate server security directory could be absent in domains checked into source-control systems.

12.27.2 Boot Time Failure Occurs With SecurityServiceException

A WebLogic Server instance can experience a boot time failure with a SecurityServiceException when the RDBMS Security Data Store is configured for a DB2 database using the DB2 driver supplied with WebLogic Server.

Workaround

When RDBMS Security Data Store is using the AlternateId connection property for a DB2 database, you must also set the additional property BatchPerformanceWorkaround as true when using the DB2 driver supplied with WebLogic Server.

12.27.3 Authentication Failure After Upgrading a Domain From WLS 6.1

After upgrading a domain from WLS 6.1, the WebLogic Server instance will not boot due to an authentication failure.

Workaround

A system user password must be set up in the WLS 6.1 domain before or after the upgrade process in order for the WebLogic Server instance to boot properly.

12.27.4 InvalidParameterException Message Generated and Displayed

After you configure either the Identity Provider or Service Provider services for SAML 2.0 and attempt to publish the SAML 2.0 services metadata file, an InvalidParameterException message may be generated and displayed in the Administration Console.

Workaround

When configuring the SAML 2.0 federation services for a WebLogic Server instance, be sure to enable all binding types that are available for the SAML role being configured. For example, when configuring SAML 2.0 Identity Provider services, you should enable the POST, Redirect, and Artifact bindings. When configuring SAML 2.0 Service Provider services, enable the POST and Artifact bindings. Optionally, you may choose a preferred binding.

12.27.5 Enabling Both the Authentication and Passive Attributes In SML 2.0 Service Provider Services Is an Invalid Configuration

When configuring SAML 2.0 Service Provider services, enabling both the Force Authentication and Passive attributes is an invalid configuration that WebLogic Server is unable to detect. If both these attributes are enabled, and an unauthenticated user attempts to access a resource that is hosted at the Service Provider site, an exception is generated and the single sign-on session fails.

Note that the Force Authentication attribute has no effect because SAML logout is not supported in WebLogic Server. So even if the user is already authenticated at the Identity Provider site and Force Authentication is enabled, the user is not forced to authenticate again at the Identity Provider site.

Avoid enabling both these attributes.

12.27.6 Running the WebLogic Full Client in a Non-Forked VM

If the WebLogic Full Client is running in a non-forked VM, for example by means of a <java> task invoked from an Ant script without the fork=true attribute, the following error might be generated:

java.lang.SecurityException: The provider self-integrity check failed.

This error is caused by the self-integrity check that is automatically performed when the RSA Crypto-J library is loaded. (The Crypto-J library, cryptoj.jar, is in the wlfullclient.jar manifest classpath.)

This self-integrity check failure occurs when the client is started in a non-forked VM and it uses the Crypto-J API, either directly or indirectly, as in the following situations:

- The client invokes the Crypto-J library directly.

- The client attempts to make a T3S connection, which triggers the underlying client SSL implementation to invoke the Crypto-J API.

When the self-integrity check fails, further invocations of the Crypto-J API fail.

Workaround

When running the full client in a <java> task that is invoked from an Ant script, always set the fork attribute to true.

For more information about the self-integrity check, see "How a Provider Can Do Self-Integrity Checking" in How to Implement a Provider in the Java™ Cryptography Architecture, available at the following URL:

http://download.oracle.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html#integritycheck

12.28 SNMP Issues and Workarounds

There are no known SNMP issues in this release of WebLogic Server.

12.29 Spring Framework on WebLogic Server Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.29.1, "OpenJPA ClassFileTranformer Does Not Work When Running on JRockit"

- Section 12.29.2, "petclinic.ear Does Not Deploy on WebLogic Server"

12.29.1 OpenJPA ClassFileTranformer Does Not Work When Running on JRockit

The OpenJPA ClassFileTranformer does not work when running WebLogic Server on JRockit.

Workaround

Use an alternative method of applying enhancements at build time through an OpenJPA enhancer compiler; do not use the LoadTimeWeaver.

12.29.2 petclinic.ear Does Not Deploy on WebLogic Server

For the SpringSource petclinic sample, the petclinic.war deploys without any problems. The petclinic.ear will not deploy on WebLogic Server because it is not packaged correctly. A request has been sent to SpringSource to fix the petclinic.ear packaging.

12.30 System Component Architecture (SCA) Issues and Workarounds

There are no known SCA issues in this release of WebLogic Server.

12.31 Upgrade Issues and Workarounds

This section describes the following issue:

- Section 12.31.1, "Domains Created on WebLogic Server 10.3.1 Cannot Be Run on WebLogic Server 10.3"

12.31.1 Domains Created on WebLogic Server 10.3.1 Cannot Be Run on WebLogic Server 10.3

If you create a domain using WebLogic Server 10.3.1, then roll back to WebLogic Server 10.3, you will not be able to start the servers that you created in that domain. This is a known restriction, as the config.xml file contains references to newer schema definitions (xmlns.oracle.com) that did not exist in WebLogic Server 10.3.

12.32 Web Applications Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.32.1, "Administration Console Fails to Implement session-timeout Changes"

- Section 12.32.2, "Connection Pool Connection Reserve Timeout Seconds Value is Overridden"

- Section 12.32.3, "Database Connections Become Unstable When a PoolLimitSQLException Occurs"

- Section 12.32.4, "Web Page Fails to Open When Accessing It Using the SSL Port"

- Section 12.32.5, "Unable to View the Output of a JSPX Page in Internet Explorer"

- Section 12.32.6, "Unable to View the Output of SVG files in Internet Explorer 7"

12.32.1 Administration Console Fails to Implement session-timeout Changes

If the session-timeout is configured in the web.xml file, any changes made to change the session-timeout using the Administration Console do not take effect.

Workaround

Use a deployment plan to override the session-timeout setting.

12.32.2 Connection Pool Connection Reserve Timeout Seconds Value is Overridden

When using a JDBC session, the value of Connection Reserve Timeout Seconds for a connection pool is changed to be one of the following:

- the JDBC connection timeout seconds, which is defined in the session descriptor (either in weblogic.xml or weblogic-application.xml)

- the default value of 120 seconds

Workaround

Configure jdbc-connection-timeout-secs in the session descriptor.

12.32.3 Database Connections Become Unstable When a PoolLimitSQLException Occurs

When a PoolLimitSQLException occurs during a JDBC persistence session, connections to the database become unstable, and may fail with recovery or fail without recovery. This results in the loss of session data. Either an older session or null is returned.

12.32.4 Web Page Fails to Open When Accessing It Using the SSL Port

When accessing a Web page using the SSL port, the page fails to open and the following error is reported:

Secure Connection Failed

An error occurred during a connection to <hostname>.

You have received an invalid certificate. Please contact the server
administrator or email correspondent and give them the following information:

Your certificate contains the same serial number as another certificate
issued by the certificate authority. Please get a new certificate containing a unique serial number.

Workaround

The following workaround can be used for Firefox.

If you have received this error and are trying to access a web page that has a self-signed certificate, perform the following steps in Firefox:

1. Go to Tools > Options >Advanced > Encryption tab > View Certificates.

2. On the Servers tab, remove the certificates.

3. On the Authorities tab, find the Certificate Authority (CA) for the security device that is causing the issue, and then delete it.

If you are using Internet Explorer or other web browsers, you can ignore the Warning page that appears and continue to the web page.

12.32.5 Unable to View the Output of a JSPX Page in Internet Explorer

When a JSPX page is deployed and is then accessed using some versions of Internet Explorer, the XHTML source is displayed instead of the page contents. This occurs in both normal and osjp.next modes.

Workaround

The application users should be instructed to use Firefox or Safari to access the application.

12.32.6 Unable to View the Output of SVG files in Internet Explorer 7

When a page using Scalar Vector Graphics is deployed and is then accessed using Internet Explorer 7 (IE7), the source is displayed instead of the page's graphic contents. This occurs in both normal and osjp.next modes.

Workaround

Application developers should avoid using SVG graphics in their applications, as it is not natively supported in IE7. If used, a warning similar to the following should be added:

All current browsers, with the exception of Internet Explorer, support SVG
files. Internet Explorer requires a plug-in to display SVG files. The plug-ins
are available for free, for example, the Adobe SVG Viewer at
http://www.adobe.com/svg/viewer/install/.

12.33 WebLogic Server Scripting Tool (WLST) Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.33.1, "Property Names Containing '.' Characters Are Not Supported by loadProperties"

- Section 12.33.2, "Invalid cachedir Created by Jython Causes WLST to Error Out"

12.33.1 Property Names Containing '.' Characters Are Not Supported by loadProperties

The WLST loadProperties command does not support loading a property with a name that contains "." characters. For example, if the property myapp.db.default is present in the property file, WLST throws a name exception:

Problem invoking WLST - Traceback (innermost last):
File "<iostream>", line 7, in ?
File "<iostream>", line 4, in readCustomProperty
NameError: myapp

This is a system limitation of Python and the loadProperties command. WLST reads the variable names and values and sets them as variables in the Python interpreter. The Python interpreter uses "." as a delimiter to indicate module scoping for the namespace, or package naming, or both. Therefore, the properties file fails because myapp.db.default.version=9i is expected to be in the myapp.db.default package. This package does not exist.

Workaround

Use variable names that do not have periods. This will allow you to load the variables from the property file and refer to them in WLST scripts. You could use another character such as "_" or lowercase/uppercase character to delimit the namespace.

As an alternative, you can set variables from a properties files. When you use the variables in your script, during execution, the variables are replaced with the actual values from the properties file. For example:

myapp.py
var1=10
var2=20
import myapp
print myapp.var1
10
print myapp.var2
20

This will work for one level of namespaces (myapp.var1, myapp.var2). It will not work for top level variables that share the same name as the namespace (for example, myapp=oracle and myapp.var1=10). Setting the myapp variable will override the myapp namespace.

If you need multiple levels, then you can define a package namespace using directories. Create a myapp/db/default directory with a vars.py file as follows:

var1=10
var2=20

Then import:

import myapp.db.default.vars
print myapp.db.default.vars.var1
10

You may need to add __init__.py files to the subdirectories. Refer to the Python documentation for more information on packages:

http://docs.python.org/tut/node8.html

12.33.2 Invalid cachedir Created by Jython Causes WLST to Error Out

The default cachedir created by Jython 2.2 is not a valid directory. If you are using Jython directly from weblogic.jar, this causes WLST to error out.

Workaround

There are two workarounds for this issue:

- When invoking WLST, specify the -Dpython.cachedir=<valid_directory> parameter, or

- Install Jython 2.2.1 separately instead of using the partial Jython that is included in weblogic.jar.

12.34 Web Server Plug-Ins Issues and Workarounds

This section describes the following issue:

- Section 12.34.1, "MOD_WLS_OHS Does Not Fail Over"

12.34.1 MOD_WLS_OHS Does Not Fail Over

Currently, mod_wl and mod_wl_ohs only support container level failover and not application level failover. mod_wl_ohs continues to route requests to a down application as long as the managed server is up and running. In the clustered case, requests continue to go to the container where the original session started even when the application is shutdown, typically resulting in the http error 404.

12.35 Web Services and XML Issues and Workarounds

This section describes the following issues and workarounds:

- Section 12.35.1, "weblogic.wsee.jaxws.mdb.DispatchPolicy WorkManager Cannot Be Found"

- Section 12.35.2, "Multiple Resize Buffer Calls Occur"

- Section 12.35.3, "Troubleshooting Problems When Applying the WebLogic Advanced Web Services for JAX-WS Extension Template"

- Section 12.35.4, "Sparse Arrays and Partially Transmitted Arrays Are Not Supported"

- Section 12.35.5, "WSDL Compiler Does Not Generate Serializable Data Types"

- Section 12.35.6, "Use of Custom Exception on a Callback"

- Section 12.35.7, "Cannot Use JMS Transport in an Environment That Also Uses a Proxy Server"

- Section 12.35.8, "clientgen Fails When Processing a WSDL"

- Section 12.35.9, "JAX RPC Handlers in Callback Web Services Are Not Supported"

- Section 12.35.10, "Message-level Security in Callback Web Services Is Not Supported"

- Section 12.35.11, "Handling of Java Method Arguments or Return Parameters That Are JAX-RPC-style JavaBeans"

- Section 12.35.12, "IllegalArgumentException When Using a Two-Dimensional XML Object in a JWS Callback"

- Section 12.35.13, "Using SoapElement[] Results in Empty Array"

- Section 12.35.14, "FileNotFound Exception When a Web Service Invokes Another Web Service"

- Section 12.35.15, "Client Side Fails to Validate the Signature on the Server Response Message"

- Section 12.35.16, "xmlcatalog Element Entity Cannot Be a Remote File or a File in an Archive"

- Section 12.35.17, "Catalog File's public Element Is Not Supported When Using XML Catalogs"

- Section 12.35.18, "Local xmlcatalog Element Does Not Work Well"

- Section 12.35.19, "JAXRPC Client Does Not Encode the HTTP SOAPAction Header With Multi-byte Characters"

- Section 12.35.20, "External Catalog File Cannot Be Used in the xmlcatalog Element of clientgen"

- Section 12.35.21, "Exceptions When Running Reliable Messaging Under Heavy Load"

- Section 12.35.22, "ClassNotFound Exception Occurs When Using wseeclient.jar"

- Section 12.35.23, "Incomplete Configuration When Adding Advanced Web Services Component to SOA Domain"

- Section 12.35.24, "WS-AT Interoperation Issues With WebSphere and WebLogic Server"

12.35.1 weblogic.wsee.jaxws.mdb.DispatchPolicy WorkManager Cannot Be Found

In some situations, warning messages are logged indicating that the weblogic.wsee.jaxws.mdb.DispatchPolicy WorkManager cannot be found, although this WorkManager is targeted to one or more of the Managed Servers in the domain.

Workaround

Use one of the following workarounds to resolve this issue.

- To prevent these warning messages, start the WebLogic Server instance with the -Dweblogic.wsee.skip.async.response=true flag. See Programming Advanced Features of JAX-RPC Web Services for Oracle WebLogic Server for more information on this flag.

- Manually target the weblogic.wsee.jaxws.mdb.DispatchPolicy WorkManager to the Administration Server.

12.35.2 Multiple Resize Buffer Calls Occur

When executing Web services client calls where Message Transmission Optimization Mechanism (MTOM) attachments are processed for send, multiple resize buffer calls occur..

Workaround

There is a patch available to resolve this issue. This patch can be applied only to WebLogic Server 10.3.4. It provides the system property jaxws.transport.streaming, which enables or disables streaming at the transport layer for a Web services client. Set this property to true for CPU-intensive applications that are running on a WebLogic Server instance that is participating in Web services interactions as a client, and is sending out large messages.

To obtain the patch, do one of the following:

- Contact My Oracle Support and request the patch for bug 9956275, or

- Download the patch from My Oracle Support and install it using Smart Update per the instructions in the following My Oracle Support document:
1302053.1

Search for Oracle patch number 9956275 or Smart Update patch 7Z5H.

12.35.3 Troubleshooting Problems When Applying the WebLogic Advanced Web Services for JAX-WS Extension Template

After upgrading from WebLogic Server 10.3.4 to 10.3.5, when creating or extending a domain using the WebLogic Advanced Web Services for JAX-WS Extension template (wls_webservices_jaxws.jar), you may encounter an exception during the execution of the final.py script. For complete details and a workaround, see "Troubleshooting Problems When Applying the WebLogic Advanced Services for JAX-WS Extension Template" in Getting Started With JAX-WS Web Services for Oracle WebLogic Server.

12.35.4 Sparse Arrays and Partially Transmitted Arrays Are Not Supported

WebLogic Server does not support Sparse Arrays and Partially Transmitted Arrays as required by the JAX-RPC 1.1 Spec.

12.35.5 WSDL Compiler Does Not Generate Serializable Data Types

The Web Service Description Language (WSDL) compiler does not generate serializable data types, so data cannot be passed to remote EJBs or stored in a JMS destination.

12.35.6 Use of Custom Exception on a Callback

WebLogic Server does not support using a custom exception on a callback that has a package that does not match the target namespace of the parent Web Service.

Workaround

Make sure that any custom exceptions that are used in callbacks are in a package that matches the target namespace of the parent Web service.

12.35.7 Cannot Use JMS Transport in an Environment That Also Uses a Proxy Server

You cannot use JMS transport in an environment that also uses a proxy server. This is because, in the case of JMS transport, the Web Service client always uses the t3 protocol to connect to the Web Service, and proxy servers accept only HTTP/HTTPS.

12.35.8 clientgen Fails When Processing a WSDL

clientgen fails when processing a WSDL that uses the complex type http://www.w3.org/2001/XMLSchema{schema} as a Web Service parameter.

12.35.9 JAX RPC Handlers in Callback Web Services Are Not Supported

WebLogic Server 9.2 and later does not support JAX RPC handlers in callback Web Services.

Workaround

If JAX RPC handlers were used with Web Services created with WebLogic Workshop 8.1, then such applications must be redesigned so that they do not use callback handler functionality.

12.35.10 Message-level Security in Callback Web Services Is Not Supported

WebLogic Server 9.2 and later does not support message-level security in callback Web Services.

Workaround

Web Services created with WebLogic Workshop 8.1 that used WS-Security must be redesigned to not use message-level security in callbacks.

12.35.11 Handling of Java Method Arguments or Return Parameters That Are JAX-RPC-style JavaBeans

WebLogic Server does not support handling of Java method arguments or return parameters that are JAX-RPC-style JavaBeans that contain an XmlBean property. For example, applications cannot have a method with a signature like this:

void myMethod(myJavaBean bean);

where myJavaBean class is like:

public class MyJavaBean {
private String stringProperty;
private XmlObject xmlObjectProperty;

public MyJavaBean() {}
String getStringProperty() {
return stringProperty;
}
void   setStringProperty(String s) {
stringProperty = s;
}
XmlObject getXmlObjectProperty() {
return xmlObjectProperty;
}
void      getXmlObjectProperty(XmlObject x) {
xmlObjectProperty = x;
}
}

Workaround

Currently there is no known workaround for this issue.

12.35.12 IllegalArgumentException When Using a Two-Dimensional XML Object in a JWS Callback

Using a two dimensional XmlObject parameter (XmlObject[][]) in a JWS callback produces an IllegalArgumentException.

Workaround

Currently there is no known workaround for this issue.

12.35.13 Using SoapElement[] Results in Empty Array

Using SoapElement[] as a Web Service parameter with @WildcardBinding(className="javax.xml.soap.SOAPElement[]", binding=WildcardParticle.ANYTYPE) will always result in an empty array on the client.

Workaround

Do not use the @WildcardBinding annotation to change the default binding of SOAPElement[] to WildcardParticle.ANYTYPE. The SOAPElement[] default binding is set to WildcardParticle.ANY.

12.35.14 FileNotFound Exception When a Web Service Invokes Another Web Service

When Web Service A wants to invoke Web Service B, Web Service A should use the @ServiceClient annotation to do this. If Web Service B needs a custom policy file that is not attached to the WSDL for Web Service B, then Web Service A will fail to run. Web Service A will look for the policy file at /Web-Inf/classes/policies/filename.xml. Since no policy file exists at that location, WebLogic Server will throw a 'file not found' exception.

Workaround

Attach the custom policy file to Web Service B, as in this example:

@Policy(uri="CustomPolicy.xml",
attachToWsdl=true)
public class B {
...
}

12.35.15 Client Side Fails to Validate the Signature on the Server Response Message

When the security policy has one of these Token Assertions, the client side may fail to validate the signature on the server response message.

<sp:WssX509PkiPathV1Token11/>
<sp:WssX509Pkcs7Token11/>
<sp:WssX509PkiPathV1Token10/>
<sp:WssX509Pkcs7Token10/>

In addition, when there are more than two certifications in the chain for X509 certification for <sp:WssX509Pkcs7Token11/> or <sp:WssX509Pkcs7Token10/> Token Assertion, the server side may fail to validate the signature on the incoming message.

A policy such as the following policy is not supported, unless the entire certificate chain remains on the client side.

<sp:AsymmetricBinding>
<wsp:Policy>
<sp:InitiatorToken>
<wsp:Policy>
<sp:X509Token
sp:IncludeToken='. . ./IncludeToken/AlwaysToRecipient'>

<wsp:Policy>
<sp:WssX509Pkcs7Token11/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:InitiatorToken>
<sp:RecipientToken>
<wsp:Policy>
<sp:X509Token sp:IncludeToken='. . ./IncludeToken/Never'>
<wsp:Policy>
<sp:WssX509Pkcs7Token11/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:RecipientToken>
. . .
</wsp:Policy>
</sp:AsymmetricBinding>

Workaround

Use either of the following two solutions:

1. Configure the response with the <sp:WssX509V3Token10/> Token Assertion, instead of WssX509PkiPathV1Token11/>. The policy will look like this:

<sp:AsymmetricBinding>
<wsp:Policy>
<sp:InitiatorToken>
<wsp:Policy>
<sp:X509Token sp:IncludeToken='. . ./IncludeToken/AlwaysToRecipient'>
<wsp:Policy>
WssX509PkiPathV1Token11/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:InitiatorToken>
<sp:RecipientToken>
<wsp:Policy> sp:IncludeToken='. . ./IncludeToken/Never'>
<sp:X509Token
<wsp:Policy>
<sp:WssX509V3Token10/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:RecipientToken>
. . .
</wsp:Policy>
</sp:AsymmetricBinding>

2. Configure the response with the WssX509PkiPathV1Token11/> token assertion, but include it in the message. The policy will look like this:

<sp:AsymmetricBinding>
<wsp:Policy>
<sp:InitiatorToken>
<wsp:Policy>
<sp:X509Token sp:IncludeToken='. . ./IncludeToken/AlwaysToRecipient'>
<wsp:Policy>
WssX509PkiPathV1Token11/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:InitiatorToken>
<sp:RecipientToken>
<wsp:Policy>
<sp:X509Token sp:IncludeToken='. . ./IncludeToken/AlwaysToInitiator'>
<wsp:Policy>
WssX509PkiPathV1Token11/>
</wsp:Policy>
</sp:X509Token>
</wsp:Policy>
</sp:RecipientToken>
. . .
</wsp:Policy>
</sp:AsymmetricBinding>

When there are multiple certifications in the X509 Certificate chain, WssX509PkiPathV1Token11/> or <sp:WssX509PkiPathV1Token10/> should be used, instead of <sp:WssX509Pkcs7Token11/> or <sp:WssX509Pkcs7Token10/>.

12.35.16 xmlcatalog Element Entity Cannot Be a Remote File or a File in an Archive

For the xmlcatalog element in build.xml, the location of an entity must be a file on the local file system. It cannot be a remote file (for example, http:) or a file in an archive (for example, jar:).

Workaround

If necessary, define the remote element as an entity in a catalog file instead.

12.35.17 Catalog File's public Element Is Not Supported When Using XML Catalogs

The public element in a catalog file is not supported when using the XML Catalogs feature. It is not supported to be consistent with JAX-WS EntityResolver implementation. WebLogic Server only supports defining the system element in a catalog file.

12.35.18 Local xmlcatalog Element Does Not Work Well

The local xmlcatalog element does not work well due to an Ant limitation.

Workaround

In the ant build.xml file, you have to define a local element above a clientgen(wsdlc) task when you are in the same target, or define the element out of any targets.

12.35.19 JAXRPC Client Does Not Encode the HTTP SOAPAction Header With Multi-byte Characters

The WebLogic Server Web Service JAXRPC client doesn't encode the HTTP SOAPAction header with multi-byte characters, but WebLogic Server only supports ASCII for HTTP headers.

Workaround

Change the SOAP action to ASCII in the WSDL.

12.35.20 External Catalog File Cannot Be Used in the xmlcatalog Element of clientgen

An external catalog file cannot be used in the xmlcatalog element of a clientgen task. For example, this snippet of an ant build file will not work:

<clientgen ...
<xmlcatalog>
<catalogpath>
<pathelement location='wsdlcatalog.xml'/>
</catalogpath>
</xmlcatalog>

This is a limitation of the Ant XML Catalog.

Workaround

Resource locations can be specified either in-line or in an external catalog file(s), or both. In order to use an external catalog file, the xml-commons resolver library (resolver.jar) must be in your classpath. External catalog files may be either plain text format or XML format. If the xml-commons resolver library is not found in the classpath, external catalog files, specified in <catalogpath> paths, will be ignored and a warning will be logged. In this case, however, processing of inline entries will proceed normally.

Currently, only <dtd> and <entity> elements may be specified inline. These correspond to the OASIS catalog entry types PUBLIC and URI respectively.

12.35.21 Exceptions When Running Reliable Messaging Under Heavy Load

When running a Web services reliable messaging scenario under heavy load with file based storage that has the Direct-Write synchronous write policy setting, you may encounter IO exceptions similar to the following in the WebLogic Server log:

weblogic.store.PersistentStoreRuntimeException: [Store:280029]The
persistent store record <number> could not be found

or

Could not load conversation with id uuid:<some ID> -> Conversation read
failed:
...
weblogic.wsee.jws.conversation.StoreException:
Conversation read failed: id=uuid:<some ID>
weblogic.store.PersistentStoreException: [Store:280052]The
persistent store was not able to read a record.
java.io.OptionalDataException

These exceptions are known to occur only when using Web Services reliable messaging. They indicate a failure to read a record from the file store and are considered 'fatal' data access errors.

The underlying issue causing these errors will be addressed in a future release.

Workaround

The following workarounds are available for this issue:

- Change the file store synchronous write policy to Direct-Write-With-Cache
or

- Change the file store synchronous write policy to Cache-Flush.
or

- Keep the Direct-Write synchronous write policy and add the following Java system property to your WebLogic server startup scripts:

-Dweblogic.store.AvoidDirectIO=true

Note:

The -Dweblogic.store.AvoidDirectIO system property has been deprecated in WebLogic Server 10.3.4. Oracle recommends configuring the store synchronous write policy to Direct-Write-With-Cache instead.

The Direct-Write-With-Cache option may improve performance; it creates additional files in the operating system's temporary directory by default.

The Cache-Flush and AvoidDirectIO workarounds may lead to some performance degradation; it may be possible to reduce or eliminate the degradation by configuring a different block-size for the file store.

For important information about these settings and additional options, see "Tuning File Stores" in Oracle Fusion Middleware Performance and Tuning for Oracle WebLogic Server.

12.35.22 ClassNotFound Exception Occurs When Using wseeclient.jar

Stand-alone JAX-WS clients are not supported in this release.

Workaround

Use the client-side JAX-WS 2.1 that is integrated with the Java Standard Edition Release 6 (JDK 1.6), Update 4 and later. This requires using the JAX-WS API instead of any WebLogic Server specific APIS.

Current releases of JDK 1.6 are available for download at http://java.sun.com/javase/downloads/index.jsp. For information about writing a standalone JAX WS 2.1 client application, see the JAX-WS Users Guide on the JAX-WS 2.1 Reference Implementation Web site at https://jax-ws.dev.java.net/.

12.35.23 Incomplete Configuration When Adding Advanced Web Services Component to SOA Domain

An incomplete configuration can result when you use the Configuration Wizard to add the WebLogic Server Advanced Web Services component to a newly created SOA domain. If you create a cluster that contains only the default 'out-of-the-box' soa_server1 server definition, the resulting cluster does not include the resources needed to run WebLogic Server Web Services in that cluster.

Workaround

Use either of the following workarounds for this issue:

1. While running Configuration Wizard, create a second server in the cluster:

1. On the Select Optional Configuration screen, select Managed Servers, Clusters, and Machines.

2. On the Configure Managed Servers screen, add a managed server.

3. On the Assign Servers to Clusters screen, add this server to the cluster in which the default soa_server1 server resides.

2. On the Configuration Wizard Target Services to Servers or Clusters screen, target Web Services resources (for example, WseeJmsServer, WseeJmsModule) to the cluster.

Either of these workarounds will cause the Configuration Wizard to apply the resources for the WebLogic Server Advanced Web Services component to the cluster.

12.35.24 WS-AT Interoperation Issues With WebSphere and WebLogic Server

Web Services Atomic Transactions (WS-AT) 1.1 interoperation using WebSphere as the client and either WebLogic Server or JRF as the service does not work.

WS-AT 1.1 interoperation does work when WebSphere is the service and either WebLogic Server or JRF is the client. In this case, interoperation works only if you have WebSphere 7 with Fix/Feature Pack 7.

12.36 WebLogic Tuxedo Connector Issues and Workarounds

This section describes the following issue and workaround:

- Section 12.36.1, "View Classes are not Set on a Per Connection Basis"

12.36.1 View Classes are not Set on a Per Connection Basis

View classes are not set on a per connection basis.

A shared WebLogic Tuxedo Connector hash table can cause unexpected behavior in the server if two applications point to the same VIEW name with different definitions. There should be a hash table for the view classes on the connection as well as for the Resource section.

Workaround

Ensure that all VIEW classes defined across all your WebLogic Workshop applications are consistent, meaning that you have the same VIEW name representing the same VIEW class.

12.37 Documentation Errata

This section describes documentation errata:

- Section 12.37.1, "Issues With Search Function in the Samples Viewer"

- Section 12.37.2, "Japanese Text Displays in Some Search Results Topics Avitek Medical Records"

- Section 12.37.3, "HTML Pages For Downloaded Libraries Do Not Display Properly"

- Section 12.37.4, "Evaluation Database Component Is Not Listed For silent.xml"

- Section 12.37.5, "Instructions for Reliable SOAP Messaging Code Example Are Incorrect"

12.37.1 Issues With Search Function in the Samples Viewer

The Search function in the Samples viewer does not work when accessing the Examples documentation by selecting Oracle Weblogic > Weblogic Server > Examples > Documentation from the Windows Start menu.

Workaround

To search the Sample Applications and Code Examples, you must start the Examples server and navigate to http://localhost:7001/examplesWebApp/docs/core/index.html. Click Instructions and then Search.

12.37.2 Japanese Text Displays in Some Search Results Topics Avitek Medical Records

The samples viewer Search function may sometimes return topics that display the Japanese and English versions of some Avitek Medical Records topics simultaneously.

12.37.3 HTML Pages For Downloaded Libraries Do Not Display Properly

After extracting the WebLogic Server documentation library ZIP files that are available from http://www.oracle.com/technetwork/middleware/weblogic/documentation/index.html, the HTML pages may not display properly in some cases for the following libraries:

- E12840_01 (WebLogic Server 10.3.0 documentation library)

- E12839_01 (Weblogic Server 10.3.1 documentation library)

- E14571_01 (WebLogic Server 10.3.3 documentation library)

Workarounds

For library E12840-01, after extracting the E12840_01.zip library file, if the HTML pages are not formatting correctly, perform the following steps:

1. Go to the directory in which you extracted the zip file.

2. Locate the /global_resources directory in the directory structure.

3. Copy the /global_resources directory to the root directory of the same drive.

For libraries E12839-01 and E14571-01, this issue occurs only on Windows operating systems. If the HTML pages of the extracted library are not formatting correctly, try extracting the ZIP file using another extraction option in your unzip utility. For example, if you are using 7-Zip to extract the files, select the Full pathnames option. Note that you cannot use the Windows decompression utility to extract the library ZIP file.

12.37.4 Evaluation Database Component Is Not Listed For silent.xml

In the WebLogic Server Installation Guides for WebLogic Server 10.3.3 and 10.3.4, the Evaluation Database is not listed as an installable component in Table 5-1 of Chapter 5, "Running the Installation Program in Silent Mode.:" The following entry should be included in the Component Paths row:

WebLogic Server/Evaluation Database

The Evaluation Database component is automatically installed if the Server Examples component is included in silent.xml. Therefore, it does not have to be explicitly included in silent.xml. If, however, you do not install the Server Examples, but you want to install the Evaluation Database, you must include WebLogic Server/Evaluation Database in silent.xml.

12.37.5 Instructions for Reliable SOAP Messaging Code Example Are Incorrect

The instructions for the "Configuring Secure and Reliable SOAP Messaging for JAXWS Web Services" example are a copy of the instructions for the "Using Make Connection and Reliable Messaging for JAX-WS Web Service" example.

The correct instructions for the "Configuring Secure and Reliable SOAP Messaging for JAXWS Web Services" example are provided here.

12.37.5.1 About the Example

This example shows how to configure secure, reliable messaging for JAX-WS Web services. The example includes the following WebLogic Web services:

- Web service whose operations can be invoked using reliable and secure SOAP messaging (destination endpoint).

- Client Web service that invokes an operation of the first Web service in a reliable and secure way (source endpoint).

Overview of Secure and Reliable SOAP Messaging

Web service reliable messaging is a framework that enables an application running on one application server to reliably invoke a Web service running on another application server, assuming that both servers implement the WS-RelicableMessaging specification. Reliable is defined as the ability to guarantee message delivery between the two endpoints (Web service and client) in the presence of software component, system, or network failures.

WebLogic Web services conform to the WS-ReliableMessaging 1.2 specification (February 2009) and support version 1.1. This specification describes how two endpoints (Web service and client) on different application servers can communicate reliably. In particular, the specification describes an interoperable protocol in which a message sent from a source endpoint (or client Web service) to a destination endpoint (or Web service whose operations can be invoked reliably) is guaranteed either to be delivered, according to one or more delivery assurances, or to raise an error.

WebLogic Web services use WS-Policy files to enable a destination Web service to describe and advertise its reliable SOAP messaging capabilities and requirements. WS-Policy files are XML files that describe features such as the version of the WS-ReliableMessaging specification that is supported, the source Web service retransmission interval, the destination Web service acknowledgment interval, and so on.

Overview of the Example

This example uses JWS annotations to specify the shape and behavior of the Web services. It describes additional JWS annotations to enable reliable and secure SOAP messaging in the destination Web service and to reliably invoke an operation from the source Web service in a secure way.

The destination ReliableEchoService Web service has two operations that can be invoked reliably and in a secure way: echo and echoOneway. The JWS file that implements this Web service uses the @Policies and @Policy JWS annotations to specify the WS-Policy file, which contains the reliable and secure SOAP messaging assertions.

The source ClientService Web service has one operation for invoking the echo operations of the ReliableEchoService Web service reliably and in a secure way within one conversation: runTestEchoWithRes. The JWS file that implements the ClientService Web service uses the @WebServiceRef JWS annotation to specify the service name of the reliable Web service being invoked.

To generate the Web services, use the jwsc WebLogic Web service Ant task, as shown in the build.xml file. The jwsc target generates the reliable and secure Web service and the jwsc-client-app target creates the source Web service that invoke the echo operations of the ReliableEchoService Web service. The jwsc Ant task compiles the JWS files, and generates the additional files needed to implement a standard J2EE Enterprise Web service, including the Web service deployment descriptors, the WSDL file, data binding components, and so on. The Ant task automatically generates all the components into an Enterprise Application directory structure that you can then deploy to WebLogic Server. This example uses the wldeploy WebLogic Ant task to deploy the Web service.

The jwsc-client-app target also shows how you must first execute the clientgen Ant task to generate the JAX-WS stubs for the destination ReliableEchoService Web service, compile the generated Java source files, and then use the classpath attribute of jwsc to specify the directory that contains these classes so that the ClientServiceImpl.java class can find them.

The WsrmJaxwsExampleRequest.java class is a standalone Java application that invokes the echo operation of the source Web service. The client target of the build.xml file shows how to run clientgen, and compile all the generated Java files and the WsrmJaxwsExampleRequest.java application.

12.37.5.2 Files Used in This Example

Directory Location: MW_HOME/wlserver_10.3/samples/server/examples/src/examples/webservices/wsrm_jaxws/wsrm_jaxws_security

MW_HOME represents the Oracle Fusion Middleware home directory.

File

Description

ClientServiceImpl.java

JWS file that implements the source Web service that reliably invokes the echo operation of the ReliableEchoService Web service in a secure way.

ReliableEchoServiceImpl.java

JWS file that implements the reliable destination Web service. This JWS file uses the @Policies and @Policy annotation to specify a WS-Policy file that contains reliable and secure SOAP messaging assertions.

client/WsrmJaxwsExampleRequest.java

Standalone Java client application that invokes the source WebLogic Web service, that in turn invokes an operation of the ReliableEchoervice Web service in a reliable and secure way.

ws_rm_configuration.py

WLST script that configures the components required for reliable SOAP messaging. Execute this script for the WebLogic Server instance that hosts the reliable destination Web service. The out-of-the-box Examples server has already been configured with the resources required for the source Web service that invokes an operation reliably.

configWss.py

WLST script that configures the components required for secure SOAP messaging. Execute this script for the WebLogic Server instance that hosts the source Web service. Remember to restart the source WebLogic Server after executing this script.

configWss_Service.py

WLST script that configures the components required for secure SOAP messaging. Execute this script for the WebLogic Server instance that hosts the destination Web service. Remember to restart the destination WebLogic Server after executing this script.

certs/serverKeyStore.jks

Server-side key store used to create the server-side BinarySecurityToken credential provider.

certs/clientKeyStore.jks

Client-side key store used to create the client-side BinarySecurityToken credential provider.

jaxws-binding.xml

XML file that describes the package name of the generated code and indicate the client side code needs to contain asynchronous invocation interface.

build.xml

Ant build file that contains targets for building and running the example.

12.37.5.3 Prepare the Example

This section describes how to prepare the example.

Prerequisites

Before working with this example:

1. Install Oracle WebLogic Server, including the examples.

2. Start the Examples Server.

3. Set up your environment.

Configure the Destination WebLogic Server Instance (Optional)

The default configuration for this example deploys both the source and destination Web services to the Examples server. You can use this default configuration to see how the example works, but it does not reflect a real life example of using reliable and secure SOAP messaging in which the source Web service is deployed to a WebLogic Server that is different from the one that hosts the destination Web service. This section describes how to set up the real life example.

The example includes WebLogic Server Scripting Language (WLST) scripts that are used to configure:

- Store-and-forward (SAF) service agent

- File store

- JMS server

- JMS module

- JMS subdeployment

- JMS queues

- Logical store

- Credential provider for Security Context Token

- Credential provider for Derived Key

- Credential provider for x.509

- KeyStores for Confidentiality and Integrity

- PKI CreditMapper

Follow these steps if you want to deploy the secure and reliable destination Web service to a different WebLogic Server instance:

1. If the managed WebLogic Server to which you want to deploy the reliable JAX-WS Web service does not exist, create it.

2. Change to the SAMPLES_HOME\server\examples\src\examples\webservices\wsrm_jaxws\wsrm_jaxws_security directory, where SAMPLES_HOME refers to the main WebLogic Server examples directory, such as c:\Oracle\Middleware\wlserver_10.3\samples.

3. Edit the build.xml file and update the following property definitions to ensure that the reliable JAX-WS Web service is deployed to the destination WebLogic Server:

<property name="wls.service.server" value="destinationServerName" />
<property name="wls.service.hostname" value="destinationHost" />
<property name="wls.service.port" value="destinationPort" />
<property name="wls.service.username" value="destinationUser" />
<property name="wls.service.password" value="destinationPassword" />

Substitute the italicized terms in the preceding properties with the actual values for your destination WebLogic Server. The default out-of-the-box build.xml sets these properties to the Examples server.

Build and Deploy the Example

To build and deploy the example:

1. Change to the SAMPLES_HOME\server\examples\src\examples\webservices\wsrm_jaxws\wsrm_jaxws_security directory, where SAMPLES_HOME refers to the main WebLogic Server examples directory, such as c:\Oracle\Middleware\wlserver_10.3\samples.

2. Run the WLST script that configures the destination WebLogic Server by executing the config.ws.reliable.service target of the build.xml file from the shell where you set your environment:
prompt> ant config.ws.reliable.service

3. Execute the following command to configure JAX-WS Web service Security from the shell where you set your environment:
prompt> ant config.wss

4. If you have configured a different destination WebLogic Server (that is, the destination server is not the Examples server), copy the certs\serverKeyStore.jks file to the domain directory of your destination server.

5. Restart both your client and destination WebLogic Server to activate the MBean changes.

6. Execute the following command from the shell where you set your environment:
prompt> ant build

This command compiles and stages the example. Specifically, it compiles both the source and destination Web services. It also compiles the standalone WsrmJaxwsExampleRequest application that invokes the source Web service, which in turn invokes the reliable destination Web service.

7. Execute the following command from the shell where you set your environment:
prompt> ant deploy

This command deploys, by default, both the source and destination Web services to the wl_server domain of your WebLogic Server installation. If you have configured a different destination WebLogic Server and updated the build.xml file accordingly, then the reliable JAX-WS Web service is deployed to the configured destination server.

12.37.5.4 Run the Example

To run the example, follow these steps:

1. Complete the steps in the Prepare the Example section.

2. In your development shell, run the WsrmJaxwsExampleRequest Java application using the following command from the main example directory (SAMPLES_HOME\server\examples\src\examples\webservices\wsrm_jaxws\wsrm_jaxws_security):
prompt> ant run

This command runs the standalone WsrmJaxwsExampleRequest application that invokes the source Web service, which in turn invokes the reliable destination JAX-WS Web service.

3. To test the reliability of the Web service, stop the destination WebLogic Server, and then rerun the WsrmJaxwsExampleRequest application. When you restart the destination WebLogic Server and the reliable Web service is deployed, you should see that the operation is also automatically invoked.

Check the Output

If your example runs successfully, the following messages display in the command shell from which you ran the WsrmJaxwsExampleRequest application:

Trying to override old definition of task clientgen

run:
[java]
[java]
[java] ###########################################
[java]     In testEcho_AsyncOnServerClient_ServiceBuffered...
[java]     On-Server / Async / Buffered case
[java]     2011/06/160 03:30:29.938
[java] ###########################################
[java]
[java]
[java] Client addr:http://localhost:9001/wsrm_jaxws_sc_example_client/Clien
tService
[java] ---[HTTP request - http://localhost:9001/wsrm_jaxws_sc_example_clien
t/ClientService]---
[java] Content-type: text/xml;charset=utf-8
[java] Soapaction: ""
[java] Accept: text/xml, multipart/related, text/html, image/gif, image/jpe
g, *; q=.2, */*; q=.2
[java] <?xml version='1.0' encoding='UTF-8'?><S:Envelope xmlns:S="http://sc
hemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:runTestEchoWithRes xmlns:ns2="htt
p://example.wsrm_jaxws/"><arg0>Foo bar</arg0><arg1>localhost</arg1>
<arg2>8001</arg2><arg3>C:\Oracle\Middleware\wlserver_10.3\samples\server\
examples\src\examples\webservices\wsrm_jaxws_security/certs</arg3>
</ns2:runTestEchoWithRes></S:Body></S:Envelope>--------------------
[java]
[java] ---[HTTP response - http://localhost:9001/wsrm_jaxws_sc_example_clie
nt/ClientService - 200]---
[java] Transfer-encoding: chunked
[java] null: HTTP/1.1 200 OK
[java] Content-type: text/xml;charset=utf-8
[java] X-powered-by: Servlet/2.5 JSP/2.1
[java] Date: Thu, 09 Jun 2011 07:30:33 GMT
[java] <?xml version='1.0' encoding='UTF-8'?><S:Envelope xmlns:S="http://sc
hemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:runTestEchoWithResResponse xmlns:
ns2="http://example.wsrm_jaxws/"><return>[2011/06/160 03:30:33.953] ## Making Ec
ho Requests (ASYNC/BUFFERED) ##
[java] [2011/06/160 03:30:42.703] *** On first good invoke ***
[java] [2011/06/160 03:30:42.703] echo returned: Foo bar expected: Foo bar
[java] [2011/06/160 03:30:42.922] echo returned: foo bar 2 expected: foo ba
r 2
[java] [2011/06/160 03:30:43.031] echo returned: foo bar 3 expected: foo ba
r 3
[java] [2011/06/160 03:30:43.031] ## Done Making Echo Requests (ASYNC/BUFFE
RED) ##
[java] </return></ns2:runTestEchoWithResResponse></S:Body>
</S:Envelope>--------------------
[java]
[java] [2011/06/160 03:30:33.953] ## Making Echo Requests (ASYNC/BUFFERED)
##
[java] [2011/06/160 03:30:42.703] *** On first good invoke ***
[java] [2011/06/160 03:30:42.703] echo returned: Foo bar expected: Foo bar
[java] [2011/06/160 03:30:42.922] echo returned: foo bar 2 expected: foo ba
r 2
[java] [2011/06/160 03:30:43.031] echo returned: foo bar 3 expected: foo ba
r 3
[java] [2011/06/160 03:30:43.031] ## Done Making Echo Requests (ASYNC/BUFFE
RED) ##
[java]

BUILD SUCCESSFUL
Total time: 2 minutes 33 seconds

The following messages display in the command window from which you started as the client WebLogic Server (that hosts the reliable source Web service):

Service addr:http://localhost:7001/wsrm_jaxws_sc_example/ReliableEchoService
[2011/06/180 01:33:40.906] ## Making Echo Requests (ASYNC/BUFFERED) ##

[2011/06/180 01:33:40.906] In invokeEchoAsync, invoking echo with request: Foo bar

[2011/06/180 01:33:40.906] In invokeEchoAsync, waiting for response to request: Foo bar ...

SignInfo mismatch  Algo mismatch http://www.w3.org/2000/09/xmldsig#rsa-sha1 VS.
http://www.w3.org/2000/09/xmldsig#hmac-sha1 Refs: Msg size =1#Signature_prfr5thF
y2vRPbpC, Policy size =3 #unt_w7HSTtcGcebXFWEr, #Timestamp_XIXttwj9Yq2XO7Tj, #Bo
dy_81D2x3V7iTNyy1I5,
STR type mismatch Actual KeyInfo:{http://docs.oasis-open.org/wss/2004/01/oasis-2
00401-wss-wssecurity-secext-1.0.xsd}KeyIdentifier|http://docs.oasis-open.org/wss
/oasis-wss-soap-message-security-1.1#ThumbprintSHA1,  StrTypes size=1 :{http://d
ocs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd}Refere
nce||http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/dk,
Security Token mismatch, token type =http://docs.oasis-open.org/ws-sx/ws-securec
onversation/200512/dk and actual ishttp://docs.oasis-open.org/wss/2004/01/oasis-
200401-wss-x509-token-profile-1.0#X509v3
<WSEE:15>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:41.718] In ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fb8)

[2011/06/180 01:33:41.718] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fb8): Foo bar

[2011/06/180 01:33:41.718] *** On first good invoke ***

[2011/06/180 01:33:41.734] echo returned: Foo bar expected: Foo bar

[2011/06/180 01:33:41.734] In invokeEchoAsync, invoking echo with request: foo bar 2

[2011/06/180 01:33:41.750] In invokeEchoAsync, waiting for response to request: foo bar 2 ...

<WSEE:15>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:41.984] In ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fae)

[2011/06/180 01:33:41.984] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fae): foo bar 2

[2011/06/180 01:33:41.984] echo returned: foo bar 2 expected: foo bar 2

[2011/06/180 01:33:42.000] In invokeEchoAsync, invoking echo with request: foo bar 3

[2011/06/180 01:33:42.015] In invokeEchoAsync, waiting for response to request: foo bar 3 ...

<WSEE:31>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:42.187] In ClientServiceImpl.onEchoResponse(request:
examplesServer:4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fab)

[2011/06/180 01:33:42.328] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer:4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fab): foo bar 3

[2011/06/180 01:33:42.328] echo returned: foo bar 3 expected: foo bar 3

[2011/06/180 01:33:42.328] ## Done Making Echo Requests (ASYNC/BUFFERED) ##

<WSEE:46>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>

The following messages display in the command window from which you started the destination WebLogic Server (that hosts the reliable destination Web service):

%% Echoing: Foo bar %%
%% Echoing: foo bar 2 %%
%% Echoing: foo bar 3 %%

If you deploy both the source and destination Web services to the same Server, the following messages display in the command window from which you started your client and destination WebLogic Server:

Service addr:http://localhost:7001/wsrm_jaxws_sc_example/ReliableEchoService
[2011/06/180 01:33:40.906] ## Making Echo Requests (ASYNC/BUFFERED) ##

[2011/06/180 01:33:40.906] In invokeEchoAsync, invoking echo with request: Foo bar

[2011/06/180 01:33:40.906] In invokeEchoAsync, waiting for response to request: Foo bar ...

SignInfo mismatch  Algo mismatch http://www.w3.org/2000/09/xmldsig#rsa-sha1 VS.
http://www.w3.org/2000/09/xmldsig#hmac-sha1 Refs: Msg size =1#Signature_prfr5thF
y2vRPbpC, Policy size =3 #unt_w7HSTtcGcebXFWEr, #Timestamp_XIXttwj9Yq2XO7Tj, #Bo
dy_81D2x3V7iTNyy1I5,
STR type mismatch Actual KeyInfo:{http://docs.oasis-open.org/wss/2004/01/oasis-2
00401-wss-wssecurity-secext-1.0.xsd}KeyIdentifier|http://docs.oasis-open.org/wss
/oasis-wss-soap-message-security-1.1#ThumbprintSHA1,  StrTypes size=1 :{http://d
ocs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd}Refere
nce||http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/dk,
Security Token mismatch, token type =http://docs.oasis-open.org/ws-sx/ws-securec
onversation/200512/dk and actual ishttp://docs.oasis-open.org/wss/2004/01/oasis-
200401-wss-x509-token-profile-1.0#X509v3
%% Echoing: Foo bar %%
<WSEE:15>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:41.718] In ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fb8)

[2011/06/180 01:33:41.718] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fb8): Foo bar

[2011/06/180 01:33:41.718] *** On first good invoke ***

[2011/06/180 01:33:41.734] echo returned: Foo bar expected: Foo bar

[2011/06/180 01:33:41.734] In invokeEchoAsync, invoking echo with request: foo bar 2

[2011/06/180 01:33:41.750] In invokeEchoAsync, waiting for response to request: foo bar 2 ...

%% Echoing: foo bar 2 %%
<WSEE:15>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:41.984] In ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fae)

[2011/06/180 01:33:41.984] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer: 4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fae): foo bar 2

[2011/06/180 01:33:41.984] echo returned: foo bar 2 expected: foo bar 2

[2011/06/180 01:33:42.000] In invokeEchoAsync, invoking echo with request: foo bar 3

[2011/06/180 01:33:42.015] In invokeEchoAsync, waiting for response to request: foo bar 3 ...

%% Echoing: foo bar 3 %%
<WSEE:31>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>
testing...................

[2011/06/180 01:33:42.187] In ClientServiceImpl.onEchoResponse(request:
examplesServer:4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fab)

[2011/06/180 01:33:42.328] Done with ClientServiceImpl.onEchoResponse(request:
examplesServer:4b1c0f3e575dfa8c:7291c50f:130d9cbaace:-7fab): foo bar 3

[2011/06/180 01:33:42.328] echo returned: foo bar 3 expected: foo bar 3

[2011/06/180 01:33:42.328] ## Done Making Echo Requests (ASYNC/BUFFERED) ##

<WSEE:46>There is no information on the incoming SOAP message.
<SmartPolicySelect or.getSmartPolicyBlueprint:501>

Part V

Oracle WebCenter Portal

Part V contains the following chapter:

- Chapter 13, "Oracle WebCenter Portal"

13 Oracle WebCenter Portal

This chapter describes issues associated with Oracle WebCenter Portal. It includes the following topics:

- Section 13.1, "General Issues and Workarounds"

- Section 13.2, "Documentation Errata"

13.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 13.1.1, "Support for Discussions Server from Jive Software"

- Section 13.1.2, "Oracle WebCenter Portal's Pagelet Producer Failover Support"

- Section 13.1.3, "Configuring a Client Security Policy for Oracle Content Server Connections"

- Section 13.1.4, "Option to Create a Portal Resource Displayed for Design-Time Task Flows"

- Section 13.1.5, "SQL Query with NCHAR Data Type Throws Exception"

- Section 13.1.6, "Setting Up WNA-Based SSO Using JDK 1.6.22 Produces an Error"

- Section 13.1.7, "Unable to Access SSL-Protected WebCenter Portal Endpoints"

- Section 13.1.8, "Configuring the REST Server Post-Installation"

- Section 13.1.9, "Resources in Framework Application Disappear after Redeployment of Application"

- Section 13.1.10, "Style Sheets Not Loaded Correctly for Sample WSRP Producer Test Pages through Oracle HTTP Server"

- Section 13.1.11, "Cannot Customize or Personalize a JSF Portlet"

- Section 13.1.12, "Fallback Support for Custom Translations"

- Section 13.1.13, "Spaces Do Not Display Correct Language When the Spaces Application is Accessed Using OAM"

- Section 13.1.14, "Announcement Publication Format can be Incorrect in Thai"

- Section 13.1.15, "Favorite Based on Seeded Page Lost When Language Preference Changed from en-US"

- Section 13.1.16, "Document Permissions Not Honored in Spaces"

- Section 13.1.17, "The Run as Servlet Link on Producer Test Page Does Not Work for JSF Portlet"

- Section 13.1.18, "Documents Service Unavailable"

- Section 13.1.19, "Granting Permissions Errors in Documents When Creating a Space"

- Section 13.1.20, "Using OpenSocial Pagelets to Post Activities to User's Activity Stream"

- Section 13.1.21, "Accessing Owners' Profile Information Using the OpenSocial API"

- Section 13.1.22, "Granting View Document Permissions to Public and Authenticated Users for a Hierarchical Space"

- Section 13.1.23, "Issues when Using the Russian or Swedish Language"

13.1.1 Support for Discussions Server from Jive Software

Oracle supports the embedded discussions server from Jive Software. The interfaces to call the discussions server directly from an application should be done by leveraging the supplied task flows that come with WebCenter Portal. Any custom development against APIs in the Jive Web Service layer are subject to review by Oracle and may not be supported.

There are a limited set of beta features that Jive Software delivers as part of the discussions server that Oracle does not recommend and cannot yet support.

Documentation for Jive Forums is included for reference only. Jive software installations and upgrades outside of the WebCenter Portal product installation are not supported.

13.1.2 Oracle WebCenter Portal's Pagelet Producer Failover Support

Oracle WebCenter Portal's Pagelet Producer supports failover in a clustered configuration. However, the in-flight data (unsaved or pending changes) is not preserved. On failover, administrators must reestablish their administrative session. End users may also need to reestablish the session if the proxy is required to have a state. If SSO is configured, credentials are automatically provided, and the session is reestablished.

13.1.3 Configuring a Client Security Policy for Oracle Content Server Connections

If your environment supports Global Policy Attachments (GPA), leave the Client Security Policy property blank when you configure the Content Server connection. The hint text and online help indicates that you must enter the value 'GPA' but this information is not correct. See also, the table "Content Server Connection Parameters" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.

13.1.4 Option to Create a Portal Resource Displayed for Design-Time Task Flows

You can bring runtime task flows into JDeveloper, edit them, and export them back to the deployed application. However, Oracle recommends that you not expose task flows created in JDeveloper as portal resources. When you create an ADF task flow inside the /oracle/webcenter/portalapp folder, the context menu on the task flow definition file displays the Create Portal Resource option. Do not use this option to expose a design-time task flow as a portal resource. Task flows typically involve multiple files. When you export a new task flow from JDeveloper, all files may not be exported properly, and this may result in the task flow being broken post deployment.

13.1.5 SQL Query with NCHAR Data Type Throws Exception

When using a SQL data control, you may encounter an error if the query contains a column with the NCHAR data type. As a workaround, you can use the to_char(NCHAR_COLUMN NAME) function.

13.1.6 Setting Up WNA-Based SSO Using JDK 1.6.22 Produces an Error

Setting up Windows Native Authentication-based single sign-on using SUN JDK 1.6.22 produces an error. Use the jrockit JDK instead of the Sun JDK, or contact Oracle Support to get a backport request for bug 10631797.

13.1.7 Unable to Access SSL-Protected WebCenter Portal Endpoints

An Oracle WebCenter Source (for searching Spaces objects, such as lists, pages, spaces, and people connections profiles) currently cannot access SSL-protected WebCenter Portal endpoints. Oracle is working on a patch for this.

13.1.8 Configuring the REST Server Post-Installation

For certain features of the WebCenter Portal REST server to work correctly when using a REST client like the Oracle WebCenter Portal iPhone application, the flag WLForwardUriUnparsed must be set to ON for the Oracle Weblogic Server Plugin that you are using.

- If you are running Apache in front of Weblogic Server, add this flag to weblogic.conf.

- If you are running Oracle HTTP Server (OHS) in front of Weblogic Server, add this flag to mod_wl_ohs.conf.

The examples below illustrate the possible configurations for both of these cases.

For more information about how to configure Weblogic Server Plugins, see Oracle Fusion Middleware Using Web Server 1.1 Plug-Ins with Oracle WebLogic Server.

Example 1: Using <location /rest> to apply the flag only for /rest URIs (recommended)

<Location /rest>
# the flag below MUST BE set to "On"
WLForwardUriUnparsed    On

# other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort

# set the handler to be weblogic
SetHandler weblogic-handler
</Location>

Example 2: Applying the flag to all URIs served by Oracle Weblogic Server

<IfModule mod_weblogic.c>
# the flag below MUST BE set to "On"
WLForwardUriUnparsed    On

# other settings, example: WebLogicCluster or WebLogicHost & WebLogicPort
WebLogicCluster johndoe02:8005,johndoe:8006
Debug ON
WLLogFile             c:/tmp/global_proxy.log
WLTempDir             "c:/myTemp"
DebugConfigInfo       On
KeepAliveEnabled ON
KeepAliveSecs  15
</IfModule>

13.1.9 Resources in Framework Application Disappear after Redeployment of Application

If a Framework application has been customized at runtime to add new resources through the Resource Manager, those new resources are lost after a new deployment or a redeployment of the same application.

Any new pages created at runtime that use the lost resources are still available even though the resources themselves are no longer available in the Resource Manager.

This issue happens when the application version or the redeployment version is changed during the redeployment of the application, either using Fusion Middleware Control or WLST. It can also happen on redeployment when the generic-site-resources.xml file has been changed at design time (for example, by creating new resources).

This issue occurs because the generic-site-resources.xml file is overwritten on redeployment.

To work around this issue, you must manually add the mds-transfer-config.xml file to the application.

Note:

Any resources created at design time must be manually added to the runtime application before redeploying the application.

1. Download the mds-transfer-config.xml file from the following location:
https://support.oracle.com/oip/faces/secure/km/DownloadAttachment.jspx?attachid=1343209.1:mdstransferconfig

2. Extract the MAR file (for example AutoGeneratedMar.mar) from the EAR file.

3. In the extracted MAR file directory, create a new directory, called META-INF, and copy the mds-transfer-config.xml file to the new directory.

4. Update the MAR file with META-INF\mds-transfer-config.xml, for example:

jar -uvf AutoGeneratedMar.mar META-INF\mds-transfer-config.xml

5. Update the EAR file with the updated MAR file:

jar -uvf YourApp.ear AutoGeneratedMar.mar

6. Redeploy YourApp.mar.

13.1.10 Style Sheets Not Loaded Correctly for Sample WSRP Producer Test Pages through Oracle HTTP Server

If Oracle HTTP Server is used as a front end for the Sample WSRP Portlets producer, the style sheets for the WSRP Producer Test Pages of the WSRP Tools and Rich Text Editor portlet producers are not loaded properly in Mozilla Firefox or Google Chrome. However, the style sheets do load properly in Internet Explorer. Functionality of the portlets is not affected.

13.1.11 Cannot Customize or Personalize a JSF Portlet

When clicking OK after customizing or personalizing a JSF portlet (that is, a portlet created using the Oracle JSF Portlet Bridge), the portlet does not respond and displays a timeout message. This caused by performing an edit action and changing the portlet mode in a single operation.End users can work around this issue by clicking Apply (instead of OK) to perform the edit action first and then clicking Return to change the portlet mode back to View mode.Portlet developers can avoid the issue occurring by editing the code for the generated Edit Defaults mode (in the edit_defaults.jspx file) and Edit mode (in the edit.jspx file) and removing the code for the OK button so that end users are forced to use the Apply button instead.

13.1.12 Fallback Support for Custom Translations

There is no fallback support for custom translations. For example, if you create a custom translations file named scope-resource-bundle_fr.xlf and the space language setting is country-specific (fr-FR), the custom translation file is not used because Spaces is looking for scope-resource-bundle_fr-FR.xlf.As a workaround, copy _fr xlf and include the country specification in the names of the custom translation files (for example, scope-resource-bundle_fr-FR.xlf).

13.1.13 Spaces Do Not Display Correct Language When the Spaces Application is Accessed Using OAM

When users access the Spaces application through OAM, spaces do not display the language selected on the OAM login page. The Spaces application does not use the same xlf file name standard as OAM.

13.1.14 Announcement Publication Format can be Incorrect in Thai

When the display language is set to Thai, the announcement publication format can be incorrect. This happens when announcements are opened to edit and are then saved, even if nothing in the announcement itself is updated.

13.1.15 Favorite Based on Seeded Page Lost When Language Preference Changed from en-US

If you add a seeded page, such as the Activities page, to your list of Favorites, and then change your preferred application language from en-US using Preferences, the favorite seeded page cannot be found.

13.1.16 Document Permissions Not Honored in Spaces

In some circumstances, permissions on a folder in Content Server that stores the documents for a space may not reflect the permissions set in the Spaces application. In such cases, one or more users may not be able to perform actions on documents in that space, even though they have been assigned appropriate permissions in Spaces.

To resolve this situation when it affects only one user, the space moderator (or a space member assigned Manage Membership permission) can do either of the following:

- Revoke the user's membership to the space, then add them back to the space: in the space administration settings, on the Members page, click Remove Members to revoke membership, then Add People to add them back as members of the space.

- Change the user's role to a different role, then change it back to the required role:in the space administration settings, on the Members page, select the user, then click Change Role.

To resolve this situation when it affects more than one user, the space moderator (or a space member assigned Manage Membership permission) can perform the following steps:

1. Identify the membership role that the affected users have, then edit that role: in the space administration settings, on the Roles page, select the role, then click Edit Permissions.

2. Clear all permissions for the role, and click Save.

3. Edit the role again, select all permissions for the role, and click Save.

13.1.17 The Run as Servlet Link on Producer Test Page Does Not Work for JSF Portlet

You can create a JSF portlet (that is, a portlet that uses the Oracle JSF Portlet Bridge) using the Create JSR 286 Java Portlet Wizard by selecting the Generate ADF-Faces JSPX implementation method on the third step of the wizard.

If you create a JSF portlet in this way, you may find that clicking the Run as Servlet link on the portlet's Producer Test Page produces an error. The portlet itself, however, runs correctly.

To avoid this issue, add the ADF Page Flow scope to the project that contains the portlet.

13.1.18 Documents Service Unavailable

After configuring WebCenter Portal: Spaces to have a active connection to a Content Repository connection (Oracle WebCenter Content: Content Server) and bouncing WebCenter Portal: Spaces, the Documents Service does not appear to be available in Spaces. For example, in the Home space or a space there are no documents available. The cause of the issue is likely to be in the Content Repository connection settings or that the WebCenter Portal data was not successfully seeded into the Content Server.

To resolve this problem:

1. Check that the Content Server is up and running. Ensure the server has the Server Port (intradoc) configured and the Server IP Filter allows connection from WebCenter Portal: Spaces:

1. Log in to the Content Server.

2. Click Administration.

3. Click Configuration for instance name

4. Click the Server Configurations link under System Configuration.

5. Ensure that Server Port is listed and that Server IP Filter allows access from WebCenter Portal: Spaces.

2. Check the Content Repository Connection settings are correct for the Content Server being used for the Document store:

1. Using either WLST or Fusion Middleware Control display the Content Repository Connection settings.

2. Ensure that the connection for the Content Server is marked as the Active Connection or Primary Connection.

3. Ensure that the settings for the Content Server are correct.

4. Ensure that the Content Administrator, Root Folder and Application Name have been specified:

- The Content Administrator must have administration rights in the Content Server. This user will be used to create and maintain folders for spaces content, security groups and roles, and manage content access rights.

- The Root Folder and Application Name must be unique and not used by any other WebCenter Portal: Spaces application using the same Content Server. If you change these values, ensure that both values are changed and not just one of them.

- It is recommended the Application Name is less than 14 characters as it is used as a prefix for items created in Content Server, such as workflows, which have a limit on the length of the item name.

3. Check the log at the time of the WebCenter Portal: Spaces start-up for any errors connecting to the Content Server or seeding the data in the Content Server:

1. When WebCenter Portal: Spaces has an active or primary Content Repository connection and the Content Administrator, Root Folder and Application Name have been specified, then when the WebCenter Portal: Spaces server starts up, data is seeded in the Content Server for that application (if it does not already exist).

2. If both Step 1 and 2 are correct, check the WebCenter Portal: Spaces log for any errors when WebCenter Portal: Spaces is started up. There may be errors when seeding the data in the Content Server.

3. If the log does not show any useful log information, turn up the logging for the Documents server and bounce WebCenter Portal: Spaces to see the log messages regarding seeding the WebCenter Portal: Spaces seed data:

1. Either use the Fusion Middleware Control or edit the logging.xml file to increase the logging for oracle.webcenter.doclib.internal.model and oracle.webcenter.doclib.internal.spaces.

2. Restart WebCenter Portal: Spaces.

3. View the log for any messages regarding the seeding of the WebCenter Portal: Spaces data.

4. If the data is seeded correctly there should be a message logged at TRACE level similar to the following:

Content Server already contains the Space container, therefore no need to seed any data

5. If the seed data does not already exist, there should be a message logged at TRACE level similar to the following:

Creating WebCenter Seeded Data

13.1.19 Granting Permissions Errors in Documents When Creating a Space

On creating a space based on a template with the Documents service, the space creation fails with an error such as the following:

Granting permissions for Documents failed

To resolve this issue, view the WebCenter Portal: Spaces log to see if there are any log messages indicating the source of the error.

If it is not clear what the cause of the error is, try resetting all the Document permissions for all the roles to see if the role mapping completes successfully. Any failures should be logged in the WebCenter Portal: Spaces log.

13.1.20 Using OpenSocial Pagelets to Post Activities to User's Activity Stream

Pagelets based on OpenSocial gadgets are not able to post activities to a user's activity stream. To implement a temporary solution, grant User Profile 'edit' permission to Oracle WebCenter Portal's Pagelet Producer using the following WLST/WSAdmin command:

grantPermission(appStripe="pagelet-producer",
principalClass="oracle.security.jps.internal.core.principals.JpsAuthenticatedRoleImpl", principalName="authenticated-role",
permClass="oracle.webcenter.peopleconnections.profile.security.ProfilePermission",
permTarget="/oracle/webcenter/peopleconnections/profile/s8bba98ff_4cbb_40b8_beee_296c916a23ed/.*", permActions="view,edit")

After running the command, restart the Pagelet Producer server.

13.1.21 Accessing Owners' Profile Information Using the OpenSocial API

To access owners' Profile/Activities/Friends information using the OpenSocial API with Oracle WebCenter Portal's Pagelet Producer, you must target the WebCenterDS data source to the WC_Portlet managed Server as described in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter. After saving this configuration, Activities and Friends information can be fetched, but Profile information is not returned. To access Profile information, restart the WC_Portlet managed server.

13.1.22 Granting View Document Permissions to Public and Authenticated Users for a Hierarchical Space

When you grant the View Document permission to the Public-User and Authenticated-User roles on a hierarchical space, equivalent "Read" permissions are not set correctly in Content Server. If you want public users and authenticated users to have View Document permissions on a space, you do not need to grant the permission to both the roles separately. When you grant the View Document permission to public users, authenticated users inherit the View Document permission automatically.

If you want to revoke View Document permissions from public users but grant View Document permissions to authenticated users, then revoke the permission from the Public-User role and add it for Authenticated-User role.

13.1.23 Issues when Using the Russian or Swedish Language

In the Spaces application when the language is set to Russian, you cannot manage user membership in spaces, including the following: adding a new user to a space, inviting a registered user to a space, and modifying or revoking a user's role assignment.

If the language is set to Swedish, the Roles page under Spaces Administration is not accessible.

13.2 Documentation Errata

This section describes documentation errata. It includes the following topic:

- Section 13.2.1, "Enabling Folders_g Component on Content Server"

13.2.1 Enabling Folders_g Component on Content Server

In Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter, in section "Enabling Mandatory Components", step 7 incorrectly states the following:

"7. Select Folders_g in the Disabled Components list box and click Enable.

After enabling the Folders_g component an alert may appear in Content Server that indicates that the Folders_g component has been deprecated and data can be migrated to the Folders feature. This message can be safely ignored. To disable the message:

a. Go to Admin Server > General Configuration > Additional Configuration Variables.

b. Add DisableFoldersgDeprecationMesssage=1."

No such alert appears on Content Server.

The FrameworkFolders component is not enabled out of the box. If you are using WebCenter Portal, Folders_g must be used as the Foldering component, and not FrameworkFolders.

Part VI

Oracle SOA Suite and Business Process Management Suite

Part VI contains the following chapters:

- Chapter 14, "Oracle SOA Suite, Oracle BPM Suite, and Common Functionality"

- Chapter 15, "Web Services Security and Administration"

14 Oracle SOA Suite, Oracle BPM Suite, and Common Functionality

To view the latest known issues associated with Oracle SOA Suite, BPM Suite, and related SOA technologies, go to Oracle Technology Network (OTN) at http://www.oracle.com/technetwork/middleware/docs/soa-aiafp-knownissuesindex-364630.html. These known issues documents include the following products:

- Oracle Adapter for Oracle Applications (Oracle E-Business Suite Adapter)

- Oracle AIA Foundation Pack

- Oracle Application Adapters for Oracle WebLogic Server

- Oracle Application Server Legacy Adapters

- Oracle B2B

- Oracle BPEL Process Manager

- Oracle Business Activity Monitoring

- Oracle Business Process Management

- Oracle Business Rules

- Oracle Complex Event Processing

- Oracle Enterprise Repository

- Oracle Human Workflow

- Oracle Mediator

- Oracle Service Bus

- Oracle SOA Suite and Oracle BPM Suite Common Functionality

- Oracle Technology Adapters

15 Web Services Security and Administration

This chapter describes issues associated with Web services security and administration, including Oracle Web Services Manager. It includes the following topics:

- Section 15.1, "Using Multibyte User Credentials with wss_http_token_* Policy"

- Section 15.2, "Importing Custom Policies Before Attaching and Deploying to a Service Application"

- Section 15.3, "Performing a Bulk Upload of Policies"

- Section 15.4, "Reviewing Policy Configuration Override Values After Detaching a Client Policy"

- Section 15.5, "Removing Post-deployment Customizations"

- Section 15.6, "Reviewing Localization Limitations"

- Section 15.7, "When Using WLST to Import a Security Policy, the Same Policy May Be Repeatedly Imported"

- Section 15.8, "Identity in WSDLs Is Not Used for Enforcement with ADF DC Applications"

- Section 15.9, "JVM limitation for Kerberos Token Policy with Message Protection Policy"

- Section 15.10, "Fusion Middleware Control Does Not List Policies When Two Servers Are SSL Enabled (Two-way SSL)"

- Section 15.11, "Web Service Test Page Cannot Test Input Arguments Bound to SOAP Headers"

- Section 15.12, "When Adding SAML Issuer From Fusion Middleware Control the jps-config.xml File Is Incorrectly Updated"

- Section 15.13, "Patching of Patch Set 1 WebLogic Server Web Services Attached to Custom Polices With Patch Set 3 Oracle WSM Policy Manager"

- Section 15.14, "Custom Policy Fails When an Empty Subject Is Passed"

- Section 15.15, "Possible Limitation When Using Custom Exactly-one Policies"

- Section 15.16, "Ignore "Services Compatibility" Error for Security Policies Used Between Oracle WSM and WebLogic Server"

- Section 15.17, "Compatible Policies Not Returned When Using JDeveloper Wizard to Attach Oracle WSM Policies to Web Service Client"

- Section 15.18, "SAML Bearer Token Policies Now Signed by Default"

- Section 15.19, "Security Policies Do Not Work on Subscriber Mediator Component"

- Section 15.20, "Policy Table Might Not Show Attached Policies for Some Locales"

- Section 15.21, "Manual Step Required to Uptake Changes in Predefined Policy"

- Section 15.22, "Usage Tracking Not Enabled for WebLogic Web Service Client"

- Section 15.23, "Invalid Authorization Combination Validates Successfully"

- Section 15.24, "Additional Quotes in Fusion Middleware Control for Run-time Constraint Input from WLST"

Note:

See also Section 12.35, "Web Services and XML Issues and Workarounds."

15.1 Using Multibyte User Credentials with wss_http_token_* Policy

In this release, multibyte user credentials are not supported for the wss_http_token_* policies. If multibyte user credentials are required, use a different policy, such as wss_username_token_* policy. For more information about the available policies, see Appendix B "Predefined Policies" in the Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

15.2 Importing Custom Policies Before Attaching and Deploying to a Service Application

It is recommended that you import custom policies before attaching and deploying them to a service application.

If you deploy an application with policies that do not exist in the Metadata Store (MDS), and subsequently import the policies, you need to restart the server for the policy attachment count to be updated.

15.3 Performing a Bulk Upload of Policies

When performing a bulk import of policies to the MDS repository, if the operation does not succeed initially, retry the operation until the bulk import succeeds.

For the most part, this can occur for an Oracle RAC database when the database is switched during the metadata upload. If there are n databases in the Oracle RAC database, then you may need to retry this operation n times.

For more information about bulk import of policies, see "Migrating Policies" in the Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

15.4 Reviewing Policy Configuration Override Values After Detaching a Client Policy

If you attach a policy to a client, override policy configuration values, and subsequently detach the policy, the policy configuration override values are not deleted. When attaching new policies to this client, ensure that you review the policy configuration override values and update them appropriately.

15.5 Removing Post-deployment Customizations

When the connections.xml file is changed after deployment using the AdfConnection MBean, the complete connection is saved as a customization. This means that changes to the connection in a redeployed application are overwritten by the customization.

When you use Fusion Middleware Control to make changes to an application's connections.xml file after deployment, a new connections.xml file is created as a customization and stored in the MDS repository. This customization persists for the life of the application. Therefore, if you redeploy the application, the customized connections.xml file continues to be applied as a customization on the application.

To allow the redeployed application's connections.xml file to be applied without the prior customization (from Fusion Middleware Control), you must explicitly remove the connections.xml customizations from the MDS repository.

For example, if you deploy an application with a Web services data control, then use Fusion Middleware Control to attach the 'username token client policy', and subsequently detach the policy. Then, you return to JDeveloper to edit the application and attach the 'http token client policy', and redeploy the application. When you view the application using Fusion Middleware Control, you see that it is not using the 'http token client policy' that you attached. That is because it is using the customized connections.xml file that you previously created using Fusion Middleware Control.

If you remove the connections.xml customizations from the MDS repository, the application will use the its own connections.xml file.

15.6 Reviewing Localization Limitations

The following information is supported in English only in this release of Oracle Enterprise Manager:

- All fields in the policy and assertion template except the orawsp:displayName field.

- If using the ?orawsdl browser address, the orawsp:description field.

- In the System MBean browser, the Description field in the oracle.wsm.upgrade Mbean.

15.7 When Using WLST to Import a Security Policy, the Same Policy May Be Repeatedly Imported

When WLST is used to import a security policy, be aware that the same policy may be repeatedly imported.

15.8 Identity in WSDLs Is Not Used for Enforcement with ADF DC Applications

For ADF DC applications, the identity extension in a WSDL (for example, the certificate published in the WSDL), cannot be used as a recipient certificate for message protection policies. Instead, either the recipient key alias (declarative configuration override) or the default recipient key alias specified in the policy are used.

15.9 JVM limitation for Kerberos Token Policy with Message Protection Policy

Within a JVM, the Kerberos acquire key works fine when there is only a single Web service principal. If there are additional Web service principals within the same JVM, the acquire key returns null. When a Web service and client exist in different JVMs, this is no longer an issue.

15.10 Fusion Middleware Control Does Not List Policies When Two Servers Are SSL Enabled (Two-way SSL)

When a Managed Server is Two-way enabled SSL (for example, a SOA server hosting Oracle WSM Policy Manager over Two-way SSL) and the Administration Server hosting Fusion Middleware Control is correctly configured to access the Two-way SSL-enabled Managed Server, Fusion Middleware Control still does not list the Oracle WSM policies.

15.11 Web Service Test Page Cannot Test Input Arguments Bound to SOAP Headers

For Web services that have any input arguments bound to SOAP headers, the Test Web Service page in the Fusion Middleware Control console cannot show the message. Therefore, such operations cannot be tested with the Test Web Service page.

For example, if the input for a multi-part WSDL is viewed through Fusion Middleware Control, and one input argument is bound to a SOAP header, the composite instance fails with the following exception because the other part of the message was missing in the input:

ORAMED-01203:[No Part]No part exist with name "request1" in source message

To resolve such an issue, select XML View for Input Arguments and edit the payload to pass input for both parts of the WSDL.

15.12 When Adding SAML Issuer From Fusion Middleware Control the jps-config.xml File Is Incorrectly Updated

In release 11g R1 (11.1.1.1.0), when you try to add or edit a trusted issuer from the Fusion Middleware Control console, then the jps-config.xml file is incorrectly updated. As a workaround for this issue, Oracle recommends upgrading to 11g R1 Patch Set 2 (11.1.1.3.0).

15.13 Patching of Patch Set 1 WebLogic Server Web Services Attached to Custom Polices With Patch Set 3 Oracle WSM Policy Manager

Due to a new feature in 11g R1 Patch Set 2 (11.1.1.3.0), the "Shared policy store for Oracle Infrastructure Web services and WebLogic Server Web services", WebLogic Server Web services now utilize the Policy Manager by default to retrieve policies from the MDS repository. In Patch Set 1, WebLogic Server Web services used classpath mode by default.

After patching your Oracle Fusion Middleware 11g R1 software installation to Patch Set 2, if you have attached a custom Oracle WSM policy to a WebLogic Server Web service, you need to make sure your custom policy is stored in the MDS repository. Note that only custom policies in use need to be migrated. All seed policies will be available in the MDS repository out-of-the-box.

To migrate policies to the Metadata Services (MDS) repository, see "Maintaining the MDS Repository" in the Security and Administrator's Guide for Web Services.

15.14 Custom Policy Fails When an Empty Subject Is Passed

If an empty subject is passed to a custom policy, it fails with a generic error. To work around this issue, you can create and set an anonymousSubject inside the execute method of the custom step. For example:

javax.security.auth.Subject subject =
oracle.security.jps.util.SubjectUtil.getAnonymousSubject();
context.setProperty(oracle.wsm.common.sdk.IMessageContext.SECURITY_SUBJECT,subject)

Note that in this example the context is of Type oracle.wsm.common.sdk.IContext

15.15 Possible Limitation When Using Custom Exactly-one Policies

In some cases, there can be a limitation when using custom Exactly-one policies. For a set of assertions within the exactly-one policy, if a request message satisfies the first assertion, then the first assertion gets executed and a response is sent accordingly. However, this may not be the desired behavior in some cases because the request may be intended for the subsequent assertions.

For example, you may have a client policy that has Timestamp=ON and a service exactly-one policy that has a wss11 username token with message protection assertions: the first has Timestamp=OFF; the second has Timestamp=ON. Therefore, the first assertion in the service exactly-one policy is not expecting the Timestamp in the request, yet the second assertion does expect it. In this case, the first assertion gets executed and the response is sent with no Timestamp. However, the client-side processing then fails because it expects the Timestamp that was sent in the request.

This limitation can exist with any cases where a client policy expects a greater number of elements to be signed and a service policy does not.

15.16 Ignore "Services Compatibility" Error for Security Policies Used Between Oracle WSM and WebLogic Server

Fusion Middleware Control may display a false error message when verifying compatibility of service policies. This incompatibility message is shown when using Enterprise Manager to attach an Oracle WSM Security client policy. Upon clicking the Check Services Compatibility, a message states that policies are incompatible despite the fact that these might be compatible.

Workaround:

If WSM policies are attached at the Web service endpoint, use the corresponding client policy. For example, if the service has wss11_saml_or_username_token_with_message_protection_service_policy, wss11_saml_token_with_message_protection_client_policy or wss11_username_token_with_message_protection_client_policy will work at the client side. If non-WSM policies are attached to the Web Service, see the Interoperability Guide for Oracle Web Services Manager for information about the corresponding client policy and attach it.

15.17 Compatible Policies Not Returned When Using JDeveloper Wizard to Attach Oracle WSM Policies to Web Service Client

During design time, the JDeveloper Wizard's option for Attaching Oracle WSM Policies to Web Service Clients might not return any compatible policies. This can occur due to one of the following reasons:

- There are no compatible client policies corresponding to the service policies published in the WSDL.

- In some cases, when you are trying to determine the compatible client policies in version 11.1.1.4 of JDeveloper running with Fusion Middleware Control Enterprise Manager that correspond to the service policies published in the WSDL of the Web service in version 11.1.1.3 or earlier.

Workaround:

Disable the Show only the compatible client policies for selection option in the JDeveloper Wizard. This will list all the client policies.

If Oracle WSM policies are attached to the Web service, use the corresponding client policy. For example, if the service has the policy wss11_saml_or_username_token_with_message_protection_service_policy, it is safe to assume that wss11_saml_token_with_message_protection_client_policy or wss11_username_token_with_message_protection_client_policy will work at the client side.

If WSM policies are not attached to the Web service, refer to the Interoperability Guide for Oracle Web Services Manager for instructions on determinant the corresponding client policy and attaching it.

15.18 SAML Bearer Token Policies Now Signed by Default

A new property, saml.enveloped.signature.required, is available when configuring wss_saml_token_bearer_over_ssl policies (both client and service). In releases prior to 11.1.1.4, the SAML bearer token was unsigned by default. In the 11.1.1.4 release and later, the SAML bearer token is signed because the default value for the saml.enveloped.signature.required property is true.

To retain the behavior of the releases prior to 11.1.1.4, set the saml.enveloped.signature.required property to false in both the client and service policies. The SAML bearer token is signed using the domain sign key, but it can be overridden using the keystore.sig.csf.key property set in the bearer client policy.

The affected policies are:

- wss_saml20_token_bearer_over_ssl_client_policy

- wss_saml_token_bearer_over_ssl_client_policy

- wss_saml20_token_bearer_over_ssl_service_policy

- wss_saml_token_bearer_over_ssl_service_policy

15.19 Security Policies Do Not Work on Subscriber Mediator Component

Component Authorization denyall policy does not work at subscriber mediator component. Authorization policy works for other normal mediator component cases.

15.20 Policy Table Might Not Show Attached Policies for Some Locales

Select the Web service application in Fusion Middleware Control and navigate to the Web service endpoint. Attach a policy to the endpoint in the Attach/Detach page. Sometimes the Directly Attached Polices table might not display the attached policies for the following locales: zh-cn, zh-tw, ja, pt-br, es, fr, ko.

As a workaround, enlarge the columns.

15.21 Manual Step Required to Uptake Changes in Predefined Policy

The oracle/wss11_saml_or_username_token_with_message_protection_service_policy now includes five assertions as described in "Configuring a Policy With an OR Group" in Oracle Fusion Middleware Security and Administrator's Guide for Web Services:

- wss_saml_token_bearer_over_ssl (new)

- wss_username_token_over_ssl (new)

- wss_http_token_over_ssl (new)

- wss11_saml_token_with_message_protection (existing)

- wss11_username_token_with_message_protection (existing)

To take advantage of these additional assertions, you need to upgrade the Oracle WSM policies in the repository using the resetWSMPolicyRepository(false) WLST command. Note that executing this command will upgrade all of the predefined policies to the latest version provided in 11.1.1.6. For additional information, see "Upgrading the Oracle WSM Policies in the Repository" in Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

15.22 Usage Tracking Not Enabled for WebLogic Web Service Client

In this release, usage tracking and analysis is not provided for WebLogic Java EE Web service clients.

15.23 Invalid Authorization Combination Validates Successfully

Although you can attach multiple authorization policies to the same Web service, you should not attach both a permitall and denyall policy. If you do so, however, the combination validates successfully in this release.

Workaround:

Do not attach a permitall and denyall policy to the same Web service. For more information about authorization policies, see "Authorization Policies and Configuration Steps" in Oracle Fusion Middleware Security and Administrator's Guide for Web Services.

15.24 Additional Quotes in Fusion Middleware Control for Run-time Constraint Input from WLST

When you specify a run-time constraint using WLST, as described in "Specifying Run-time Constraints in Policy Sets" in Oracle Fusion Middleware Security and Administrator's Guide for Web Services, you must specify the constraint using quotes, for example setPolicySetConstraint('HTTPHeader("VIRTUAL_HOST_TYPE", "external")'). If you then use Fusion Middleware Control to view and edit the policy set constraint, the constraint is shown with the quotes in the Constraint Name and Constraint Value fields. You need to remove the quotes in these fields.

Part VII

Communication Services

Part VII contains the following chapters:

- Chapter 16, "Oracle User Messaging Service"

- Chapter 17, "Oracle WebLogic Communication Services"

16 Oracle User Messaging Service

This chapter describes issues associated with Oracle User Messaging Service. It includes the following topics:

- Section 16.1, "General Issues and Workarounds"

- Section 16.2, "Configuration Issues and Workarounds"

- Section 16.3, "Documentation Errata"

16.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 16.1.1, "UMS Schema Purge Script Now Available"

- Section 16.1.2, "Permission Grants for Upgraded Domains"

- Section 16.1.3, "XML File Handle Left Open after Upload Fails"

- Section 16.1.4, "Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server"

- Section 16.1.5, "User Messaging Service URLs Unavailable After Restart"

- Section 16.1.6, "User Preferences User Interface Renders Improperly"

16.1.1 UMS Schema Purge Script Now Available

A UMS schema purge script is available for your download and use. You can access the script and instructions for its use by contacting Oracle Suppotr.

16.1.2 Permission Grants for Upgraded Domains

In order for Oracle User Messaging Service to run as a specific user, a code-based permission grant is required. This grant is pre-seeded in WebLogic domains that are created after the Fusion Middleware 11gR1 Patch Set 2 upgrade.

If you created a WebLogic domain prior to the Patch Set 2 upgrade, you must manually add this grant by running the following Oracle Platform Security Services (OPSS) WLST commands in online (connected) mode:

wls:/mydomain/serverConfig>
grantPermission(codeBaseURL="file:${ums.oracle.home}/communications/modules/oracle.sdp.client_11.1.1/-",
permClass="oracle.security.jps.JpsPermission",permTarget="IdentityAssertion", permActions="execute")

wls:/mydomain/serverConfig>
grantPermission(codeBaseURL="file:${ums.oracle.home}/communications/modules/oracle.sdp.messaging_11.1.1/-",
permClass="oracle.security.jps.JpsPermission",permTarget="IdentityAssertion", permActions="execute")

See Oracle WebLogic Fusion Middleware Scripting Tool Command Reference for information regarding grantPermission

16.1.3 XML File Handle Left Open after Upload Fails

If an error occurs when uploading a user messaging preferences XML file using the WLST manageUserMessagingPrefs command, the XML file handle is left open. On the Microsoft Windows platform, this file cannot be deleted until you exit the WLST shell.

16.1.4 Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server

When no metric data is found (for example when no messages have been sent or received after server setup), the Metrics Performance page will display Unavailable. This is not a problem with the software, and the Performance reporting is operating properly. As soon as Send and Receive traffic exists, the Performance page will display results normally.

16.1.5 User Messaging Service URLs Unavailable After Restart

Upon restarting the User Messaging Service server (usermessagingserver) from Oracle Enterprise Manager Fusion Middleware Control or through Oracle WebLogic Console, you may get an error: Error 503--Service Unavailable when attempting to access any URLs served by the User Messaging Service server, such as the User Preferences UI (/sdpmessaging/userprefs-ui) or the various Web Services endpoints. This error occurs intermittently in cases when the Oracle WebLogic Server is heavily loaded (such as with a SOA instance). To work around this issue:

- Restart the User Messaging Service server again (two or more restarts may be required).

- If multiple User Messaging Service server restarts are not sufficient, then restart the entire Oracle WebLogic Server instance.

16.1.6 User Preferences User Interface Renders Improperly

Intermittent UI rendering errors have been reported in some languages, due to the generation of a corrupted .css file. If you experience problems, follow these steps to work around the issue:

1. Delete the cached, auto-generated .css file for the affected locale (or simply, all locales) on the server located at DOMAIN_HOME/servers/<server_name>/tmp/_WL_user/usermessagingserver/<random_name>/public/adf/styles/cache and restart the usermessagingserver application using Oracle Enterprise Manager Fusion Middleware Control. Have all users clear their browser caches.
The next time the UI is accessed from a browser, a new .css file will be generated for the desired locale, and it is very likely that it will be a valid .css file. If not, repeat this process a couple of times.

2. If the previous solution does not work, disable content compression in the web.xml file of the User Preferences Web Module located at DOMAIN_HOME/servers/<server_name>/tmp/_WL_user/usermessagingserver/<random_name>/sdpmessaginguserprefs-ui-web.war. In particular, extract web.xml, add the following <context-param/> to it:

<context-param>
<param-name>org.apache.myfaces.trinidad.DISABLE_CONTENT_COMPRESSION</param-name>
<param-value>true</param-value>
</context-param>

Then, re-archive it to the war module.

Finally, restart the usermessagingserver application using Oracle Enterprise Manager Fusion Middleware Control.

16.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 16.2.1, "Enable Extension Driver after Upgrade"

- Section 16.2.2, "Preseeded Channel for Worklist and Pop-up Drivers Cannot be Removed"

- Section 16.2.3, "Worklist Driver Configuration"

- Section 16.2.4, "Configure Email Alerts"

- Section 16.2.5, "Migrate Custom Business Terms After PS3 Patch"

- Section 16.2.6, "Use Correct SSL Trust Store When Configuring Drivers"

- Section 16.2.7, "User Messaging Service Driver Configuration Changes Not Immediately Effective"

- Section 16.2.8, "Email Notifications Sent Even if You Do Not Change Default Parameters in driverconfig.xml"

16.2.1 Enable Extension Driver after Upgrade

When you upgrade to the current release, you must complete the following manual configuration steps in order to enable use of the Extension driver:

1. Stop all servers it the domain.

2. Add this .jar file to the classpath of the domain:

$UMS_ORACLE_HOME/communications/modules/usermessaging-config_11.1.1.jar

This can be done by modifying the setDomainEnv.sh/setDomainEnv.cmd in the domain's bin folder. That is, the POST_CLASSPATH variable is updated like this:

POST_CLASSPATH="${UMS_ORACLE_HOME}/communications/modules/usermessaging-config_11.1.1.jar${CLASSPATHSEP}${POST_CLASSPATH}"export POST_CLASSPATH

3. From the template .jar file at $UMS_ORACLE_HOME/common/templates/applications/oracle.ums_template_11.1.1.jar extract the .xml files:

/config/fmwconfig/usermessagingconfig.xml
/config/fmwconfig/mbeans/ums-mbeans.xml

4. Copy these two .xml files into the domain's config and fmwconfig folders:

$DOMAIN_HOME/config/fmwconfig/usermessagingconfig.xml
$DOMAIN_HOME/config/fmwconfig/mbeans/ums-mbeans.xml

5. Start the servers.

6. Deploy the UMS Extension Driver by executing the WLST driver deployment command. For example:

wls:/emsoa/serverConfig> deployUserMessagingDriver(baseDriver='extension',appName='extension', targets='soa_server1')

The UMS Extension Driver is now enabled.

16.2.2 Preseeded Channel for Worklist and Pop-up Drivers Cannot be Removed

If you deinstall the Worklist or Pop-up driver, the preseeded channel for these drivers cannot be removed. The preseeded channel will remain available in your preference list.

16.2.3 Worklist Driver Configuration

While following the Worklist Driver configuration instructions, you may see that Oracle User Messaging Service for SOA in the Configuration Wizard is not selected, leading you to think that it is not configured and that you must select and configure it. This is not the case. The basic Oracle User Messaging Service is already configured, along with a few UMS drivers.

Continue to follow the documented instructions, and disregard the fact that the Oracle User Messaging Service for SOA option is unselected.

16.2.4 Configure Email Alerts

There is an issue with the default environment settings on Windows related to keystore which prevents UMS from connecting securely to Beehive. To fix this issue:

1. Modify setDomainEnv.sh to remove SSL config.

2. Restart the env.

16.2.5 Migrate Custom Business Terms After PS3 Patch

After installing the PS3 patch, you must re-create any custom-built business terms using Oracle Enterprise Manager Fusion Middleware Control. A copy of the custom-built business terms is available at: $DOMAIN_HOME/config/fmwconfig/servers/<ServerName>/applications/usermessagingserver/configuration/businessterms.xml.bak

Restart your servers after making any changes!

Note:

New, pre-seeded business terms have been introduced in this release. Do not overwrite the upgraded (PS3) file with a PS1 backup (the new terms will be lost, otherwise).

16.2.6 Use Correct SSL Trust Store When Configuring Drivers

Before configuring any User Messaging Service Driver (such as the Email Driver), to connect to a remote gateway using SSL, ensure that the SSL Trust Store is properly configured as described in "Configure Keystores" in Oracle Fusion Middleware Oracle WebLogic Server Administration Console Online Help.

Ensure that the value of the JVM system property (javax.net.ssl.trustStore) set in $DOMAIN_HOME/bin/setDomainEnv.sh (or Windows equivalent file) points to the correct trust store that you want to use.The Java Standard Trust Store is located at:

$JAVA_HOME/jre/lib/security/cacerts or $BEA_JAVA_HOME/jre/lib/security/cacerts

Note that with the default out-of-the-box configuration of SSL trust store, the UMS driver will not be able to connect to the Oracle Beehive Email Server over SSL. To resolve this issue, follow the instructions for using the correct SSL trust store. Replacing the DemoTrust keystore in the setDomainEnv.sh file (or Windows equivalent file) with the Java Standard SSL trust store will enable UMS email driver to connect successfully over SSL to the Oracle Beehive Email Server.

16.2.7 User Messaging Service Driver Configuration Changes Not Immediately Effective

When you change a driver's configuration and then restart the driver, the changes will not take effect until all managed connections in the pool are destroyed (900 seconds [15 minutes] by default). Take one of these actions to ensure that the connections are destroyed:

- When performing driver configuration changes, stop the driver application and wait for 15 minutes. Then re-start the driver application.

Note:

If you follow this recommendation and the wait time of 900 seconds (15 minutes) is too long, you can reduce the time using the Oracle WebLogic Server Administration Console as follows:

1. Click Deployments.

2. Select the desired User Messaging Service Driver deployment.

3. Click the Resource Adapter Type module.

4. Click Configuration > Outbound Connection Pools.

5. Click the DriverConnectionFactory group.

6. Click Connection Pool.

7. Edit the value of Shrink Frequency Seconds (for example, set to 120 seconds).

8. Click Save, and save the changes to a deployment plan file when prompted.

9. Restart the User Messaging Service driver deployment to include the new plan.

Remember that if Shrink Frequency is reduced to a short interval, it may eventually have a negative impact on the performance of the driver as idle connections will be recycled frequently.

OR

- Restart the entire Oracle WebLogic Server after performing driver configuration changes. The new changes will take effect immediately upon server re-start.

16.2.8 Email Notifications Sent Even if You Do Not Change Default Parameters in driverconfig.xml

Instructions for notification configuration include setting your outgoing server parameters. Please note that if you do not change the parameters (that is, if you leave the default setting unchanged), notifications may still be sent. This is expected behavior, but you should not rely on the default settings without verifying them. You should set your parameters to ensure that they are correct.

16.3 Documentation Errata

This section contains the documentation errata for the User Messaging Service online documentation.

16.3.1 Wrong URL for Sample Codes in the Online Documentation

The links to the UMS sample codes provided in the Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite are wrong.

You can download the sample codes from the following URL:

http://www.oracle.com/technetwork/indexes/samplecode/index.html

17 Oracle WebLogic Communication Services

This chapter describes issues associated with Oracle WebLogic Communication Services (OWLCS). It includes the following topics:

- Section 17.1, "General Issues and Workarounds"

- Section 17.2, "Configuration Issues and Workarounds"

- Section 17.3, "Documentation Errata"

17.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 17.1.1, "Active SIP Session and APP Session Count Show as -1 in Clustered Configuration"

- Section 17.1.2, "Oracle WebLogic Server Pack/Unpack Tool Does Not Function in OWLCS"

- Section 17.1.3, "Oracle WebLogic Server Cloning Tool Does Not Function in OWLCS"

- Section 17.1.4, "Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server"

17.1.1 Active SIP Session and APP Session Count Show as -1 in Clustered Configuration

In the Administration Console, the Monitoring -> General tab displays Undefined for the Active SIP Session Count and Active Application Session Count attributes when monitoring a replicated WebLogic SIP Server deployment. There is currently no workaround for this problem.

17.1.2 Oracle WebLogic Server Pack/Unpack Tool Does Not Function in OWLCS

The Pack/Unpack tool in Oracle WebLogic Server does not work in this OWLCS release. There is no workaround currently available.

17.1.3 Oracle WebLogic Server Cloning Tool Does Not Function in OWLCS

The Cloning tool in Oracle WebLogic Server does not work in this OWLCS release. There is no workaround currently available.

17.1.4 Messages Metrics Rendered as Unavailable in the Performance Page for User Messaging Server

When no metric data is found, for example when no messages have been sent or received after server setup, the Metrics Performance page will display Unavailable. This is not a problem with the software, and the Performance reporting is operating properly. As soon as Send and Receive traffic exists, the Performance page will display results normally.

17.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 17.2.1, "Launch_sash Option Error"

- Section 17.2.2, "Same User Who Installed WLS/WLSS Product Must Perform Uninstall"

- Section 17.2.3, "Uppercase Usernames Cause Reregistration and Presence Subscription Failures"

- Section 17.2.4, "Running the uninstall.sh Script in Text Mode Does Not Uninstall the Product"

- Section 17.2.5, "SIP Monitor in F5 Networks BigIP Does Not Work in UDP Mode"

- Section 17.2.6, "SIP Container Does Not Bind to IPV6 Interfaces for Listening on Windows"

- Section 17.2.7, "JAWS Unable to Read Some Install Screens"

- Section 17.2.8, "Configure VoiceXML Driver Receive URLs Correctly"

17.2.1 Launch_sash Option Error

An error has been reported when using the launch_sash command with the -e option. For example:

MW_HOME/user_projects/domains/base_domain/bin/launch_sash.sh -p 8001 -n weblogic -w welcome1 -a presenceapplication -e "xcap appusage list"

does not properly process the xcap appusage list argument because the double quote (") is mishandled.

To work around this problem, issue the command at the sash prompt directly.

17.2.2 Same User Who Installed WLS/WLSS Product Must Perform Uninstall

In order to perform a clean uninstall, ensure that the same user (privileges) who accomplished the install also accomplishes the uninstall.

17.2.3 Uppercase Usernames Cause Reregistration and Presence Subscription Failures

When a user is created with an uppercase username, then the following occurs:

- Initial registration progresses normally, resulting in successful registration with Oracle Communicator.

- Presence subscriptions fails.

- After a few minutes, Oracle Communicator displays Server Refused Registration (403).

- User's account is locked and sign-in is blocked for 30 minutes.

To work around this issue, set Trusted Authentication Hosts for the SIP Container by doing the following (from the Administration Console):

1. Click SipServer in the left pane.

2. Click the SIP Security tab.

3. In Trusted Authentication Hosts, add the IP address of your server (that is running OWLCS).

4. Save and restart OWLCS.

Note:

Using this workaround, presence functionality will fail for clients running on the same machine as the OWLCS server. Such cases (both Oracle Communicator and server running on the same machine) are mostly for demonstration and development environments. For these cases, ensure you create users with lowercase usernames.

Reregistration and presence subscription failures can also occur when users are created with privateId being different than the username part of the publicId.

For example, if privateId is test.user1 and publicId is sip:test.user1@example.com, everything works because test.user1 is the username part of the publicId sip:test.user1@example.com.

But if privateId is tuser1 and publicId is sip:test.user1@example.com, the username part of the publicId is not the same as privateId. In this case, the first registration succeeds with Oracle Communicator, but reregistrations and presence subscriptions fail. Apply the same workaround (configure trusted host as described above) to resolve this issue.

17.2.4 Running the uninstall.sh Script in Text Mode Does Not Uninstall the Product

Perform uninstallation using the Administration Console to ensure that all components are uninstalled. Ensure that you use the same user privilege as when you installed.

17.2.5 SIP Monitor in F5 Networks BigIP Does Not Work in UDP Mode

When using the F5 Networks BigIP load balancer for a cluster of SIP engines and the SIP monitor in BigIP is used for failure detection, it must be configured to operate (sending OPTIONS requests) over TCP and not UDP. UDP mode will not work (the pool will indicate that the servers are down).

17.2.6 SIP Container Does Not Bind to IPV6 Interfaces for Listening on Windows

Due to limitations in the Windows IPv6 stack, the SIP Container cannot bind to IPv6 sockets for listening.

17.2.7 JAWS Unable to Read Some Install Screens

Due to an issue with the OWLCS Core Platform CIE-based installer, the JAWS tool cannot correctly read the installation screens. To work around this issue, you must run the installer in silent mode. For information on Silent Mode installation, see Oracle WebLogic Communication Services Installation Guide.

17.2.8 Configure VoiceXML Driver Receive URLs Correctly

In a clustered (high-availability) environment with Oracle HTTP Server (OHS) configured, do not use the OHS port to configure the VoiceXML Driver Receive URLs. Using the OHS port to configure the VoiceXML Driver Receive URLs will cause a conflict with the drivers.

Each Voice XML Driver must be configured with its own WLS server's port (as described in the parameters' documentation).

17.3 Documentation Errata

This section details changes to the documentation since the last release. Topics include:

- Section 17.3.1, "Create a Basic SIP Domain"

- Section 17.3.2, "Create a Custom AUID with OCP (Presence)"

- Section 17.3.3, "Cannot Create a SIP Server Domain Using Default WebLogic Platform Components"

- Section 17.3.4, "Broken Documentation Links in Some (SIP Server) Translated Files"

- Section 17.3.5, "Missing (SIP Server) Online Help Regarding Security Providers"

17.3.1 Create a Basic SIP Domain

Directions for creating a basic SIP Domain have changed slightly in this release. Please ensure that you follow these steps:

1. Start the configuration wizard located at WLS_HOME/wlserver_10.3/common/bin/config.sh. This location has changed since the last release.

2. Select Create a New WebLogic Domain, and click Next.

3. Select Basic WebLogic SIP Server Domain, and click Next.
The rest of the process remains the same as before when creating a WLS Domain.

17.3.2 Create a Custom AUID with OCP (Presence)

Follow these steps to create custom AUIDs:

1. View the XML file for presence rules (presrules_au.xml). It is found in one of the following locations, depending on your installation:

$ORACLE_HOME/j2ee/ocms/config/sdp/xcap

$ORACLE_HOME/j2ee/home/config/sdp/xcap

The file contains the following:

- Name of the application (pres-rules)

- Mime type

- User Quota

- List of schemas associated with the application's XML files

2. Create a similar file for the new application usage

3. For all the XSD files listed in the XML file above, create the XSD files and copy them to the XCAP config location mentioned in Step 1 above.

4. cd $ORACLE_HOME/sdp/bin

5. ./launch_sash.sh -a presenceapplication

6. Provide admin credentials. At the sash prompt enter:

xcap appusage create applicationUsage=<new application usage name>
configurationFilename=<name of application usage XML file>

For instance, this command was run to create the pres-rules application usage:

xcap appusage create applicationUsage=pres-rules
configurationFilename=presrules_au.xml

7. To provision users for the new application usage, at the sash prompt enter:

xcap user add userName=<string> applicationUsage=<new application usage name>
.
<string> is of the form username@example.com (replace example.com with domain
for the deployment)

17.3.3 Cannot Create a SIP Server Domain Using Default WebLogic Platform Components

When running config.sh for SIP Server domain configuration, you can choose whether to use WebLogic Platform Components or a Custom Template. The default for Select Domain Source is to use WebLogic Platform Components. In previous releases, this selection worked, but does not in this release. You must select Custom Template in order to create a SIP Server domain.

17.3.4 Broken Documentation Links in Some (SIP Server) Translated Files

Some links to additional documentation were removed in the English language version, but broken links in translated (languages other than English) have been reported. These broken links are being addressed.

17.3.5 Missing (SIP Server) Online Help Regarding Security Providers

Online Help regarding Security Providers is not included. Oracle SIP Server, including information about security providers, is licensed and documented through OCCAS. Please consult your OCCAS documentation for more information.

Part VIII

Oracle Identity Management

Part VIII contains the following chapters:

- Chapter 18, "Oracle Access Manager"

- Chapter 19, "Oracle Adaptive Access Manager"

- Chapter 20, "Oracle Authentication Services for Operating Systems"

- Chapter 21, "Oracle Directory Integration Platform"

- Chapter 22, "Oracle Entitlements Server"

- Chapter 23, "Oracle Identity Federation"

- Chapter 24, "Oracle Identity Manager"

- Chapter 25, "Oracle Identity Navigator"

- Chapter 26, "Oracle Internet Directory"

- Chapter 27, "Oracle Platform Security Services"

- Chapter 28, "SSL Configuration in Oracle Fusion Middleware"

- Chapter 29, "Oracle Virtual Directory"

18 Oracle Access Manager

This chapter describes issues associated with Oracle Access Manager 11g Release 1 (11.1.1). It includes the following topics:

- Section 18.1, "Patch Requirements"

- Section 18.2, "General Issues and Workarounds"

- Section 18.3, "Configuration Issues and Workarounds"

- Section 18.4, "Oracle Security Token Service Issues and Workarounds"

- Section 18.5, "Integration and Inter-operability Issues and Workarounds"

- Section 18.6, "Oracle Access Manager with Impersonation Workarounds"

- Section 18.7, "Documentation Errata"

18.1 Patch Requirements

This section describes patch requirements for Oracle Access Manager 11g Release 1 (11.1.1). It includes the following sections:

- Section 18.1.1, "Plain Text Credentials Exposed in Diagnostic Logs when Creating an Identity Store"

See Also:

- Oracle Technology Network for details about the latest supported versions and platforms:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

- Oracle Fusion Middleware Patching Guide for details about the latest patch set

- My Oracle Support at the following URL for the latest Oracle Access Manager 11g Release 1 (11.1.1) bundle patches and related release notes:

https://support.oracle.com/

18.1.1 Plain Text Credentials Exposed in Diagnostic Logs when Creating an Identity Store

To work around this issue:

1. Go to My Oracle Support at
http://support.oracle.com

2. Click the Patches & Updates tab, and search for bug 9824531.Download the associated patch and install it by following the instructions in the README file included with the patch.

3. On the Patches & Updates tab, search for bug 9882205. Download the associated patch and install it by following the instructions in the README file included with the patch.

18.2 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topic:

- Section 18.2.1, "Replacing oamreg Scripts with Remote Registration Home."

- Section 18.2.2, "Incorrect SSO Agent Date/Time Shown to User"

- Section 18.2.3, "The oamreg.sh File Missing Execute Permission After Configuring"

- Section 18.2.4, "Initial Messages After Webgate Registration Are Not Shown in the User's Locale"

- Section 18.2.5, "Error While Browsing Resources Table in the Resource Type Tab"

- Section 18.2.6, "Single-Click to Open Child Node is Not Supported in the Navigation Tree"

- Section 18.2.7, "User Credential for Registration Tool Does Not Support Non-ASCII Characters on Native Server Locale"

- Section 18.2.8, "Turkish and Greek Character Issues on Oracle Access Manager Authentication Page"

- Section 18.2.9, "Oracle Access Manager Authentication Does Not Support Non-ASCII Passwords on Locales Other than UTF8"

- Section 18.2.10, "Error Message of Create Agent Shows as Server Locale"

- Section 18.2.11, "Referrals in LDAP Searches"

- Section 18.2.12, "Diagnostic Information Is Not Being Displayed on the Administration Console"

- Section 18.2.13, "Non-ASCII Resources Require OHS To Restart To Make Protection Take Effect"

- Section 18.2.14, "Non-ASCII Characters on Success/Failure URL Results in Garbled Redirect URL"

- Section 18.2.15, "Resource with Non-ASCII Characters Cannot Be Protected by an OSSO Agent"

- Section 18.2.16, "Error in Administration Server Log from Console Logins"

- Section 18.2.17, "Translation Packages Use the Term, Agents, Instead of WebGates."

- Section 18.2.18, "Application Domain Subtree in the Navigation Tree Is Not Rendered and Does Not Respond to User Actions"

- Section 18.2.19, "Error in the "Evaluate Single Sign-On Requirements" Help Topic"

- Section 18.2.20, "editWebgateAgent Command Does Not Give An Error If Invalid Value is Entered"

- Section 18.2.21, "WLST Command displayWebgate11gAgent In Offline Mode Displays the Webgate Agent Entry Twice"

- Section 18.2.22, "Message Logged at Error Level Instead of at INFO When Servers in Cluster Start"

- Section 18.2.23, "Help Is Not Available for WLST Command registeroifdappartner"

- Section 18.2.24, "User Must Click Continue to Advance in Authentication Flow"

- Section 18.2.25, "After Remote Registration: Click Refresh Domain Twice to Display Changes."

- Section 18.2.26, "OCSP-Related Fields are Not Mandatory"

- Section 18.2.27, "Database Node is Absent in the Console"

- Section 18.2.28, "Online Help Provided Might Not Be Up To Date"

- Section 18.2.29, "Agent Key Password Should Be Mandatory for Both the Console and Remote Registration Tool in Cert Mode."

- Section 18.2.30, "Oracle Access Manager Audit Report AUTHENTICATIONFROMIPBYUSER Throws a FROM Keyword Not Found Where Expected Error."

- Section 18.2.31, "Disabled: Custom Resource Types Cannot be Created"

- Section 18.2.32, "Oracle Access Manager IAMSuiteAgent Provides SSO to Most IDM domain consoles."

- Section 18.2.33, "Use of a Non-ASCII Name for a Webgate Might Impact SSO Redirection Flows"

- Section 18.2.34, "Authentication Module Lists Non-Primary Identity Stores"

- Section 18.2.35, "Unable to Stop and Start OAM Server Through Identity and Access Node in Fusion Middleware Control."

- Section 18.2.36, "ADF Applications Using ADF Security Fail to Work in Oracle Access Manager 11g."

- Section 18.2.37, "AdminServer Won't Start if the Wrong Java Path Given with WebLogic Server Installation."

- Section 18.2.38, "Changing UserIdentityStore1 Type Can Lock Out Administrators."

- Section 18.2.39, "Page Layouts and Locales."

- Section 18.2.40, "Some Pages Are Not Correctly Localized."

- Section 18.2.41, "Non-ASCII Query String Issues with Internet Explorer v 7, 8, 9."

- Section 18.2.42, "Oracle Virtual Directory with SSL Enabled."

- Section 18.2.43, "Test to Production Files Locked on Windows."

- Section 18.2.44, "Query String Not Properly Encoded."

18.2.1 Replacing oamreg Scripts with Remote Registration Home

IM_ORACLE_HOME/oam/server/rreg/bin contains the scripts (oamreg.bat and oamreg.sh) for performing remote registration. Prior to execution, the scripts need to be edited to point the attribute OAM_REG_HOME to the absolute file location for RREG HOME.

RREG_HOME will be one directory above where the scripts exist.

For example,

If IM_ORACLE_HOME in a particular Linux environment is:

MW_HOME/Oracle_IDM

The entry for the attribute OAM_REG_HOME in oamreg.sh will be:

export OAM_REG_HOME=MW_HOME/Oracle_IDM/oam/server/rreg

18.2.2 Incorrect SSO Agent Date/Time Shown to User

The default start date on the Create OAM Agent page is based on the Oracle Access Manager server date/time. The date/time shown to the end user is based on the Oracle Access Manager server time zone rather than on the user's machine.

18.2.3 The oamreg.sh File Missing Execute Permission After Configuring

Out of the box, execute permissions are not set for the oamreg.sh and oamreg.bat files in the Oracle Access Manager install location. Before you perform remote registration (rreg), you need to set the execute permissions on the scripts by using the following commands:

chmod +x oamreg.sh   OR  chmod +x oamreg.bat

Then, you can proceed with the regular remote registration steps.

18.2.4 Initial Messages After Webgate Registration Are Not Shown in the User's Locale

After Webgate registration, the description fields in the initial messages for related components are not shown in the user's locale.

The description field does not support Multilingual Support (MLS).

18.2.5 Error While Browsing Resources Table in the Resource Type Tab

While browsing across the Resources table in the Resource Type tab, the following error message is displayed:

<Error> <oracle.adfinternal.view.faces.model.binding.CurrencyRowKeySet>
<BEA-000000> <ADFv: Rowkey does not have any primary key attributes. Rowkey:
oracle.jbo.Key[], table: model.ResTypeVOImpl@620289.>

This message is harmless and does not hinder any functionality.

18.2.6 Single-Click to Open Child Node is Not Supported in the Navigation Tree

Single-click to open a child node in the navigation tree is not supported, but double-click is supported.

18.2.7 User Credential for Registration Tool Does Not Support Non-ASCII Characters on Native Server Locale

The user credential for the Oracle Access Manager registration tool oamreg.sh/oamreg.bat does not support non-ASCII characters on the Linux Non-UTF8 server locale and the Windows native server.

18.2.8 Turkish and Greek Character Issues on Oracle Access Manager Authentication Page

In some cases if a user has Turkish, German, or Greek special characters in the user name and the login name only differs in the special characters, he might pass authentication because of case mappings and case-insensitivity.

Some internationalization characters should have special capitalization rule so that characters do not convert back to the lower case.

For example, there is the case with SS and ß in German, where ß only exists as a lower case character. When performing "to Upper" against ß, ß will be changed to SS. And if the upper case text is then converted back to lower case, the SS becomes ss and not the original ß.

18.2.9 Oracle Access Manager Authentication Does Not Support Non-ASCII Passwords on Locales Other than UTF8

When the server locale is not UTF-8 and using WebLogic Server embedded LDAP as an identity store, the SSO Authentication page does not support Non-ASCII passwords.

18.2.10 Error Message of Create Agent Shows as Server Locale

When an administrator creates an agent with the same name as one that already exists, the language of the error message displayed is based on the server locale rather than on the browser locale.

18.2.11 Referrals in LDAP Searches

Oracle Access Manager 11g Release 1 (11.1.1) cannot operate directly with LDAP servers returning referrals.

The workaround is to use Oracle Virtual Directory.

18.2.12 Diagnostic Information Is Not Being Displayed on the Administration Console

Diagnostic information is not displayed in the Oracle Access Manager Console for monitoring Agents when one or more nodes of the cluster are down.

This information can be retrieved using the Oracle Dynamic Monitoring Service (DMS). The steps are as follows:

1. Using WebLogic credentials, log in to the DMS application
http://<adminserver-host>:<adminserver-port>/dms

2. On the navigation tree, click OAMS.OAM_Server.OAM_Agents under the DMS Metrics node.

18.2.13 Non-ASCII Resources Require OHS To Restart To Make Protection Take Effect

When you add a resource with a non-ASCII name to the protected authentication policy, it will require the 11g OHS Server to restart to make the protection take effect, whereas in adding resources with English characters, protection takes effect in real time without having to restarting the OHS Server.

18.2.14 Non-ASCII Characters on Success/Failure URL Results in Garbled Redirect URL

If an on success or on failure URL configured for an authentication policy contains non-ASCII characters in the URL specified, then the URL specified will be garbled when it is used during a user authentication. This will happen only when the authentication scheme is Basic Authentication and the end user's browser is the Simplified Chinese version of IE8 running on the Chinese version of Windows.

18.2.15 Resource with Non-ASCII Characters Cannot Be Protected by an OSSO Agent

The OSSO Agent cannot protect a resource because it does not encode the entire resource URL to UTF-8 format.

To work around this issue, use the Webgate Agent instead of the SSO Agent.

Webgate is able to convert the entire resource URL to UTF-8 format.

18.2.16 Error in Administration Server Log from Console Logins

If you log in to the Oracle Access Manager Console as an administrator and then log in to the Console as an administrator in a new browser tab, the following error appears in the administration logs:

------------------------------------------------------------
<May 20, 2010 10:12:47 AM PDT> <Error>
<oracle.adfinternal.view.page.editor.utils.ReflectionUtility> <WCS-16178>
<Error instantiating class -
oracle.adfdtinternal.view.faces.portlet.PortletDefinitionDTFactory>
------------------------------------------------------------

The error message does not impact functionality.

18.2.17 Translation Packages Use the Term, Agents, Instead of WebGates

The term Agents has been changed to WebGates.

The issue is that because of this late change, the translation packages are not updated and will continue to use the term, Agents, instead of the preferred term, WebGates.

18.2.18 Application Domain Subtree in the Navigation Tree Is Not Rendered and Does Not Respond to User Actions

If the Application Domain subtree on the navigation tree does not render or respond to user interface actions over a period of time, it may be the result of multiple refreshes.

To work around these issues, restart the administration server and log in to the Oracle Access Manager Console again.

18.2.19 Error in the "Evaluate Single Sign-On Requirements" Help Topic

In the help topic, "Evaluate Single Sign-On Requirements," "Configuring Single Logout for 10g Webgate with OAM 11g Servers" was listed twice under "Review steps to configure single sign-off."

The English version has been corrected to read:

"Step 7 Review steps to configure single sign-off

- Configuring Single Logout for 10g Webgate with OAM 11g Servers. More.

- Configuring Single Logout for 11g Webgate with OAM 11g Servers. More.

- Configuring Single Logout for Oracle ADF Applications. More

The translated version will be fixed.

18.2.20 editWebgateAgent Command Does Not Give An Error If Invalid Value is Entered

The WLST command editWebgateAgent does not give an error when a invalid value is entered for the state field in both online and offline mode. The Oracle Access Manager Console does show the state field value as neither enabled nor disabled, though it is a mandatory field.

18.2.21 WLST Command displayWebgate11gAgent In Offline Mode Displays the Webgate Agent Entry Twice

In the offline mode, the WLST command, displayWebgate11gAgent, displays the 11g Webgate Agent entry in the System Configuration tab twice.

18.2.22 Message Logged at Error Level Instead of at INFO When Servers in Cluster Start

When starting Oracle Access Manager servers in a cluster, the following message is displayed:

<Jun 22, 2010 3:59:41 AM PDT> <Error> <oracle.jps.authorization.provider.pd>
<JPS-10774> <arme can not find state.chk file.>

The correct level of the message is INFO, rather than Error.

18.2.23 Help Is Not Available for WLST Command registeroifdappartner

The Help command is not available for the WLST command, registeroifdappartner.

The online and offline command registers Oracle Identity Federation as a Delegated Authentication Protocol (DAP) Partner.

For information, refer to "registerOIFDAPPartner" in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

Syntax

registerOIFDAPPartner(keystoreLocation="/scratch/keystore"
logoutURL="http://<oifhost>:<oifport>/fed/user/sploosso?doneURL=
http://<oamhost>:< oam port>/ngam/server/pages/logout.jsp",
rolloverTime="526")

Parameter Name

Definition

keystoreLocation

Location of the Keystore file. The file generated at the OIF Server. (mandatory)

logoutURL

The OIF Server's logout URL. <mandatory>

rolloverInterval

The Rollover Interval for the keys used to enc/decrypt SASSO Tokens (optional)

Example

The following invocation illustrates use of all parameters.

registerOIFDAPPartner(keystoreLocation="/scratch/keystore",
logoutURL="http://<oifhost>:<oifport>/fed/user/sploosso?doneURL=http://<oamhost>:
<oam port>/ngam/server/pages/logout.jsp", rolloverTime="526")

18.2.24 User Must Click Continue to Advance in Authentication Flow

In a native integration with Oracle Adaptive Access Manager, the resource is protected by an Oracle Access Manager policy that uses the Basic Oracle Adaptive Access Manager authentication scheme.

When a user tries to access a resource, he is presented with the username page.

After he enters his username, he must click Continue before he can proceed to the password page. He is not taken to this page automatically.

The workaround is for the user to click Continue, which might allow him to proceed to the password page.

18.2.25 After Remote Registration: Click Refresh Domain Twice to Display Changes

After performing rreg (through the console/rreg scripts), the user must click the Refresh button twice on the Policy Configuration tab for any policy-related changes to be visible.

18.2.26 OCSP-Related Fields are Not Mandatory

In the X509 authentication modules, the following OCSP-related fields are no longer mandatory:

- OCSP Server Alias

- OCSP Responder URL

- OCSP Responder Timeout

If OCSP is enabled

The OCSP-related fields should be filled in by the administrator. If they are not filled, there will not be an error from the Console side.

It is the responsibility of the administrator to provide these values.

If OCSP is not enabled

The OCSP-related fields need not be filled in this case. If there are values for these fields, they will be of no consequence/significance, as OCSP itself is not enabled.

In the default out of the box configuration, the OCSP responder URL is http://ocspresponderhost:port. If you make changes to other fields and leave this as is, you will see a validation error, since this value is still submitted to the back end and at the Console, the layer port should be a numeric field. You can either modify the field, with the port being a numeric field or delete the entire value.

18.2.27 Database Node is Absent in the Console

Under the Data Sources node of the System Configuration tab, Common Configuration section, there is no Databases node in Oracle Access Manager 11g (11.1.1.5).

18.2.28 Online Help Provided Might Not Be Up To Date

Online help is available in the Oracle Access Manager Console, but you should check OTN to ensure you have the latest information.

18.2.29 Agent Key Password Should Be Mandatory for Both the Console and Remote Registration Tool in Cert Mode

Providing the Agent Key Password during registration should be mandatory for both the Oracle Access Manager Console and the Remote Registration tool. Currently it is mandatory for one and not the other.

When registering the 11g Webgate in cert mode through the remote registration tool, the Agent Key Password must be provided. If it is not, the password for cert mode cannot be null. Please enter the valid password message is shown.

The Agent Key Password is not mandatory when registering the 11g Webgate in cert mode through the Oracle Access Manager Console. The password.xml is generated regardless of whether the Agent Key Password is provided or not.

18.2.30 Oracle Access Manager Audit Report AUTHENTICATIONFROMIPBYUSER Throws a FROM Keyword Not Found Where Expected Error

The Oracle Access Manager audit report AuthenticationFromIPByUser uses an Oracle Database 11.2.0 feature and will not work with older versions of database. The following error is displayed if an older version is used:

ORA-00923: FROM keyword not found where expected

18.2.31 Disabled: Custom Resource Types Cannot be Created

For Oracle Access Manager 11g, creating custom resource types should not be attempted. In the initial release, the buttons to create/edit/delete resource types were available.

With Oracle Access Manager 11g (11.1.1.5) these command buttons are disabled. Oracle provided resource types include:

- HTTP (includes HTTPS)

- TokenServiceRP (Resources for representing Token Service Relying Party)

- wl_authen (Resources for representing WebLogic Authentication schemes)

18.2.32 Oracle Access Manager IAMSuiteAgent Provides SSO to Most IDM domain consoles

The Oracle Access Manager IAMSuiteAgent replaces IDM Domain Agent and IAM Suite replaces IDMDomainAgent Application Domain.

IAMSuiteAgent provides Single-Sign On for the IDM domain consoles including the Oracle Identity Manager, Oracle Adaptive Access Manager and other Identity Management servers created during domain creation. It excludes Single-Sign On protection for Fusion Middleware Control and the WebLogic Server Administration Console.

18.2.33 Use of a Non-ASCII Name for a Webgate Might Impact SSO Redirection Flows

When using the OAM Server with WebGates and when the Webgate ID is registered with a non-ASCII name, the OAM Server may reject that authentication redirect as an invalid request.

To work around this redirection issue, use an ASCII name for the Webgate.

Note:

Resources are protected and error messages do not occur when the administration server and oracle access servers are started on UTF-8 locales.
The redirection issue only occurs on native server locales (Windows and Non-UTF8 Linux server locales)

18.2.34 Authentication Module Lists Non-Primary Identity Stores

In the user interface under the Authentication Module, only the primary identity store should be selected in the list since only primary identity stores can be used for authentication/authorization. Currently, the Oracle Access Manager Console allows you to select identity stores that are not primary.

18.2.35 Unable to Stop and Start OAM Server Through Identity and Access Node in Fusion Middleware Control

The following Oracle Access Manager operations are not supported through using the oam_server node under Identity and Access in Fusion Middleware Control:

- Start up

- Shut down

- View Log Messages

However, these operations are supported per the Oracle Access Manager managed server instance through using the oam_server node (for the specific server) under Application Deployments in Fusion Middleware Control.

18.2.36 ADF Applications Using ADF Security Fail to Work in Oracle Access Manager 11g

Due to a bug, when accessing a protected resource (protected by 11g Webgate) with query parameters containing encoded URL strings, an error is displayed in browser:

Action failed. Please try again

18.2.37 AdminServer Won't Start if the Wrong Java Path Given with WebLogic Server Installation

WebLogic Server installation on Windows 64-bit platform can be successful with 32-bit JAVA_HOME (jdk1.6.0_23). On Windows 64-bit platform, the path to 32-bit JAVA_HOME (c:\program files (x86)\java\jdkxxx) is not correctly handled by the startWeblogic.cmd.

- If you launch the install shield with setup.exe, you are asked for the path of the 64-bit JAVA_HOME. If you provide the 32-bit JAVA_HOME (jdk1.6.0_24) path, the install shield is not launched.

- If you execute config.cmd from \Middleware\Oracle_IDM1\common\bin, the path to the 32-bit JAVA_HOME (jdk1.6.0_24) is used. Following successful installation, however, you cannot start AdminServer.

Workaround: Oracle recommends replacing SUN_JAVA_HOME to use the path with the shorter name (c:\progra~2\java\jdkxxxx).

- On Windows, the shorter names can be seen by executing "dir /X".

- Alternatively, you can set Windows command shell variable JAVA_HOME to path with shorter name and execute startWeblogic.cmd within that. For example:
>set JAVA_HOME=c:\progra~2\java\jdkXXX

>startweblogic.cmd

18.2.38 Changing UserIdentityStore1 Type Can Lock Out Administrators

An Identity Store that is designated as the System Store should not be edited to change the store type (from Embedded LDAP to OID, for instance) nor the connection URLs.

If you do need to change the Identity Store that is designated as the System Store should not be edited to change the store type, Oracle recommends that you create a new Identity Store and then edit that registration to mark it as your System Store.

18.2.39 Page Layouts and Locales

The layout of the single sign-on (SSO) Login Page, Impersonation Consent page, Logout Page, Impersonation Error page, and Login Error Page do not change for Arabic and Hebrew locales.

18.2.40 Some Pages Are Not Correctly Localized

The date formats of "Creation Instant" and "Last Access Time" on the Session Management Search page are not correctly localized.

18.2.41 Non-ASCII Query String Issues with Internet Explorer v 7, 8, 9

Due to a limitation with the Internet Explorer browser, resources with Non-ASCII query string when if you directly type or paste the resource URL.

18.2.42 Oracle Virtual Directory with SSL Enabled

With Oracle Virtual Directory as the user identity store, no errors are seen after changing its registration to use the SSL port, checking the SSL box, and testing the connection (Test Connection button). However, authentication fails (even though non-SSL port is fine). The first time Test Connection goes through and any subsequent time it results in Socket Timeout exception from the Oracle Virtual Directory side.

Workaround: Disable NIO for the SSL port as follows:

1. Stop Oracle Virtual Directory. For example:

$ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=ovd1

2. Edit the a LDAP SSL listener section of listener.os_xml to add <useNIO>false</useNIO>, as follows:

$ORACLE_INSTANCE/config/OVD/ovd1/listener.os_xml

<ldap version="20" id="LDAP SSL Endpoint">
<port>7501</port>
<host>0.0.0.0</host>
.........
.........
<tcpNoDelay>true</tcpNoDelay>
<readTimeout>180000</readTimeout>
</socketOptions>
<useNIO>false</useNIO>
</ldap>

3. Save the file.

4. Test the connection several times to confirm this is working.

18.2.43 Test to Production Files Locked on Windows

Files under $DOMAIN_HOME/servers/felix-cache_oam are locked on Windows and in use by the servers, which causes the source domain to fail. To work around this, :

1. Set AVA_OPTIONS to create the felix cache under $DOMAIN_HOME/managed_server_name/servers, as follows. For example:

setenv JAVA_OPTIONS -Dorg.osgi.framework.storage=<domain_home_path>/
managed_server_name/servers/felix-cache_oam

2. If the felix-cache_oam directory does not exist it is created.

3. Restart the OAM Servers.

18.2.44 Query String Not Properly Encoded

There is no encoding on the query string from Webgate when % is not followed by a sequence of characters that form a valid URL escape sequence. In this case, Oracle Access Manager etains % as % in the decoded string and the following error occurs:

No message for The Access Server has returned a status that is unknown to the
Access Gate .Contact your website administrator to remedy this problem.

Workaround:

11g Webgate: To specify the '%' character in a query string, you must specify '%25' instead of '%'.

10g Webgate: The 11g Webgate workaround applies to only the anonymous scheme. For other authentication schemes, there is currently no workaround.

18.3 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 18.3.1, "For mod-osso Value for RedirectMethod Should be "POST""

- Section 18.3.2, "User Wrongly Directed to the Self-User Login after Logging Out of the Oracle Identity Manager Administration Console"

- Section 18.3.3, "11g Webgate Fails to Install with Compact Configuration."

- Section 18.3.4, "Auditing Does Not Capture the Information Related to Authentication Failures if a Resource is Protected Using Basic Authentication Scheme"

- Section 18.3.5, "Incompatible Msvcirt.dll Files"

- Section 18.3.6, "IPv6 Support"

- Section 18.3.7, "What to Avoid or Note in Oracle Access Manager Configuration"

- Section 18.3.8, "Install Guides Do Not Include Centralized Logout Configuration Steps"

- Section 18.3.9, "NULL Pointer Exception Shown in Administration Server Console During Upgrade."

- Section 18.3.10, "Using Access SDK Version 10.1.4.3.0 with Oracle Access Manager 11g Servers."

- Section 18.3.11, "Finding and Deleting Sessions Using the Console."

- Section 18.3.12, "Non-ASCII Users with Resource Protected by Kerberos Authentication Scheme."

18.3.1 For mod-osso Value for RedirectMethod Should be "POST"

For Webgate to support long URLs, the following code sample was added under oam-config.xml:

<Setting Name="AgentConfig" Type="htf:map">
<Setting Name="OSSO" Type="htf:map">
<Setting Name="RedirectMethod"Type="xsd:string">GET</Setting>
<Setting Name="Delimiter" Type="xsd:string">AND</Setting>
</Setting>

For mod-osso, the value for RedirectMethod should be POST, however, the values shipped out of the box is GET. Follow these steps to perform the modification, as this change needs to be performed manually and there is no user interface or WLST commands available to do so.

1. Stop the Oracle Access Manager Console and managed servers.

2. Enter cd DOMAIN_HOME/config/fmwconfig

3. Enter vi oam-config.xml

4. Go to the following line in oam-config.xml:

<Setting Name="AgentConfig" Type="htf:map">
<Setting Name="OSSO" Type="htf:map">
<Setting Name="RedirectMethod"Type="xsd:string">GET</Setting>

Modify GET to POST as follows:

<Setting Name="RedirectMethod"Type="xsd:string">POST</Setting>

5. Save the changes and start the AdminServer and managed servers.

18.3.2 User Wrongly Directed to the Self-User Login after Logging Out of the Oracle Identity Manager Administration Console

The user is directed to the self-user login after logging out of the Oracle Identity Manager Administration Console.

To be redirected correctly, the logout must work properly.

The workaround for logout with 10g Webgate is to:

1. Copy logout.html (for example, from Oracle_IDM1/oam/server/oamsso/logout.html) to webgate_install_dir/oamsso.

2. Update logout URL in the file to http://oam_server:oam_server/ngam/server/logout.

3. If redirection to specific page has to occur after logout, change the logout URL to http://oam_server:oam_server/ngam/server/logout?doneURL=http://host:port/specifipage.html.

18.3.3 11g Webgate Fails to Install with Compact Configuration

A compact configuration is an installation with all identity management components on a machine with limited hardware capacity.

On trying to install the 11g Webgate with compact configuration, the following error occurs during the configure step:

Configuring WebGate...
There is an error. Please try again.
Preparing to connect to Access Server. Please wait.
Client authentication failed, please verify your WebGate ID.
cp: cannot stat
`$ORACLE_HOME/ohs/conf/aaa_key.pem':
No such file or directory
cp: cannot stat
`$ORACLE_HOME/ohs/conf/aaa_cert.pem':
No such file or directory
cp: cannot stat
`$ORACLE_HOME/ohs/conf/aaa_chain.pem':

The error occurs because the following entries were not initialized in oam-config.xml during the installation:

<Setting Name="oamproxy" Type="htf:map">
<Setting Name="sslGlobalPassphrase" Type="xsd:string">changeit</Setting>
<Setting Name="SharedSecret" Type="xsd:string">1234567812345678</Setting>
</Setting>

To initialize oam-config.xml properly:

1. Delete the OAM entry from CSF repository by performing the following steps:

1. Start the WebLogic Scripting Tool:
oracle_common/oracle_common/common/bin/wlst.sh

2. In the WLST shell, enter the command to connect to the domain and then enter the requested information.
A sample is given below.

wls:/offline> connect ()
Please enter your username [weblogic] :
Please enter your password [welcome1] :
Please enter your server URL [t3://localhost:7001] :
Connecting to t3://localhost:7001 with userid weblogic ...
Successfully connected to Admin Server 'AdminServer' that belongs to domain 'imdomain86'.

3. Change to domainRuntime.
A sample is given below.

wls:/imdomain86/serverConfig> domainRuntime ()
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root.

4. Check whether an entry exists in the CSF repository with the map name as OAM and key as jks.
A sample is given below.

wls:/imdomain86/domainRuntime> listCred(map="OAM_STORE",key="jks") {map=OAM_STORE, key=jks}
Already in Domain Runtime Tree
.
[Name : jks, Description : null, expiry Date : null]
PASSWORD:1qaldrk3eoulhlcmfcqasufgj2
.

5. Delete the OAM map entry from the CSF repository.

wls:/imdomain86/domainRuntime> deleteCred(map="OAM_STORE",key="jks")
{map=OAM_STORE, key=jks}
Already in Domain Runtime Tree
.

6. Exit from wlst shell.
A sample is given below.

wls:/imdomain86/domainRuntime> exit ()
.
.
.

2. Go to DOMAIN_HOME/config/fmwconfig and delete the file .oamkeystore.
A sample [on linux] is given below.

[aime@pdrac09-5 fmwconfig]$ rm .oamkeystore
.

3. Stop the Managed Server and Admin Server.

4. Start the AdminServer.

5. Verify oam-config.xml.

6. Start Managed Server.

Steps to verify oam-config.xml:

1. Go to DOMAIN_HOME/config/fmwconfig/oam-config.xml.

2. Verify that all the WebLogic Server server instances are configured under DeployedComponent > Server > NGAMServer > Instance

3. Verify that the OAM Managed Server protocol, host and port are available at:
DeployedComponent > Server > NGAMServer > Profile > OAMServerProfile > OAMSERVER

4. Verify that the SSO CipherKey is generated and available at:
DeployedComponent > Server > NGAMServer > Profile > ssoengine > CipherKey

5. Verify that the oamproxy entries for SharedSecret and sslGlobalPassphrase is generated and available at:
DeployedComponent > Server > NGAMServer > Profile > oamproxy

SharedSecret should have a value different from 1234567812345678 and sslGlobalPassphrase different from changeit.

18.3.4 Auditing Does Not Capture the Information Related to Authentication Failures if a Resource is Protected Using Basic Authentication Scheme

Although a resource can be protected using the BASIC scheme, the WebLogic server has a feature by which it first authenticates the user and then sends it to the server.

If you add the following flag under <security-configuration> in config.xml and restart the server, you will be able to bypass WebLogic server's authentication <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>. Once the credentials are submitted back to the OAM Server, it will be audited.

The WebLogic Server Administration Console does not display or log the enforce-valid-basic-auth-credentials setting. However, you can use WLST to check the value in a running server. You must modify this value by setting this in config.xml.

To do so, refer to the following documentation:

"Developing Secure Web Applications" at:

http://download.oracle.com/docs/cd/E13222_01/wls/docs103/security/thin_client.html#wp1037337

18.3.5 Incompatible Msvcirt.dll Files

When you install the Oracle Access Manager 10g Webgate, do not replace the current version of msvcirt.dll with a newer version when prompted. If you do so, there may be incompatibility issues. Later, when you try to install OSSO 10g (10.1.4.3), the opmn.exe command might fail to start and the OracleCSService might time out because the required .dll file is missing.

18.3.6 IPv6 Support

The supported topology for Oracle Access Manager 11g is shown below.

Supported Topology

- WebGate10g or Webgate 11g and protected applications on IPv4 (Internet Protocol Version 4) protocol host

- OHS (Oracle HTTP Server) reverse proxy on dual-stack host

- Client on IPv6 (Internet Protocol Version 6) protocol host

Dual-stack is the presence of two Internet Protocol software implementations in an operating system, one for IPv4 and another for IPv6.

The IPv6 client can access Webgate (10g or 11g) through the reverse proxy on IPv4/IPv6 dual-stack.

18.3.7 What to Avoid or Note in Oracle Access Manager Configuration

This section contains scenarios and items to note in Oracle Access Manager Configuration

18.3.7.1 Unsupported Operations for WLST Scripts

WLST scripts for Oracle Access Manager 10g and Oracle Access Manager 11g WebGates do not support changing Agent security modes.

18.3.7.2 Unsupported Operations for Oracle Access Manager Console and WLST

Unsupported operations for the Oracle Access Manager Console and WLST are described in the following subsections.

18.3.7.2.1

OAM Server

Use Case: Concurrent Deletion and Updating

Description

1. Open an OAM Server instance in edit mode in Browser 1.

2. Using the Oracle Access Manager Console in another browser (Browser 2) or using a WLST script, delete this server instance.

3. Return to Browser 1 where the server instance is opened in edit mode.

4. In Browser 1, click the Apply button.

Current Behavior

The Oracle Access Manager Console displays the message, "Server instance server_name might be in use, are you sure you want to edit it?" along with the confirmation that the update succeeded.

On clicking Yes, the following error message pops up, as expected, and the OAM Server instance page is closed (correct behavior):

"Error while reading your_server-name OAM Server Instance Configuration."

However, the navigation tree node might continue to display the OAM Server instance until you click the Refresh command button for the navigation tree.

Use Case: Two OAM Server Instances with Same Host Cannot have the Same Proxy Port.

Description

For this use case, there are two instances of the OAM Server: oam_server1 and oam_server2.

1. Open oam_server1 in edit mode and specify a host and OAM proxy port.

2. Now open oam_server2 in edit mode and specify the same host and proxy port as oam_server1.

The changes are saved without any error message.

Current Behavior

The Oracle Access Manager Console does not display any error and allows the update.

The behavior is incorrect.

Use Case: Log Statements Detailing the Server Instance Creation, Update and Delete are not Present on the Oracle Access Manager Console

Description

If you create, edit, or delete an OAM Server instance from the Oracle Access Manager Console, the log statements corresponding to create, edit and delete are not displayed by the Console.

18.3.7.2.2

LDAP Authentication Module:

Use Case: Concurrent Deletion/Creation of User Identity Store does not Reflect in the List of Identity Stores in the LDAP Authentication Module Create and Edit

Description

1. Open create/ edit for the LDAP authentication module.
A list displays the identity stores present in the system.

2. Now create a user identity store using another tab.

3. Return to the create/edit tab for the LDAP authentication module and check the list for user identity stores.

Current Behavior

The Oracle Access Manager Console displays the error message, as expected, and closes the Authentication Module page (correct behavior):

"Error while reading module-name Authentication Module Configuration."

However, the navigation tree node might continue to display the Authentication Module node until you click the Refresh command button for the navigation tree.

18.3.7.2.3

LDAP, Kerberos and X509 Authentication Module

Use Case: Concurrent deletion and updating

Description

1. Open an LDAP/Kerberos/X509 authentication module in edit mode in Oracle Access Manager Console in Browser 1.

2. Using Oracle Access Manager Console in another browser (Browser 2) or using a WLST script, delete this authentication module.

3. Now return to Browser 1 where the authentication module is opened in edit mode.

4. Click the Apply button.

Current Behavior

The Oracle Access Manager Console updates this authentication module configuration and writes it to back end.

The behavior is incorrect.

Use Case: Log Statements Detailing the Server Instance Creation, Update and Delete are Not present on Oracle Access Manager Console side.

Description

When you create, edit or delete an authentication module from Oracle Access Manager Console, the log statements corresponding to create, edit and delete are not written by the Console.

18.3.7.2.4

OAM 11G Webgate

Use Case: Concurrent Deletion and Update

Description

1. Open an OAM 11g Webgate instance in edit mode in Oracle Access Manager Console in Browser 1.

2. Using the Oracle Access Manager Console in another browser (Browser 2) or using a WLST script, delete this OAM 11g Webgate.

3. Now return to the Browser1 where the server instance is opened in edit mode.

4. Click on the Apply button.

Current Behavior

The Oracle Access Manager Console for edit OAM11g Webgate does not change and the tab does not close.

A OAM11g Webgate configuration not found error dialog is displayed by the Oracle Access Manager Console.

However, the navigation tree is blank and attempts to perform any operation results in a javax.faces.model.NoRowAvailableException".

The behavior is incorrect.

18.3.7.2.5

OSSO Agent

Use Case: Concurrent Deletion and Update

Description

1. Open an OSSO Agent instance in edit mode in the Oracle Access Manager Console in Browser 1.

2. Using the Oracle Access Manager Console in another browser (Browser 2) or using a WLST script, delete this OSSO Agent.

3. Now return to the Browser 1 where the OSSO Agent instance is opened in edit mode.

4. Click on Apply button.

Current Behavior

Editing the OSSO Agent in the Oracle Access Manager Console results in a null pointer exception.

The behavior is incorrect.

18.3.8 Install Guides Do Not Include Centralized Logout Configuration Steps

Single-Sign On is enabled after Oracle Access Manager is installed; to complete configuration of Single-Sign On out of the box, centralized log out must be configured post-install. Configure centralized log out by following direction from these sections:

- Configuring Centralized Logout for ADF-Coded Applications with Oracle Access Manager 11g
In order for the ADF logout to work correctly, Single Sign-On Server Patch 9824531 is required. Install this patch, as described in the readme file that is included in the patch.

- Configuring Centralized Logout for the IDM Domain Agent (in the patch set this is now the IAMSuiteAgent)

18.3.9 NULL Pointer Exception Shown in Administration Server Console During Upgrade

A NULL pointer exception occurs because of the configuration events trigger when the identity store shuts down. The upgrade is successful, however, and error messages are seen in administration server console. There is no loss of service.

If the NULL pointer is seen during upgrade, there is no loss of service, you can ignore the error.

If the NULL pointer is seen during WLST command execution, you must restart the administration server.

18.3.10 Using Access SDK Version 10.1.4.3.0 with Oracle Access Manager 11g Servers

In general, the Sun Microsystems JDK 1.4.x compiler is the JDK version used with the Java interfaces of Access SDK Version 10.1.4.3.0.

As an exception, the Java interfaces of the 64-bit Access SDK Version 10.1.4.3.0, specifically for the Linux operating system platform, requires the use of Sun Microsystems JDK 1.5.x compiler.

The new Session Management Engine capability within Oracle Access Manager 11g will create a session for every Access SDK version 10.1.4.3.0 call for authentication.

This may cause issues for customers that use Access SDK to programmatically authenticate an automated process. The issue is the number of sessions in the system that is generated within Access SDK will increase dramatically and cause high memory consumption.

18.3.11 Finding and Deleting Sessions Using the Console

When session search criteria is generic (using just a wild card (*), for example), there is a limitation on deleting a session from a large list of sessions.

Oracle recommends that your session search criteria is fine-grained enough to obtain a relatively small set of results (ideally 20 or less).

18.3.12 Non-ASCII Users with Resource Protected by Kerberos Authentication Scheme

Non-ASCII users fail to access a resource protected by a Kerberos authentication scheme using WNA as a challenge method.

The exception occurs when trying to get user details to populate the subject with the user DN and GUID attributes.

18.4 Oracle Security Token Service Issues and Workarounds

This section provides the following topics:

- Section 18.4.1, "No Warnings Given If Required Details are Omitted"

- Section 18.4.2, "New Requester Pages, Internet Explorer v7, and Japanese Locale"

- Section 18.4.3, "Delete Button Not Disabled When Tables Have No Rows"

- Section 18.4.4, "Copying an Issuance Template Does Not Copy All Child Elements"

- Section 18.4.5, "Apply and Revert Buttons are Enabled"

- Section 18.4.6, "Only Generic Fault Errors Written to Oracle WSM Agent Logs"

- Section 18.4.7, "Server and Client Key Tab Files Must be the Same Version"

- Section 18.4.8, "Default Partner Profile Required for WS-Security"

- Section 18.4.9, "SAML Token Issued When NameID is Not Found"

18.4.1 No Warnings Given If Required Details are Omitted

On the Token Mapping page of a new Validation Template with the following characteristics:

- WS-Security

- Token Type SAML 1.1

- Default Partner Profile: requester profile

No warnings are given:

- If you check the box to Enable Attribute Based User Mapping if you leave empty the required User Attributes field
A new row is not saved if the User Attribute field is empty. However, it is saved if both fields are filled. Removing the value of the User Attribute field in a user-added row causes the row to be deleted when you Apply changes

- If you attempt to delete built-in Name Identifier Mapping rows
Built-in Name Identifier Mapping rows cannot be deleted.

18.4.2 New Requester Pages, Internet Explorer v7, and Japanese Locale

When using the Japanese Locale with Internet Explorer v7, the title "New Requester" is not displayed in one line on the page. The Partner, Name, Partner Type, and Partner Profile fields might wrap on the page.

This can occur whether you are creating or modifying the Partner (Requester, Relying Party, and Issuing Authority).

18.4.3 Delete Button Not Disabled When Tables Have No Rows

The Delete button is enabled even though there are no rows to be deleted in the following tables:

- The Attribute Name Mapping table (Token and Attributes page for Partner Profiles (Requester, Relying Party, Issuing Authority Profiles).

- The Value Mapping table in Issuing Authority Partner Profiles

When there are no rows in a table, the Delete button should be disabled by default.

18.4.4 Copying an Issuance Template Does Not Copy All Child Elements

Issuance Template Copy Like function does not copy nested tables (attribute mapping and filtering tables, and the custom token attribute table).

Workaround: Navigate to the desired Issuance Template, click the name in the navigation tree and click the Copy Like button. Manually enter missing information from the original: Attribute Mappings or custom attribute tables.

18.4.5 Apply and Revert Buttons are Enabled

The Apply and Revert buttons are enabled on Oracle Security Token Service pages even if there are no changes to apply or saved changes to revert to the previous version.

18.4.6 Only Generic Fault Errors Written to Oracle WSM Agent Logs

No content is written logs for the Oracle WSM agent errors. There is only a generic fault error.

Workaround: Enable message logging for the Oracle WSM agent on the host OAM Server.

1. Locate the logging.xml file in $DOMAIN/config/fmwconfig/server/oam_server1/logging.xml file.

2. Change the WSM block of the logging.xml file, to:

<logger name="oracle.wsm" level="TRACE:32" useParentHandlers="false">
<handler name="odl-handler"/>
</logger>

<logger name="oracle.wsm.msg.logging" level="TRACE:32"
useParentHandlers="false">
<handler name="owsm-message-handler"/>
<handler name="wls-domain"/>
</logger>

3. OSTS Policies: When Oracle Security Token Service policies are used (instead of Oracle-provided WSM policies) perform the following steps:

1. Locate: Oracle_IDM1/oam/server/policy

2. Unjar sts-policies.jar.

3. Change all the polices to set Enforced to true: META-INF/polices/sts.

<oralgp:Logging orawsp:name="Log Message1" orawsp:Silent="true
orawsp:Enforced="true" orawsp:category="security/logging">
<oralgp:msg-log>
<oralgp:request>all</oralgp:request>
<oralgp:response>all</oralgp:response>
<oralgp:fault>all</oralgp:fault>
</oralgp:msg-log>
</oralgp:Logging>

4. Re-jar the updated sts-policies.jar.

5. Restart the AdminServer and managed servers.

18.4.7 Server and Client Key Tab Files Must be the Same Version

An exception to authenticate the Kerberos token occurs if WebLogic 10.3.5 is configured with Sun JDK6 greater than u18.

When using the Kerberos token as an authentication token requesting the security token from Oracle Security Token Service:

- The keytab file configured in the validation template should always be the latest version from the KDC server

- The KVNO should always be the latest that is available on the server:

18.4.8 Default Partner Profile Required for WS-Security

The Oracle Access Manager Access Administration Guide states "When you toggle the Token Protocol from WS-Trust to WS-Security, options in the Token Type list do not change. However, the required "Default Partner Profile" list appears from which you must choose one profile for WS-Security."

Correction: When you toggle the Token Protocol from WS-Trust to WS-Security a required field "Default Partner Profile" will appear. You must choose a value for this field. If you again toggle back to WS-Trust without choosing a value for this field The options in the Token Type list are not updated correctly to have the WS-Trust Token Type values.

18.4.9 SAML Token Issued When NameID is Not Found

Rather than returning an error response, an assertion issued with an empty NameIdentifier field can be issued even when the NameIdentifier user attribute has a null or empty value. For example:

<saml:NameIdentifier
Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"/>

Workaround: The "Name Identifier User Attribute" Field in the Issuance Template requires a value for the Userstore.

18.5 Integration and Inter-operability Issues and Workarounds

This section provides the following topics:

- Section 18.5.1, "WNA Authentication Does Not Function on Windows 2008"

- Section 18.5.2, "JVM Plug-in Ignores Cookies Marked 'httponly'"

18.5.1 WNA Authentication Does Not Function on Windows 2008

The default Kerberos encryption supported by Windows 2008 Server and Windows 2007 machines are "AES256-CTS-HMAC-SHA1-96", "AES128-CTS-HMAC-SHA1-96" and "RC4-HMAC".

If the clients are configured to use DES only encryption, users will not be able to access protected resources with Kerberos authentication. The error message, An incorrect username and password was specified might be displayed.

Because the initial Kerberos tokens are not present, the browser sends NTLM tokens, which the OAM Server does not recognize; therefore, the user authentication fails.

The workaround is to enable the encryption mechanisms, and follow the procedure mentioned in:

http://technet.microsoft.com/en-us/library/dd560670%28WS.10%29.aspx

18.5.2 JVM Plug-in Ignores Cookies Marked 'httponly'

Cookies set with the httponly flag are not available to Browser Side Scripts and Java Applets. The JVM plugin ignores cookies marked 'httponly.'

To resolve the issue

1. In mod_sso.conf, disable the OssoHTTPOnly off parameter.

2. Add the required OSSO cookies to the list of possible applet parameters to pass for authentication.

18.6 Oracle Access Manager with Impersonation Workarounds

This section provides the following topics:

- Section 18.6.1, "Impersonation Can Fail on Internet Explorer v 7, 8, 9"

- Section 18.6.2, "With Oracle Access Manager 11g ORA_FUSION_PREFS Cookie Domain is Three Dots"

18.6.1 Impersonation Can Fail on Internet Explorer v 7, 8, 9

Due to a limitation with the Internet Explorer browser, Impersonation can fail to go to the Consent page when the Impersonatee's userid contains Non-ASCII characters.

Impersonation goes instead to the failure_url if you directly type or paste the starting impersonation URL in the browser.

18.6.2 With Oracle Access Manager 11g ORA_FUSION_PREFS Cookie Domain is Three Dots

With Oracle Access Manager 10g the ORA_FUSION_PREFS cookie domain used the following form (2 dots):

10g Form .oracle.com

However, Oracle Access Manager 11g localized login accepts only the following format for the ORA_FUSION_PREFS cookie domain (3 dots):

11g Form .us.oracle.com

For example, if the host name is gcsptf.us.oracle.com, Oracle Access Manager 11g creates a cookie with the domain name .us.oracle.com.

However, the application session creates a cookie with the domain name .oracle.com, which causes inter-operability failure between Fusion Middleware and the application session using this cookie.

Workaround: Update the FACookieDomain parameter to correspond to 11g requirements, and increment the Version xsd:integer in the oam-config.xml, as shown in this example:

1. Back up DOMAIN_HOME/config/fmwconfig/oam-config.xml.

2. Open the file for editing and pay close attention to your changes.

3. Set FACookieDomain to your domain (with 3 dot separators):

<Setting Name="FAAppsConfig" Type="htf:map">
<Setting Name="FACookieDomain" Type="xsd:string">.us.oracle.com</Setting>
<Setting Name="FAAuthnLevel" Type="xsd:integer">2</Setting>
<Setting Name="consentPage" Type="xsd:string">/oam/pages/impconsent.jsp
</Setting>
</Setting>

4. Configuration Version: Increment the Version xsd:integer as shown in the next to last line of this example (existing value (26, here) + 1):
Example:

<Setting Name="Version" Type="xsd:integer">
<Setting xmlns="http://www.w3.org/2001/XMLSchema"
Name="NGAMConfiguration" Type="htf:map:>
<Setting Name="ProductRelease" Type="xsd:string">11.1.1.3</Setting>
<Setting Name="Version" Type="xsd:integer">26</Setting>
</Setting>

5. Save oam-config.xml.

18.7 Documentation Errata

This section provides documentation errata for the following guides:

- Section 18.7.1, "Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager with Oracle Security Token Service"

- Section 18.7.2, "Oracle Fusion Middleware Developer's Guide for Oracle Access Manager and Oracle Security Token Service"

- Section 18.7.3, "Oracle Fusion Middleware Integration Guide for Oracle Access Manager"

18.7.1 Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager with Oracle Security Token Service

There is no documentation errata for this guide.

18.7.2 Oracle Fusion Middleware Developer's Guide for Oracle Access Manager and Oracle Security Token Service

There is no documentation errata for this guide.

18.7.3 Oracle Fusion Middleware Integration Guide for Oracle Access Manager

There is no documentation errata for this guide.

19 Oracle Adaptive Access Manager

This chapter describes issues associated with Oracle Adaptive Access Manager. It includes the following topics:

- Section 19.1, "General User Interface"

- Section 19.2, "Scheduler"

- Section 19.3, "Policy Management"

- Section 19.4, "Transactions"

- Section 19.5, "OTP"

- Section 19.6, "Proxy"

- Section 19.7, "Integration"

- Section 19.8, "Reports"

- Section 19.9, "Export"

- Section 19.10, "Globalization"

- Section 19.11, "Configuration Issues and Workarounds"

- Section 19.12, "Documentation Errata"

19.1 General User Interface

This section describes general user interface issues. It includes the following topics:

- Section 19.1.1, "A Few Conditions in the Base Snapshot Are Not Translated"

- Section 19.1.2, "Alert Trigger Sources Are Not Being Displayed in Session Details Page"

19.1.1 A Few Conditions in the Base Snapshot Are Not Translated

The following four conditions have not been translated for this release and display in English in non-English browsers:

- Check to see if the ASN for the current IP address is (or is not) in the ASN group

- Compare Transaction Counts across two different durations

- Checks if user's OTP failure counter value over a specified value

- IP is valid, unknown or private

19.1.2 Alert Trigger Sources Are Not Being Displayed in Session Details Page

In the Sessions Details page for sessions which contain alerts, the Trigger Source column is empty.

By default, the Session Details page does not display the trigger sources if the execution time for alerts is less than 2000 millisecond (2000 ms) since detailed logging is dependent on the execution time.

The property that controls this threshold and logging is

# Int property determining minimum time required for detailed logging
vcrypt.tracker.rulelog.detailed.minMillis=2000

After changing the property, print vcrypt.tracker.rulelog.detailed.minMillis=<value>.

Note: Changing the property influences only new sessions.

19.2 Scheduler

This section describes scheduler issues and workarounds. It includes the following topics:

- Section 19.2.1, "Job Queue Does Not Display Next Recurrence For Canceled Jobs"

- Section 19.2.2, "Pause and Cancel Job Status Is Not Displayed in the Job Instance Tab"

- Section 19.2.3, "Job Queue Process Start and End Time Does Not Follow the Browser Language Setting"

- Section 19.2.4, "Changing the Schedule Parameters Does Not Affect Next Recurrence"

- Section 19.2.5, "When Searching for an Online Job a Warning Might Appear in the Log"

- Section 19.2.6, "When the Create Job Dialog is Clicked an Error Might Display"

- Section 19.2.7, "Errors Are Seen When Creating a New Job"

19.2.1 Job Queue Does Not Display Next Recurrence For Canceled Jobs

If the job is canceled, its next recurrence does not appear in the Job Queue.

19.2.2 Pause and Cancel Job Status Is Not Displayed in the Job Instance Tab

Pause and Cancel Job statuses do not display in the Job Instance tab when a job is canceled or paused. However, the Job Instance tab does show the status (record) at the next scheduled job instance.

19.2.3 Job Queue Process Start and End Time Does Not Follow the Browser Language Setting

In the Job Log tab of the Job Queue page, the Process Start Time and Process End Time columns display in the yyyy-mm-dd format even if the browser is not set to English.

19.2.4 Changing the Schedule Parameters Does Not Affect Next Recurrence

Changing the schedule parameters of a scheduled job does not affect the next recurrence of the job if the start date and time have not been changed. If a non-recurring job is changed to a recurring job, the scheduled recurrence does not occur if there is no change to the start date and time.

19.2.5 When Searching for an Online Job a Warning Might Appear in the Log

When a user clicks the Search button in the online Jobs page, a warnings may appear in the log. There is no loss of functionality.

19.2.6 When the Create Job Dialog is Clicked an Error Might Display

When the user clicks the Create Job dialog, an error may result occasionally. To work around this issue, log out or close the browser and open a new browser to log back in.

19.2.7 Errors Are Seen When Creating a New Job

Errors occur when creating a new job in the OAAM Offline environment. The workaround is to close the browser and start the application again.

19.3 Policy Management

This section describes policy management issues and workarounds. It includes the following topics:

- Section 19.3.1, "Some Attributes of Returned Rules Result Not Set"

- Section 19.3.2, "Search with Rule Notes Keyword is Not Working Properly"

- Section 19.3.3, "Database Error Occurs When Deleting an Action or Alert Group in a Policy Override"

- Section 19.3.4, "Exclude IP List Parameter Was Added to the User and Device Velocity Rule Conditions"

19.3.1 Some Attributes of Returned Rules Result Not Set

When using the processRules OAAM Server API, users should be aware that the rule result returned by the API call may have attributes empty or null.

The following attributes returned by processRules API are not set:

- alertIdList

- transactionLogId

- runTimeType

- session Id

19.3.2 Search with Rule Notes Keyword is Not Working Properly

In the rule listing, the search and sort may not work properly on the Notes column. The search result may include rows that do not contain the search keyword.

19.3.3 Database Error Occurs When Deleting an Action or Alert Group in a Policy Override

Groups used in Score Overrides and Action Overrides are deleted without a warning message.

19.3.4 Exclude IP List Parameter Was Added to the User and Device Velocity Rule Conditions

A parameter, Exclude IP List, was added to the following conditions:

- Device: Velocity from last login

- User: Velocity from last login

This parameter allows you to specify a list of IPs to ignore. If a user's IP is from that list, then this condition always evaluates to false. If the user's IP is not in that list or if the list is null or empty, then the condition evaluates the velocity of the user or the device from the last login and evaluates to true if the velocity exceeds the configured value.

19.4 Transactions

This section describes Transaction API issues.

19.4.1 NullPointerException Occurs for UpdateTransaction and createTransaction APIs When Transaction is Null

A NullPointerException error on the client side occurs for the updateTransactions and createTransactions APIs when one of the transactions in the array is null. The server only returns success responses and the failed one is ignored.

19.5 OTP

This section describes an OTP issue.

19.5.1 java.lang.NullPointerException Occurs When GETOTPCODE Returns Error Response

A java.lang.NullPointerException occurs when a user tries to call toString on the returned response that contains an error.

19.6 Proxy

This section describes UIO Proxy issues and workarounds. It includes the following topics:

- Section 19.6.1, "UIO ISA Proxy: Certain Filters Are Note Evaluating the Variable in Value"

- Section 19.6.2, "UIO ISA Proxy: the Send-to-Server in Response Interceptor Fails Without Error Message"

- Section 19.6.3, "Warnings are Displayed in Memcached Environment During User Login"

19.6.1 UIO ISA Proxy: Certain Filters Are Note Evaluating the Variable in Value

Filters are used in the proxy to modify HTTP request/response contents or modify the state information saved in the proxy (variables). The following filters are not evaluating variables in the value:

- SetVariable

- AddHeader

- AddResponseCookie

- AddRequestCookie

- ReplaceText

19.6.2 UIO ISA Proxy: the Send-to-Server in Response Interceptor Fails Without Error Message

When the send-to-server action in the response interceptor is used without the display-url, the UIO ISA Proxy redirects the user to an incorrect location and does not display an error.

19.6.3 Warnings are Displayed in Memcached Environment During User Login

In an Apache Memcached environment, warnings are shown in the log during the user login flow. The functionality is not impacted.

19.7 Integration

This section describes an integration issue.

19.7.1 NameValueProfile APIs Return Empty Values

The following namevalueprofile APIs return empty values:

- getNameValueProfile

- saveNameValueProfile

- refreshNameValueProfile

19.8 Reports

This section describes OAAM BI Publisher reports and Sessions issues and workarounds. It includes the following topics:

- Section 19.8.1, "OAAM BI Publisher Reports Are Not Working in BI Publisher 11g"

- Section 19.8.2, "Session Details Checkpoint Panel Order Sometimes Randomized"

- Section 19.8.3, "Alert Message Link in Session Details Page Does Not Open the Alert Details"

19.8.1 OAAM BI Publisher Reports Are Not Working in BI Publisher 11g

OAAM BI Publisher reports are not working on BI Publisher 11g.

19.8.2 Session Details Checkpoint Panel Order Sometimes Randomized

In the Session Details page, sometimes the checkpoint execution display order may not be the same as the execution order.

19.8.3 Alert Message Link in Session Details Page Does Not Open the Alert Details

When the user tries to access an alert details page from an alert message link in the Session Details page, the page fails to open.

To work around this issue, use the alert message link on the Session Search page.

19.9 Export

This section describes an issue with the Export function.

19.9.1 Export Session Is Not Exporting All Records

Export Sessions to Excel exports selected rows only in the current set of visible 25 rows.

19.10 Globalization

This section describes globalization issues and workarounds. It includes the following topics:

- Section 19.10.1, "Localization Limitations"

- Section 19.10.2, "Policy, Rule, and Action in the OAAM Dashboard Do Not Pick Up110N Value"

- Section 19.10.3, "NLS: Descriptions in Non-ASCII Characters Fails to Save Maximum Length"

- Section 19.10.4, "XMLDOMException Occurs When Saving Searches"

- Section 19.10.5, "Date Format May Not Follow the Browser Language Setting in User Details"

- Section 19.10.6, "Sort for NLS String Might Not Work Properly for Out-of-the-Box Objects"

- Section 19.10.7, "A Few Objects from the OAAM_BASE_SNAPSHOT.ZIP Appear in English Only"

19.10.1 Localization Limitations

The following information is supported in English only in this release:

- Alert messages in the standard policies packaged with Oracle Adaptive Access Manager

- Action values in the RulesBreakdown and RecentLogin OAAM BI Publisher reports

- Notes for Action Templates

19.10.2 Policy, Rule, and Action in the OAAM Dashboard Do Not Pick Up110N Value

Policy, rule, and action are not displayed in their translated values in the Dashboard table. The issues are listed below:

- Locations: The Actions table in the Location dashboard does not display the translated value for actions when non-English content is viewed.

- Security: The Rules table in the Security dashboard does not display the Policy name, Rule name and Action in the browser's locale when non-English content is viewed.

- Performance: The Rules table in the Performance dashboard does not display the translated value for policy names when non-English content is viewed.

19.10.3 NLS: Descriptions in Non-ASCII Characters Fails to Save Maximum Length

On a few OAAM Administration pages, for fields with tooltips that say "Enter between 0 and 4000 characters", OAAM accepts input of up to 4000 non-ASCII characters but cannot save the non-ASCII string (for example, Chinese) if it contains more than 4000 bytes.

With UTF-8 encoding, one non-ASCII character uses 1, 2, 3 or 4 byte(s) to store in the database, so 4000 non-ASCII characters require more than 4000 bytes, which is the maximum size of the VARCHAR2 type field.

19.10.4 XMLDOMException Occurs When Saving Searches

An XMLDOMException may occur while saving the search criteria if certain characters, such as fullwidth digits (Unicode U+FF10 through U+FF19) are used. To work around this issue, substitute the characters with more ordinary equivalents (for example, ASCII digits 0 through 9 instead of fullwidth digits).

19.10.5 Date Format May Not Follow the Browser Language Setting in User Details

The Date of Last Online Action field uses the date format yyyy-mm-dd rather than the browser locale's date format. This occurs in the Registration Information panel on the Summary tab of the User Details page.

19.10.6 Sort for NLS String Might Not Work Properly for Out-of-the-Box Objects

With a 11.1.1.5.0 refresh installation and restore of pre-defined data from the oaam_base_snapshot.zip, sorting might not work properly for Group Name, Pattern Name, Entity Name and Description, Action Templates Name, KBA Validation Name and KBA Category Name in a non-English environment.

19.10.7 A Few Objects from the OAAM_BASE_SNAPSHOT.ZIP Appear in English Only

Some rules, groups, and other items are displayed in English when the 11.1.1.5.0 base snapshot is imported into the system.

19.11 Configuration Issues and Workarounds

This section describes the following configuration issue and its workaround:

- Section 19.11.1, "Specifying Timeout Session Option in WebLogic Does Not Work for OAAM"

19.11.1 Specifying Timeout Session Option in WebLogic Does Not Work for OAAM

The WebLogic Console provides an option to specify the session timeout for an application but changing this value does not work for OAAM Admin. The session timeout value should be configurable when OAAM is deployed.

The workaround to configure the session timeout value is to configure the web.xml session timeout in the WebLogic application server using the deployment plan feature. The steps are as follows:

1. Generate deployment plan from the existing non-plan based deployment.
The URL for a WebLogic deployment plan example is:

http://www.slideshare.net/jambay/weblogic-deployment-plan-example

2. Edit the plan.xml.

1. Add a variable definition for the custom session timeout in minutes.

...
<variable-definition>
<variable>
<name>mySessionTimeOut</name>
<value>60</value>
</variable>
</variable-definition>
...

2. Override the desired web application oaam_admin.war's web.xml as follows:

<module-override>
<module-name>oaam_admin.war</module-name>
...
<module-descriptor external="false">
<root-element>web-app</root-element>
<uri>WEB-INF/web.xml</uri>
<variable-assignment>
<name>mySessionTimeOut</name>
<xpath>/web-app/session-config/session-timeout</xpath>
</variable-assignment>
</module-descriptor>
...

3. Then, select the application oaam_admin.ear and click the Update button in the deployment list

4. Select the plan path and redeploy the application.
Ignore any shared library warnings.

5. Make sure your config-root is the application ear directory.

6. Restart all the servers.

19.12 Documentation Errata

This section describes documentation errata for the Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager, part number E14568, the Oracle Fusion Middleware Developer's Guide for Oracle Adaptive Access Manager, part number E15480, and the OAAM sections of the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, part number E12002. It includes the following topics:

- Section 19.12.1, "Incorrect File Location for sample.bharosa_location.properties"

- Section 19.12.2, "A Separate Step to Import KBA Questions Is Redundant in OAAM Setup"

- Section 19.12.3, "Rules Logging Property Setting for OAAM Offline Is Not Correct"

19.12.1 Incorrect File Location for sample.bharosa_location.properties

The procedure to load location data into the Oracle Adaptive Access Manager database is not correct in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management. The location of the sample.bharosa_location.properties file is documented as oaam/WEB-INF/classes. The correct location for sample.bharosa_location.properties is <ORACLE_MW_HOME>/<IAM_HOME>/oaam/cli.

The corrected text is provided below:

Load Location Data into the Oracle Adaptive Access Manager database as follows:

1. Configure the IP Location Loader script, as described in the topics "OAAM Command Line Interface Scripts" and "Importing IP Location Data" in the Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager.

2. Make a copy of the sample.bharosa_location.properties file, which is located under the <ORACLE_MW_HOME>/<IAM_HOME>/oaam/cli directory. Enter location data details in the location.data properties, as in the following examples:

location.data.provider=quova
location.data.file=/tmp/quova/EDITION_Gold_2008-07-22_v374.dat.gz
location.data.ref.file=/tmp/quova/EDITION_Gold_2008-07-22_v374.ref.gz
location.data.anonymizer.file=/tmp/quova/anonymizers_2008-07-09.dat.gz

3. Run the loader on the command line as follows:
On Windows: loadIPLocationData.bat

On UNIX: ./loadIPLocationData.sh

Note:

If you wish to generate CSF keys or passwords manually, see the "Setting Up Encryption and Database Credentials for OAAM" topic in the Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager.

19.12.2 A Separate Step to Import KBA Questions Is Redundant in OAAM Setup

In the Oracle Fusion Middleware Installation Guide for Oracle Identity Management, a separate step is given to import KBA questions after importing the snapshot. Importing KBA questions is duplication and redundant since importing the snapshot imports KBA questions by default.

19.12.3 Rules Logging Property Setting for OAAM Offline Is Not Correct

The property for setting up rules logging in OAAM Offline is incorrect in the Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager. With property vcrypt.tracker.rules.trace.policySet.min.ms = 100, rules logs are not processed. The value to vcrypt.tracker.rules.trace.policySet.min.ms must be changed to -1.

Rule logging for detailed information can be turned on by setting:

vcrypt.tracker.rules.trace.policySet=true
vcrypt.tracker.rules.trace.policySet.min.ms=-1

20 Oracle Authentication Services for Operating Systems

This chapter describes issues associated with Oracle Product. It includes the following topics:

- Section 20.1, "What is New with Oracle Authentication Services for Operating Systems 11.1.1.3 ?"

- Section 20.2, "General Issues and Workarounds"

20.1 What is New with Oracle Authentication Services for Operating Systems 11.1.1.3 ?

Oracle Fusion Middleware Release 11g R1 patchset 2 (11.1.1.3) is the first 11g release to include Oracle Authentication Services for Operating Systems. This product is also available as a download from http://www.oracle.com/technology/.

The following features and capabilities have been added to Oracle Authentication Services for Operating Systems since the 10g release:

- Full integration with Fusion Middleware Release 11g R1 patchset 2 (11.1.1.3). OAS4OS was not available with FMW 11g R1 or FMW 11g R1 patchset 1.

- Extended client platform support. For a full list see: http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html.

- New configuration scripts to enable PAM proxy user-based access to Oracle Internet Directory for enhanced security.

- Easy configuration of Oracle Internet Directory SSL using customer provided certificates for production deployments, or use of self signed certificates to test OID SSL connections.

- Restricting client access based on IP address.

- Easy reset of client configuration to support testing.

20.2 General Issues and Workarounds

For up-to-date information about product bugs and updates, see Note 1064891.1: Oracle Authentication Services for Operating Systems Documentation Addendum (11.1.1.3). This document is available on My Oracle Support at https://support.oracle.com/.

21 Oracle Directory Integration Platform

This chapter describes issues associated with Oracle Directory Integration Platform. It includes the following topics:

- Section 21.1, "General Issues and Workarounds"

- Section 21.2, "Configuration Issues and Workarounds"

- Section 21.3, "Documentation Errata"

21.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- The Oracle Password Filter for Microsoft Active Directory is not Certified for use With Oracle Unified Directory or Oracle Directory Server Enterprise Edition

- LDIF Files That Contain Non-ASCII Characters Will Cause the testProfile Command Option to Fail if the LDIF File has Native Encoding

- Some Changes May Not Get Synchronized Due to Race Condition in Heavily-Loaded Source Directory

- Synchronization Continues After Stopping Oracle Directory Integration Platform

- File Path Separator Must Be Escaped on Windows

- Certain Queries and Provisioning Profile Functionality may Fail on JDK 1.6 u 21

21.1.1 The Oracle Password Filter for Microsoft Active Directory is not Certified for use With Oracle Unified Directory or Oracle Directory Server Enterprise Edition

To use the Oracle Password Filter for Microsoft Active Directory, your Oracle back-end directory must be Oracle Internet Directory. The Oracle Unified Directory back-end directory and the Oracle Directory Server Enterprise Edition back-end directory do not support integration with the Oracle Password Filter for Microsoft Active Directory.

21.1.2 LDIF Files That Contain Non-ASCII Characters Will Cause the testProfile Command Option to Fail if the LDIF File has Native Encoding

When running DIP Tester from a command-line, the manageSyncProfiles testProfile command will fail if the -ldiffile option is specified and the LDIF file contains non-ASCII characters.

Note that LDIF files with UTF-8 encoding are not impacted by this limitation. If an LDIF file containing multibyte characters cannot be saved with UTF-8 encoding, then use the following workaround:

1. From a command-line, add the entry using the ldapadd command and include the -E option to specify the locale. See the Oracle Fusion Middleware User Reference for Oracle Identity Management for the required command syntax.

2. Get the specific changeNumber for the last add operation.

3. Execute the testProfile command using the changeNumber from the previous step.

For more information, see "Section 7.1.5.2, Running DIP Tester From the WLST Command-Line Interface" in the Administrator's Guide for Oracle Directory Integration Platform.

21.1.3 Some Changes May Not Get Synchronized Due to Race Condition in Heavily-Loaded Source Directory

If the source directory is heavily-loaded, a race condition may occur where database commits cannot keep pace with updates to the lastchangenumber. If this race condition occurs, Oracle Directory Integration Platform may not be able to synchronize some of the changes.

To work around this issue, perform the following steps to enable database commits to keep pace with the lastchangenumber:

1. Increase the value of the synchronization profile's Scheduling Interval.

2. Control the number of times the search is performed on the source directory during a synchronization cycle by setting the searchDeltaSize parameter in the profile. Oracle suggests starting with a value of 10, then adjusting the value as needed.

21.1.4 Synchronization Continues After Stopping Oracle Directory Integration Platform

If you stop the Oracle Directory Integration Platform application during synchronization, the synchronization process that the Quartz scheduler started will continue to run.

To work around this issue, restart the Oracle WebLogic Managed Server hosting Oracle Directory Integration Platform or redeploy the Oracle Directory Integration Platform application.

21.1.5 File Path Separator Must Be Escaped on Windows

On Windows, you must escape the file path separator using a back-slash ( \ ) in profile properties files and when executing Oracle Directory Integration Platform commands. For example:

- In profile properties files:

odip.profile.configfile = C:\\test\\Oracle_
IDM1\\ldap\\odi\\conf\\activeimp.cfg.master

- When executing an Oracle Directory Integration Platform command, such as manageDIPServerConfig:

C:\test\Oracle_IDM1\BIN>manageDIPServerConfig.bat set -attribute \
keystorelocation -h myhost.mycompany.com -p 7005 -D LOGIN_ID \
-value C:\\test\\Oracle_IDM1\\bin\\server_keystore.jks

21.1.6 Certain Queries and Provisioning Profile Functionality may Fail on JDK 1.6 u 21

LDAP JNDI filter processing has been updated to be stricter in JDK 1.6 u21. Consequently, certain queries performed by Oracle Directory Integration Platform may fail on JDK 1.6 u21 and provisioning profile functionality may also be affected. To fix this issue, download and apply patch 10631569, which is available for download on My Oracle Support (formerly MetaLink). Access My Oracle Support at https://support.oracle.com.

Oracle strongly recommends that you download and apply patch 10631569 for Identity Management 11.1.1.4.0.

21.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Do not use localhost as Oracle Internet Directory Hostname When Configuring Oracle Directory Integration Platform

- You may Need to Restart the Directory Integration Platform After Running dipConfigurator Against Oracle Unified Directory

- When Configuring a Profile, you may Need to Scroll Past a Section of Whitespace to View Mapping Rules

- Resource Usage Charts will not Display if Multiple IDM Domains are Running on the Same Host

21.2.1 Do not use localhost as Oracle Internet Directory Hostname When Configuring Oracle Directory Integration Platform

When configuring Oracle Directory Integration Platform against an existing Oracle Internet Directory—using either the installer's Install and Configure installation option or the Oracle Identity Management 11g Release 1 (11.1.1) Configuration Wizard—you must specify the hostname for Oracle Internet Directory using only its fully qualified domain name (such as myhost.example.com). Do not use localhost as the Oracle Internet Directory hostname even if Oracle Directory Integration Platform and Oracle Internet Directory are collocated on the same host.

If you use localhost as the Oracle Internet Directory hostname, you will not be able to start the Oracle WebLogic Managed Server hosting Oracle Directory Integration Platform.

21.2.2 You may Need to Restart the Directory Integration Platform After Running dipConfigurator Against Oracle Unified Directory

After running dipConfigurator against an Oracle Unified Directory (OUD) endpoint, if you are unable to open the Directory Integration Platform (DIP) UI in Enterprise Manger, stop and start DIP to fix the UI problem.

21.2.3 When Configuring a Profile, you may Need to Scroll Past a Section of Whitespace to View Mapping Rules

If you are using Internet Explorer to view the Directory Integration Platform (DIP) UI, you may need to scroll past a large blank space to see the profile mapping rules section. This issue is not known to affect other browsers.

21.2.4 Resource Usage Charts will not Display if Multiple IDM Domains are Running on the Same Host

If two IDM domains on the same host share the same Oracle home and are both configured to use wls_ods1 managed servers, then the DIP home page will not display the resource usage charts if both instances are running at the same time.

21.3 Documentation Errata

There are no known documentation issues at this time.

22 Oracle Entitlements Server

This chapter describes issues associated with Oracle Entitlements Server. It includes the following topics:

- Section 22.1, "General Issues and Workarounds"

- Section 22.2, "Configuration Issues and Workarounds"

- Section 22.3, "Documentation Errata"

22.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topic:

- Using Backslash on Oracle Internet Directory Policy Store

- Performance Tuning the Oracle Database Policy Store

- Action Bar Disappears When Using Internet Explorer 7

- Re-created Application May Not Be Distributed in Controlled Mode

- Enterprise Manager Doesn't Pick Up Newly Added Audit Events

- Attributes Passed to Authorization Request Are Treated as Case Sensitive

- Audit Schema Definitions are Incomplete

- Java Security Module on IPv6 Client Not Supported on Windows

- WebLogic Security Module Policy Distribution Configuration Issue on Windows IPv6 Hosts

- Validating Attribute Names in Custom Functions

22.1.1 Using Backslash on Oracle Internet Directory Policy Store

When a backslash (\) is used in a policy object name and the backslash is followed by either a pound sign (#) or two hex characters ([a-fA-f_0-9][a-fA-f_0-9]), searches for the object may not work as expected. The issue has been observed when one of either a Resource Type name or a Resource name and action association has such a value causing the query of permission sets by Resource Type, Resource name or action to fail.

WORKAROUND:

Avoid using these values in policy object names.

22.1.2 Performance Tuning the Oracle Database Policy Store

The Oracle dbms_stats package can be used to improve data migration performance on an Oracle database policy store. The exact SQL command to be executed is:

*EXEC DBMS_STATS.gather_schema_stats
('DEV_OPSS',DBMS_STATS.AUTO_SAMPLE_SIZE,no_invalidate=>FALSE);*

where DEV_OPSS is the schema owner being used for the database policy store. You can use the other two parameters as illustrated.

WORKAROUND:

You can run this DBMS_STATS call periodically using either of the options below:

- Use DBMS_JOB.

1. Copy and paste the following code to a SQL script.
In this example, the job will be executed every 10 minutes.

variable jobno number;
BEGIN
DBMS_JOB.submit
(job => :jobno,
what =>
'DBMS_STATS.gather_schema_stats(''DEV_OPSS'',DBMS_STATS.AUTO_SAMPLE_SIZE,
no_invalidate=>FALSE);',
interval => 'SYSDATE+(10/24/60)');
COMMIT;
END;
/
#end of sql script

2. Login to sqlplus as the schema owner; for example, 'DEV_OPSS' not sys_user.

3. Run the SQL script.
To find the job ID from the script you ran, execute the following:

sqlplus '/as sysdba'
SELECT job FROM dba_jobs WHERE schema_user = 'DEV_OPSS' AND what =
'DBMS_STATS.gather_schema_stats(''DEV_OPSS'',DBMS_STATS.AUTO_SAMPLE_SIZE,
no_invalidate=>FALSE);';

To remove the job, login to sqlplus as the schema owner (for example, 'DEV_OPSS' not sys_user) and run the following SQL command:

EXEC DBMS_JOB.remove(27);

- Use cron job or shell script to execute the SQL command.

# run dbms_stats periodically
./runopssstats.sh
# runopssstats.sh content is below:
# In this example, we will execute the command in every 10 minutes
#!/bin/sh

i=1
while [ $i -le 1000 ]
do
echo $i
sqlplus dev_opss/welcome1@inst1 @opssstats.sql
sleep 600
i=`expr $i + 1`
done
# end of sh

# opssstats.sql
EXEC DBMS_STATS.gather_schema_stats('DEV_OPSS',
DBMS_STATS.AUTO_SAMPLE_SIZE,no_invalidate=>FALSE);
QUIT;
# end of sql

22.1.3 Action Bar Disappears When Using Internet Explorer 7

If you are using Internet Explorer 7 and select a role or user from an Administrator Role under System Configuration -> System Administrators, the action bar disappears thus, External Role Mappings and External User Mappings can not be deleted.

WORKAROUND:

This issue is specific to Internet Explorer 7. Use Firefox 3.

22.1.4 Re-created Application May Not Be Distributed in Controlled Mode

In some cases, when the PDP Service is running in controlled mode, if one Application object is deleted from the policy store and re-created using the same name, the change may not be distributed to the PDP Service. This is because the Application in the local cache has a higher version than the one in the policy store.

WORKAROUND:

Remove the local cache files for the PDP service and restart the PDP Service instance. The oracle.security.jps.runtime.pd.client.localpolicy.work_folder configuration parameter defines the path to the cache. The default value is <SM_INSTANCE>/config/work/.

22.1.5 Enterprise Manager Doesn't Pick Up Newly Added Audit Events

component_events.xml is the audit event definition file used by configuration tools (like Enterprise Manager and WebLogic Scripting Tool) and by the audit runtime and database loader. You need to modify the component_events.xml file to insure that Enterprise Manager picks up all newly added events in the Low/Medium list.

WORKAROUND:

1. Log out of Enterprise Manager.

2. Open the component_events.xml file.
This file is located in the $IDM_OPSS_ORACLE_HOME/modules/oracle.iau_11.1.1/components/JPS/ directory.

3. Search for <FilterPresetDefinition name="Low">.

4. In the event list, change purgeDistributionStatus to PurgeDistributionStatus.
Note the capitalization.

5. Search for <FilterPresetDefinition name="Medium">.

6. In the event list, change purgeDistributionStatus to PurgeDistributionStatus.
Note the capitalization.

7. Save the file and close it.

8. Start Enterprise Manager.

22.1.6 Attributes Passed to Authorization Request Are Treated as Case Sensitive

When using the PEP API names of passed attributes, they must be in the same case as those mentioned in the policies.

22.1.7 Audit Schema Definitions are Incomplete

The IAUOES audit schema is not synchronized with Oracle Entitlements Server event definitions, so it does not contain the necessary columns for this component. Consequently, data cannot be stored in the appropriate columns and audit reports cannot be run against Oracle Entitlements Server data.

WORKAROUND - Option 1

Use this option if RCU has not yet been run. The steps are:

1. Locate JPS.sql at this location:

$RCU_HOME/rcu/integration/iauoes/scripts/JPS.sql

Modify the file permission, making the file writable.

2. Copy over the file:

$IDM_OPSS_ORACLE_HOME/modules/oracle.iau_11.1.1/sql/scripts/JPS.sql

to:

$RCU_HOME/rcu/integration/iauoes/scripts/JPS.sql

3. Run RCU to create the IAUOES schema.

WORKAROUND - Option 2

Use this option if RCU has already been run. The steps are:

1. Copy over the file:

$IDM_OPSS_ORACLE_HOME/modules/oracle.iau_11.1.1/sql/scripts/JPS.sql

to the directory from which you run sqlplus.

2. Connect to sqlplus as sysdba.

3. Run the following commands at the SQL prompt:

1. alter session set current_schema=audit_schema_user

2. drop table JPS;

3. @@JPS.sql audit_schema_user audit_schema_user_Append audit_schema_user_Viewer;

22.1.8 Java Security Module on IPv6 Client Not Supported on Windows

Because of an issue with the JDK 1.6, the Java Security Module is not supported when using a Windows IPv6 client. We are working with the JDK development team for a resolution.

22.1.9 WebLogic Security Module Policy Distribution Configuration Issue on Windows IPv6 Hosts

The Policy Distribution URL may not be correctly generated on some Windows IPv6 hosts. Specifically, in jps-config.xml you might see the following line:

@ <property value="https://127.0.0.1:8002/pd-client"
name="oracle.security.jps.runtime.pd.client.DistributionServiceURL"/>

WORKAROUND:

Edit jps-config.xml (located in <domain_home>/config/oeswlssmconfig/) so it contains the correct policy distribution client URL. In the following example, <WLS-SM-client-host> is the hostname on which the WebLogic Server Security Module is running and <Pd-client-port> is the port on which the client is listening for policy distribution.

@ <property value="https://<WLS-SM-client-host>:<Pd-client-port>/pd-client"
name="oracle.security.jps.runtime.pd.client.DistributionServiceURL"/>

22.1.10 Validating Attribute Names in Custom Functions

When using custom function implementations, if the attribute name is invalid, the result of the authorization request could be wrong. Thus, attribute names must be validated before retrieving their values.

WORKAROUND:

Use the following code in custom function implementations to validate attribute names.

boolean isValidAttributeName(String name) {
if (name == null) return false;
return name.matches("[A-Za-z_][A-Za-z0-9_]*");
}

22.2 Configuration Issues and Workarounds

There are no configuration issues at this time.

22.3 Documentation Errata

There are no documentation errata at this time.

23 Oracle Identity Federation

This chapter describes issues associated with Oracle Identity Federation. It includes the following topics:

- Section 23.1, "General Issues and Workarounds"

- Section 23.2, "Configuration Issues and Workarounds"

- Section 23.3, "Documentation Errata"

23.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 23.1.1, "Database Table for Authentication Engine must be in Base64 Format"

- Section 23.1.2, "Considerations for Oracle Identity Federation HA in SSL mode"

- Section 23.1.3, "Incorrect Managed Server Metrics Displayed"

- Section 23.1.4, "Database Column Too Short error for IDPPROVIDEDNAMEIDVALUE"

23.1.1 Database Table for Authentication Engine must be in Base64 Format

When using a database table as the authentication engine, and the password is stored hashed as either MD5 or SHA, it must be in base64 format.

The hashed password can be either in the base64-encoded format or with a prefix of {SHA} or {MD5}. For example:

{SHA}qUqP5cyxm6YcTAhz05Hph5gvu9M=

23.1.2 Considerations for Oracle Identity Federation HA in SSL mode

In a high availability environment with two (or more) Oracle Identity Federation servers mirroring one another and a load balancer at the front-end, there are two ways to set up SSL:

- Configure SSL on the load balancer, so that the SSL connection is between the user and the load balancer. In that case, the keystore/certificate used by the load balancer has a CN referencing the address of the load balancer.
The communication between the load balancer and the WLS/Oracle Identity Federation can be clear or SSL (and in the latter case, Oracle WebLogic Server can use any keystore/certificates, as long as these are trusted by the load balancer).

- SSL is configured on the Oracle Identity Federation servers, so that the SSL connection is between the user and the Oracle Identity Federation server. In this case, the CN of the keystore/certificate from the Oracle WebLogic Server/Oracle Identity Federation installation needs to reference the address of the load balancer, as the user will connect using the hostname of the load balancer, and the Certificate CN needs to match the load balancer's address.
In short, the keystore/certificate of the SSL endpoint connected to the user (load balancer or Oracle WebLogic Server/Oracle Identity Federation) needs to have its CN set to the hostname of the load balancer, since it is the address that the user will use to connect to Oracle Identity Federation.

23.1.3 Incorrect Managed Server Metrics Displayed

Included per bug 8606743

Problem

On Windows, in the resource usage section of the Oracle Identity Federation home page, the CPU and memory utilization usage metrics for the managed server where Oracle Identity Federation is deployed always show a value of 0.

Workaround

Take these steps to correct the issue:

1. Navigate to the oracle instance home of the Fusion Middleware Control agent that is used to monitor Oracle Identity Federation.

2. Run the opmnctl command to stop the emagent process:

$INST_HOME/bin/opmnctl stopproc ias-component=EMAGENT

3. Run the emctl command to start the emagent process:

$INST_HOME/EMAGENT/EMAGENT/bin/emctl start agent

23.1.4 Database Column Too Short error for IDPPROVIDEDNAMEIDVALUE

Included per bug 12408587

Problem

When Oracle Identity Federation is configured to use a database store for session and message data store, the following error is seen if data for IDPPROVIDEDNAMEID is over 200 characters long:

ORA-12899: value too large for column
"WDO_OIF"."ORAFEDTMPPROVIDERFED"."IDPPROVIDEDNAMEIDVALUE" (actual: 240,
maximum: 200)\n]

Workaround

Alter table ORAFEDTMPPROVIDERFED to increase the column size for "idpProvidedNameIDValue" to 240.

23.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 23.2.1, "WLST Environment Setup when SOA and OIF are in Same Domain"

- Section 23.2.2, "Oracle Virtual Directory Requires LSA Adapter"

- Section 23.2.3, "Settings for Remote WS-Fed SP Must be Changed Dynamically"

- Section 23.2.4, "Required Property when Creating a WS-Fed Trusted Service Provider"

- Section 23.2.5, "Federated Identities Table not Refreshed After Record Deletion"

- Section 23.2.6, "Default Authentication Scheme is not Saved"

- Section 23.2.7, "Configuring 10g to Work with 11g Oracle Identity Federation using Artifact Profile"

23.2.1 WLST Environment Setup when SOA and OIF are in Same Domain

If your site contains Oracle SOA Suite and Oracle Identity Federation in the same domain, the WLST setup instructions in the Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation are insufficient for WLST to correctly execute Oracle Identity Federation commands.

This can happen if you install an IdM domain, then extend it with an Oracle SOA install; the SOA installer changes the ORACLE_HOME environment variable. This breaks the Oracle Identity Federation WLST environment, as it relies on the IdM value for ORACLE_HOME.

Take these steps to enable the use of WLST commands:

1. Execute the instructions described in Section 9.1.1, Setting up the WLST Environment, in the Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation.

2. Copy OIF-ORACLE_HOME/fed/script/*.py to WL_HOME/common/wlst.

3. Append the CLASSPATH environment variable with OIF-ORACLE_HOME/fed/scripts.

23.2.2 Oracle Virtual Directory Requires LSA Adapter

To use Oracle Virtual Directory as an Oracle Identity Federation user store or an authentication engine, you must configure a Local Storage Adapter, and the context root must be created as required at installation or post-install configuration time.

For details about this task, see the chapter Creating and Configuring Oracle Virtual Directory Adapters in the Oracle Fusion Middleware Administrator's Guide for Oracle Virtual Directory.

23.2.3 Settings for Remote WS-Fed SP Must be Changed Dynamically

On the Edit Federations page, the Oracle Identity Federation (OIF) settings for remote WS-Fed service provider contain a property called SSO Token Type; you can choose to either inherit the value from the IdP Common Settings page or override it here. The number of properties shown in 'OIF Settings' depends on the value of SSO Token Type.

If you choose to override SSO Token Type with a different value (for example, by changing from SAML2.0 to SAML1.1), the number of properties shown in 'OIF Settings' does not change until you click the Apply button.

Also, if you have overridden the value for Default NameID Format to 'Persistent Identifier' or 'Transient/One-Time Identifier', then changed the SSO Token Type value from 'SAML2.0' to 'SAML1.1' or 'SAML1.0', you will notice that the value for Default NameID Format is now blank. To proceed, you must reset this property to a valid value from the list.

23.2.4 Required Property when Creating a WS-Fed Trusted Service Provider

When you create a WS-Fed Trusted Service Provider, you must set the value for the 'Use Microsoft Web Browser Federated Sign-On' property with these steps:

1. In Fusion Middleware Control, navigate to Federations, then Edit Federations.

2. Choose the newly create WS-Fed Trusted Service Provider and click Edit.

3. In the 'Trusted Provider Settings' section, set the value for Use Microsoft Web Browser Federated Sign-On by checking or unchecking the check-box.

4. Click Apply.

23.2.5 Federated Identities Table not Refreshed After Record Deletion

When the federation store is XML-based, a record continues to be displayed in the federated identities table after it is deleted.

The following scenario illustrates the issue:

1. The federation data store is XML.

2. Perform federated SSO, using "map user via federated identity".

3. In Fusion Middleware Control, locate the Oracle Identity Federation instance, and navigate to Administration, then Identities, then Federated Identities.

4. Click on the created federation record and delete it.

After deletion, the federated record is still in the table. Further attempts at deleting the record result in an error.

The workaround is to manually refresh the table by clicking Search.

23.2.6 Default Authentication Scheme is not Saved

Problem

This problem is seen when you configure Oracle Access Manager in Fusion Middleware Control as a Service Provider Integration Module. It is not possible to set a default authentication scheme since the default is set to a certain scheme (say OIF-password-protected) but the radio button is disabled.

Solution

Take these steps to set the preferred default authentication scheme:

1. Check the Create check-box for the scheme that is currently set as the default but disabled.

2. Check the Create check-box(es) for the authentication scheme(s) that you would like to create.

3. Click the radio button of the scheme that you wish to set as the default.

4. Uncheck the Create check-box of the scheme in Step 1 only if you do not want to create the scheme.

5. Provide all the required properties in the page.

6. Click the Configure Oracle Access Manager button to apply the changes.

The default authentication scheme is now set to the one that you selected.

Note:

In addition, when trying to remove any authentication scheme, ensure that you do not remove the default scheme; if you must remove the scheme, change the default to another authentication scheme before you remove the scheme.

23.2.7 Configuring 10g to Work with 11g Oracle Identity Federation using Artifact Profile

In the SAML 1.x protocol, for a 10g Oracle Identity Federation server to work with an 11g Oracle Identity Federation server using the Artifact profile, you need to set up either basic authentication or client cert authentication between the two servers.

For instructions, see:

- Section 6.9 Protecting the SOAP Endpoint, in the Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation, 11g Release 1 (11.1.1)

- Section 6.5.13.2 When Oracle Identity Federation is an SP, in the Oracle Identity Federation Administrator's Guide, 10g (10.1.4.0.1)

23.3 Documentation Errata

This section describes documentation errata for the Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation, part number E13400-01. It includes the following topics:

- Section 23.3.1, "Different Passwords for Keystore and Private Key not Supported"

- Section 23.3.2, "Documentation Erratum for Deploying Oracle Identity Federation"

- Section 23.3.3, "Documentation Erratum for Configuring Security and Trust"

- Section 23.3.4, "Additional Steps for SSL Configuration"

- Section 23.3.5, "ParseException Message in Diagnostic Log"

- Section 23.3.6, "Forcing Re-authentication when Integrated with Oracle Access Manager"

- Section 23.3.7, "Supported Version of Oracle Access Manager 10g"

- Section 23.3.8, "Additional Steps for OpenID Configuration"

- Section 23.3.9, "Documentation Erratum for Oracle Identity Federation MBeans"

Note:

For documentation errata and other release notes relating to the integration of Oracle Identity Federation with Oracle Access Manager 11g , see the chapter for "Oracle Access Manager."

23.3.1 Different Passwords for Keystore and Private Key not Supported

Oracle Identity Federation only supports configuring one password for signing and encryption keystores, and uses that password to open both the keystore and the private key. This means that if a keystore is configured with different store password and key password, an error will occur when Oracle Identity Federation tries to access the private key.

To avoid this error, ensure that the private key password for the configured key alias is the same as the keystore password.

Note:

In Oracle Identity Federation 11g Release 1 (11.1.1), if you change the key password to match the keystore password, you must remove the old keystore/wallet from the configuration.

23.3.2 Documentation Erratum for Deploying Oracle Identity Federation

In Section 3.2.2.2, "Integrate Oracle Single Sign-On with OHS", replace the following set of instructions:

Copy $AS_INST/config/OHS/$OHS_NAME/disabled/mod_osso.conf to $AS_INST/config/OHS/$OHS_NAME/moduleconf. All files in the moduleconf directory are read when OHS is started.

Open the $AS_INST/config/OHS/$OHS_NAME/moduleconf/mod_osso.conf file and set the OssoConfigFile directive to reference the Oracle Single Sign-On configuration file that was created and then copied to the OHS config directory:

OssoConfigFile ${ORACLE_INSTANCE}/config/${COMPONENT_TYPE}/${COMPONENT_NAME}/oif.server.com.osso.conf

with the following text:

Copy $AS_INST/config/OHS/$OHS_NAME/disabled/mod_osso.conf to $AS_INST/config/OHS/$OHS_NAME/moduleconf. All files in the moduleconf directory are read when OHS is started.

Open the $AS_INST/config/OHS/$OHS_NAME/moduleconf/mod_osso.conf file. Set the OssoConfigFile directive to reference the Oracle Single Sign-On configuration file that was created and then copied to the OHS config directory:

OssoConfigFile ${ORACLE_INSTANCE}/config/${COMPONENT_TYPE}/ ${COMPONENT_NAME}/oif.server.com.osso.conf

Add the /fed/user/authnosso URL to be protected by Oracle SSO Server, through the Location element.

Then the mod_osso.conf example would look like this:

LoadModule osso_module ${ORACLE_HOME}/ohs/modules/mod_osso.so

<IfModule mod_osso.c>
OssoIpCheck off
OssoIdleTimeout off
OssoConfigFile ${ORACLE_INSTANCE}/config/${COMPONENT_TYPE}/
${COMPONENT_NAME}/oif.server.com.osso.conf

<Location /fed/user/authnosso>
require valid-user
AuthType Osso
</Location>
</IfModule>

23.3.3 Documentation Erratum for Configuring Security and Trust

In Section 5.10.3, "Security and Trust - Trusted CAs and CRLs", change the following sentence:

"When the certificate validation store is enabled, Oracle Identity Federation uses it to validate the certificates needed to verify the signatures on incoming messages."

to read:

"When the certificate validation store is enabled, Oracle Identity Federation uses it to validate the certificates needed to verify the signatures on incoming SAML/WS-Federation messages."

23.3.4 Additional Steps for SSL Configuration

In Section 8.2.2, "Configuring Oracle Identity Federation as an SSL Client," add the following subsection, which shows the steps needed to ensure that Fusion Middleware Control can continue to manage the Oracle Identity Federation server after SSL is enabled for the Admin server and the managed server hosting Oracle Identity Federation:

Ensuring that Fusion Middleware Control can Manage an Oracle Identity Federation Target

Take these steps:

1. Locate $INSTANCE_HOME/EMAGENT/EMAGENT/sysman/emd/targets.xml.
Change the protocol for the 'serviceURL' property to the correct protocol. If you have more than one Oracle Identity Federation target (besides host and oracle_emd), you need to modify the 'serviceURL' for each target.

2. Locate $INSTANCE_HOME/EMAGENT/EMAGENT/sysman/config/emd.properties.
If necessary, update the protocol for 'REPOSITORY_URL' to the correct protocol. The EM Agent uses this property to connect to Fusion Middleware Control.

3. Stop the EM Agent using the command:

$INSTANCE_HOME/bin/opmnctl stopproc ias-component=EMAGNET

4. Secure the EM Agent using the command:

$INSTANCE_HOME/EMAGENT/EMAGENT/bin/emctl secure fmagent -admin_host
<host> -admin_port <port> -admin_user <username> [-admin_pwd <pwd>]

5. Restart the EM Agent using the command:

$INSTANCE_HOME/bin/opmnctl startproc ias-component=EMAGNET

23.3.5 ParseException Message in Diagnostic Log

After installation, a configuration assistant performs a number of configuration updates to the Oracle Identity Federation server using MBeans. Another task periodically checks to see if the configuration files were changed so that the server can be notified.

A parsing error during this procedure can result in the following type of message in the diagnostic log file:

$DOMAIN_HOME/servers/wls_oif1/logs/wls_oif1-diagnostic.log
.
[org.xml.sax.SAXParseException: XML document structures must start and end
within the same entity.]
at
javax.xml.bind.helpers.AbstractUnmarshallerImpl.createUnmarshalExcept
ion(AbstractUnmarshallerImpl.java:315)
at
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.createUnmar
shalException(UnmarshallerImpl.java:514)
at
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal0(
UnmarshallerImpl.java:215)
at
com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal(U
nmarshallerImpl.java:184)
at
javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(AbstractUnm
arshallerImpl.java:137)
at
javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(AbstractUnm
arshallerImpl.java:184)
at
oracle.as.config.persistence.jaxb.JAXBXmlPersistenceManagerImpl.load(
JAXBXmlPersistenceManagerImpl.java:156)
... 10 more
Caused by: org.xml.sax.SAXParseException: XML document structures must start
and
end within the same entity.
at
com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper.createSAX
ParseException(ErrorHandlerWrapper.java:195)
at
com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper.fatalErro
r(ErrorHandlerWrapper.java:174)
.

Provided that the Oracle Identity Federation server is up and running (/fed/idp/metadata can be accessed without any errors), the message is harmless and has no effect on the stability of the server. The configuration change occurs as intended, and all the servers are notified of the change.

23.3.6 Forcing Re-authentication when Integrated with Oracle Access Manager

Add the following note in Section 3.2.3, "Deploying Oracle Identity Federation with Oracle Access Manager":

Note:

Oracle Identity Federation does not support the ability to force re-challenging the user for credentials when integrated with the Oracle Access Manager 10g authentication engine, so that Oracle Identity Federation cannot support use cases where reauthentication must be forced.
For example, if an SP sends an AuthnRequest with ForceAuthn="true" to an Oracle Identity Federation IdP, and Oracle Identity Federation is integrated with Oracle Access Manager, the ForceAuthn flag is ignored.

23.3.7 Supported Version of Oracle Access Manager 10g

For integration with Oracle Access Manager 10g server, Oracle Identity Federation supports Oracle Access Manager Version 10.1.4.3.

In Section 3.2.3.2 Integrate Oracle Access Manager as an Authentication Engine, under the Verify Requirements heading, change the first step to verify component versions to read:

1. Verify that the Oracle Access Manager server is at Version 10.1.4.3.

23.3.8 Additional Steps for OpenID Configuration

Section 5.4.4 Configure OpenID IdP Properties describes how to enable the out-of-the-box Oracle Identity Federation OpenID provider.

You can also configure an external OpenID provider so that Oracle Identity Federation acts as the relying party (RP/SP) and an external resource acts as the OpenID provider (OP). Google and Yahoo are examples of external OpenID providers.

The following steps describe how to configure an external OpenID provider:

1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

2. Navigate to the Oracle Identity Federation instance.

3. Select Administration, then Federations.

4. Click Add to add a new OpenID provider.

5. In the pop-up box, select "Add provider manually".

6. Enter the provider ID using a URL in this format:

http://node123.us.example.com:7777/fed/idp

7. For protocol version, select "OpenID2.0".

8. For provider type, select "Identity Provider".

9. Click OK to create the provider.

10. Edit the new provider. Enter the provider's discovery URL in this format:

http://node123.us.example.com:7777/fed/idp

or enter the provider's OpenID endpoint URL if the IdP does not support OpenID discovery.

11. Click Apply to commit the edits.

23.3.9 Documentation Erratum for Oracle Identity Federation MBeans

In Section A.5.2 "Access Oracle Identity Federation MBeans", the MBean names are stated in Table A-1 and the sample code as "Oracle Identity FederationConfigMBean" which should be corrected to read "OIFConfigMBean"..

24 Oracle Identity Manager

This chapter describes issues associated with Oracle Identity Manager. It includes the following topics:

- Section 24.1, "Patch Requirements"

- Section 24.2, "General Issues and Workarounds"

- Section 24.3, "Configuration Issues and Workarounds"

- Section 24.4, "Multi-Language Support Issues and Limitations"

- Section 24.5, "Documentation Errata"

24.1 Patch Requirements

This section describes patch requirements for Oracle Identity Manager 11g Release 1 (11.1.1). It includes the following sections:

- Obtaining Patches From My Oracle Support (Formerly OracleMetaLink)

- Patch Requirements for Oracle Database 11g (11.1.0.7)

- Patch Requirements for Oracle Database 11g (11.2.0.2.0)

- Patch Requirements for Segregation of Duties (SoD)

- Patch Upgrade Requirement

24.1.1 Obtaining Patches From My Oracle Support (Formerly OracleMetaLink)

To obtain a patch from My Oracle Support (formerly OracleMetaLink), go to following URL, click Patches and Updates, and search for the patch number:

https://support.oracle.com/

24.1.2 Patch Requirements for Oracle Database 11g (11.1.0.7)

Table 24-1 lists patches required for Oracle Identity Manager 11g Release 1 (11.1.1) configurations that use Oracle Database 11g (11.1.0.7). Before you configure Oracle Identity Manager 11g, be sure to apply the patches to your Oracle Database 11g (11.1.0.7) database.

Table 24-1 Required Patches for Oracle Database 11g (11.1.0.7)

Platform

Patch Number and Description on My Oracle Support

UNIX / Linux

7614692: BULK FEATURE WITH 'SAVE EXCEPTIONS' DOES NOT WORK IN ORACLE 11G

7000281: DIFFERENCE IN FORALL STATEMENT BEHAVIOR IN 11G

8327137: WRONG RESULTS WITH INLINE VIEW AND AGGREGATION FUNCTION

8617824: MERGE LABEL REQUEST ON TOP OF 11.1.0.7 FOR BUGS 7628358 7598314

Windows 32 bit

8689191: ORACLE 11G 11.1.0.7 PATCH 16 BUG FOR WINDOWS 32 BIT

Windows 64 bit

8689199: ORACLE 11G 11.1.0.7 PATCH 16 BUG FOR WINDOWS (64-BIT AMD64 AND INTEL EM64T)

Note:

The patches listed for UNIX/Linux in Table 24-1 are also available by the same names for Solaris SPARC 64 bit.

24.1.3 Patch Requirements for Oracle Database 11g (11.2.0.2.0)

If you are using Oracle Database 11g (11.2.0.2.0), make sure that you download and install the appropriate version (based on the platform) for the RDBMS Patch Number 9776940. This is a prerequisite for installing the Oracle Identity Manager schemas.

Table 24-2 lists the patches required for Oracle Identity Manager 11g Release 1 (11.1.1) configurations that use Oracle Database 11g Release 2 (11.2.0.2.0). Make sure that you download and install the following patches before creating Oracle Identity Manager schemas.

Table 24-2 Required Patches for Oracle Database 11g (11.2.0.2.0)

Platform

Patch Number and Description on My Oracle Support

Linux x86 (32-bit)

Linux x86 (64-bit)

Oracle Solaris on SPARC (64-bit)

Oracle Solaris on x86-64 (64-bit)

RDBMS Interim Patch#9776940.

Microsoft Windows x86 (32-bit)

Bundle Patch 2 [Patch#11669994] or later. The latest Bundle Patch is 4 [Patch# 11896290].

Microsoft Windows x86 (64-bit)

Bundle Patch 2 [Patch# 11669995] or later. The latest Bundle Patch is 4 [Patch# 11896292].

If this patch is not applied, then problems might occur in user and role search and manager lookup. In addition, search results might return empty result.

Note:

- Apply this patch in ONLINE mode. Refer to the readme.txt file bundled with the patch for the steps to be followed.

- In some environments, the RDBMS Interim Patch has been unable to resolve the issue, but the published workaround works. Refer to the metalink note "Wrong Results on 11.2.0.2 with Function-Based Index and OR Expansion due to fix for Bug:8352378 [Metalink Note ID 1264550.1]" for the workaround. This note can be followed to set the parameters accordingly with the only exception that they need to be altered at the Database Instance level by using ALTER SYSTEM SET <param>=<value> scope=<memory> or <both>.

24.1.4 Patch Requirements for Segregation of Duties (SoD)

Table 24-3 lists patches that resolve known issues with Segregation of Duties (SoD) functionality:

Table 24-3 SoD Patches

Patch Number / ID

Description and Purpose

Patch number 9819201 on My Oracle Support

Apply this patch on the SOA Server to resolve the known issue described in "SoD Check During Request Provisioning Fails While Using SAML Token Client Policy When Default SoD Composite is Used".

The description of this patch on My Oracle Support is "ERROR WHILE USING SAML TOKEN CLIENT POLICY FOR CALLBACK."

Patch ID 3M68 using the Oracle Smart Update utility. Requires passcode: 6LUNDUC7.

Using the Oracle Smart Update utility, apply this patch on the Oracle WebLogic Server to resolve the known issue described in "SoD Check Fails While Using Client-Side Policy in Callback Invocation During Request Provisioning".

Note:

The SoD patches are required to resolve the known issues in Oracle Identity Manager 11g Release 1 (11.1.1.3), but these patches are not required in 11g Release 1 (11.1.1.5).

24.1.5 Patch Upgrade Requirement

While applying the patch provided by Oracle Identity Manager, the following error is generated:

ApplySession failed: ApplySession failed to prepare the system.

OPatch version 11.1.0.8.1 must be upgraded to version 11.1.0.8.2 to meet the version requirement.

See "Obtaining Patches From My Oracle Support (Formerly OracleMetaLink)" for information about downloading OPatch from My Oracle Support.

24.2 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Do Not Use Platform Archival Utility

- SPML-DSML Service is Unsupported

- Resource Object Names Longer than 100 Characters Cause Import Failure

- Status of Users Created Through the Create and Modify User APIs

- Status of Locked Users in Oracle Access Manager Integrations

- Generating an Audit Snapshot after Bulk-Loading Users or Accounts

- Browser Timezone Not Displayed

- Date Format Change in the SoD Timestamp Field Not Supported

- Bulk Loading CSV Files with UTF-8 BOM Encoding Not Supported

- Date Type Attributes are Not Supported for the Default Scheduler Job, "Job History Archival"

- Low File Limits Prevent Adapters from Compiling

- Reconciliation Engine Requires Matching Rules

- SPML Requests Do Not Report When Any Date is Specified in Wrong Format

- Logs Populated with SoD Exceptions When the SoD Message Fails and Gets Stuck in the Queue

- A Backslash (\) Cannot Be Used in a weblogic.properties File

- Underscore Character Cannot Be Used When Searching for Resources

- Assign to Administrator Action Rule is Not Supported by Reconciliation

- Some Buttons on Attestation Screens Do Not Work in Mozilla Firefox

- The maxloginattempts System Property Causes Autologin to Fail When User Tries to Unlock

- "<User not found>" Error Message Appears in AdminServer Console While Setting-Up an Oracle Identity Manager-Oracle Access Manager Integration

- Do Not Use Single Quote Character in Reconciliation Matching Rule

- Do Not Use Special Characters When Reconciling Roles from LDAP

- SoD Check During Request Provisioning Fails While Using SAML Token Client Policy When Default SoD Composite is Used

- SoD Check Fails While Using Client-Side Policy in Callback Invocation During Request Provisioning

- Error May Appear During Provisioning when Generic Technology Connector Framework Uses SPML

- Cannot Click Buttons in TransUI When Using Mozilla Firefox

- LDAP Handler May Cause Invalid Exception While Creating, Deleting, or Modifying a Role

- Cannot Reset User Password Comprised of Non-ASCII Characters

- Benign Exception and Error Message May Appear While Patching Authorization Policies

- The DateTime Pick in the Trans UI Does Not Work Correctly in the Thai Locale

- User Without Access Policy Administrators Role Cannot View Data in Access Policy Reports

- Archival Utility Throws an Error for Empty Date

- TransUI Closes with Direct Provisioning of a Resource

- Scheduler Throws "ParameterValueTypeNotSupportedException" Instead of "RequiredParameterNotSetException"

- All New User Attributes Are Not Supported for Attestation in Oracle Identity Manager 11g

- LDAP GUID Mapping to Any Field of Trusted Resource Not Supported

- User Details for Design Console Access Field Must Be Mapped to Correct Values When Reading Modify Request Results

- Cannot Create a User Containing Asterisks if a Similar User Exists

- Blank Status Column Displayed for Past Proxies

- Mapping the Password Field in a Reconciliation Profile Prevents Users from Being Created

- UID Displayed as User Login in User Search Results

- Roles/Organizations Browse Trees Disappear

- Entitlement Selection Is Not Optional for Data Gathering

- Oracle Identity Manager Server Throws Generic Exception While Deploying a Connector

- Create User API Allows Any Value for the "Users.Password Never Expires", "Users.Password Cannot Change", and "Users.Password Must Change" Fields

- Incorrect Label in JGraph Screen for the GTC

- Running the Workflow Registration Utility Generates an Error

- Native Performance Pack is Not Enabled On Solaris 64-bit JVM Install

- Error in the Create Generic Technology Connector Wizard

- DSML Profile for the SPML Web Service is Not Deployed With Oracle Identity Manager

- New Human Tasks Must Be Copied in SOA Composites

- Modify Provisioned Resource Request Does Not Support Service Account Flag

- Erroneous "Query by Example" Icon in Identity Administration Console

- The XL.ForcePasswordChangeAtFirstLogin System Property Is No Longer Used

- The tcExportOperationsIntf.findObjects(type,name) API Does Not Accept the Asterisk (*) Wilcard Character in Both Parameters

- Disabled Links on the Access Policy Summary Page Opened in Mozilla FireFox

- Benign Error is Generated on Editing the IT Resource Form in Advanced Administration

- User Account is Not Locked in iPlanet Directory Server After it is Locked in Oracle Identity Manager

- Oracle Identity Manager Does Not Support Autologin With JavaAgent

- Benign Error Logged on Opening Access Policies, Resources, or Attestation Processes

- User Locked in Oracle Identity Manager But Not in LDAP

- Reconciliation Profile Must Not Be Regenerated Via Design Console for Xellerate Organization Resource Object

- Benign Error Logged on Clicking Administration After Upgrade

- Provisioning Fails Through Access Policy for Provisioned User

- Benign Warning Messages Displayed During Oracle Identity Manager Managed Server Startup

- Benign Message Displayed When Running the Deployment Manager

- Deployment Manager Export Fails When Started Using Microsoft Internet Explorer 7 With JRE Plugin 1.6_23

- User Creation Fails in Microsoft Active Directory When Value of Country Attribute Exceeds Two Characters

- Permission on Target User Required to Revoke Resource

- Reconciliation Event Fails for Trusted Source Reconciliation Because of Missing Reconciliation Rule in Upgraded Version of Oracle Identity Manager

- XML Validation Error on Oracle Identity Manager Managed Server Startup

- Cannot View or Edit Adapter Mapping in the Data Object Manager Form of the Design Console

- Role Memberships for Assign or Revoke Operations Not Updated on Enabling or Disabling Referential Integrity Plug-in

- Reconciliation Data Displays Attributes That Are Not Modified

- Benign Errors Displayed on Starting the Scheduler Service When There are Scheduled Jobs to be Recovered

- Trusted Source GTC Reconciliation Mapping Cannot Display Complete Attribute Names

- Benign Error Logged for Database Connectivity Test

- MDS Validation Error When Importing GTC Provider Through the Deployment Manager

- Encrypted User-Defined Field (UDF) Cannot be Stored with Size of 4000 Characters or More

- Request Approval Fails With Callback Service Failure

- Localized Display Name is Not Reconciled Via User/Role Incremental Reconciliation with iPlanet Directory Server

- LDAP Role Hierarchy and Role Membership Reconciliation With Non-ASCII Characters Does Not Reconcile Changes in Oracle Identity Manager

- Import of Objects Fails When All Objects Are Selected for Export

- Benign Audit Errors Logged After Upgrade

- Connector Upgrade Fails if Existing Data is Bigger in Size Than New Column Length

- Connector Artifacts Count Increases in the Deployment Manager When File is Not Imported

- Uploading JAR Files By Using the Upload JAR Utility Fails

- Oracle Identity Manager Data and MT Upgrade Fails Because Change of Database User Password

- Reverting Unsaved UDFs Are Not Supported in the Administration Details Page for Roles and Organizations

- Resources Provisioned to User Without Checking Changes in User Status After Request is Submitted

- Starting UCP Connection Pool Fails When Trying to Create User on 64-Bit Microsoft Windows With JDK 6

- Config.sh Command Fails When JRockit is Installed With Data Samples and Source

- Unexpected Memory Usage in Oracle Identity Manager 11g Release 1(11.1.1)

- Reports Link No Longer Exists in the Administrative and User Console

- Not Allowing to Delete a Role Whose Assigned User Members are Deleted

- Roles and Organizations Do Not Support String UDFs of Password Type

- Error on Importing Connector By Using the Deployment Manager

- Manage Localizations Dialog Box Does Not Open After Modifying Roles

- Not Allowing to Create User With Language-Specific Display Name Values

- SoD Check Results Not Displayed for Requests Created by Users for the PeopleSoft Resource

- The XL.UnlockAfter System Property and the Automatically Unlock User Scheduled Job Do Not Take Effect

- Resetting Password on Account Lockout Does Not Unlock User

- Starting Oracle Identity Manager and SOA Server on Some 64-bit Microsoft Windows Computers for the First Time Takes Time

- Incremental and Full Reconciliation Jobs Cannot Be Run Together

- Incorrect Content in the ScheduleTask Jars Loaded and Third Party Jars Tables in the MT Upgrade Report

- Scroll Bar Not Available on the Select Connector Objects to Be Upgraded Page of the Connector Management - Upgrading Wizard

- Adapter Import Might Display Adapter Logic if Compilation Fails Because of Incorrect Data

- XIMDD Tests Fail in Oracle Identity Manager

24.2.1 Do Not Use Platform Archival Utility

Currently, the Platform Archival Utility is not supported and should not be used.

To work around this issue, use the predefined scheduled task named Orchestration Process Cleanup Task to delete all completed orchestration processes and related data.

24.2.2 SPML-DSML Service is Unsupported

Oracle Identity Manager's SPML-DSML Service is currently unsupported in 11g Release 1 (11.1.1). However, you can manually deploy the spml-dsml.ear archive file for Microsoft Active Directory password synchronization.

24.2.3 Resource Object Names Longer than 100 Characters Cause Import Failure

If a resource object name is more than 100 characters, an error occurs in the database and the resource object is not imported. To work around this issue, change the resource object's name in the XML file so the name is less than 100 characters.

24.2.4 Status of Users Created Through the Create and Modify User APIs

You cannot create users in Disabled State. Users are always created in Active State.

The Create and Modify User APIs do not honor the Users.Disable User attribute value. If you pass a value to the Users.Disable User attribute when calling the Create API, Oracle Identity Manager ignores this value and the USR table is always populated with a value of 0, which indicates the user's state is Active.

Use the Disable API to disable a user.

24.2.5 Status of Locked Users in Oracle Access Manager Integrations

When Oracle Access Manager locks a user account in an Oracle Identity Manager-Oracle Access Manager integration, it may take approximately five minutes, or the amount of time defined by the incremental reconciliation scheduled interval, for the status of the locked account to be reconciled and appear in Oracle Identity Manager. However, if a user account is locked or unlocked in Oracle Identity Manager, the status appears immediately.

24.2.6 Generating an Audit Snapshot after Bulk-Loading Users or Accounts

The GenerateSnapshot.[sh|bat] option does not work correctly when invoked from the Bulk Load utility. To work around this issue and generate a snapshot of the initial audit after bulk loading users or accounts, you must run GenerateSnapshot.[sh|bat] from the $OIM_HOME/bin/ directory.

24.2.7 Browser Timezone Not Displayed

Due to an ADF limitation, the browser timezone is currently not accessible to Oracle Identity Manager. Oracle Identity Manager bases the timezone information in all date values on the server's timezone. Consequently, end users will see timezone information in the date values, but the timezone value will display the server's timezone.

24.2.8 Date Format Change in the SoD Timestamp Field Not Supported

The date-time value that end users see in the Segregation of Duties (SoD) Check Timestamp field on the SoD Check page will always display as "YYYY-MM-DD hh:mm:ss" and this format cannot be localized.

To work around this localization issue, perform the following steps:

1. Open the "Oracle_eBusiness_User_Management_9.1.0.1.0/xml/Oracle-eBusinessSuite-TCA-Main-ConnectorConfig.xml" file.

2. In the EBS Connector import xml, locate the SoDCheckTimeStamp field for the Process Form. Change <SDC_FIELD_TYPE> to 'DateFieldDlg' and change <SDC_VARIANT_TYPE> to 'Date' as shown in the following example:

<FormField name = "UD_EBST_USR_SODCHECKTIMESTAMP">
<SDC_UPDATE>!Do not change this field!</SDC_UPDATE>
<SDC_LABEL>SoDCheckTimestamp</SDC_LABEL>
<SDC_VERSION>1</SDC_VERSION>
<SDC_ORDER>23</SDC_ORDER>
<SDC_FIELD_TYPE>DateFieldDlg</SDC_FIELD_TYPE>
<SDC_DEFAULT>0</SDC_DEFAULT>
<SDC_ENCRYPTED>0</SDC_ENCRYPTED>
<!--SDC_SQL_LENGTH>50</SDC_SQL_LENGTH-->
<SDC_VARIANT_TYPE>Date</SDC_VARIANT_TYPE>
</FormField>

3. Import the Connector.

4. Enable SoD Check.

5. Provision the EBS Resource with entitlements to trigger an SoD Check.

6. Check the SoDCheckTimeStamp field in Process Form to confirm it is localized like the other date fields in the form.

24.2.9 Bulk Loading CSV Files with UTF-8 BOM Encoding Not Supported

Bulk loading a CSV file for which UTF-8 BOM (byte order mark) encoding is specified causes an error. However, bulk-loading UTF-8 encoded CSV files works as expected if you specify "no BOM" encoding.

To work around this issue,

- If you want to load non-ASCII data, you must change your CSV file encoding to "UTF-8 no BOM" before loading the CSV file.

- If your data is stored in CSV files with "UTF-8 BOM" encoding, you must change them to "UTF-8 no BOM" encoding before running the bulkload script.

24.2.10 Date Type Attributes are Not Supported for the Default Scheduler Job, "Job History Archival"

The default Scheduler job, "Job History Archival," does not support date type attributes.

The "Archival Date" attribute parameter in "Job History Archival" only accepts string patterns such as "ddMMyyyy" and "MMM DD, yyyy."

When you run a Scheduler job, the code checks the date format. If you enter the wrong format, an error similar to the following example, displays in the execution status list and in the log console:

<IAM-1020063> <Incorrect format of Archival Date parameter. Archival Date is expected in DDMMYYYY or UI Date format.>

The job cannot run successfully until you input the correct Archival Date information.

24.2.11 Low File Limits Prevent Adapters from Compiling

On machines where the file limits are set too low, trying to create and compile an entity adapter causes a "Too many open files" error and the adapter will not compile.

To work around this issue, change the file limits on your machine to the following (located in /etc/security/limits.conf) and then restart the machine:

- soft nofile 4096

- hard nofile 4096

24.2.12 Reconciliation Engine Requires Matching Rules

Currently, Oracle Identity Manager's Reconciliation Engine in 11g Release 1 (11.1.1) requires you to define a matching rule to identify the users for every connector in reconciliation. Errors will occur during reconciliation if you do not define a matching rule to identify users.

24.2.13 SPML Requests Do Not Report When Any Date is Specified in Wrong Format

When any date, such as activeStartDate, hireDate, and so on, is specified in an incorrect format, the Web server does not pass those values to the SPML layer. Only valid dates are parsed and made available to SPML. Consequently, when any SPML request that contains an invalid date format, the invalid date format from the request is ignored and is not available for that operation. For example, if you specify the HireDate month as "8" instead of "08," the HireDate will not be populated after the Create request is completed and no error message is displayed.

The supported date format is:

yyyy-MM-dd hh:mm:ss.fffffffff

No other date format is supported.

24.2.14 Logs Populated with SoD Exceptions When the SoD Message Fails and Gets Stuck in the Queue

SoD functionality uses JMS-based processing. Oracle Identity Manager submits a message to the oimSODQueue for each SoD request. If for some reason an SoD message always results in an error, Oracle Identity Manager never processes the next message in the oimSODQueue. Oracle Identity Manager always picks the same error message for processing until you delete that message from the oimSODQueue.

To work around this issue, use the following steps to edit the queue properties and to delete the SoD message in oimSODQueue:

1. Log on to the WebLogic Admin Console at http://<hostname>:<port>/console

2. From the Console, select Services, Messaging, JMS Modules.

3. Click OIMJMSModule. All queues will be displayed.

4. Click oimSODQueue.

5. Select the Configurations, Delivery Failure tabs.

6. Change the retry count so that the message can only be submitted a specified number of times.

7. Change the default Redelivery Limit value from -1 (which means infinite) to a specific value. For example, if you specify 1, the message will be submitted only once.

8. To review and delete the SoD error message, go to the Monitoring tab, select the message, and delete it.

24.2.15 A Backslash (\) Cannot Be Used in a weblogic.properties File

If you are using the WeblogicImportMetadata.cmd utility to import data to MDS, then do not use a backslash (\) character in a path in the weblogic.properties file, or an exception will occur.

To work around this issue, you must use a double backslash (\\) or a forward slash (/) on Microsoft Windows. For example, change metadata_from_loc=C:\metadata\file to metadata_from_loc=C:\\metadata\\file in the weblogic.properties file.

24.2.16 Underscore Character Cannot Be Used When Searching for Resources

When you are searching for a resource object, do not use an underscore character (_) in the resource name. The search feature ignores the underscore and consequently does not return the expected results.

24.2.17 Assign to Administrator Action Rule is Not Supported by Reconciliation

Reconciliation does not support the Assign to Administrator Action rule.

To work around this issue, change the Assign to Administrator to None in the connector XML before importing the connector. However, after changing the value to None, you cannot revert to Assign to Administrator.

24.2.18 Some Buttons on Attestation Screens Do Not Work in Mozilla Firefox

If you are creating attestations in a Mozilla Firefox Web browser and you click certain buttons, nothing happens.

To work around this issue, click the Refresh button to refresh the page.

24.2.19 The maxloginattempts System Property Causes Autologin to Fail When User Tries to Unlock

WLS Security Realm has a default lock-out policy that locks out users for some time after several unsuccessful login attempts. This policy can interfere with the locking and unlocking functionality of Oracle Identity Manager.

To prevent the WLS Security Realm lock-out policy from affecting the lock/unlock functionality of Oracle Identity Manager, you must set the 'Lockout Threshold' value in the WLS 'User Lockout Policy' to at least 5 more than the value in Oracle Identity Manager. For example, if the value in Oracle Identity Manager is set to 10, you must set the WLS 'Lockout Threshold' value to 15.

To change the default values for the 'User lockout Policy,' perform the following steps:

1. Open the WebLogic Server Administrative Console.

2. Select Security Realms, REALM_NAME.

3. Select the User Lockout tab.

4. If configuration editing is not enabled, then click the Lock and Edit button to enable configuration editing.

5. Change the value of lockout threshold to the required value.

6. Click Save to save the changes.

7. Click Activate to activate your changes.

8. Restart all the servers in the domain.

24.2.20 "<User not found>" Error Message Appears in AdminServer Console While Setting-Up an Oracle Identity Manager-Oracle Access Manager Integration

When you set up Oracle Identity Manager-Oracle Access Manager Integration with a JAVA agent and log into the Admin Server Console, a "<User not found>" error message is displayed. This message displays even when the login is successful.

24.2.21 Do Not Use Single Quote Character in Reconciliation Matching Rule

If the single quote character (') is used in reconciliation data (for example, 'B'1USER1'), then target reconciliation will fail with an exception.

24.2.22 Do Not Use Special Characters When Reconciling Roles from LDAP

Due to a limitation in the Oracle SOA Infrastructure, do not use special characters such as commas (,) in role names, group names, or container descriptions when reconciling roles from LDAP. Oracle Identity Manager's internal code uses special characters as delimiters. For example, Oracle Identity Manager uses commas (,) as approver delimiters and the SOA HWF-level global configuration uses commas as assignee delimiters.

24.2.23 SoD Check During Request Provisioning Fails While Using SAML Token Client Policy When Default SoD Composite is Used

SoD check fails and the following error is displayed on the SOA console when SoD check is performed during request provisioning only when the Default SoD Check composite is used:

SEVERE: FabricProviderServlet.handleException Error during retrieval of test page or composite resourcejavax.servlet.ServletException: java.lang.NullPointerException

This happens when Callback is made from Oracle Identity Manager to SOA with the SoDCheck Results.

To resolve this issue, apply patch 9819201 on the SOA server. You can obtain patch 9819201 from My Oracle Support. The description of this patch on My Oracle Support is "ERROR WHILE USING SAML TOKEN CLIENT POLICY FOR CALLBACK."

For more information, refer to:

- Obtaining Patches From My Oracle Support (Formerly OracleMetaLink).

- Patch Requirements for Segregation of Duties (SoD)

24.2.24 SoD Check Fails While Using Client-Side Policy in Callback Invocation During Request Provisioning

SoD check fails and following error is displayed on the Oracle Identity Manager Administrative and User Console when SoD check is performed during request provisioning only when the Default SoD Check composite is used:

<Error> <oracle.wsm.resources.policymanager><WSM-02264> <"/base_domain/oim_server1/oim/unknown/iam-ejb.jar/WEBSERVICECLIENTs/SoDCheckResultService/PORTs/ResultPort" is not a recognized resource pattern.>
<Error> <oracle.iam.sod.impl> <IAM-4040002><Error getting Request Service : java.lang.IllegalArgumentException: WSM-02264 "/base_domain/oim_server1/oim/unknown/iam-ejb.jar/WEBSERVICECLIENTs/SoDCheckResultService/PORTs/ResultPort" is not a recognized resource pattern.>

To resolve this issue, use the Oracle Smart Update utility to apply patch ID 3M68, which requires passcode of 6LUNDUC7, on Oracle WebLogic Server. For more information, refer to:

- The Oracle Smart Update Installing Patches and Maintenance Packs documentation.

- Patch Requirements for Segregation of Duties (SoD)

24.2.25 Error May Appear During Provisioning when Generic Technology Connector Framework Uses SPML

When using the generic technology connector framework uses SPML, during provisioning, the following error may appear:

<SPMLProvisioningFormatProvider.formatData :problem with Velocity Template Unable
to find resource 'com/thortech/xl/gc/impl/prov/SpmlRequest.vm'>

If the error occurs, it blocks provisioning by using the predefined SPML GTC provisioning format provider. Restarting the Oracle Identity Manager server prevents the error from appearing again.

24.2.26 Cannot Click Buttons in TransUI When Using Mozilla Firefox

When using the Mozilla Firefox browser, in certain situations, some buttons in the legacy user interface, also known as TransUI, cannot be clicked. This issue occurs intermittently and can be resolved by using Firefox's reload (refresh) function.

24.2.27 LDAP Handler May Cause Invalid Exception While Creating, Deleting, or Modifying a Role

If an LDAP handler causes an exception when you create, modify, or delete a role, an invalid error message, such as System Error or Role does not exist, may appear.

To work around this issue, look in the log files, which will display the correct error message.

24.2.28 Cannot Reset User Password Comprised of Non-ASCII Characters

If a user's password is comprised of non-ASCII characters, and that user tries to reset the password from either the My Profile or initial login screens in the Oracle Identity Manager Self Service interface, the reset will fail with the following error message:

Failed to change password during the validation of the old password

Note:

This error does not occur with user passwords comprised of only ASCII characters.

To work around this issue, perform the following steps:

1. Set the JVM file encoding to UTF8, for example: -Dfile.encoding=UTF-8

Note:

On Windows systems, this may cause the console output to appear distorted, though output in the log files appear correctly.

2. Restart the Oracle WebLogic Server.

24.2.29 Benign Exception and Error Message May Appear While Patching Authorization Policies

When patches are applied to the Authorization Polices that are included with Oracle Identity manager and the JavaSE environment registers the Oracle JDBC driver, java.security.AccessControlException is reported and the following error message appears:

Error while registering Oracle JDBC Diagnosability MBean

You can ignore this benign exception, as the Authorization Policies are seeded successfully, despite the exception and error messages.

24.2.30 The DateTime Pick in the Trans UI Does Not Work Correctly in the Thai Locale

When locale is set to th_TH in Microsoft Windows Internet Explorer Web browser, the datetime in Oracle Identity Manager follows the Thai Buddhist calendar. In the Create Attestation page of the Administrative and User Console, when you select a date for start time, the year is displayed according to the Thai Buddhist calendar, for example, 2553. After you click OK, the equivalent year according to the Gregorian calendar, which is 2010, is displayed in the start time field. But when you click Next to continue creating the attestation, an error message is displayed stating that the start time of the process must not belong to the past.

To workaround this issue, perform any one of the following:

- Specify the datetime manually.

- Use Mozilla Firefox Web browser, which uses the Gregorian calendar.

24.2.31 User Without Access Policy Administrators Role Cannot View Data in Access Policy Reports

OIM user without the ACCESS POLICY ADMINISTRATORS role cannot view data in the following reports:

- Access Policy Details

- Access Policy List by Role

To workaround this issue:

1. Assign the ACCESS POLICY ADMINISTRATORS role to an OIM user.

2. Create a BI Publisher user with the same username in Step 1. Assign appropriated BI Publisher role to view reports.

3. Login as the BI Publisher user mentioned in step 2. View the Access Policy Details and Access Policy List by Role reports. All access policies are displayed.

24.2.32 Archival Utility Throws an Error for Empty Date

In case of empty date, archival utility throws an error message, but proceeds to archive data by mapping to the current date. Currently, no workaround exists for this issue.

24.2.33 TransUI Closes with Direct Provisioning of a Resource

TransUI closes while doing a direct provisioning if user defined field (UDF) is created with the default values. To work around this issue, you need to create a Lookup Code for the INTEGER/DOUBLE type UDF in the LKU/LKV table.

24.2.34 Scheduler Throws "ParameterValueTypeNotSupportedException" Instead of "RequiredParameterNotSetException"

On AIX platform, when a required parameter is missing during the creation of a scheduler job, instead of throwing "RequiredParameterNotSetException" with the error message "The value is not set for required parameters of a scheduled task.", it throws "ParameterValueTypeNotSupportedException" with the error message "Parameter value is not set properly". Currently, no workaround exists for this issue.

24.2.35 All New User Attributes Are Not Supported for Attestation in Oracle Identity Manager 11g

New user attributes are added in Oracle Identity Manager 11g. Not all of them are available for Attestation while defining user-scope. However, Attestation has been enhanced to include the following user attributes:

- USR_COUNTRY

- USR_LDAP_ORGANIZATION

- USR_LDAP_ORGANIZATION_UNIT

- USR_LDAP_GUID

Currently, no workaround exists for this issue.

24.2.36 LDAP GUID Mapping to Any Field of Trusted Resource Not Supported

Update fails in LDAP, if LDAP GUID is mapped to any field of trusted resource in LDAP-SYNC enabled installation. To work around this issue, Oracle does not recommend mapping for LDAP GUID field while creating reconciliation field mapping for a trusted resource.

24.2.37 User Details for Design Console Access Field Must Be Mapped to Correct Values When Reading Modify Request Results

When a Modify Request is raised, "End-User" and "End-User Administrator" values are displayed for the "Design Console Access" field. These values must be mapped to False/True while interpreting the user details.

24.2.38 Cannot Create a User Containing Asterisks if a Similar User Exists

If you try to create a user that contains an asterisk (*) after creating a user with a similar name, the attempt will fail. For example, if you create user test1test, followed by test*test, test*test will not be created.

It is recommended to not create users with asterisks in the User Login field.

24.2.39 Blank Status Column Displayed for Past Proxies

The Status field on the Post Proxies page is blank. However, active proxies are displayed correctly on Current Proxies page.

Currently, no workaround exists for this issue.

24.2.40 Mapping the Password Field in a Reconciliation Profile Prevents Users from Being Created

The Password field is available to be mapped with a reconciliation profile, but it should not be used. Attempting to map this field will generate a reconciliation event that will not create users. (The event ends in "No Match Found State".) In addition, you will not be able to re-evaluate or manually link this event.

24.2.41 UID Displayed as User Login in User Search Results

Although you can select the UID attribute from the Search Results Table Configuration list on the Search Configuration page of the Advanced Administration, the search results table for advanced search for users displays the User Login field instead of the UID field.

24.2.42 Roles/Organizations Browse Trees Disappear

After you delete an organization, the Browse trees for organizations and roles might not be displayed.

To work around this issue, click the Search Results tab, then click the Browse tab. The roles and organizations browse trees display correctly.

24.2.43 Entitlement Selection Is Not Optional for Data Gathering

Entitlement (Child Table) selection during data gathering on the process form, for the "Depends On (Depended)" attribute is not optional. During data gathering, if dependent lookups are configured, then the user has to select the parent lookup value so that filtering happens on the child lookup and thus user gets a final list of entitlements to select . Currently, no workaround exists to directly filter the values based on the child lookup.

24.2.44 Oracle Identity Manager Server Throws Generic Exception While Deploying a Connector

Generic exceptions are shown in server logs every time deployment manager import happens or profile changes manually or profile changes via design console. This is because "WLSINTERNAL" is not an authorized user of Oracle Identity Manager. "WLSINTERNAL" is an internal user of WebLogic Server, and MDS uses it to invoke MDS listeners if there is a change in XMLs stored in MDS. Currently, no workaround exists for this issue.

24.2.45 Create User API Allows Any Value for the "Users.Password Never Expires", "Users.Password Cannot Change", and "Users.Password Must Change" Fields

Create User API allows the user to set any value between 0 and 9 instead of 0 or 1 for "Users.Password Never Expires", "Users.Password Cannot Change" and "Users.Password Must Change" fields. However, any value other than 0 is considered as TRUE and 0 is considered as FALSE, and the flag is set accordingly for the user being created. Currently, no workaround exists for this issue.

24.2.46 Incorrect Label in JGraph Screen for the GTC

The User Type label on the JGraph screen is displayed incorrectly as Design Console Access. To display User Type, add the line Xellerate_Type=User Type to the OIM_HOME/server/customResources/customResources.properties file.

24.2.47 Running the Workflow Registration Utility Generates an Error

When the workflow registration utility is run in a clustered deployment of Oracle Identity Manager, the following error is generated:

[java] oracle.iam.platform.utils.NoSuchServiceException:
java.lang.reflect.InvocationTargetException

Ignore the error message.

24.2.48 Native Performance Pack is Not Enabled On Solaris 64-bit JVM Install

For Oracle Identity Manager JVM install on a Solaris 64-bit computer, Oracle WebLogic log displays the following error:

Unable to load performance pack. Using Java I/O instead. Please ensure that a native performance library is in:

To workaround this issue, perform the following to ensure that JDK picks up the 64-bit native performance:

1. In a text editor, open the MIDDLEWARE_HOME/wlserver_10.3/common/bin/commEnv.sh file.

2. Replace the following:

SUN_ARCH_DATA_MODEL="32"

With:

SUN_ARCH_DATA_MODEL="64"

3. Save and close the commEnv.sh file.

4. Restart the application server.

24.2.49 Error in the Create Generic Technology Connector Wizard

If you enter incorrect credentials for the database on the Create Generic Technology Connector wizard, a system error window is displayed. You must close this window and run the wizard again.

24.2.50 DSML Profile for the SPML Web Service is Not Deployed With Oracle Identity Manager

The DSML profile for the SPML Web service is not deployed by default with Oracle Identity Manager 11g Release 1 (11.1.1). SPML-DSML binaries are bundled with the Oracle Identity Manager installer to support Microsoft Active Directory Password Synchronization. You must deploy the spml-dsml.ear file manually.

24.2.51 New Human Tasks Must Be Copied in SOA Composites

When you add a new human task to an existing SOA composite, you must ensure that all the copy operations for the attributes in the original human task are added to the new human task. Otherwise, an error could be displayed on the View Task Details page.

24.2.52 Modify Provisioned Resource Request Does Not Support Service Account Flag

A regular account cannot be changed to a service account, and similarly, a service account cannot be changed to a regular account through a Modify Provisioned Resource request.

24.2.53 Erroneous "Query by Example" Icon in Identity Administration Console

In the Identity Administration console, when viewing role details from the Members tab, an erroneous icon with the "tooltip" (mouse-over text) of "Query By Example" appears. This "Query By Example" icon is non-functional and should be ignored.

24.2.54 The XL.ForcePasswordChangeAtFirstLogin System Property Is No Longer Used

The XL.ForcePasswordChangeAtFirstLogin system property is no longer used in Oracle Identity Manager 11g Release 1 (11.1.1.1). Therefore, forcing the user to change the password at first login cannot be configured. By default, the user must change the password:

- When the new user, other than self-registered users, is logging in to Oracle Identity Manager for the first time

- When the user is logging in to Oracle Identity Manager for the first time after the password has been reset

24.2.55 The tcExportOperationsIntf.findObjects(type,name) API Does Not Accept the Asterisk (*) Wilcard Character in Both Parameters

The tcExportOperationsIntf.findObjects(type,name) API accepts the asterisk (*) wildcard character only for the second parameter, which is name. For type, a category must be specified. For example, findObjects("Resource","*") is a valid call, but findObjects("*","*") is not valid.

24.2.56 Disabled Links on the Access Policy Summary Page Opened in Mozilla FireFox

In the Verify Information for this Access Policy page of the Create/Modify Access Policy wizards opened in Mozilla Firefox Web browser, you click Change for resource to be provisioned by the access policy, and then click Edit to edit the process form data for the resources to be provisioned. If you click the Close button on the Edit form, then the change links for any one of the access policy information sections, such as resources to be provisioned by the access policy, resources to be denied by the access policy, or roles for the access policy, do not work.

To workaround this issue, click Refresh. All the links in the Verify Information for this Access Policy page are enabled.

24.2.57 Benign Error is Generated on Editing the IT Resource Form in Advanced Administration

When you click the Edit link on the IT Resource form in the Advanced Administration, the following error message is logged:

<Error> <XELLERATE.APIS> <BEA-000000>
<Class/Method: tcFormDefinitionOperationsBean/getFormFieldPropertyValue encounter some problems: Property 'Column Names' has not defined for the form field '-82'>

The error message is benign and can be ignored because there is no loss of functionality.

24.2.58 User Account is Not Locked in iPlanet Directory Server After it is Locked in Oracle Identity Manager

After reaching the maximum login attempts, a user is locked in Oracle Identity Manager. But in iPlanet DS/ODSEE, the user is not locked. The orclAccountLocked feature is not supported because the backend iPlanet DS/ODSEE does not support account unlock by setting the Operational attribute. Account is unlocked only with a password reset. The nsaccountlock attribute is available for administrative lockout. The password policies do not use this attribute, but you can use this attribute to independently lock an account. If the password policy locks the account, then nsaccountlock locks the user even after the password policy lockout is gone.

24.2.59 Oracle Identity Manager Does Not Support Autologin With JavaAgent

In an Oracle Access Manager (OAM) integrated deployment of Oracle Identity Manager with JavaAgent, when a user created in Oracle Identity Manager tries to login to the Oracle Identity Manager Administrative and User Console for the first time, the user is forced to reset password and set challenge questions. After this, the user is not logged in to Oracle Identity Manager automatically, but is redirected to the OAM login page. This is because Oracle Identity Manager does not support autologin when JavaAgent is used.

24.2.60 Benign Error Logged on Opening Access Policies, Resources, or Attestation Processes

As a delegated administrator, when you open the page to display the details of an access policy, resource, or attestation process, the following error is logged:

Error> <org.apache.struts.tiles.taglib.InsertTag> <BEA-000000>
<Can't insert page '/gc/EmptyTiles.jsp' : Write failed: Broken pipe  java.net.SocketException: Write failed: Broken pipe

The error is benign and can be ignored because there is no loss of functionality.

24.2.61 User Locked in Oracle Identity Manager But Not in LDAP

In a LDAP-enabled deployment of Oracle Identity Manager in which the directory servers are Microsoft Active Directory (AD) or Oracle Internet Directory (OID), when a user is manually locked in Oracle Identity Manager by the administrator, the user is not locked in LDAP if a password policy is not configured in LDAP. The configurable password policy in LDAP can either be the default password policy that is applicable to all the LDAP users, or it can be a user-specific Password Setting Object (PSO).

24.2.62 Reconciliation Profile Must Not Be Regenerated Via Design Console for Xellerate Organization Resource Object

By default, the Xellerate Organization resource object does not have reconciliation to Oracle Identity Manager field mappings and any matching/action rule information. As a result, when reconciliation profile for Xellerate Organization resource object is updated via Design Console, it corrupts the existing reconciliation configuration for that resource object, and reconciliation fails with empty status.

To workaround this issue, do not generate the reconciliation profile/configuration via the Design Console. Instead, export the Xellerate Organization profile from Meta Data Store (MDS) and edit it manually, and import it back into Oracle Identity Manager. If the profile changes include modification of the reconciliation fields, then the corresponding changes must be made in the horizontal table schema and its entity definition as well.

24.2.63 Benign Error Logged on Clicking Administration After Upgrade

After upgrading Oracle Identity Manager from Release 9.1.0.1 to 11g Release 1 (11.1.1), on clicking the Administration link on the Administrative and User Console, the following error is logged:

<Error> <oracle.adfinternal.view.page.editor.utils.ReflectionUtility>
<WCS-16178> <Error instantiating class - oracle.adfdtinternal.view.faces.portlet.PortletDefinitionDTFactory>

This error is benign and can be ignored because there is no loss of functionality.

24.2.64 Provisioning Fails Through Access Policy for Provisioned User

When a user is already provisioned and you try to assign a role to the user that triggers provisioning to the target domain, the provisioning is not started. However, if the user is not provisioned already and you assign a role to the user, then the provisioning occurs successfully.

To workaround this issue:

1. Open the connector-specific user form in the Design Console.

2. Create a new version of the connector, and select Edit.

3. Click the Properties tab, and then click server (ITResourceLookupField). Click Add Property.

4. Add Required for the property and specify true. Click Make Version Active, and then click Save.

5. Login to Oracle Identity Manager Administrative and User Console.

6. Navigate to System Property. Search for the 'Allows access policy based provisioning of multiple instances of a resource' system property. Change the value of this property to TRUE.

7. Restart Oracle Identity Manager.

Try provisioning a provisioned user to provision through access policy of the same IT Resource Type, and the provisioning is successful.

24.2.65 Benign Warning Messages Displayed During Oracle Identity Manager Managed Server Startup

Several messages resembling the following are logged during Oracle Identity Manager managed server startup:

<Mar 30, 2011 6:51:01 PM PDT> <Warning> <oracle.iam.platform.kernel.impl>
<IAM-0080071>
<Preview stage is not supported in kernel and found an event handler with name ProvisionAccountPreviewHandler implemented by the class oracle.iam.accesspolicy.impl.handlers.provisioning.ProvisionAccountPreviewHandlerfor this stage. It will be ignored.>

These warning messages are benign and can be ignored because there is no loss of functionality.

24.2.66 Benign Message Displayed When Running the Deployment Manager

When running the Deployment Manager, a message with header ' XUL SYNTAX: ID Conflict' is displayed.

This message is benign and can be ignored because there is no loss of functionality. Close the message and continue.

24.2.67 Deployment Manager Export Fails When Started Using Microsoft Internet Explorer 7 With JRE Plugin 1.6_23

After upgrading Oracle Identity Manager from an earlier release to 11g Release 1 (11.1.1), when you use the Microsoft Internet Explorer 7 Web browser with JRE plugin 1.6_23 to open the Administrative and User Console and try to export files by using the Deployment Manager, an error is generated and you cannot proceed with the export.

To workaround this issue, use a combination of the following Web browsers and plugins:

- Mozilla Firefox 3.6 and JRE version 1.6_23 on 64-bit computer

- Microsoft Internet Explorer 7 and JRE version 1.5

- Microsoft Internet Explorer 8 and JRE version 1.6_18

- Microsoft Internet Explorer 7 and JRE version 1.6_24

24.2.68 User Creation Fails in Microsoft Active Directory When Value of Country Attribute Exceeds Two Characters

In a LDAP-enabled deployment of Oracle Identity Manager, user creation fails in the Microsoft Active Directory (AD) server if the value of the Country attribute exceeds two characters. AD mandates two characters for the Country attribute, for example US, based on the ISO 3166 standards.

24.2.69 Deployment Manager Import Fails if Scheduled Job Entries Are Present Prior To Scheduled Task Entries in the XML File

In Oracle Identity Manager 11g Release 1 (11.1.1), schedules job has a dependency on scheduled task. Therefore, scheduled task must be imported prior to scheduled job.

As a result, if a XML file has scheduled job entries prior to scheduled task entries, then importing the XML file using Deployment Manager fails with the following error message:

[exec] Caused By: oracle.iam.scheduler.exception.SchedulerException: Invalid ScheduleTask definition
[exec] com.thortech.xl.ddm.exception.DDMException

To workaround this issue, open the XML file and move all scheduled task entries above the scheduled job entries.

24.2.70 Permission on Target User Required to Revoke Resource

When you login to the Administrative and User Console with Identity User Administrators and Resource Administrators roles, direct provision a resource to a user, and attempt to revoke the resource from the user, an error message is displayed.

To workaround this issue, you (logged-in user) must have the write permission on the target user (such as user1). To achieve this:

1. Create a role, such as role1, and assign self to this role.

2. Create an organization, such as org1, and assign role1 as administrative group.

3. Modify the user user1 and change its organization to org1. You can now revoke the resource from user1.

24.2.71 Reconciliation Event Fails for Trusted Source Reconciliation Because of Missing Reconciliation Rule in Upgraded Version of Oracle Identity Manager

When Oracle Identity Manager is upgraded from an earlier release to 11g Release 1 (11.1.1), for trusted source reconciliation, such as trusted source reconciliation using GTC, the reconciliation event fails with the following error message because of a missing reconciliation rule:

<Mar 31, 2011 6:27:41 PM CDT> <Info> <oracle.iam.reconciliation.impl>
<IAM-5010006> <The following exception occurred: {0}
oracle.iam.platform.utils.SuperRuntimeException:
Error occurred in XL_SP_RECONEVALUATEUSER while processing Event No 3
Error occurred in XL_SP_RECONUSERMATCH while processing Event No 3
One or more input parameter passed as null

To workaround this issue:

1. Create a reconciliation rule for the resource object.

2. In the Resource Object form of the Design Console, click Create Reconciliation Profile.

24.2.72 XML Validation Error on Oracle Identity Manager Managed Server Startup

The following error message is logged at the time of Oracle Identity Manager Managed Server startup:

<Mar 29, 2011 2:49:31 PM PDT> <Error> <oracle.iam.platform.kernel.impl>
<IAM-0080075> <XML schema validation failed for XML/metadata/iam-features-callbacks/event_configuration/EventHandlers.xml and it will not be loaded by kernel. >

<Mar 29, 2011 2:49:32 PM PDT> <Error> <oracle.iam.platform.kernel.impl>
<IAM-0080075> <XML schema validation failed for XML/metadata/iam-features-OIMMigration/EventHandlers.xml and it will not be loaded by kernel. >

This error message is benign and can be ignored because there is no loss of functionality.

24.2.73 Cannot View or Edit Adapter Mapping in the Data Object Manager Form of the Design Console

When you click Map on the Map Adapters tab in the Data Object Manager form of the Design Console, a dialog box is displayed that allows you to edit the individual entity adapter mappings. But the list with fields on the user object to map is displayed as empty. As a result, you cannot view or edit the individual entity adapter mappings.

Use of entity adapters is deprecated in Oracle Identity Manager 11g Release 1 (11.1.1), although limited support is still provided for backward compatibility only. Event handlers must be used for all new or changed scenarios.

24.2.74 Role Memberships for Assign or Revoke Operations Not Updated on Enabling or Disabling Referential Integrity Plug-in

In a multi-directory deployment, the secondary server must be OID. The primary server can be OID or AD. For example, users can be stored in the OID or AD primary server, and roles can be stored in the OID secondary server. Enabling of disabling the referential integrity plug-in does not update the role memberships for assign or revoke operations.

24.2.75 Deployment Manager Import Fails if Data Level for Rules is Set to 1

An entry in the Oracle Identity Manager database cannot be updated if data level is set to 1. When you try to import a Deployment Manager XML, the following error is displayed:

Class/Method: tcTableDataObj/updateImplementation Error :The row cannot be updated.
[2011-04-06T07:25:36.583-05:00] [oim_server1] [ERROR] []
[XELLERATE.DDM.IMPORT] [tid: [ACTIVE].ExecuteThread: '6' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: xelsysadm] [ecid:
cad00d8aeed4d8fc:-67a4db1a:12f2abbac4b:-8000-000000000000018e,0] [APP:
oim#11.1.1.3.0] The security level for this data item indicates that it cannot be updated.

To workaround this issue, open the XML file and change the data level for rules from 1 to 0, as shown:

<RUL_DATA_LEVEL>0</RUL_DATA_LEVEL>

24.2.76 Reconciliation Data Displays Attributes That Are Not Modified

In an Oracle Identity Manager deployment with LDAP synchronization enabled and Microsoft Active Directory (AD) as the directory server, the Reconciliation Data tab of the Event Management page in the Administrative and User Console displays all the attributes of the reconciled user instead of displaying only the modified attributes. This is because of the way AD changelogs are processed, in which the entire entry is marked as updated when any attribute is changed. Therefore, Oracle Virtual Directory (OVD) returns the full entry. There is no way to figure out which attribute has been modified as a result of reconciliation.

24.2.77 Benign Errors Displayed on Starting the Scheduler Service When There are Scheduled Jobs to be Recovered

When the Scheduler service is started and there are some scheduled jobs that have not been recovered, the following error might be logged in the oim_diagnostic log:

Caused by: java.lang.NullPointerException
at
org.quartz.SimpleTrigger.computeNumTimesFiredBetween(SimpleTrigger.java:800)
at org.quartz.SimpleTrigger.updateAfterMisfire(SimpleTrigger.java:514)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.doUpdateOfMisfiredTrigger(JobStor
eSupport.java:944)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.recoverMisfiredJobs(JobStoreSuppo
rt.java:898)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.recoverJobs(JobStoreSupport.java:
780)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport$2.execute(JobStoreSupport.java:75
2)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport$40.execute(JobStoreSupport.java:3
628)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.executeInNonManagedTXLock(JobStor
eSupport.java:3662)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.executeInNonManagedTXLock(JobStor
eSupport.java:3624)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.recoverJobs(JobStoreSupport.java:
748)
at
org.quartz.impl.jdbcjobstore.JobStoreSupport.schedulerStarted(JobStoreSupport.
java:573)

This error is benign and can be ignored because there is no loss of functionality.

In an upgrade environment, the next time when some scheduled jobs will be triggered is not defined. This results in a null input for Quartz code, which is not handled gracefully in earlier versions of Quartz. This has been fixed in Quartz version 1.6.3, and therefore, this error is not generated when you upgrade to that version of Quartz.

24.2.78 Trusted Source GTC Reconciliation Mapping Cannot Display Complete Attribute Names

When creating a trusted GTC (for example, flat file), the right-hand column under OIM User is not wide enough to display the complete names for many attributes. For example, two entries are displayed as 'LDAP Organizati', whereas the attribute names are 'LDAP Organization' and 'LDAP Organization Unit'.

To workaround this issue, click the Mapping button for the attribute. The Provide Field Information dialog box is displayed with the complete attribute name.

24.2.79 Benign Error Logged for Database Connectivity Test

When running the database connectivity test in XIMDD, the following error is logged multiple times:

<Apr 10, 2011 7:45:20 PM PDT> <Error> <Default> <J2EE JMX-46335> <MBean attribute access denied.
MBean: oracle.logging:type=LogRegistration
Getter for attribute Application
Detail: Access denied. Required roles: Admin, Operator, Monitor, executing
subject: principals=[REQUEST TEMPLATE ADMINISTRATORS, SYSTEM ADMINISTRATORS, APPROVAL POLICY ADMINISTRATORS, oimusers, xelsysadm, PLUGIN ADMINISTRATORS]
java.lang.SecurityException: Access denied. Required roles: Admin, Operator, Monitor, executing subject: principals=[REQUEST TEMPLATE ADMINISTRATORS, SYSTEM ADMINISTRATORS, APPROVAL POLICY ADMINISTRATORS, oim users, xelsysadm, PLUGIN ADMINISTRATORS]

Each time the error occurs in the log, the name of the bean is different, but the error is same. In spite of these errors, the test passes. These errors are benign and can be ignored because there is no loss of functionality.

24.2.80 MDS Validation Error When Importing GTC Provider Through the Deployment Manager

An MDS validation error is generated when you import the GTC provider by using the Deployment Manager.

To workaround this issue, do not import the GTC provider through the Deployment Manager. If the Deployment Manager XML file contains tags for GTC provider, then remove it and import the rest of the XML by using the Deployment Manager. Import the XML file with the GTC provider tags separately by using the MDS import utility. To do so:

1. If the XML file being imported through the Deployment Manager contains <GTCProvider> tags, then remove these tags along with everything under them.
The following is an example of the original XML file to be imported:

<?xml version = '1.0' encoding = 'UTF-8'?>
<xl-ddm-data version="2.0.1.0" user="XELSYSADM"
database="jdbc:oracle:thin:@localhost:5521:myps12"
exported-date="1302888552341" description="sampleGTC"><GTCProvider
repo-type="MDS" name="InsertIntoTargetList"
mds-path="/db/GTC/ProviderDefinitions"
mds-file="InsertIntoTargetListProvTransport.xml"><completeXml><Provider><Provi
der>
<Provisioning>
<ProvTransportProvider
class="provisioningTransportProvider.InsertIntoTargetList"
name="InsertIntoTargetList">
<Configuration>
<Parameter datatype="String" name="targetServerName"
type="Runtime" encrypted="NO" required="YES"/>
<Response code="FUNCTIONALITY_NOT_SUPPORTED"
description="Functionality not supported"/>
<Response code="TARGET_SERVER_NAME_MISSING" description="Target
server name is missing"/>
<Response code="TARGET_SERVER_NAME_STARTSWITH_A"
description="Target server name starts with A, from XML"/>
<Response code="PROBLEM_WHILE_INITIALIZAING" description="Problem
occured while intializing Provider instance"/>
</Configuration>
</ProvTransportProvider>
</Provisioning>
</Provider></Provider></completeXml></GTCProvider><GTCProvider
repo-type="MDS" name="PrepareDataHMap" mds-path="/db/GTC/ProviderDefinitions"
mds-file="PrepareDataHMapProvFormat.xml"><completeXml><Provider><Provider>
<Provisioning>
<ProvFormatProvider class="provisioningFormatProvider.PrepareDataHMap"
name="PrepareDataHMap">
<Configuration>
<DefaultAttribute datatype="String" name="testField" size="40"
encrypted="NO"/>
<Response code="INCORRECT_PROCESS_DATA" description="Incorrect
process data received from GTC provisioning framework"/>
<Response code="PROCESSING_ISSUE" description="Processing issue
in Preparing provisioning input, check logs"/>
</Configuration>
</ProvFormatProvider>
</Provisioning>
</Provider></Provider></completeXml></GTCProvider><GTCProvider
repo-type="MDS" name="IsValidOrgInOIM" mds-path="/db/GTC/ProviderDefinitions"
mds-file="IsValidOrgInOIM.xml"><completeXml><Provider><Provider>
<Validation>
<ValidationProvider class="validationProvider.IsValidOrgInOIM"
name="IsValidOrgInOIM">
<Configuration>
<Parameter datatype="String" name="maxOrgSize"/>
</Configuration>
</ValidationProvider>
</Validation>
</Provider></Provider></completeXml></GTCProvider><GTCProvider
repo-type="MDS" name="ConvertToUpperCase"
mds-path="/db/GTC/ProviderDefinitions"
mds-file="ConvertToUpperCase.xml"><completeXml><Provider><Provider>
<Transformation>
<TransformationProvider
class="transformationProvider.ConvertToUpperCase" name="ConvertToUpperCase">
<Configuration>
<Parameter type="Runtime" datatype="String" required="YES"
encrypted="NO" name="Input"/>
<Response code="errorRespNullInput" description="Input String is
Missing"/>
</Configuration>
</TransformationProvider>
</Transformation>
</Provider></Provider></completeXml></GTCProvider><Resource repo-type="RDBMS"
name="SAMPLEGTC_GTC">....</Resource><Process repo-type="RDBMS"
name="SAMPLEGTC_GTC">
...........
</Process><Form repo-type="RDBMS" name="UD_SAMPLEGT" subtype="Process
Form">.....
</Form>....</xl-ddm-data>

2. Import the rest of the XML file through the Deployment Manager.
The following is the XML file after removing the <GTCProvider> tags from the original XML file. Import this XML file by using the Deployment Manager.

<?xml version = '1.0' encoding = 'UTF-8'?>
<xl-ddm-data version="2.0.1.0" user="XELSYSADM"
database="jdbc:oracle:thin:@localhost:5521:myps12"
exported-date="1302888552341" description="sampleGTC"><Resource
repo-type="RDBMS" name="SAMPLEGTC_GTC">....</Resource><Process
repo-type="RDBMS" name="SAMPLEGTC_GTC">
...........
</Process><Form repo-type="RDBMS" name="UD_SAMPLEGT" subtype="Process
Form">.....
</Form>....</xl-ddm-data>

The following is the removed XML content:

<GTCProvider
repo-type="MDS" name="InsertIntoTargetList"
mds-path="/db/GTC/ProviderDefinitions"
mds-file="InsertIntoTargetListProvTransport.xml"><completeXml><Provider><Provider>
<Provisioning>
<ProvTransportProvider
class="provisioningTransportProvider.InsertIntoTargetList"
name="InsertIntoTargetList">
<Configuration>
<Parameter datatype="String" name="targetServerName"
type="Runtime" encrypted="NO" required="YES"/>
<Response code="FUNCTIONALITY_NOT_SUPPORTED"
description="Functionality not supported"/>
<Response code="TARGET_SERVER_NAME_MISSING" description="Target
server name is missing"/>
<Response code="TARGET_SERVER_NAME_STARTSWITH_A"
description="Target server name starts with A, from XML"/>
<Response code="PROBLEM_WHILE_INITIALIZAING" description="Problem
occured while intializing Provider instance"/>
</Configuration>
</ProvTransportProvider>
</Provisioning>
</Provider></Provider></completeXml></GTCProvider>

<GTCProvider
repo-type="MDS" name="PrepareDataHMap" mds-path="/db/GTC/ProviderDefinitions"
mds-file="PrepareDataHMapProvFormat.xml"><completeXml><Provider><Provider>
<Provisioning>
<ProvFormatProvider class="provisioningFormatProvider.PrepareDataHMap"
name="PrepareDataHMap">
<Configuration>
<DefaultAttribute datatype="String" name="testField" size="40"
encrypted="NO"/>
<Response code="INCORRECT_PROCESS_DATA" description="Incorrect
process data received from GTC provisioning framework"/>
<Response code="PROCESSING_ISSUE" description="Processing issue
in Preparing provisioning input, check logs"/>
</Configuration>
</ProvFormatProvider>
</Provisioning>
</Provider></Provider></completeXml></GTCProvider>

<GTCProvider
repo-type="MDS" name="IsValidOrgInOIM" mds-path="/db/GTC/ProviderDefinitions"
mds-file="IsValidOrgInOIM.xml"><completeXml><Provider><Provider>
<Validation>
<ValidationProvider class="validationProvider.IsValidOrgInOIM"
name="IsValidOrgInOIM">
<Configuration>
<Parameter datatype="String" name="maxOrgSize"/>
</Configuration>
</ValidationProvider>
</Validation>
</Provider></Provider></completeXml></GTCProvider>

<GTCProvider
repo-type="MDS" name="ConvertToUpperCase"
mds-path="/db/GTC/ProviderDefinitions"
mds-file="ConvertToUpperCase.xml"><completeXml><Provider><Provider>
<Transformation>
<TransformationProvider
class="transformationProvider.ConvertToUpperCase" name="ConvertToUpperCase">
<Configuration>
<Parameter type="Runtime" datatype="String" required="YES"
encrypted="NO" name="Input"/>
<Response code="errorRespNullInput" description="Input String is
Missing"/>
</Configuration>
</TransformationProvider>
</Transformation>
</Provider></Provider></completeXml></GTCProvider>

3. Separate the removed XML content based on the <GTCProvier> tags. The following is an example of the first <GTCProvider> tag:

<GTCProvider repo-type="MDS" name="InsertIntoTargetList"
mds-path="/db/GTC/ProviderDefinitions"
mds-file="InsertIntoTargetListProvTransport.xml"><completeXml><Provider><Provi
der>
<Provisioning>
<ProvTransportProvider
class="provisioningTransportProvider.InsertIntoTargetList"
name="InsertIntoTargetList">
<Configuration>
<Parameter datatype="String" name="targetServerName"
type="Runtime" encrypted="NO" required="YES"/>
<Response code="FUNCTIONALITY_NOT_SUPPORTED"
description="Functionality not supported"/>
<Response code="TARGET_SERVER_NAME_MISSING" description="Target
server name is missing"/>
<Response code="TARGET_SERVER_NAME_STARTSWITH_A"
description="Target server name starts with A, from XML"/>
<Response code="PROBLEM_WHILE_INITIALIZAING" description="Problem
occured while intializing Provider instance"/>
</Configuration>
</ProvTransportProvider>
</Provisioning>
</Provider></Provider></completeXml></GTCProvider>
Resultant xml after removal of tags surronding inner <Provider> tag:
<Provider>
<Provisioning>
<ProvTransportProvider
class="provisioningTransportProvider.InsertIntoTargetList"
name="InsertIntoTargetList">
<Configuration>
<Parameter datatype="String" name="targetServerName"
type="Runtime" encrypted="NO" required="YES"/>
<Response code="FUNCTIONALITY_NOT_SUPPORTED"
description="Functionality not supported"/>
<Response code="TARGET_SERVER_NAME_MISSING" description="Target
server name is missing"/>
<Response code="TARGET_SERVER_NAME_STARTSWITH_A"
description="Target server name starts with A, from XML"/>
<Response code="PROBLEM_WHILE_INITIALIZAING" description="Problem
occured while intializing Provider instance"/>
</Configuration>
</ProvTransportProvider>
</Provisioning>
</Provider>

4. From the removed <GTCProvider> tags, remove everything surrounding the inner <Provider> tag. In other words, keep the content inside the inner <Provider> tag. For each <Provider> tag, create a separate XML file. This results in multiple XML files with each <Provider> tag as the root element.
The following is the resultant XML content after removal of tags surrounding the inner <Provider> tag:

<Provider>
<Provisioning>
<ProvTransportProvider
class="provisioningTransportProvider.InsertIntoTargetList" name="InsertIntoTargetList">
<Configuration>
<Parameter datatype="String" name="targetServerName" type="Runtime" encrypted="NO" required="YES"/>
<Response code="FUNCTIONALITY_NOT_SUPPORTED" description="Functionality not supported"/>
<Response code="TARGET_SERVER_NAME_MISSING" description="Target server name is missing"/>
<Response code="TARGET_SERVER_NAME_STARTSWITH_A" description="Target server name starts with A, from XML"/>
<Response code="PROBLEM_WHILE_INITIALIZAING" description="Problem occured while intializing Provider instance"/>
</Configuration>
</ProvTransportProvider>
</Provisioning>
</Provider>

5. Name the resultant XML files, which have the <Provider> tag as the root element, with the mds-file attribute value from the <GTCProvider> tag. For example, name the first XML file with the first <GTCProvider> tag as InsertIntoTargetListProvTransport.xml. The file name must be the value of the mds-file attribute.

6. Similarly, create other GTC provider XML files. There must be one XML file for each <GTCProvider> tag.

7. Import the GTC Provider XML files by using the MDS utility.

24.2.81 Encrypted User-Defined Field (UDF) Cannot be Stored with Size of 4000 Characters or More

An encrypted UDF cannot be stored with size of 4000 characters or more. This is because encryption automatically increases the column width by 1.5 times approximately, and the size of the attribute exceeds the maximum allowable width of 4000. As a result, the UDF is automatically type-promoted to a CLOB data type. Oracle Identity Manager 11g Release 1 (11.1.1) does not intercept this as an exception and might subsequently show errors. This is likely to be addressed in the next patch release.

However, an encrypted attribute that does not exceed the final width of 4000 characters can be stored. The specified width must factor in the increment of 1.5 times, which means that it must not exceed approximately 2500 characters.

24.2.82 Request Approval Fails With Callback Service Failure

In an environment where SSL is enabled in the OAAM server but not in Oracle Identity Manager and SOA server, when you create a request, the request-level approval is successful on the SOA side, but the operational-level approval is not displayed anywhere in the UI. When the SOA composite that provides approval workflow for the Oracle Identity Manager request tries to invoke the request callback Web service to indicate whether the workflow is approved or rejected, the Web service invocation fails with the following error:

Unable to dispatch request to
http://slc402354.us.oracle.com:14000/workflowservice/CallbackService due to exception[[
javax.xml.ws.WebServiceException:
oracle.fabric.common.PolicyEnforcementException: PolicySet Invalid: WSM-06162
PolicyReference The policy referenced by URI
"oracle/wss11_saml_token_with_message_protection_client_policy" could not be
retrieved as connection to Policy Manager cannot be established at
"t3s://slc402354:14301" due to invalid configuration or inactive state.

The error indicates that OWSM is not able to connect to the Policy Manager on the specified port. This port is for the OAAM server in SSL mode, which is shut down. The issue occurs because SSL is enabled in the OAAM server but not on Oracle Identity Manager and SOA server, and the Policy Manager is also targeted on that server. If there is an SSL-enabled Policy Manager, then OWSM does not use the non-SSL ports anymore. In this setup, SSL is enabled only for OAAM and not for others. Therefore, the only usable WSM Policy Manager is on OAAM. Because the OAAM server is down, the connection to the Policy Manager is not established, and as a result, the call fails.

To workaround this issue, start the OAAM server and then create the request.

Note:

This issue does not occur if:

- OAAM server is not SSL-enabled.

- SSL is enabled on any other server that is up and running, such as Oracle Identity Manager or SOA server.

24.2.83 Localized Display Name is Not Reconciled Via User/Role Incremental Reconciliation with iPlanet Directory Server

In an Oracle Identity Manager deployment with LDAP synchronization enabled in which iPlanet is the directory server, the following issues occur:

- The localized Display Name is not reconciled into Oracle Identity Manager via user/role incremental reconciliation.

- The localized value of the Display Name attribute is returned to Oracle Identity Manager, but the original base value of Display Name is lost and is replaced by the localized value that is received from iPlanet.

24.2.84 LDAP Role Hierarchy and Role Membership Reconciliation With Non-ASCII Characters Does Not Reconcile Changes in Oracle Identity Manager

LDAP role hierarchy and role membership reconciliation jobs with non-ASCII characters do not bring in role hierarchy and role membership changes into Oracle Identity Manager. This issue is applicable to incremental reconciliation only.

24.2.85 Import of Objects Fails When All Objects Are Selected for Export

In an upgraded environment of Oracle Identity Manager 11g Release 1 (11.1.1), the import of objects can fail when you select the Select All option to export the objects. When you select all the objects to be exported, the corresponding XML file grows in size. If it exceeds 2.5 million records, then it does not remain valid. As a result, the import fails. However, selecting all objects works if the data is small and the generated XML file does not exceed 2.5 million records.

To workaround this issue, select the objects to be exported in smaller logical units. For example, if there are 20 resource objects in the system, then select four or five resource objects with all dependencies and children objects in a XML file, and export. Then select another five resource objects into a new XML file. Similarly, for all other objects, such as GTC or adapters, export in small logical units in separate XML files. Examples of logical unit grouping are:

- Resource objects, process definition forms, adapters, IT resources, lookup definitions, and roles

- Organizations, attestation, and password policies

- Access policies and rules

- GTC and resource objects

24.2.86 Benign Audit Errors Logged After Upgrade

After upgrading from Oracle Identity Manager Release 9.1.0 to 11g Release 1 (11.1.1), audit errors are logged. An example of such an audit error is:

IAM-0050001
oracle.iam.platform.async.TaskExecutionException: java.lang.Exception: Audit
handler failed
at com.thortech.xl.audit.engine.jms.XLAuditMessage.execute(XLAuditMessage.java:59)

These errors are benign and can be ignored because there is no loss of functionality.

24.2.87 Connector Upgrade Fails if Existing Data is Bigger in Size Than New Column Length

In the current release of some connectors, the sizes of some process form fields have been reduced. For example, the length of the UD_ADUSER_MNAME field in the Microsoft Active Directory connector release 9.1.1.5 has been reduced to 6 characters from 80 characters in release 9.0.4.16 of the connector. The length of the existing data in these columns or fields are already bigger in size than the new column length. As a result, the connector upgrade fails, and the following error is logged:

<Apr 16, 2011 4:52:37 PM GMT+05:30> <Error> <XELLERATE.DATABASE> <BEA-000000>
<ALTER TABLE UD_ADUSER MODIFY UD_ADUSER_MNAME VARCHAR2(6) java.sql.SQLException: ORA-01441: cannot decrease column length because some value is too big

To workaround this issue:

1. Make sure that you create a backup of the database.

2. Restore the backed up database.

3. Check the logs to locate the 'ORA-01441: cannot decrease column length because some value is too big' exception. Note the form field name, such as UD_ADUSER_MNAME.

4. Open the Deployment Manager XML file that you are using for upgrade. Search for the form field in the <SDC_SQL_LENGTH> tag, and change the length to the base version length. You can get the base version length in the Deployment Manager XML of the base connector.

5. Retry the upgrade.

24.2.88 Connector Artifacts Count Increases in the Deployment Manager When File is Not Imported

When you upgrade a connector, map the connector artifacts between the base and latest versions, select the connector objects to be upgraded, and exit the upgrade without importing the objects by using the Deployment Manager, the connector artifacts count in the left panel displays more than the actual count. When this process is repeated, the artifacts count continues increasing. This is a known issue, and there is no loss of functionality.

24.2.89 Uploading JAR Files By Using the Upload JAR Utility Fails

When SSL is enabled for Oracle Identity Manager, uploading the JAR files by using the Upload JAR utility fails with the following error:

Error occurred in performing the operation:
Exception in thread "main" java.lang.NullPointerException at oracle.iam.platformservice.utils.JarUploadUtility.main(JarUploadUtility.java:229)

With SSL enabled in Oracle Identity Manager, the server URL must contain the exact host name or IP address. If localhost is used as the host name, then the error is generated.

To workaround this issue, use the exact server URL.

24.2.90 Oracle Identity Manager Data and MT Upgrade Fails Because Change of Database User Password

If you are NOT upgrading the original Oracle Identity Manager Release 9.x database, but choose to export/import to a new database, then you must make sure that the database connection setting, schema name, and password in the OIM_HOME/xellerate/config/xlconfig.xml file used for the upgrade is correct.

To workaround this issue, change the Oracle Identity Manager database information in the xlconfig.xml file. You must create a backup of this file before updating it. To update the file with the new database information, modify the information of the loaction where the database has been imported in the <URL>, <username>, and <Password ...> tags, as shown:

<DirectDB>
<driver>oracle.jdbc.driver.OracleDriver</driver>
<url>jdbc:oracle:thin:@localhost:1522:oimdb</url>
<username>oimadm</username>
<password encrypted="false"><NEW_PASSWORD_FOR_OIM_DB_USER></password>
<maxconnections>5</maxconnections>
<idletimeout>360</idletimeout>
<checkouttimeout>1200</checkouttimeout>
<maxcheckout>1000</maxcheckout>
</DirectDB>

24.2.91 Reverting Unsaved UDFs Are Not Supported in the Administration Details Page for Roles and Organizations

The Administration Details pages for roles and organizations in the Administrative and User Console do not support reverting unsaved UDF attribute values. Therefore, if you modify the UDF attribute values for a role or organization and then do not want to save the changes to these attributes, then perform one of the following:

- Close the tab with the modified role or organization. A warning message is displayed asking if you want to continue. Clicking Yes cancels all unsaved changes.

- You can manually edit the modified attributes to their original state. Saving the entity applies any other desired changes made.

24.2.92 Resources Provisioned to User Without Checking Changes in User Status After Request is Submitted

After submission of a request, if the user associated with the request, such as beneficiary, requester, or approver, is disabled or deleted, then the resources are provisioned to the user without checking for user status, such as Disabled or Deleted, after the request is approved.

24.2.93 Starting UCP Connection Pool Fails When Trying to Create User on 64-Bit Microsoft Windows With JDK 6

CRUD operations on Microsoft Windows 64-bit platform using JDK 6 fails in Non Input Output (NIO) mode. This is because of a limitation in JDK 6 to support IPv6 stack in Microsoft Windows Vista 2008. This support is added in JDK 7 since Build b36. With JDK 7, it works in OVD NIO mode.

To workaround this issue:

1. In the OVD server, turn off NIO mode. To do so:

1. Open the OracleInstance/config/OVD/ovd1/listeners.os_xml file.

2. Add <useNIO>false</useNIO> at the following location:

<ldap id="LDAP Endpoint" version="0">
<port>6501</port>
...
<socketOptions>
...
</socketOptions>
<useNIO>false</useNIO>
</ldap>

3. Save the listeners.os_xml file.

2. Restart the OVD server.

24.2.94 Config.sh Command Fails When JRockit is Installed With Data Samples and Source

When you install jrockit-jdk1.6.0_24-R28.1.3-4.0.1-linux-x64.bin with demo samples and source, and install Oracle WebLogic Server using wls1035_generic.jar on a Linux 64-bit computer, and run Oracle Identity Manager configuration wizard by running the config.sh command from the $ORACLE_HOME/bin/ directory, the Oracle universal installer does not start and the following error message is displayed:

config.sh: line 162:  9855 Segmentation fault $INSTALLER_DIR/runInstaller-weblogicConfig ORACLE_HOME="$ORACLE_HOME" -invPtrLoc$ORACLE_HOME/oraInst.loc -oneclick $COMMANDLINE -Doracle.config.mode=true

24.2.95 Unexpected Memory Usage in Oracle Identity Manager 11g Release 1(11.1.1)

On running scheduled tasks that perform user orchestration in bulk, such as EndDateSchedulerTask and StartDateSchedulerTask, Oracle Identity Manager 11g Release 1 (11.1.1) might consume large memory space. This can cause Out of Memory issues.

This is a known issue, and a workaround is not available for this in the current release.

24.2.96 Reports Link No Longer Exists in the Administrative and User Console

Under the Administration tab of the Advanced Administration in the Administrative and User Console, the Reports link to generate BI Publisher Reports has been removed, even though BIP has been selected while installing Oracle Identity Manager.

24.2.97 Not Allowing to Delete a Role Whose Assigned User Members are Deleted

If the user members of a role have been deleted before revoking the role memberships, then the role cannot be deleted. Therefore, you must revoke the user role memberships that have been explicitly assigned before deleting the user.

24.2.98 Roles and Organizations Do Not Support String UDFs of Password Type

Creating a String UDF of password type for roles and organizations is not supported. If you try to create such a UDF, then the Administrative and User Console does not allow you create roles and organizations.

24.2.99 Error on Importing Connector By Using the Deployment Manager

If you export a connector from a Oracle Identity Manager deployment to another deployment by using the Deployment Manager, then an error similar to the following might be generated:

[ERROR] [] [XELLERATE.WEBAPP]
[tid: [ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: xelsysadm] [ecid:
f9e72ab2a292a346:-421e2bf0:12f77f65b9a:-8000-0000000000000174,0] [APP:
oim#11.1.1.3.0] Class/Method: LoadDeploymentUtility/importSelected encounter
some problems: oracle.iam.reconciliation.exception.ConfigException: Profile
:AD User Trusted InvalidAttributes : [ObjectGUID][[
com.thortech.xl.ddm.exception.DDMException:
oracle.iam.reconciliation.exception.ConfigException: Profile :AD User Trusted
InvalidAttributes : [ObjectGUID]
at
com.thortech.xl.ejb.beansimpl.tcImportOperationsBean.performImport(tcImportOpe
.
rationsBean.java:1199)

This problem is because of the missing dependencies of UDFs created on the user entity. To avoid this problem, perform any one of the following:

- Manually create the UDFs in the system before importing the connector XMLs.

- Export the user meta data through the Deployment Manager and import it in the target environment. This bring in all the UDFs created on the user entity. However, if the requirement confines to some specific UDFs or if it is not desirable to have all the UDFs in the target system, then create the required UDFs manually.

24.2.100 Manage Localizations Dialog Box Does Not Open After Modifying Roles

After a role is modified, the Manage Localizations dialog box is not opening on clicking the Manage Localizations button in the role details page.

To open the Manage Localizations dialog box after modifying a role, close the role details page and open it again.

24.2.101 Not Allowing to Create User With Language-Specific Display Name Values

In an Oracle Identity Manager deployment with Microsoft Active Directory (AD) as the LDAP server, localized display name values are supported when you specify the oimLanguage parameter values in the UserManagement plugin adapter for AD via OVD. However, a user cannot be created when a language-specific value for the Display Name attribute is specified in Canadian French or Latin American Spanish, even if these languages have been specified in oimLanguage. In addition, when you create a user without language-specific Display Name, and then modify the user to add Canadian French or Latin American Spanish Display Name values, the same issue persists.

24.2.102 SoD Check Results Not Displayed for Requests Created by Users for the PeopleSoft Resource

SoD check results are not displayed for the requests created by users for the PeopleSoft (PSFT) resource.

To workaround this issue:

1. Open the PSFT connector XML file.

2. Under the <ITResource name = "PSFT Server"> tag, add the following:

<ITResourceAdministrator>
<SUG_READ>1</SUG_READ>
<SUG_UPDATE>1296129050000</SUG_UPDATE>
<UGP_KEY UserGroup = "ALL USERS"/>
</ITResourceAdministrator>

3. Save the PSFT connector XML file.

4. Manually add or assign the ALL USERS role with Read permission to the PSFT Server IT resource.

24.2.103 The XL.UnlockAfter System Property and the Automatically Unlock User Scheduled Job Do Not Take Effect

The XL.UnlockAfter system property determines the unlock time for the locked user accounts after the specified time. If the user account is locked because of the maximum login attempt failure with invalid credentials, then the account is automatically unlocked after the time (in minutes) as configured in the XL.UnlockAfter system property. By default, the value of this system property is 0, which implies that the locked user is never unlocked automatically.

The Automatically Unlock User scheduled job is responsible for unlocking such users. This scheduled job is configured to run after every 24 hours (1 day).

Therefore, even after the maximum time of Oracle WebLogic lockout threshold and expiry of the time specified for the XL.UnlockAfter system property, the locked users might not be able to login unless the Automatically Unlock User scheduled job is run.

If you are changing the default value of the XL.UnlockAfter system property, then it is recommended to change the frequency of the Automatically Unlock User scheduled task so that both the values are in sync. This ensures that the scheduled task gets triggered at the appropriate interval, and the users are unlocked successfully and are able to login in to Oracle Identity Manager.

24.2.104 Resetting Password on Account Lockout Does Not Unlock User

In a Oracle Identity Manager deployment with LDAP synchronization enabled and integrated with Oracle Access Manager (OAM), a user is locked on entering incorrect password more than the maximum allowed limit. However, the user is not allowed to unlock by resetting the password until after reconciliation is run.

24.2.105 Starting Oracle Identity Manager and SOA Server on Some 64-bit Microsoft Windows Computers for the First Time Takes Time

On some Microsoft Windows 64-bit computers, it is observed that Oracle Identity Manager and SOA Server take more than an hour to start for the first time. However, do not stop the managed servers while this process is going on. After the first start, subsequent restarts do not take the extended time.

24.2.106 Incremental and Full Reconciliation Jobs Cannot Be Run Together

Both incremental and full reconciliation jobs cannot be run at the same time. Incremental reconciliation jobs are enabled and run in periodic intervals of 5 minutes. At the same time, when full reconciliation job is run, an error is generated.

To workaround this issue, if full reconciliation needs to be run, then disable the incremental reconciliation jobs before running the full reconciliation jobs. After full reconciliation completes successfully, re-enable the incremental reconciliation jobs.

24.2.107 Incorrect Content in the ScheduleTask Jars Loaded and Third Party Jars Tables in the MT Upgrade Report

When Oracle Identity Manager release 9.1.x is upgraded to Oracle Identity Manager 11g Release 1 (11.1.1), the contents of the ScheduleTask Jars Loaded and Third Party Jars tables in the CRBUpgradeReport.html page generated by MT upgrade are not correct. The original scheduled task JARs are not displayed in the ScheduleTask Jars Loaded table. Therefore, you must run the SQL query query to know the scheduled task JARs. In addition, the third-party JARs are incorrectly placed in the ScheduleTask Jars Loaded table.

However, this does not result in any loss of functionality.

24.2.108 Scroll Bar Not Available on the Select Connector Objects to Be Upgraded Page of the Connector Management - Upgrading Wizard

If the Connector Management - Upgrading wizard is opened by using Microsoft Internet Explorer, then all the fields and buttons on the Step 13: Select Connector Objects to Be Upgraded page might not be visible. There is no scroll bar available in this page. Therefore, maximize the window to display all the controls in the page.

24.2.109 Adapter Import Might Display Adapter Logic if Compilation Fails Because of Incorrect Data

If you import a process task adapter by using the Design Console and the adapter compilation fails because of incorrect data, then the error displays the entire code for the adapter.

This is a known issue, and a workaround is not available for this in the current release.

24.2.110 XIMDD Tests Fail in Oracle Identity Manager

After you deploy the Diagnostic Dashboard in Oracle Identity Manager, failures are encountered when you perform the following tests:

- Test OWSM setup by submitting a request with OWSM header information

- Test SPML to Oracle Identity Manager request invocation

The failures might occur because the Diagnostic Dashboard is not capable of performing tests when the wss1_saml_or_username_token_policy is attached to the SPML XSD Web services.

To workaround this issue, set the Web service to use the XIMDD supported policy. To configure the policies for the SPML XSD Web service:

1. Login to Fusion Middleware Control.

2. Navigate to Application Deployments, spml-xsd.

3. For a clustered deployment of Oracle Identity Manager, expand and select a node.

4. From the Application Deployment menu, select Web Services.

5. Click the Web Service Endpoint tab, and then click the SPMLServiceProviderSOAP link.

6. Click the Policies tab, and then click Attach/Detach.

7. Detach the default policy: oracle/wss11_saml_or_username_token_with_message_protection_service_policy.

8. Under Available Policies, select oracle/wss_username_token_service_policy. Otherwise, select the SSL version of the same policy if SSL is in use.

9. Click Attach, and then click OK.

10. For a clustered deployment of Oracle Identity Manager, repeat step 3 through step 9 for each managed node listed for SPML XSD.

11. Restart the application servers.

24.3 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Configuring UDFs to be Searchable for Microsoft Active Directory Connectors

- Creating or Modifying Role Names When LDAP Synchronization is Enabled

- ADF Issue Causes Oracle Identity Manager to Fail on the Sun JDK

- Nexaweb Applet Does Not Load In an Oracle Identity Manager and Oracle Access Manager Integrated Environment

- Packing a Domain With managed=false Option

- Option Not Available to Specify if Design Console is SSL-Enabled

- Nexaweb Applet Does Not Load in JDK 1.6.0_20

- Error is Generated on Starting Servers With Sun JDK 160_24 (32-bit) on Microsoft Windows 2008

- Oracle Identity Manager and Design Console Must be Installed in Different Directory Paths

24.3.1 Configuring UDFs to be Searchable for Microsoft Active Directory Connectors

A Microsoft Active Directory connector installation automatically creates a UDF: USR_UDF_OBGUID. When you add a new user-defined field (UDF), the "searchable" property will be false by default unless you provide a value for that property. After installing an Active Directory connector, you must perform the following steps to make the user-defined field searchable:

1. Using the Advanced Administration console (user interface), change the "searchable" UDF property to true by performing the following steps:

1. Click the Advanced tab.

2. Select User Configuration and then User Attributes.

3. Modify the USR_UDF_OBGUID attribute in the Custom Attributes section by changing the "searchable" property to true.

2. Using the Identity Administration console (user interface), create a new Oracle Entitlement Server policy that allows searching the UDF by performing the following steps:

1. Click the Administration tab and open the Create Authorization policy.

2. Enter a Policy Name, Description, and Entity Name as User Management.

3. Select Permission, then View User Details, and then Search User.

4. Edit the Attributes for View User Details and select all of the attributes.

5. Select the SYSTEM ADMINSTRATOR role name.

6. Click Finish.

24.3.2 Creating or Modifying Role Names When LDAP Synchronization is Enabled

When LDAP synchronization is enabled and you attempt to create or modify a role, entering a role name comprised of approximately 1,000 characters prevents the role from being created or modified and causes a Decoding Error to appear. To work around this issue, use role names comprised of fewer characters.

24.3.3 ADF Issue Causes Oracle Identity Manager to Fail on the Sun JDK

Due to an ADF issue, using the Oracle Identity Manager application with the Sun JDK causes a StringIndexOutOfBoundsException error. To work around this issue, add the following option to the DOMAIN_HOME/bin/setSOADomainEnv.sh or the setSOADomainEnv.cmd file:

1. Open the DOMAIN_HOME/bin/setSOADomainEnv.sh or setSOADomainEnv.cmd file.

2. Add the -XX:-UseSSE42Intrinsics line to the JVM options.

3. Save the setSOADomainEnv.sh or setSOADomainEnv.cmd file.

Note:

This error does not occur when you use JRockit.

24.3.4 Nexaweb Applet Does Not Load In an Oracle Identity Manager and Oracle Access Manager Integrated Environment

In an Oracle Identity Manager and Oracle Access Manager (OAM) integrated environment, when you login to the Oracle Identity Manager Administrative and User Console and click a link that opens the Nexaweb applet, the applet does not load.

To workaround this issue, configure loading of the NexaWeb Applet in an Oracle Identity Manager and OAM integrated environment. To do so:

1. Login to the Oracle Access Manager Console.

2. Create a new Webgate ID. To do so:

1. Click the System Configuration tab.

2. Click 10Webgates, and then click the Create icon.

3. Specify values for the following attributes:
Name: NAME_OF_NEW_WEBGATE_ID

Access Client Password: PASSWORD_FOR_ACCESSING_CLIENT

Host Identifier: IDMDomain

4. Click Apply.

5. Edit the Webgate ID, as shown:
set 'Logout URL' = /oamsso/logout.html

6. Deselect the Deny On Not Protected checkbox.

3. Install a second Oracle HTTP Server (OHS) and Webgate. During Webgate configurations, when prompted for Webgate ID and password, use the Webgate ID name and password for the second Webgate that you provided in step 2c.

4. Login to the Oracle Access Manager Console. In the Policy Configuration tab, expand Application Domains, and open IdMDomainAgent.

5. Expand Authentication Policies, and open Public Policy. Remove the following URLs in the Resources tab:
/xlWebApp/.../*

/xlWebApp

/Nexaweb/.../*

/Nexaweb

6. Expand Authorization Policies, and open Protected Resource Policy. Remove the following URLs in the Resources tab:
/xlWebApp/.../*

/xlWebApp

/Nexaweb/.../*

/Nexaweb

7. Restart all the servers.

8. Update the obAccessClient.xml file in the second Webgate. To do so:

1. Create a backup of the SECOND_WEBGATE_HOME/access/oblix/lib/ObAccessClient.xml file.

2. Open the DOMAIN_HOME/output/WEBGATE_ID_FOR_SECOND_WEBGATE/ObAccessClient.xml file.

Note:

Ensure that the DenyOnNotProtected parameter is set to 0.

3. Copy the DOMAIN_HOME/output/WEBGATE_ID_FOR_SECOND_WEBGATE/ObAccessClient.xml file to the SECOND_WEBGATE_HOME/access/oblix/lib/ directory.

9. Copy the mod_wls_ohs.conf from the FIRST_OHS_INSTANCE_HOME/config/OHS_NAME/directory to the SECOND_OHS_INSTANCE_HOME/config/OHS_NAME/ directory. Then, open the mod_wls_host.conf of the second OHS to ensure the WebLogicHost and WeblogicPort are still pointing to Oracle Identity Manager managed server host and port.

10. Remove or comment out the following lines in the SECOND_OHS_INSTANCE_HOME/config/OHS_NAME/httpd.conf file:

<LocationMatch "/oamsso/*">
Satisfy any
</LocationMatch>

11. Copy the logout.html file from the FIRST_WEBGATE_HOME/access/oamsso/ directory to the SECOND_WEBGATE_HOME/access/oamsso/ directory. Then, open the logout.html file of the second Webgate to ensure that the host and port setting of the SERVER_LOGOUTURL variable are pointing to the correct OAM host and port.

12. Login to Oracle Access Manager Console. In the Policy Configuration tab, expand Host Identifiers, and open the host identifier that has the same name as the second Webgate ID name. In the Operations section, verify that the host and port for the second OHS are listed. If not, then click the add icon (+ sign) to add them. Then, click Apply.

13. Use the second OHS host and port in the URL for the OAM login page for Oracle Identity Manager. The URL must be in the following format:
http://SECOND_OHS_HOST:SECOND_OHS_PORT/admin/faces/pages/Admin.jspx

24.3.5 Packing a Domain With managed=false Option

When a domain is packed with the managed=false option and unpacked on the another computer, Oracle Identity Manager Authentication Provider is not recognized by WebLogic and basic administrator authentication fails when the Oracle Identity Manager managed server is started.

The following workaround can be applied for performing successful authentication via Oracle Identity Manager Authentication Provider:

1. Login in to the Oracle WebLogic Administrative Console by using the following URL:
http://HOST_NAME:ADMIN_PORT/console

2. Navigate to Security Realms, Realm(myrealm), and then to Providers.

3. Delete OIMAuthenticationProvider.

Note:

Make sure that you note the provider-specific details, such as the database URL, password, and driver, before deleting the provider.

4. Restart the WebLogic Administrative Server.

5. Navigate to Security Realms, Realm(myrealm), and then to Providers.

6. Create a new Authentication Provider of type OIMAuthenticationProvider.

7. Enter the provider specific details and mark the control flag as SUFFICIENT.

8. Restart the WebLogic Administrative Server.

9. Restart Oracle Identity Manager and other servers, if any.

24.3.6 Option Not Available to Specify if Design Console is SSL-Enabled

While configuring Oracle Identity Manager Design Console, you cannot specify if Design Console is SSL-enabled.

To workaround this issue after installing Oracle Identity Manager Design Console, edit the OIM_HOME/designconsole/config/xlconfig.xml file to change the protocol in the Oracle Identity Manager URL from t3 to t3s.

24.3.7 Nexaweb Applet Does Not Load in JDK 1.6.0_20

Deployment Manager and Workflow Visualizer might not work if the client browser has JDK/JRE installed on it whose version is 1.6.0_20. To workaround this issue, uninstall the JDK/JRE version 1.6.0_20 from the client browser and reinstall the JDK/JRE version 1.6.0_15.

24.3.8 Error is Generated on Starting Servers With Sun JDK 160_24 (32-bit) on Microsoft Windows 2008

When you install Oracle WebLogic Server (64-bit), Oracle Identity Manager, and SOA Server, and select Sun JDK 160_24 (32-bit) on Microsoft Windows 2008, an out-of-memory error is generated on starting the SOA Server and Oracle Identity Manager.

To workaround this issue, add -XX:-DoEscapeAnalysis. For example:

set USER_MEM_ARGS=-Xms512m -Xmx1024m -XX:CompileThreshold=8000 -XX:PermSize=128m -XX:MaxPermSize=512m -XX:-DoEscapeAnalysis

24.3.9 Oracle Identity Manager and Design Console Must be Installed in Different Directory Paths

Oracle recommends to install Oracle Identity Manager and the Design Console in different directory paths.

24.4 Multi-Language Support Issues and Limitations

This section describes multi-language issues and limitations. It includes the following topics:

- Multi-language Valued Attributes in SPML and Oracle Identity Manager Do Not Match

- Login Names with Some Special Characters May Fail to Register

- The Create Role, Modify Role, and Delete Role Request Templates are Not Available for Selection in the Request Templates List

- Parameter Names and Values for Scheduled Jobs are Not Translated

- Bidirectional Issues for Legacy User Interface

- Localization of Role Names, Role Categories, and Role Descriptions Not Supported

- Localization of Task Names in Provisioning Task Table Not Supported

- Localization of Search Results of Scheduled Tasks Not Supported

- Searching for User Login Names Containing Certain Turkish Characters Causes an Error

- Localization of Notification Template List Values for Available Data Not Supported

- Searching for Entity Names Containing German "ß" (Beta) Character Fails in Some Features

- Special Asterisk (*) Character Not Supported

- Translated Error Messages Are Not Displayed in UI

- Reconciliation Table Data Strings are Hard-coded on Reconciliation Event Detail Page

- Translated Password Policy Strings May Exceed the Limit in the Background Pane

- Date Format Validation Error in Bi-Directional Languages

- Mistranslation on the Create Job page

- E-mail Notification for Password Expiration Cannot Be Created With Arabic Language Setting

- Translated Justification is Not Displayed in Access Policy-Based Resource Provisioning Request Detail

- Additional Single Quotes Displayed in GTC Reconciliation Mapping Page for French UI

- Not Allowing to Enter Design Console Password When Server Locale is Set to Simple Chinese, Traditional Chinese, Japanese, or Korean

- Bidirectional Text Not Supported in Nexaweb Pages

- Do Not Modify Oracle Identity Manager Predefined System Properties in Non-English Locale

- Error Generated When Translated String for System Property Name Exceeds Maximum Allowed Length in PTY_NAME Column

- Password Notification is Not Sent if User Login Contains Special Characters

- Reset Password Fails if User Login Contains Lowercase Special Characters

24.4.1 Multi-language Valued Attributes in SPML and Oracle Identity Manager Do Not Match

Oracle Identity Manager supports only the Display Name attribute for multi-language values. SPML specifies additional attributes, such as commonName and surname, as multi-language valued in the PSO schema. When multiple locale-values are specified in an SPML request for one of these attributes, only a single value is picked and passed to Oracle Identity Manager. The request will not fail and a warning message identifying the attributes and the value that was passed to Oracle Identity Manager is provided in the response.

24.4.2 Login Names with Some Special Characters May Fail to Register

In Oracle Identity Manager, the user login name is case-insensitive. When a user is created, the login name is converted to upper case and saved in the database. But the password is always case-sensitive. However, some special characters may encounter an error while registering to Oracle Identity Manager:

- Both the Greek characters &#963; (sigma) and &#962; (final sigma) maps to the &#931; character.

- Both English character i and Turkish character &#305; maps to the I character.

- Both German character ß and English string SS maps to the SS string.

This means that two user login names containing these special characters when the other characters in the login names are same cannot be created. For example, the user login names Johnß and JohnSS maps to the same user login name. If Johnß already exists, then creation of JohnSS is not allowed because both the ß character and the SS string maps to the SS string.

24.4.3 The Create Role, Modify Role, and Delete Role Request Templates are Not Available for Selection in the Request Templates List

The Create Role, Modify Role, and Delete Role request templates are not available in the Request Templates list of the Create Request wizard. This is because request creation by using any request template that are based on the Create Role, Modify Role, and Delete Role request models are supported from the APIs, but not in the UI. However, you can search for these request templates in the Request Templates tab. In addition, the Create Role, Modify Role, and Delete Role request models can be used to create approval policies and new request templates.

24.4.4 Parameter Names and Values for Scheduled Jobs are Not Translated

In the Create Job page of Oracle Identity Manager Advanced Administration, the fields in the Parameter section and their values are not translated. The parameter field names and values are available only in English.

24.4.5 Bidirectional Issues for Legacy User Interface

The following are known issues in the legacy user interface, also known as TransUI, contained in the xlWebApp war file:

- Hebrew bidirectional is not supported

- Workflow designer bidirectional is not supported for Arabic and Hebrew

24.4.6 Localization of Role Names, Role Categories, and Role Descriptions Not Supported

Localization of role names, categories, and descriptions is not supported in this release.

24.4.7 Localization of Task Names in Provisioning Task Table Not Supported

All Task Name values in the Provisioning Task table list are hard-coded and these pre-defined process task names are not localized.

24.4.8 Localization of Search Results of Scheduled Tasks Not Supported

When you search Scheduler Tasks using a Simple or Advanced search, the search results are not localized.

24.4.9 Searching for User Login Names Containing Certain Turkish Characters Causes an Error

On the Task Approval Search page, if you select "View Tasks Assigned To", then "Users You Manage", and then choose a user whose login name contains a Turkish Undotted "&#305" or a Turkish dotted "&#304" character, a User Not Found error will result.

24.4.10 Localization of Notification Template List Values for Available Data Not Supported

Localizing Notification Template Available Data list values is not supported in this release. Oracle Identity Manager depends upon the Velocity framework to merge tokens with actual values, and Velocity framework does not allow a space in token names.

24.4.11 Searching for Entity Names Containing German "ß" (Beta) Character Fails in Some Features

When you search for entity names containing the special German "ß" (beta) character from the Admin Console, the search fails in the following features:

- System Configuration

- Request Template

- Approve Policy

- Notification

In these features, the "ß" character matches to "ss" instead of itself. Consequently, the Search function cannot find entity names that contain the German beta character.

24.4.12 Special Asterisk (*) Character Not Supported

Although special characters are supported in Oracle Identity Manager, using the asterisk character (*) can cause some issues. You are advised not to use the asterisk character when creating or modifying user roles and organizations.

24.4.13 Translated Error Messages Are Not Displayed in UI

Oracle Identity Manager does not support custom resource bundles for Error Message display in user interfaces. Currently, there is no workaround for this issue.

24.4.14 Reconciliation Table Data Strings are Hard-coded on Reconciliation Event Detail Page

Some of the table data strings on the Reconciliation Event Detail page are hard-coded, customized field names. These strings are not localized.

24.4.15 Translated Password Policy Strings May Exceed the Limit in the Background Pane

Included as per bug# 9539501

The password policy help description may run beyond the colored box in some languages and when the string is too long. Currently, there is no workaround for this issue.

24.4.16 Date Format Validation Error in Bi-Directional Languages

When Job Detail page is opened in bi-directional languages, you cannot navigate away from this page because of "Date Format Validation Error". To work around this issue, select a value for the "Start Date" using the date-time control and then move to another page.

24.4.17 Mistranslation on the Create Job page

On the Japanese locale (LANG=ja_JP.UTF-8), "Fourth Wednesday" is mistranslated as "Fourth Friday" on the Create Job page when "Cron" is selected as the Schedule Type and "Monthly on given weekdays" is selected as the Recurring Interval.

24.4.18 E-mail Notification for Password Expiration Cannot Be Created With Arabic Language Setting

When the server locale is set to ar_AE.utf8 and values for user.language and user.region system properties are ar and AE respectively, if you create a password expiration warning e-mail notification in the Design Console, the value AE is not available for selection in the Region field. As a result, the email notification message cannot be created.

To workaround this issue:

1. Open the Lookup Definitions form in the Design Console.

2. Search for 'Global.Lookup.Region'.

3. Add an entry with Code key and Decode value as 'AE'. You can now create an e-mail definition with language ar and region AE.

24.4.19 Translated Justification is Not Displayed in Access Policy-Based Resource Provisioning Request Detail

When an access policy with approval is created, it generates a resource provisioning request that is subject to approval. In the request details page in Self Service or Advanced Administration, the translated request justification according to the locale setting by the user is not displayed. The justification is displayed in the default server locale.

24.4.20 Additional Single Quotes Displayed in GTC Reconciliation Mapping Page for French UI

When you set the Oracle Identity Manager Administrative and User Console locale to French, select the Provisioning and Reconciliation checkboxes while creating a Generic Technology Connector (GTC), and map the reconciliation fields in the page for modifying mapping fields, a message is displayed with two single quotes. You can ignore the single quotes because this is benign and has no effect on functionality.

24.4.21 Not Allowing to Enter Design Console Password When Server Locale is Set to Simple Chinese, Traditional Chinese, Japanese, or Korean

When you set the server locale to Simple Chinese, Traditional Chinese, Japanese, or Korean, and start the Design Console, you are not allowed to enter the password to login to the Design Console.

To workaround this issue:

1. Kill all scim processes. To do so, run the following command:

kill `pgrep scim`

2. Edit the scim config file. To do so:

1. Search for the following line:
/FrontEnd/X11/Dynamic = ......

2. Enter true as the value, as shown:
/FrontEnd/X11/Dynamic = true

Note:

If this line does not exist, then enter:
/Frontend/X11/Dynamic = true

3. Save the file.

3. Log out of the VNC viewer.

4. Restart the VNC server and log in again. You can now enter the password for the Design Console.

24.4.22 Bidirectional Text Not Supported in Nexaweb Pages

The Nexaweb pages that open from the Oracle Identity Manager Administrative and User Console do not support bidirectional text. For example, when you select any of the languages that are written from right to left, such as Arabic or Hebrew, and click Install Connector on the Welcome page, search for a connector, click Upgrade, and then proceed to step 13 of the Connector Upgrade wizard, the text in the page is not displayed from right to left.

24.4.23 Do Not Modify Oracle Identity Manager Predefined System Properties in Non-English Locale

When the user preference language for the Administrative and User Console is not English, and you update the value of a predefined system property in Oracle Identity Manager, translated property name and keyword are written in the PTY table. Therefore, on searching for system properties in the Administrative and User Console, this system property is not found.

24.4.24 Error Generated When Translated String for System Property Name Exceeds Maximum Allowed Length in PTY_NAME Column

When you try to set the value of a system property in a Western language UI, such as French, and if the translation string length exceeds the maximum allowed length, which is 80 characters, in the PTY_NAME column of the PTY table, then an error is generated.

24.4.25 Password Notification is Not Sent if User Login Contains Special Characters

For a user entity created with valid e-mail address in LDAP, if the User Login contains the German beta character, then the notification message is not sent on running LDAP user create/update full reconciliation.

24.4.26 Reset Password Fails if User Login Contains Lowercase Special Characters

In a Oracle Identity Manage deployment with LDAP synchronization enabled, if the User Login contains special characters such as Turkis dotted I, dotless i, German beta, and Greek sigma in lowercase format, then the reset password does not work.

To workaround this issue, use uppercase User Login to reset password because User Login is not case-sensitive in Oracle Identity Manager.

24.5 Documentation Errata

Documentation Errata: Currently, there are no documentation issues to note.

25 Oracle Identity Navigator

This chapter describes issues associated with Oracle Identity Navigator. It includes the following topics:

- Section 25.1, "General Issues and Workarounds"

- Section 25.2, "Configuration Issues and Workarounds"

- Section 25.3, "Documentation Errata"

25.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topics:

- Section 25.1.1, "Avoid Selecting Reset Page in Dashboard Edit Mode"

- Section 25.1.2, "How to Navigate Product Registration Using the Keyboard"

- Section 25.1.3, "How to Navigate Product Discovery When Using the Keyboard"

- Section 25.1.4, "Color Contrast is Inadequate for Some Labels in Edit Mode"

- Section 25.1.5, "No Help Topic in Dashboard Edit Mode"

- Section 25.1.6, "Customization Problem in Internet Explorer 7"

- Section 25.1.7, "Discovery Problem in Internet Explorer 7"

- Section 25.1.8, "How to Navigate BI Publisher Configuration When Using the Keyboard"

- Section 25.1.9, "User Missing From Common Admin Role Search Results"

- Section 25.1.10, "Unable to View Users After Log in Or Log In Fails In Oracle Identity Manager Environment"

- Section 25.1.11, "Horizontal Scroll-bar Missing in Discovery Wizard"

25.1.1 Avoid Selecting Reset Page in Dashboard Edit Mode

If you select Customize to personalize the Dashboard, then click Reset Page, expect an error message. Reload Oracle Identity Navigator to recover from this error.

25.1.2 How to Navigate Product Registration Using the Keyboard

In the Product Registration section of the Administration screen, after you enter data into all the fields in the right pane, you must enter many Tab strokes to reach the Test, Save, or Cancel button. As a workaround, you can use Shift-Tab to move in the opposite direction.

You cannot use the Tab key alone to navigate the left pane of the Product Registration section. Use the Tab to move focus to the first category, then click the left or right arrow keys to expand and collapse the tree. Use the up and down arrow keys to navigate the nodes.

25.1.3 How to Navigate Product Discovery When Using the Keyboard

When you use Product Discovery to discover consoles, you enter a Host and Port, then click Next. Then, in the Add Products pane, you enter a Display Name for each of the products. If you want to change the display name, you must delete the entire name to retype it. Alternatively, you can enter the F2 key to switch to insert mode, then use left and right arrow keys to move around the display name characters.

You cannot use the arrow keys alone to navigate through the Category list on the Add Products pane. Inside the editable table, use the F2 key to focus on a field, then use up and down arrows to make a selection within the field.

25.1.4 Color Contrast is Inadequate for Some Labels in Edit Mode

After clicking Customize to change the layout of the Dashboard, some users might find certain labels, such as + Add Content, difficult to read, due to poor contrast.

25.1.5 No Help Topic in Dashboard Edit Mode

If you select Customize to personalize the Dashboard, then click the? icon for Oracle Composer Help, the help page displays Topic Not Found.

See "Personalizing Oracle Identity Navigator" in Oracle Fusion Middleware Administrator's Guide for Oracle Identity Navigator for more information about personalizing the Dashboard.

25.1.6 Customization Problem in Internet Explorer 7

If you enter Edit mode by clicking Customize in the global navigation links on the Dashboard in IE7, you will not be able to edit the page because the toolbar is hidden. As a workaround, use a different browser. If you use Internet Explorer 8, do not use compatibility mode.

25.1.7 Discovery Problem in Internet Explorer 7

Intermittently, when you use product discovery in Internet Explorer 7, buttons might disappear in the product discovery wizard. Refresh the browser to correct this problem.

25.1.8 How to Navigate BI Publisher Configuration When Using the Keyboard

When you use keyboard navigation to configure BI Publisher, when the Component Path dialogue box opens, use the Tab key along with the arrow keys to navigate in tree structure.

25.1.9 User Missing From Common Admin Role Search Results

The last user assigned the Application Configuration role may not appear in the Common Admin Roles search results list. This can occur if a search for Common Admin Roles is performed in the Access Privileges page immediately after assigning this role.

To workaround this issue, click another role type in the Role Name pane, then click Application Configuration role. The user last assigned the Application Configuration role displays in the Access Privileges list.

25.1.10 Unable to View Users After Log in Or Log In Fails In Oracle Identity Manager Environment

This issue can affect environments configured to use both Oracle Identity Manager and Oracle Identity Navigator. After log in to Oracle Identity Navigator using the bootstrap administrator credentials, users may not be visible in Access Privileges page. Or the log in attempt will fail. Issue is caused if the identity store entry in jps-config.xml is changed from the default value, <serviceInstanceRef ref="idstore.ldap"/>, to <serviceInstanceRef ref="idstore.oim"/>.

To verify this entry, check the value in <Extended_Domain_Home>/config/fmwconfig/jps-config.xml as follows:

1. Search for the jpscontexts section, with the name default, in the file. The section looks like the following:

<jpsContext name="default">
<serviceInstanceRef ref="credstore"/>
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="policystore.xml"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="idstore.oim"/>
</jpsContext>

2. To change the entry, perform steps 1 through 11 as detailed in Chapter 20, 20.5.5 "Post-Configuration Steps", in Oracle Fusion Middleware Installation Guide for Oracle Identity Management.
Oracle Authorization Policy Manager does not need to be installed in your environment to perform this procedure.

25.1.11 Horizontal Scroll-bar Missing in Discovery Wizard

The full URL may not be viewable in the second page of the Discovery Wizard when viewed in a browser window.

To workaround this issue, collapse the left pane to view the full URL.

25.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 25.2.1, "No Oracle Icon is Visible in HTML Reports"

- Section 25.2.2, "Problems with Administration Screen When Using JAWS Screen Reader"

- Section 25.2.3, "SSO-Protected Consoles Must Be Configured by Name and Domain"

25.2.1 No Oracle Icon is Visible in HTML Reports

If you choose HTML as the format type when adding a report from the Dashboard screen, when you view the report, the words An Image appear in the report in place of the Oracle icon.

25.2.2 Problems with Administration Screen When Using JAWS Screen Reader

When you use a screen reader such as JAWS with the Administration screen in accessibility mode, and you bring up the list of combo boxes using the INS+CTRL+C JAWS keystroke, the combo boxes on the screen are listed as:

*Required Category(Required) Combo box

*Required Type(Required) Combo box

With this naming convention, keyboard shortcuts such as C for Category or T for Type do not work. Use the up and down arrow keys to navigate to fields within and between the two combo boxes.

25.2.3 SSO-Protected Consoles Must Be Configured by Name and Domain

Sometimes, when you use product discovery to find a console, even if you provide the host by name, the discovered address that fills in contains an IP address instead of the host and domain names.

If the console is protected by SSO, replace the IP address with the host.domain address that is known to SSO. For example, use an address such as http://myhost.mycompany.com:7005/odsm rather than http://130.35.10.10:7005/odsm. If you do not replace the IP address with the host and domain, single sign-on will not occur. That is, when users attempt to access the console from Oracle Identity Navigator, they will be prompted for their login name and password.

In some browsers, a redirection or connection error occurs.

25.3 Documentation Errata

This section describes documentation errata. It includes the following topic:

- Section 25.3.1, "IPv4/IPv6 Translation Issues"

25.3.1 IPv4/IPv6 Translation Issues

The following statement appears in the Troubleshooting section in Chapter 2 and in a note in Chapter 3 of Oracle Fusion Middleware Administrator's Guide for Oracle Identity Navigator:

In a dual-stack, IPv4 and IPv6 environment, some URLs might be inaccessible from your browser. Consult your network administrator for more information.

Actually, in a correctly configured dual-stack environment, all URLs are accessible. For more information about IPv4/IPv6 Translation Issues, see Framework for IPv4/IPv6 Translation draft-ietf-behave-v6v4-framework-09 at: http://www.ietf.org/

26 Oracle Internet Directory

This chapter describes issues associated with Oracle Internet Directory. It includes the following topics:

- Section 26.1, "General Issues and Workarounds"

- Section 26.2, "Configuration Issues and Workarounds"

- Section 26.3, "Documentation Errata"

26.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topic:

- Section 26.1.1, "ODSM Browser Window Becomes Unusable"

- Section 26.1.2, "Bulkmodify Might Generate Errors"

- Section 26.1.3, "Turkish Dotted I Character is Not Handled Correctly"

- Section 26.1.4, "OIDCMPREC Might Modify Operational Attributes"

- Section 26.1.5, "OIDREALM Does Not Support Realm Removal"

- Section 26.1.6, "Apply Patch to Oracle Database 11.2.0.1.0 to Fix Purge Job Problem"

- Section 26.1.7, "SQL of OPSS ldapsearch Might Take High %CPU"

- Section 26.1.8, "If you Start the Replication Server by Using the Command Line, Stop it Using the Command Line"

- Section 26.1.9, "ODSM Problems in Internet Explorer 7"

- Section 26.1.10, "ODSM Bug Requires Editing of odsmSkin.css File"

26.1.1 ODSM Browser Window Becomes Unusable

Under certain circumstances, after you launch ODSM from Fusion Middleware Control, then select a new ODSM task, the browser window might become unusable. For example, the window might refresh repeatedly, appear as a blank page, fail to accept user input, or display a null pointer error.

As a workaround, go to the URL: http://host:port/odsm, where host and port specify the location where ODSM is running, for example, http://myserver.example.com:7005/odsm. You can then use the ODSM window to log in to a server.

26.1.2 Bulkmodify Might Generate Errors

If Oracle Internet Directory is using Oracle Database 11g Release 1 (11.1.0.7.0), you might see ORA-600 errors while performing bulkmodify operations. To correct this problem, apply the fixes for Bug 7019313 and Bug 7614692 to the Oracle Database.

26.1.3 Turkish Dotted I Character is Not Handled Correctly

Due to a bug, Oracle Internet Directory cannot handle the upper-case dotted I character in the Turkish character set correctly. This can cause problems in Oracle Directory Services Manager and in command-line utilities.

26.1.4 OIDCMPREC Might Modify Operational Attributes

By default, the oidcmprec tool excludes operational attributes during comparison.That is, oidcmprec does not compare the operational attributes values in source and destination directory entries. During reconciliation of user defined attributes however, operational attributes might be changed.

26.1.5 OIDREALM Does Not Support Realm Removal

The oidrealm tool supports creation, but not deletion, of a realm. A procedure for deleting a realm is provided in Note 604884.1, which is available on My Oracle Support at https://support.oracle.com/.

26.1.6 Apply Patch to Oracle Database 11.2.0.1.0 to Fix Purge Job Problem

If you use Oracle Database 11.2.0.1.0 with Oracle Internet Directory, apply Patch 9952216 (11.2.0.1.3 PSU) to Oracle Database. Purge jobs do not function properly without this patch.

26.1.7 SQL of OPSS ldapsearch Might Take High %CPU

The SQL of an OPSS one level ldapsearch operation, with filter "orcljaznprincipal=value" and required attributes, might take unreasonably high %DB CPU. If this search performance impacts the overall performance of the machine and other processes, you can alleviate the issue by performing the following steps in the Oracle Database:

1. Log in to the Oracle Database as user ODS and execute the following SQL:

BEGIN
DBMS_STATS.GATHER_TABLE_STATS(OWNNAME=>'ODS',
TABNAME=>'CT_ORCLJAZNPRINCIPAL',
ESTIMATE_PERCENT=>DBMS_STATS.AUTO_SAMPLE_SIZE,
CASCADE=>TRUE);
END;
/

2. Flush the sharedpool.

26.1.8 If you Start the Replication Server by Using the Command Line, Stop it Using the Command Line

If you start the replication server by using the command line, stop it by using the command line. If you attempt to stop it by using Oracle Enterprise Manager Fusion Middleware Control, the attempt fails.

See Also:

Note 1313395.1 on My Oracle Support (formerly MetaLink), http://metalink.oracle.com

26.1.9 ODSM Problems in Internet Explorer 7

The ODSM interface might not appear as described in Internet Explorer 7.

For example, the Logout link might not be displayed.

If this causes problems, upgrade to Internet Explorer 8 or 9 or use a different browser.

26.1.10 ODSM Bug Requires Editing of odsmSkin.css File

Due to a misplaced comment in the file odsmSkin.css, some labels on the ODSM home page are not displayed correctly. Specifically, the labels in the diagram on the right are misplaced or missing.

To work around this issue, proceed as follows:

1. Stop the wls_ods1 managed server.

2. Edit the file:

MW_HOME/user_projects/domains/DOMAIN_NAME/servers/MANAGED_SERVER_NAME/tmp/_WL_user/ODSM_VERSION_NUMBER/RANDOM_CHARACTERS/war/skins/odsmSkin.css

For example:

wlshome/user_projects/domains/base_domain/servers/wls_ods1/tmp/_WL_user/odsm_11.1.1.2.0/z5xils/war/skins/odsmSkin.css

Before editing, the odsmSkin.css file looks like this:

@agent ie /*========== Fix for bug#7456880 ==========*/
{
af|commandImageLink::image,
af|commandImageLink::image-hover,
af|commandImageLink::image-depressed
{
vertical-align:bottom;
}
}

Move the comment:

/*========== Fix for bug#7456880 ==========*/

so that it is above the line

@agent ie

After editing, the file should look like this:

/*========== Fix for bug#7456880 ==========*/
@agent ie
{
af|commandImageLink::image,
af|commandImageLink::image-hover,
af|commandImageLink::image-depressed
{
vertical-align:bottom;
}
}

3. Restart the wls_ods1 managed server.

26.2 Configuration Issues and Workarounds

This section describes configuration issues and workarounds. It includes the following topics:.

- Section 26.2.1, "Re-Create Wallet After Moving Oracle Internet Directory from Test to Production"

- Section 26.2.2, "OIDMON Process Fails While Configuring Oracle Internet Directory on Microsoft Windows x64 (64-Bit)"

26.2.1 Re-Create Wallet After Moving Oracle Internet Directory from Test to Production

If you configure Oracle Internet Directory to use SSL in server authentication mode or mutual authentication mode on your test machine, and then move Oracle Internet Directory to a production machine, re-create the Oracle Internet Directory wallet on the production machine.

The old wallet contains the host name of the original machine as the DN in the certificate. This host name in the DN is not changed during the test to production move. Re-create the wallet on the production machine to avoid SSL communication issues.

26.2.2 OIDMON Process Fails While Configuring Oracle Internet Directory on Microsoft Windows x64 (64-Bit)

When the configuration wizard tries to stop Oracle Internet Directory Monitor (OIDMON) process, during the configuration of Oracle Internet Directory (OID) on Microsoft Windows x64 (64-Bit), oidmon.exe creates a minidump file in:

ORACLE_INSTANCE/diagnostics/logs/OID/oidn

Ignore this issue as it does not impact functionality.

26.3 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 26.3.1, "Bulkdelete Deletes Entries, not Attributes"

- Section 26.3.2, "ODSM Section Should Refer to Oracle Internet Directory"

- Section 26.3.3, "Incorrect Bug Numbers in Prerequisites for Rolling Upgrade"

- Section 26.3.4, "Default orclcryptoscheme Value is SSHA"

- Section 26.3.5, "Setting Up Oracle Internet Directory SSL Mutual Authentication"

- Section 26.3.6, "ODSM Schema Tab is Available to Non-Super User"

- Section 26.3.7, "Wrong Command and Path in Appendix P of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory"

- Section 26.3.8, "Missing Option to opmnctl updatecomponentregistration in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory"

- Section 26.3.9, "Update Component Registration Whenever You Change Certain Instance-Specific Attributes"

- Section 26.3.10, "Incorrect LDIF File for Enabling Referential Integrity"

- Section 26.3.11, "Errors in remtool -pthput Sections"

- Section 26.3.12, "Oracle Internet Directory Wallets Must be Auto Login"

- Section 26.3.13, "List of bulkmodify Limitations is Incomplete"

- Section 26.3.14, "orclpwdmaxinactivity Attribute Should be orclpwdmaxinactivitytime"

- Section 26.3.15, "Replication Instructions in Tutorial for Identity Management are Incomplete"

26.3.1 Bulkdelete Deletes Entries, not Attributes

The section on bulkdelete in the "Performing Bulk Operations" chapter of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory is entitled "Deleting Entries or Attributes of Entries by Using bulkdelete." This title is misleading. You can only use bulkdelete to delete entire entries or subtrees. The first sentence in that section is also misleading and should be ignored.

26.3.2 ODSM Section Should Refer to Oracle Internet Directory

The Chapter 7 section of Oracle Fusion Middleware Administrators Guide for Oracle Internet Directory entitled "Single Sign-On Integration with Oracle Directory Services Manager" contains references to Oracle Virtual Directory. It should actually refer to Oracle Internet Directory.

26.3.3 Incorrect Bug Numbers in Prerequisites for Rolling Upgrade

The bug fix numbers listed in the Prerequisites section of the "Performing Rolling Upgrades" appendix to Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory are incorrect. They should be as follows:

- If you have Oracle Internet Directory Version 11.1.1.2.0, apply the fix for bug number 10431688 on each Middleware Oracle home.

- If you have Oracle Internet Directory Version 11.1.1.3.0, apply the fix for bug number 10431664 on each Middleware Oracle home.

26.3.4 Default orclcryptoscheme Value is SSHA

In Oracle Internet Directory 11g (11.1.1.3) and (11.1.1.4), the default value of orclcryptoscheme is SSHA. The documentation is incorrect in the following places:

- Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory, Table 9-3, "Attributes of the DSE."

- Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory, Chapter 30, "Managing Password Verifiers," in the section "Hashing Schemes for Creating Userpassword Verifiers."

- Oracle Fusion Middleware Reference for Oracle Identity Management, Chapter 8, "LDAP Attribute Reference," entry for orclcryptoscheme.

26.3.5 Setting Up Oracle Internet Directory SSL Mutual Authentication

Neither Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory nor Oracle Fusion Middleware Administrator's Guide describes how to set up Oracle Internet Directory SSL Client and Server Authentication. This information is provided in Note 1311791.1, which is available on My Oracle Support at:

https://support.oracle.com/

26.3.6 ODSM Schema Tab is Available to Non-Super User

Section 7.4.1.2, "Non-Super User Access to Oracle Directory Services Manager," in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory, states that if you log in as a user other than the super user, you can access only the Home and Data Browser tabs. Actually, you can access the Schema tab as well.

26.3.7 Wrong Command and Path in Appendix P of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

Two errors have been noted in Appendix P, "Starting and Stopping the Oracle Stack."

In Step 2 of P.1 "Starting the Stack,"

MW_HOME/user_projects/domains/DOMAIN_NAME/bin/startManagedWebLogic.sh

should be

MW_HOME/user_projects/domains/DOMAIN_NAME/bin/startWebLogic.sh

In Step 3 of P.1 "Starting the Stack,"

MW_HOME/user_projects/domains/DOMAIN_NAME/bin/startNodeManager.sh

should be

MW_HOME/wlserver_10.3/server/startNodeManager.sh

26.3.8 Missing Option to opmnctl updatecomponentregistration in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

In Chapter 10, "Managing IP Addresses," the opmnctl updatecomponentregistration command is missing the -Sport option. Both -Port and -Sport are required for this command.

26.3.9 Update Component Registration Whenever You Change Certain Instance-Specific Attributes

You must update the registration of an Oracle Internet Directory component in a registered Oracle instance by running opmnctl updatecomponentregistration whenever you change any of the following instance parameters:

Table 26-1 Attribute Changes Requiring Update of Component Registration

Attribute

Section of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory

orclhostname

"Attributes of the Instance-Specific Configuration Entry" in Chapter 9

orclnonsslport

"Attributes of the Instance-Specific Configuration Entry" in Chapter 9

orclsslport

"Attributes of the Instance-Specific Configuration Entry" in Chapter 9

userpassword

"Changing the Password for the EMD Administrator Account" in Chapter 12

In versions of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory released in January, 2011 or earlier, there are several statements to the effect that you do not need to run opmnctl updatecomponentregistration if you use Oracle Enterprise Manager Fusion Middleware Control or WLST to change the parameter. This is not true. You must always run the command after changing any of these parameters. The syntax is:

ORACLE_INSTANCE/bin/opmnctl updatecomponentregistration
-adminHost hostname
-adminPort weblogic_port
-adminUsername weblogic_admin
-componentType OID
-componentName compName
-Port non-sslport
-Sport sslport

For more information, see:

- "Updating the Component Registration of an Oracle Instance by Using opmnctl" in the "Managing Oracle Internet Directory Instances" chapter of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.

- "Updating the Component Registration of an Oracle Instance by Using opmnctl" in the "Managing Oracle Internet Directory Instances" chapter of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.

26.3.10 Incorrect LDIF File for Enabling Referential Integrity

In versions of Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory prior to January 2011, the LDIF file shown in the "Enabling Referential Integrity by Using the Command Line" section in the "Configuring Referential Integrity" is incorrect. The file should look like this:

dn: cn=dsaconfig, cn=configsets, cn=oracle internet directory
changetype: modify
replace: orclRIenabled
orclRIenabled: 2

26.3.11 Errors in remtool -pthput Sections

In the "Syntax for remtool," "Arguments to remtool," and "Syntax for remtool -pthput" sections of the remtool reference in Chapter 4 of Oracle Fusion Middleware Reference for Oracle Identity Management, the -interval time_in_seconds option should be enclosed in brackets ([]) because it is optional.

The sample output in the section "Listing DRG Information at Intervals" is missing the line:

Interval for refreshing stats is X seconds

26.3.12 Oracle Internet Directory Wallets Must be Auto Login

Step 4 of Section 26.2.1, "Creating a Wallet by Using Fusion Middleware Control" in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory implies that selecting Auto Login is optional. Actually, selecting Auto Login is required for all Oracle Internet Directory wallets.

26.3.13 List of bulkmodify Limitations is Incomplete

Section 15.4, "Modifying Attributes of a Large Number of Entries By Using bulkmodify," in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory and Section 3.3, "bulkmodify," in Oracle Fusion Middleware Reference for Oracle Identity Management both contain incomplete lists of bulkmodify limitations. The limitations are as follows:

The bulkmodify tool does not allow add or replace operations on the following attributes:

- dn (use ldapmoddn instead)

- cn (use ldapmodify instead)

- userpassword (use ldapmodify instead)

- orclpassword (use ldapmodify instead)

- orclentrylevelaci (use ldapmodify instead)

- orclaci (use ldapmodify instead)

- orclcertificatehash

- orclcertificatematch

- any binary attribute

- any operational attribute

It does not allow replace operation on the attribute objectclass.

It does not allow add for single-valued attributes.

26.3.14 orclpwdmaxinactivity Attribute Should be orclpwdmaxinactivitytime

Both Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory and Oracle Fusion Middleware Reference for Oracle Identity Management refer to the attribute orclpwdmaxinactivity. The actual name of the attribute is orclpwdmaxinactivitytime

26.3.15 Replication Instructions in Tutorial for Identity Management are Incomplete

In the Tutorial for Identity Management, which is linked from Getting Started with Oracle Identity Management, Chapter 3, "Setting up Oracle Internet Directory Replication," is missing important information. Specifically, the instructions do not work unless the new consumer node is empty. For more information, see Section 39.1.7, "Rules for Configuring LDAP-Based Replication," in Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.

27 Oracle Platform Security Services

This chapter describes notes on topics associated with Oracle Platform Security Services (OPSS), in the following sections:

- Section 27.1, "Configuration Issues and Workarounds"

- Section 27.2, "Authorization Policy Manager Issues"

- Section 27.3, "Documentation Errata"

The following documents are relevant to topics included in this chapter:

- Oracle Fusion Middleware Security Guide

- Oracle Fusion Middleware Security Overview

- Oracle Fusion Middleware Administrator's Guide

- Oracle Fusion Middleware Administrator's Guide for Authorization Policy Manager

27.1 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 27.1.1, "Oracle Fusion Middleware Audit Framework"

- Section 27.1.2, "Trailing '\n' Character in Bootstrap Key"

- Section 27.1.3, "Users with Same Name in Multiple Identity Stores"

- Section 27.1.4, "Script listAppRoles Outputs Wrong Characters"

- Section 27.1.5, "Propagating Identities over the HTTP Protocol"

27.1.1 Oracle Fusion Middleware Audit Framework

This section describes configuration issues for the Oracle Fusion Middleware Audit Framework. It contains these topics:

- Section 27.1.1.1, "Configuring Auditing for Oracle Access Manager"

- Section 27.1.1.2, "Audit Reports do not Display Translated Text in Certain Locales"

- Section 27.1.1.3, "Audit Reports Always Display in English"

- Section 27.1.1.4, "Creating a New Audit Schema"

- Section 27.1.1.5, "Upgrading the Audit Schema"

27.1.1.1 Configuring Auditing for Oracle Access Manager

Although Oracle Access Manager appears as a component in Oracle Enterprise Manager Fusion Middleware Control, you cannot configure auditing for Oracle Access Manager using Fusion Middleware Control.

27.1.1.2 Audit Reports do not Display Translated Text in Certain Locales

The standard audit reports packaged with Oracle Business Intelligence Publisher support a number of languages for administrators. Oracle Business Intelligence Publisher can start in different locales; at start-up, the administrator can specify the language of choice by setting the preferred locale in Preferences.

Due to this bug, if Oracle Business Intelligence Publisher is started on any of these 3 locales:

- zh_CN (simplified chinese)

- zh_TW (traditional chinese)

- pt_BR (portuguese brazilian)

then users cannot see the report in that locale (the entire report including labels, headers, titles and so on appears in English), while the other locales display the translated text as expected. For example, when Oracle Business Intelligence Publisher is started in zh_CN, the text cannot be seen in zh_CN even though the preferred locale is set to zh_CN; information is displayed in English.

This issue will be fixed in a future release of Oracle Business Intelligence Publisher.

27.1.1.3 Audit Reports Always Display in English

The standard audit reports packaged with Oracle Business Intelligence Publisher support a number of languages.

Due to this bug, report titles and descriptions are displayed in English even when they have been translated.

This issue will be fixed in a future release of Oracle Business Intelligence Publisher.

27.1.1.4 Creating a New Audit Schema

When RCU is run for PS3 it completes the creation of the audit schema and gives the status of the creation as success. However, the STS table is not created because of a typographical issue in the STS.sql script which is invoked by RCU.

Information indicating that the table did not get created can be found only if the iau.log file is inspected or if you specifically look for the created tables.

Due to this issue, for a Release 11g PS3 full install, you must explicitly ensure the STS table is created if you have chosen to create the audit schema and are planning to use it.

You have two options to resolve the issue, depending on whether RCU has already been run for PS3.

Option 1

Use this option if RCU has not yet been run for PS3. The steps are:

1. Open the following file for editing:

$RCU_HOME/rcu/integration/iau/scripts/STS.sql

2. Remove the comma on line number 48 in STS.sql.

3. Save and close the file.

4. Open the following file for editing:

$RCU_HOME/rcu/integration/iau/iau.xml

5. Search for string 11.1.1.3.0 and replace it with the string 11.1.1.4.0

6. Save and close the file.

7. Run RCU.

Option 2

Use this option if RCU has already been run for PS3. The steps are:

1. Open the following file for editing:

$COMMON_COMPONENTS_HOME/modules/oracle.iau_11.1.1/sql/scripts/STS.sql

2. Remove the comma on line number 48 in STS.sql.

3. Save and close the file.

4. Copy STS.sql to the location from where it is going to be run.

5. Connect as sysdba and run the following SQL commands:

sqlplus> connect /as sysdba;
sqlplus> alter session set current_schema=audit_schema_user;
sqlplus> @@STS.sql audit_schema_user audit_schema_user_Append
audit_schema_user_Viewer

replacing audit_schema_user with the name of your audit schema user.

27.1.1.5 Upgrading the Audit Schema

This note describes a required workaround that applies in case (and only in case) you are upgrading your audit schema from PS1 or PS2 to PS3. The following workaround must be executed before running the Patch Set Assistant (PSA).

To implement the workaround, proceed as follows:

1. Copy

$COMMON_COMPONENTS_HOME/modules/oracle.iau_11.1.1/sql/scripts/STS.sql

to

$COMMON_COMPONENTS_HOME/common/sql/iau/upgrade/STS.sql

2. Open the copied file for edit.

3. Remove the comma in line number 48.

4. Save and close the file.

5. Open the following files for edit:

$COMMON_COMPONENTS_HOME/common/sql/iau/upgrade/ iau111134.sql
$COMMON_COMPONENTS_HOME/common/sql/iau/upgrade/ iau11114.sql

6. In each of those files:

- Remove the line ALTER TABLE OAM ADD IAU_ResourceTemplateName VARCHAR(100);

- Just before the line ALTER TABLE OAM ADD IAU_AdditionalInfo CLOB, insert the following line before the line

RENAME COLUMN IAU_AdditionalInfo TO IAU_AdditionalInfo_OLD;

7. Save and close both edited files.

8. At this point you can use PSA.

27.1.2 Trailing '\n' Character in Bootstrap Key

In 11gR1, the process that reassociates XML to LDAP stores creates a bootstrap key with the trailing new line character '\n', or its equivalent code '&#xA'. This key value is written in the file jps-config.xml and stored in the wallet. In both places, the key value contains the trailing character '\n'.

When reusing that same wallet in 11gR1 PS1, upon retrieving the bootstrap key, the system trims out the trailing '\n' character; but the key value in the wallet, however, still contains the trailing character, a situation that leads to errors since the requested and stored key values no longer match.

To resolve this issue, proceed as follows:

1. Use the WLST command modifyBootStrapCredential to reprovision wallet credentials without trailing '\n'. For details on the command usage, see section 9.5.2.5 in the Oracle Fusion Middleware Security Guide.

2. Manually edit the file jps-config.xml and remove the trailing characters '&#xA' from any bootstrap key.

This problem arises only in the scenario above, namely, when an 11gR1 wallet is reused in 11gR1 PS1; in particular, when reassociating in an 11gR1 PS1 environment, the above trailing character is not an issue.

27.1.3 Users with Same Name in Multiple Identity Stores

If a user name is present in more than one LDAP repositories and the property virtualize is set to use LibOVD, then the data in only one of those repositories is returned by the User and Role API when that name is queried.

27.1.4 Script listAppRoles Outputs Wrong Characters

On Linux and Windows platforms, when the locale is set to non-UTF8 locales, such as fr_FR_iso88591, the OPSS script listAppRoles may wrongly output the character '?' instead of the expected character.

27.1.5 Propagating Identities over the HTTP Protocol

This section includes the following additions, corrections, and new information in the following sections:

- Addition to Section Propagating Identities over the HTTP Protocol

- Correction to Section Client Application Code Sample

- Correction to Section Keystore Service Configuration

- Updating the Trust Service Configuration Parameters

27.1.5.1 Addition to Section Propagating Identities over the HTTP Protocol

The following new information belongs in section 19.3.1.2:

The out of box configuration assumes that the token issuer name and the key alias is based on the WebLogic server name. Note that the key alias server name on WebSphere is set based on the WebSphere server root. For example, if the server root is $T_WORK/middleware/was_profiles/DefaultTopology/was_as/JrfServer then the server name is set to JrfServer. To change the default value, use the procedures explained in section 19.3.12.

27.1.5.2 Correction to Section Client Application Code Sample

The following sample illustrates a client application; note that the file jps-api.jar and OSDT jars osdt_ws_sx.jar, osdt_core.jar, osdt_xmlsec.jar, osdt_saml2.jar must be included the class path for the code sample to compile.

27.1.5.3 Correction to Section Keystore Service Configuration

Assuming that the WebLogic server name is jrfServer_admin, the following command illustrates the creation of the keystore, represented by the generated file default-keystore.jks.

27.1.5.4 Updating the Trust Service Configuration Parameters

The information in this section is new and it explains how to modify the trust service configuration parameters in the file jps-config.xml with a script.

Out-of-the-box the values of the parameters trust.aliasName and trust.issuerName are set to the WebLogic server name. To modify their values to deployment-specific values, use a script like the following:

import sys

wlsAdmin = 'weblogic'
wlsPwd ='password_value'
wlUrl='t3://localhost:7001'
issuer= 'issuer'
alias = 'alias'

print "OPSS Trust Service provider configuration management script.\n"

instance = 'trust.provider'
name = 'trust.provider.embedded'
cfgProps = HashMap()
cfgProps.put("trust.issuerName", issuer)
cfgProps.put("trust.aliasName", alias)
pm = PortableMap(cfgProps);

connect(wlsAdmin, wlsPwd, wlUrl)
domainRuntime()

params = [instance, name, pm.toCompositeData(None)]
sign = ["java.lang.String", "java.lang.String", "javax.management.openmbean.CompositeData"]
on = ObjectName("com.oracle.jps:type=JpsConfig")
mbs.invoke(on, "updateTrustServiceConfig", params, sign)
mbs.invoke(on, "persist", None, None)

print "Done.\n"

27.2 Authorization Policy Manager Issues

This section describes issues and workarounds with Authorization Policy Manager, in the following sections:

- Section 27.2.1, "Error Message While Searching Application Roles"

- Section 27.2.2, "Some Errors/Warnings in Authorization Policy Manager Display Server Locale"

- Section 27.2.3, "Support for Internet Protocols"

- Section 27.2.4, "Authorization Policy Manager Patch Installation Fails on 64-bit Operating Systems"

27.2.1 Error Message While Searching Application Roles

If you encounter an error while performing an application role search that includes the message:

An error has occurred. Please view the logs for details

and the error logged includes a PolicyStoreOperatioNotAllowedException similar to the log illustrated in the following fragment (and found in the file apm_server1-diagnostic.log):

[2010-03-02T22:06:29.998-08:00] [apm_server1] [ERROR] []
[oracle.security.apm] [tid: [ACTIVE].ExecuteThread: '4' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: weblogic] [ecid:
0000ISYcUY2B1FcpPg1Fid1BXsJn00006W,0] [APP: oracle.security.apm]
PolicyStoreException while calling searchAppRole[[
oracle.security.jps.service.policystore.PolicyStoreOperationNotAllowedExceptio
n: javax.naming.OperationNotSupportedException: [LDAP: error code 53 - Parent
entry not found in the directory.];...

then retry the operation, which should then run without errors.

27.2.2 Some Errors/Warnings in Authorization Policy Manager Display Server Locale

Errors and warnings in Authorization Policy Manager display the server locale and not the browser locale. There is no workaround to this issue.

27.2.3 Support for Internet Protocols

Authorization Policy Manager components support the following Internet Protocol versions:

- Oracle database on IPv4 host

- Authorization Policy Manager server on IPv4/IPv6 dual-stack host

- Client (browser) on either IPv4 or IPv6 hosts

27.2.4 Authorization Policy Manager Patch Installation Fails on 64-bit Operating Systems

To work around this issue, in Windows or UNIX/Linux 64-bit operating systems, proceed as follows:

1. Set the variables ORACLE_HOME and PATH as explained in the README.TXT file included in the patch.

2. Run OPatch as illustrated in either of the following invocations:

> OPatch -jre <64-bit java home location> lsinventory
> OPatch -jdk <64-bit java home location> lsinventory

A successful run returns Opatch succeeded; otherwise, verify that the passed location is valid.

3. Change directory to the patch location:

> cd <patch location>

4. Run OPatch as illustrated in either of the following invocations:

> OPatch -jre <64-bit java home location> apply
> OPatch -jdk <64-bit java home location> apply

27.3 Documentation Errata

This section contains corrections for documentation errors. Topics include:

- Section 27.3.1, "Updated Instructions for SSL for the Identity Store Service"

27.3.1 Updated Instructions for SSL for the Identity Store Service

This note contains clarifications to Section 7.5 "SSL for the Identity Store Service" in the Oracle Fusion Middleware Application Security Guide, part number E10043-10.

Doc Update 1

Update the beginning of Section 7.5 to explain the various scenarios in which the identity store service is used.

7.5 SSL for the Identity Store Service

Connections between the identity store and an LDAP server can be SSL-enabled. This section explains how the connections are configured in the various scenarios. Use the following table to determine the correct procedure to use:

If virtualize flag is set to

And the User and Role API is in use

And the Identity Directory Service is in use

virtualize=false (that is, virtualize flag is not set)

Specify truststore using JSSE parameters, as explained in Section 8.2.3.
For example:

-Djavax.net.ssl.trustStore=trust_store_path_name

Use the adapters.jks file as shown in Sections 7.5.2 and 7.5.3.

virtualize=true (that is, virtualize flag is set)

Use the adapters.jks file as shown in Sections 7.5.2 and 7.5.3.

Use the adapters.jks file as shown in Sections 7.5.2 and 7.5.3.

Doc Update 2

Remove the information in Section 7.5.4. It is not needed.

28 SSL Configuration in Oracle Fusion Middleware

This chapter describes issues associated with SSL configuration in Oracle Fusion Middleware. It includes the following topics:

- Section 28.1, "General Issues and Workarounds"

- Section 28.2, "Configuration Issues and Workarounds"

28.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 28.1.1, "Replacement User Certificates for Oracle Wallets"

- Section 28.1.2, "Incorrect Message or Error when Importing a Wallet"

28.1.1 Replacement User Certificates for Oracle Wallets

The Oracle wallets used by Oracle HTTP Server, Oracle Web Cache, and Oracle Internet Directory, as well as the keystore used by Oracle Virtual Directory, include a Verisign root key (Serial#: 02:ad:66:7e:4e:45:fe:5e:57:6f:3c:98:19:5e:dd:c0 ) that expires Jan 07, 2010 15:59:59 PST.

Customers using the user certificate signed by this root key will need to obtain a replacement user certificate signed by their Certificate Authority (CA), and import that CA's root key into the Oracle wallet.

See "Common Certificate Operations" in the "Wallet Management" section of the Oracle Fusion Middleware Administrator's Guide for steps to import a root key into an Oracle wallet.

28.1.2 Incorrect Message or Error when Importing a Wallet

Problem 1

Fusion Middleware Control displays an incorrect message when you specify an invalid wallet password while attempting to import a wallet. The issued message "Cannot create p12 without password." is incorrect. Instead, it should notify the user that the password is incorrect and request a valid password.

Problem 2

Fusion Middleware Control displays an incorrect message when you attempt to import a password-protected wallet as an autologin wallet. The issued message "Cannot create p12 without password." does not provide complete information. Instead, it should notify the user that importing a password-protected wallet requires a password.

Problem 3

If you attempt to import an autologin wallet as a password-protected wallet using either Fusion Middleware Control or WLST, a NullPointerException error is displayed.

28.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 28.2.1, "Tools for Importing DER-encoded Certificates"

- Section 28.2.2, "Using a Keystore Not Created with WLST or Fusion Middleware Control"

- Section 28.2.3, "Components May Enable All Supported Ciphers"

28.2.1 Tools for Importing DER-encoded Certificates

You cannot use Oracle Enterprise Manager Fusion Middleware Control or the WLST command-line tool to import DER-encoded certificates or trusted certificates into an Oracle wallet or a JKS keystore.

Instead, use other tools that are available for this purpose.

- To import DER-encoded certificates or trusted certificates into an Oracle wallet, use:

- Oracle Wallet Manager or

- orapki command-line tool

- To import DER-encoded certificates or trusted certificates into a JKS keystore, use the keytool utility.

28.2.2 Using a Keystore Not Created with WLST or Fusion Middleware Control

If an Oracle wallet or JKS keystore was created with tools such as orapki or keytool, it must be imported prior to use. Specifically:

- For Oracle HTTP Server, Oracle Webcache, and Oracle Internet Directory, if a wallet was created using orapki or Oracle Wallet Manager, in order to view or manage it in Fusion Middleware Control you must first import it with either Fusion Middleware Control or the WLST importWallet command.

- For Oracle Virtual Directory, if a keystore was created using keytool, in order to view or manage it in Fusion Middleware Control you must first import it with either Fusion Middleware Control or the WLST importKeyStore command.

28.2.3 Components May Enable All Supported Ciphers

Customers should be aware that when no cipher is explicitly configured, some 11g Release 1 (11.1.1) components enable all supported SSL ciphers including DH_Anon (Diffie-Hellman Anonymous) ciphers.

At this time, Oracle HTTP Server is the only component known to set ciphers like this.

Configure the components with the desired cipher(s) if DH_Anon is not wanted.

29 Oracle Virtual Directory

This chapter describes issues associated with Oracle Virtual Directory. It includes the following topics:

- Section 29.1, "General Issues and Workarounds"

- Section 29.2, "Configuration Issue and Workaround"

- Section 29.3, "Documentation Errata"

29.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- ODSM Version Does Not Change in Enterprise Manager after Patching ODSM to 11.1.1.6.0

- Oracle Virtual Directory Version 11.1.1.6.0 Start-Up Fails on Windows

- ODSM Bug Requires Editing of odsmSkin.css File

- Oracle Directory Services Manager Browser Window is Not Usable

- Exceptions May Occur in Oracle Directory Services Manager When Managing Multiple Oracle Virtual Directory Components and One is Stopped

- Identifying the DN Associated with an Access Control Point in Oracle Directory Services Manager

- Issues With Oracle Virtual Directory Metrics in Fusion Middleware Control

- Using a Wildcard when Performing an LDAPSEARCH on a TimesTen Database Causes an Operational Error

- ODSM Version 11.1.1.4.0 Does Not Support OVD Versions 11.1.1.2.0 or 11.1.1.3.0

- ODSM Version 11.1.1.5.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, or 11.1.1.4.0

- ODSM Version 11.1.1.6.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, 11.1.1.4.0, or 11.1.1.5.0

- Oracle Virtual Directory Issues with IPv6 Stack on Windows Platforms Using JDK6

- Users with Non-ASCII Names Might Encounter Problems when Using ODSM with SSO

- Creating an Attribute/Object Class Throws NPE Error

- Patch Required to Enable Account Lockout Feature

- ODSM Problems in Internet Explorer 7

29.1.1 ODSM Version Does Not Change in Enterprise Manager after Patching ODSM to 11.1.1.6.0

The Oracle Directory Services Manager version shown in Enterprise Manager is the application version, which does not change when you patch ODSM.

The Oracle Lifecycle team requires all Enterprise Manager components to retain the same application version. However, because customers want to know which ODSM version they are using, ODSM maintains the actual (patch) version and Enterprise Manager maintains the application version, which causes this mismatch.

This issue is a known issue, starting with version 11.1.1.3.0.

29.1.2 Oracle Virtual Directory Version 11.1.1.6.0 Start-Up Fails on Windows

With version 11.1.1.6.0 on Windows 2003 and 2008 machines (both 32-bit and 64-bit), starting Oracle Virtual Directory fails with an exception.

To work around this issue, perform the following steps before you start an instance containing Oracle Virtual Directory:

1. Locate the cwallet.sso file at

$instance_home\config\jps\bootstrap\cwallet.sso

2. Add the write permission to the SYSTEM user's assigned privileges.

3. Start the Oracle Virtual Directory instance.

29.1.3 ODSM Bug Requires Editing of odsmSkin.css File

Due to a misplaced comment in the file odsmSkin.css, some labels on the ODSM home page are not displayed correctly. Specifically, the labels in the diagram on the right are misplaced or missing.

To work around this issue, proceed as follows:

1. Stop the wls_ods1 managed server and the WebLogic Administration server.

2. Edit the file:

MW_HOME/user_projects/domains/DOMAIN_HOME/servers/MANAGED_SERVER_NAME/tmp/_WL_user/ODSM_VERSION_NUMBER/RANDOM_CHARACTERS/war/skins/odsmSkin.css

For example:

wlshome/user_projects/domains/base_domain/servers/wls_ods1/tmp/_WL_user/odsm_11.1.1.2.0/z5xils/war/skins/odsmSkin.css

Before editing, the odsmSkin.css file looks like this:

@agent ie /*========== Fix for bug#7456880 ==========*/
{
af|commandImageLink::image,
af|commandImageLink::image-hover,
af|commandImageLink::image-depressed
{
vertical-align:bottom;
}
}

Move the comment:

/*========== Fix for bug#7456880 ==========*/

so that it is above the line

@agent ie

After editing, the file should look like this:

/*========== Fix for bug#7456880 ==========*/
@agent ie
{
af|commandImageLink::image,
af|commandImageLink::image-hover,
af|commandImageLink::image-depressed
{
vertical-align:bottom;
}
}

3. Restart the WebLogic Administration server and the wls_ods1 managed server.

29.1.4 Oracle Directory Services Manager Browser Window is Not Usable

In some circumstances, after you launch Oracle Directory Services Manager from Fusion Middleware Control, then select a new Oracle Directory Services Manager task, the browser window might become unusable. For example, the window might refresh repeatedly, appear as a blank page, fail to accept user input, or display a null pointer error.

As a work around, go to the URL: http://host:port/odsm, where host and port specify the location where Oracle Directory Services Manager is running, for example, http://myserver.example.com:7005/odsm. You can then use the Oracle Directory Services Manager window to log in to a server.

29.1.5 Exceptions May Occur in Oracle Directory Services Manager When Managing Multiple Oracle Virtual Directory Components and One is Stopped

Under certain circumstances, when managing multiple Oracle Virtual Directory components from the same Oracle Directory Services Manager session, exception or error messages may appear if you stop one of the Oracle Virtual Directory components. For example, you are managing Oracle Virtual Directory components named ovd1 and ovd2 from the same Oracle Directory Services Manager session. Both ovd1 and ovd2 are configured and running. If you stop ovd1, an exception or Target Unreachable message may appear when you try to navigate Oracle Directory Services Manager.

To work around this issue, exit the current Oracle Directory Services Manager session, close the web browser, and then reconnect to Oracle Virtual Directory components in a new Oracle Directory Services Manager session.

29.1.6 Identifying the DN Associated with an Access Control Point in Oracle Directory Services Manager

When you create an Access Control Point (ACP) using Oracle Directory Services Manager, the Relative Distinguished Name (RDN) of the DN where you created the ACP appears in the navigation tree on the left side of the screen. For example, if you create an ACP at the DN of cn=ForExample,dc=us,dc=sales,dc=west, then cn=ForExample appears in the navigation tree. After clicking an ACP in the navigation tree, its settings appear in the right side of the screen and the RDN it is associated with appears at the top of the page.

To identify the DN associated with an ACP, move the cursor over ("mouse-over") the ACP entry in the navigation tree. The full DN associated with the ACP will be displayed in a tool-tip dialog box.

Mousing-over ACPs in the navigation tree is useful when you have multiple ACPs associated with DNs that have identical RDNs, such as:

ACP 1 = cn=ForExample,dc=us,dc=sales,dc=west

ACP 2 = cn=ForExample,dc=us,dc=sales,dc=east

29.1.7 Issues With Oracle Virtual Directory Metrics in Fusion Middleware Control

This topic describes issues with Oracle Virtual Directory metrics in Fusion Middleware Control, including:

- Configuring Operation-Specific Plug-Ins to Allow Performance Metric Reporting in Fusion Middleware Control After Upgrading to 11g Release 1 (11.1.1)

29.1.7.1 Configuring Operation-Specific Plug-Ins to Allow Performance Metric Reporting in Fusion Middleware Control After Upgrading to 11g Release 1 (11.1.1)

If you upgraded an Oracle Virtual Directory Release 10g installation with plug-ins configured to execute on specific operations, such as add, bind, get, and so on, to 11g Release 1 (11.1.1), you may have to update those operation-specific plug-ins before you can use Fusion Middleware Control to view performance metrics.

After upgrading to 11g Release 1 (11.1.1) and performing some initial operations to verify the upgrade was successful, check the Oracle Virtual Directory home page in Fusion Middleware Control. You should see data for the Current Load and Average Response Time and Operations metrics.

If you do not see any data for these metrics, you must update the plug-ins configured to execute on specific operations. The work-around is to add the Performance Monitor plug-in to the operation-specific plug-in's configuration chain.

Perform the following steps to add the Performance Monitor plug-in to the operation-specific plug-in's configuration chain:

1. If the operation-specific plug-in is a Global-level plug-in, edit the server.os_xml file located in the ORACLE_INSTANCE/config/OVD/NAME_OF_OVD_COMPONENT/ directory.
If the operation-specific plug-in is an adapter-level plug-in, edit the adapters.os_xml file located in the ORACLE_INSTANCE/config/OVD/NAME_OF_OVD_COMPONENT/ directory.

Note:

If multiple adapters are configured, you must perform steps 2 and 3 for every adapter configuration in the adapters.os_xml file.

2. Locate the pluginChains element in the file. For example, if the Dump Transactions plug-in is configured to execute on the get operation, you will see something similar to the following:

Example 29-1 Dump Transactions Plug-In Configured for get Operation

<pluginChains xmlns="http://xmlns.oracle.com/iam/management/ovd/config/plugins">
<plugins>
<plugin>
<name>Dump Transactions</name>
<class>com.octetstring.vde.chain.plugins.DumpTransactions.DumpTransactions</class>
<initParams>
<param name="loglevel" value="info"/>
</initParams>
</plugin>
<plugin>
<name>Performance Monitor</name>
<class>com.octetstring.vde.chain.plugins.performance.MonitorPerformance</class>
<initParams/>
</plugin>
</plugins>
<default>
<plugin name="Performance Monitor"/>
</default>
<get>
<plugin name="Dump Transactions">
<namespace>ou=DB,dc=oracle,dc=com </namespace>
</plugin>
</get>
</pluginChains>

3. Add the following Performance Monitor plug-in element within the operation-specific configuration chain:

<plugin name="Performance Monitor"/>

For example:

Example 29-2 Adding the Performance Monitor to the Operation-Specific Plug-In Configuration Chain

<pluginChains xmlns="http://xmlns.oracle.com/iam/management/ovd/config/plugins">
<plugins>
<plugin>
<name>Dump Transactions</name>
<class>com.octetstring.vde.chain.plugins.DumpTransactions.DumpTransactions</class>
<initParams>
<param name="loglevel" value="info"/>
</initParams>
</plugin>
<plugin>
<name>Performance Monitor</name>
<class>com.octetstring.vde.chain.plugins.performance.MonitorPerformance</class>
<initParams/>
</plugin>
</plugins>
<default>
<plugin name="Performance Monitor"/>
</default>
<get>
<plugin name="Dump Transactions">
<namespace>ou=DB,dc=oracle,dc=com </namespace>
</plugin>
<plugin name="Performance Monitor"/>
</get>
</pluginChains>

4. Save the file.

5. Restart Oracle Virtual Directory.

29.1.8 Using a Wildcard when Performing an LDAPSEARCH on a TimesTen Database Causes an Operational Error

Currently, a TimesTen bug is preventing wildcard searches (such as "cn=t*") from working in a Database adapter with TimesTen.

To work around this problem, enable the Case Insensitive Search option and create the necessary linguistic indexes for any database columns used in the search.

For more information, see the related TimesTen Enhancement Request, Bug# 9885055 and Section 12.2.2 "Creating Database Adapters for Oracle TimesTen In-Memory Database" in the Oracle® Fusion Middleware Administrator's Guide for Oracle Virtual Directory.

29.1.9 ODSM Version 11.1.1.4.0 Does Not Support OVD Versions 11.1.1.2.0 or 11.1.1.3.0

Oracle Directory Services Manager Version 11.1.1.4.0 does not support Oracle Virtual Directory Versions 11.1.1.2.0 or 11.1.1.3.0.

Changes introduced in Oracle Directory Services Manager Version 11.1.1.4.0 improve configuration auditing, and these changes require that you use Oracle Virtual Directory 11.1.1.4.0.

29.1.10 ODSM Version 11.1.1.5.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, or 11.1.1.4.0

Oracle Directory Services Manager Version 11.1.1.5.0 does not support Oracle Virtual Directory Versions 11.1.1.2.0, 11.1.1.3.0, or 11.1.1.4.0.

Changes introduced in Oracle Directory Services Manager Version 11.1.1.5.0 improve configuration auditing, and these changes require that you use Oracle Virtual Directory 11.1.1.5.0.

29.1.11 ODSM Version 11.1.1.6.0 Does Not Support OVD Versions 11.1.1.2.0, 11.1.1.3.0, 11.1.1.4.0, or 11.1.1.5.0

Oracle Directory Services Manager Version 11.1.1.6.0 does not support Oracle Virtual Directory Versions 11.1.1.1.0, 11.1.1.2.0, 11.1.1.3.0, 11.1.1.4.0, or 11.1.15.0.

Changes introduced in Oracle Directory Services Manager Version 11.1.1.6.0 improve configuration auditing, and these changes require that you use Oracle Virtual Directory 11.1.1.6.0.

29.1.12 Oracle Virtual Directory Issues with IPv6 Stack on Windows Platforms Using JDK6

Included per bugs 10404375, 10427917, 10629132, 13357382.

Running CRUD operations on Microsoft Windows platforms using JDK 6 causes an issue in NIO (non-blocking Input/Output) mode because an issue exists with non-blocking IO. The same problem happens for the IPv6 addresses in Windows dual-stack (IPv4/IPv6) systems.

Note:

Support for IPv6 stack was added in JDK 7 Build b36.

For more information, refer to JDK Bug ID 6230761 (http://bugs.sun.com/view_bug.do?bug_id=6230761) and 4640544 (http://bugs.sun.com/view_bug.do?bug_id=4640544).

The Oracle Virtual Directory development team verified this use case with JDK 7 and confirmed that it works in Oracle Virtual Directory NIO mode.

Workaround:

Note:

You must apply this workaround in the Oracle Virtual Directory server.

In the OVD server, turn off NIO mode by adding the <useNIO>false</useNIO> XML element in <OracleInstance>/config/OVD/ovd1/listeners.os_xml at the following location, then stop and restart the Oracle Virtual Directory server:

<ldap id="LDAP Endpoint" version="0">
<port>6501</port>
...
<socketOptions>
...
</socketOptions>
<useNIO>false</useNIO>
</ldap>

29.1.13 Users with Non-ASCII Names Might Encounter Problems when Using ODSM with SSO

When ODSM is configured to use Oracle Access Manager 11g Release 1 (11.1.1.2) for single sign-on, a user whose name contains non-ASCII characters might observe the following issues after logging in:

- The user name displayed on the Home page is garbled.

- Single sign-on connections to Oracle Virtual Directory servers do not appear in the list of connections.

29.1.14 Creating an Attribute/Object Class Throws NPE Error

After upgrading Oracle Directory Services Manager, creating an attribute or an objectclass causes an NPE error.

Workaround:

Refresh the entries by clicking Refresh every time the creation fails.

29.1.15 Patch Required to Enable Account Lockout Feature

An additional Patch 10365116 is required to enable the Account Lockout functionality.

In addition, Oracle Virtual Directory may not update the AD badpasswdcount until the account is fully locked out, which means AD badpasswdcount shows the correct number when it reaches the bad password count setting in AD.

29.1.16 ODSM Problems in Internet Explorer 7

The ODSM interface might not appear as described in Internet Explorer 7.

For example, the Logout link might not be displayed.

If this causes problems, upgrade to Internet Explorer 8 or 9 or use a different browser.

29.1.17 Strings Related to New Enable User Account Lockout Feature on EUS Wizard Are Not Translated

The new Enable User Account Lockout feature (and related messages) provided in the Oracle Virtual Directory EUS wizard have not been translated.

29.2 Configuration Issue and Workaround

This section describes a configuration issue and its workaround. It includes the following topic:

- Section 29.2.1, "Java Virtual Machine Dumps Core With OutOfMemory Error in Oracle Virtual Directory Database"

- Section 29.2.2, "OVD Server Configuration Issue on Microsoft Windows x64 (64-bit)"

29.2.1 Java Virtual Machine Dumps Core With OutOfMemory Error in Oracle Virtual Directory Database

Included per bug 8599757

For certain operations, the out-of-box heap size of 512 MB is not sufficient for Oracle Virtual Directory (OVD) on AIX.

Workaround

Increase the heap size to over 1 GB for production environments. Complete the following steps to increase the heap size for Oracle Virtual Directory (OVD):

1. In INSTANCE_HOME/config/OPMN/opmn.xml, find the following XML fragment:

<process-type id="OVD" module-id="OVD">
<environment>
<variable id="TNS_ADMIN" value="$ORACLE_INSTANCE/config"/>
</environment>
<module-data>
<category id="start-options">
<data id="java-bin" value="$ORACLE_HOME/jdk/bin/java"/>
<data id="java-options" value="-server -Xms512m -Xmx512m
-Dvde.soTimeoutBackend=0
-Doracle.security.jps.config=$ORACLE_INSTANCE/config/JPS/jps-config-jse.xml"/>
<data id="java-classpath"
value="$ORACLE_HOME/ovd/jlib/vde.jar$:$ORACLE_HOME/jdbc/lib/ojdbc6.jar"/>
</category>
</module-data>
<stop timeout="120"/>
</process-type>

2. Modify the default -Xmx512m to an appropriate value. For example: -Xmx2048m.

3. Shutdown Oracle Virtual Directory.

4. Execute opmnctl reload command to refresh OPMN configuration.

5. Start Oracle Virtual Directory.

29.2.2 OVD Server Configuration Issue on Microsoft Windows x64 (64-bit)

Included per bug 13357382

While configuring Oracle Virtual Directory (OVD) server on Microsoft Windows x64 (64-Bit) with IPv4 or IPv6 dual-stack system, it fails to listen on IPv6 address for non-SSL port.

To work around this issue, add the following line for the non-SSL OVD port in listeners.os_xml:

<useNIO>false</useNIO>

It shows as:

<ldap id="LDAP Endpoint" version="1">
<port>6501</port>
<host>0.0.0.0</host>
<threads>10</threads>
<active>true</active>
<ssl enabled="false">
.....
<readTimeout>0</readTimeout>
</socketOptions>
<useNIO>false</useNIO>
</ldap>

29.3 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Deploying Oracle Unified Directory with Oracle Virtual Directory

- Code Example Does Not Close Connection to LDAP Server

29.3.1 Deploying Oracle Unified Directory with Oracle Virtual Directory

You can deploy Oracle Unified Directory as an LDAP data source with Oracle Virtual Directory. For information about how to deploy Oracle Unified Directory with Oracle Virtual Directory, see "Creating LDAP Adapters" in the Oracle® Fusion Middleware Administrator's Guide for Oracle Virtual Directory.

29.3.2 Code Example Does Not Close Connection to LDAP Server

The code example currently provided in section 18.3.3.3, "Operation Plug-In Implementation Point" of the Administrator's Guide for Oracle Virtual Directory does not close the connection to the back-end LDAP server.

The example code uses chain.getVSI().get, which populates a Vector<EntrySet> with one EntrySet for each adapter. Each EntrySet in get() contains a live handle to the data source connection, which is used to retrieve entries.

To release this data source connection to the pool, you must provide a call to EntrySet.cancelEntrySet()or Oracle Virtual Directory could be blocked. Blocking occurs when the plug-in occupies all of the configured connections from the pool and no connections are available to execute new requests.

The example code should be updated to implement a call to entrySet.cancelEntrySet() as follows:

ChainVector results = new ChainVector();
try
{
chain.getVSI().get(...);
}
catch (...)
{

}
finally
{
for (EntrySet entrySet : results)
entrySet.cancelEntrySet();
}

29.3.3 Missing Instruction for Configuring Oracle Virtual Directory for Integration with Oracle Directory Server Enterprise Edition

Section 19.2.3.3.1, "Configuring Oracle Virtual Directory for the Integration" should include an instruction for setting SSL Authentication Mode. The section should read as follows:

- Select the EUS_Sun template.

- Set SSL Authentication Mode to Server Only / Mutual Authentication.

- The Proxy DN user must be able to read the userPassword attribute in the Oracle Directory Server Enterprise Edition.

Part IX

Oracle Portal, Forms, Reports and Discoverer

Part IX contains the following chapters:

- Chapter 30, "Oracle Business Intelligence Discoverer"

- Chapter 31, "Oracle Forms"

- Chapter 32, "Oracle Portal"

- Chapter 33, "Oracle Reports"

30 Oracle Business Intelligence Discoverer

This chapter describes issues associated with Oracle Business Intelligence Discoverer. It includes the following topics:

- Section 30.1, "General Issues"

- Section 30.2, "Issues Specific to Oracle BI Discoverer Plus Relational"

- Section 30.3, "Issues Specific to Oracle BI Discoverer Plus OLAP"

- Section 30.4, "Issues Specific to Oracle BI Discoverer Portlet Provider"

- Section 30.5, "Issues Specific to Oracle BI Discoverer Viewer"

- Section 30.6, "Issues Specific to Oracle BI Discoverer EUL Command Line for Java"

- Section 30.7, "Issues Specific to Oracle BI Discoverer Administrator"

- Section 30.8, "Documentation Errata"

30.1 General Issues

This section describes general issues that affect more than one Discoverer component. It includes the following topics:

- Section 30.1.1, "Issue while Creating Discoverer schema on Oracle Database 12g Release 1"

- Section 30.1.2, "Issues with Metadata Repository and Oracle Database 10g Release 1"

- Section 30.1.3, "Compatibility Issues with Required Support Files"

- Section 30.1.4, "Serif Font Issue in Worksheets"

- Section 30.1.5, "Query Prediction Requires the Majority of the Query Time"

- Section 30.1.6, "Word Wrapping Behavior with Oracle BI Discoverer Plus and Oracle BI Discoverer Viewer"

- Section 30.1.7, "Applet Appears Behind Browser Window"

- Section 30.1.8, "Issues with Mac OS X Browser and Oracle BI Discoverer Plus"

- Section 30.1.9, "Issues with Turkish Regional Settings"

- Section 30.1.10, "Multibyte Characters Rendered as Square Boxes in Exported PDF and Other Formats"

- Section 30.1.10, "Multibyte Characters Rendered as Square Boxes in Exported PDF and Other Formats"

- Section 30.1.12, "HTTP 404 Error While Accessing Discoverer on a Remote Machine"

- Section 30.1.13, "Error While Launching Discoverer Plus Applet on an IPv6 Environment"

- Section 30.1.14, "Error While Updating the Discoverer Web Services Configuration Parameter"

- Section 30.1.15, "Exception Logged for Discoverer Web-Based Applications in an Extended Domain"

- Section 30.1.16, "Issue with Discoverer Application URL in Fusion Middleware Control after a Backup Recovery"

- Section 30.1.17, "Incorrect Version Number for Discoverer in Fusion Middleware Control 11g."

- Section 30.1.18, "Oracle BI Discoverer Startup Fails after Shutdown."

- Section 30.1.19, "The Database Export and Import Utility does not Work with Applications Mode EUL."

- Section 30.1.20, "Install-level Scripts are not Updated in Existing Instances after Patching."

30.1.1 Issue while Creating Discoverer schema on Oracle Database 12g Release 1

When you create Oracle Discoverer schema by using Repository Creation Utility (RCU) on Oracle Database 12g (12.1.0.0.0), you might get a similar error as follows:

ORA-01950: no privileges on tablespace 'DB6861_DISCO_PSTORE'

To work around this issue, edit the parameter file (pfile) by following the procedure below:

1. Create Oracle Database 12g.

2. Create a pfile by running the SQL command 'create pfile from spfile'. The user should have SYSDBA privileges to run this command.

3. Edit the pfile and add the parameter _resource_includes_unlimited_tablespace=TRUE.

4. Shut down the database.

5. Create an spfile by running the SQL command 'create spfile from pfile'.

6. Start the database.

Alternatively, you can create the database in silent mode and specify the value of _resource_includes_unlimited_tablespace as TRUE as in the following example:

./dbca -createDatabase -templateName General_Purpose.dbc -gdbName
db111.us.oracle.com -sid db111 -sysPassword Welcome1 -systemPassword Welcome1
-emConfiguration LOCAL -dbsnmpPassword Welcome1 -sysmanPassword Welcome1
-datafileJarLocation /dbhome_1/assistants/dbca/templates
-storageType FS -datafileDestination /db123/oradata
-responseFile NO_VALUE -characterset AL32UTF8 -obfuscatedPasswords false
-sampleSchema true -oratabLocation ORATAB -recoveryAreaDestination NO_VALUE
-initParams _resource_includes_unlimited_tablespace=TRUE -silent

30.1.2 Issues with Metadata Repository and Oracle Database 10g Release 1

When using Oracle Database 10g Release 1 (10.1.x) for the Metadata Repository or after upgrading the Metadata Repository to Oracle Database 10g Release 1, you might see the following error on the Oracle BI Discoverer Plus Connection pages, the Oracle BI Discoverer Viewer Connection pages, and the Public Connection definition page in Fusion Middleware Control:

The connection list is currently unavailable.
ORA-06510: PL/SQL: unhandled user-defined exception
ORA-06512: at "ORASSO.WWSSO_API_PRIVATE," line 258
ORA-06510: PL/SQL: unhandled user-defined exception
ORA-06512: at "ORASSO.WWSSO_UTL" line 728
ORA-28231: no data passed to obfuscation toolkit
ORA-06512: at line 1 Unable to retrieve connection list

To resolve this issue, make the following changes in the Metadata Repository database:

1. Edit the init%ORACLE_SID%.ora file. This file exists either in the dbs folder or the database folder. For example, in Windows, this file is located in the DB_install_home/database/ folder.

2. Add the following line to this file:
event="10946 trace name context forever, level 36"

3. If an spfile%ORACLE_SID%.ora exists in either the dbs folder or the database folder, rename the file to spfile%ORACLE_SID%.bak. Changes to init%ORACLE_SID%.ora are not loaded if the database server finds an spfile.

4. Log in as a sysadmin.

5. At the SQL prompt, shut down then start up the database server.

6. Restart the Oracle BI Discoverer server using the command opmnctl restartall.

30.1.3 Compatibility Issues with Required Support Files

The Oracle Database and other Oracle database client software (for example, SQL*Plus, the database export utility) use Oracle Required Support Files (RSF).

Oracle BI Discoverer also uses Oracle Required Support Files (RSF), specifically RSF version 11.1.0.7. This version of the Oracle Required Support Files is installed during Oracle BI Discoverer installation.

Note that the Required Support Files version 11.1.0.7 is incompatible with earlier versions of Oracle Database 10g. So if the machine on which you install Oracle BI Discoverer already has a version of Oracle Database 10g or database client software that is earlier than 11.1.0.7, there will be compatibility issues. For example, if you install Oracle BI Discoverer and attempt to run a version of SQL*Plus earlier than 11.1.0.7, then the following error is displayed:

ORA-12557 TNS: protocol adapter not loadable

To avoid the compatibility issues, upgrade Oracle Database 10g or database client software on the machine to the same version (11.1.0.7) as the version of the Required Support Files that were installed with Oracle BI Discoverer.

This issue does not exist for Oracle9i Database Server.

30.1.4 Serif Font Issue in Worksheets

You might notice unsightly font issues when using a non-English locale such as Czech. For example, when a worksheet uses a serif font, text in that worksheet might be displayed incorrectly on the screen and in printouts.

To work around this issue, update the file that maps the serif fonts. The name of this file differs depending on the locale in use. When you use Oracle BI Discoverer Plus Relational or Plus OLAP in English, the file is named file.properties. If you use Oracle BI Discoverer in a non-English locale, then the file name includes the code for the locale, such as file.properties.cs for Czech.

Update the mapping file with the following information:

serif.0=Times New Roman,EASTEUROPE_CHARSET serif.1=WingDings,SYMBOL_CHARSET,NEED_CONVERTED serif.2=Symbol,SYMBOL_CHARSET,NEED_CONVERTED

Consult the following Sun Web site for additional information about fonts:

http://java.sun.com/j2se/1.3/docs/guide/intl/addingfonts.html

30.1.5 Query Prediction Requires the Majority of the Query Time

When using Oracle BI Discoverer with a relational data source, you can predict the time that is required to retrieve information by setting the value of the QPPEnable preference to 1. However, in some circumstances, the majority of the time taken to retrieve information is consumed by the prediction activity itself.

To work around this issue, set the value of the QPPObtainCostMethod preference to 0 (use the EXPLAIN PLAN statement to predict query times) rather than to 1 (use dynamic views to predict query times).

For more information about setting preferences, see the Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

30.1.6 Word Wrapping Behavior with Oracle BI Discoverer Plus and Oracle BI Discoverer Viewer

To use word wrap settings correctly, you must understand how they are designed for Oracle BI Discoverer:

- Oracle BI Discoverer Plus: Word wrap settings that you make in Oracle BI Discoverer Plus are saved in the worksheet and affect the display of worksheets in Oracle BI Discoverer Plus and when printing to PDF.

- Oracle BI Discoverer Viewer: Word wrap settings that you see in the Print Settings dialog work as follows:

- The word wrap settings do not affect the display of worksheets in Oracle BI Discoverer Viewer.

- For relational data:

- The word wrap settings do affect the printing of worksheets to PDF.

- If the Always wrap text when size exceeds column width box is checked, then the print settings in Oracle BI Discoverer Viewer do override the settings made in a worksheet in Oracle BI Discoverer Plus Relational for printing to PDF.

- If the Always wrap text when size exceeds column width box is not checked, then the print settings in Oracle BI Discoverer Viewer do not override the settings made in a worksheet in Oracle BI Discoverer Plus Relational for printing to PDF.

- For OLAP data:

- The word wrap settings do not affect the printing of worksheets to PDF.

- Regardless of whether the Always wrap text when size exceeds column width check box is selected, the print settings in Oracle BI Discoverer Viewer never override the settings made in a worksheet in Oracle BI Discoverer Plus OLAP for printing to PDF.

30.1.7 Applet Appears Behind Browser Window

When you use Microsoft Internet Explorer, the Oracle BI Discoverer Plus Relational or Plus OLAP applet initialization and download dialog appears behind the browser window from which it was launched. After the applet is downloaded and initialized, it appears in front of the browser window from which it was launched.

To work around this issue:

- Use a browser other than Internet Explorer, such as Netscape Navigator or Mozilla Firefox.

- Use the Oracle BI Discoverer Plus URL parameter _plus_popup=false, which is documented in the Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

30.1.8 Issues with Mac OS X Browser and Oracle BI Discoverer Plus

The following are issues that you might encounter when you use the Safari browser on Mac OS X with Oracle BI Discoverer Plus Relational or Plus OLAP:

- If you resize the browser window in the applet, then some parts of the content might be clipped. To work around this problem, always maximize the browser window for the applet when working with Mac OS X.

- Keyboard combinations (also known as mnemonics) do not work in Oracle BI Discoverer Plus Relational and Plus OLAP.
For example, you cannot press Alt+F to access the File menu.

- In the Share Workbooks dialog of Oracle BI Discoverer Plus Relational, the leading characters of the "Shared:" list are clipped. In other words, the left edge of the list is truncated. For example, if you shared a workbook with DISCODEV, then you will only see SCODEV in the list. The title for the list is also truncated such that you see only the vertical line of the "d" in "Shared" and the colon (that is, "l:").
The dialog continues to work as expected, but you might have difficulty reading the names in the "Shared:" list.

This issue has no workaround.

30.1.9 Issues with Turkish Regional Settings

Because of Sun JRE 1.4 bug 4688797, you might encounter issues when connecting to a database schema from a computer that has Turkish regional settings. You will encounter the issue when you attempt to connect to a database schema with a user name that contains certain letters, such as the letter 'I' or 'i', for example, in "bibdemo". See the Sun JRE bug for information on the letters that are affected.

To work around this issue, either do not use Turkish regional settings or use a user name that does not contain the affected letters.

30.1.10 Multibyte Characters Rendered as Square Boxes in Exported PDF and Other Formats

When you export a workbook to PDF and other formats, multibyte characters (for example, Korean, Japanese, and Chinese characters) appear as square boxes.

To work around this issue, copy the following Albany fonts from ORACLE_HOME/jdk/jre/lib/fonts to the fonts folder of your JDK (Oracle JRockit or Sun) within the MW_HOME directory. For example, if you are using Sun JDK, you must copy the fonts to MW_HOME/jre/jdk160_11/lib/fonts.

- AlbanWTJ.ttf

- AlbanWTK.ttf

- AlbanWTS.ttf

- AlbanWTT.ttf

- ALBANYWT.ttf

30.1.11 Java Plug-in Not Downloaded Automatically on Firefox

When you attempt to connect to Discoverer Plus by using the Mozilla Firefox browser on a machine that does not have Java 1.6 installed, the browser does not download the JRE 1.6 plug-in automatically. Instead, the browser displays the following message:

Additional plugins are required to display this page...

You must download the JRE 1.6 plug-in (by clicking the Install Missing Plugin link) and install it manually.

30.1.12 HTTP 404 Error While Accessing Discoverer on a Remote Machine

When you attempt to connect to Discoverer Plus, occasionally, the browser returns an HTTP 404 (File Not Found) error.

The page loads correctly when you refresh the browser a few times.

30.1.13 Error While Launching Discoverer Plus Applet on an IPv6 Environment

If the Web tier is on an IPv6 machine, when you start Discoverer Plus, the following error message might be displayed:

Attempt1. RMI protocol over JRMP transport: Connection refused to host: DiscoServerMahcineName;nested exception is:
@ java.net.ConnectionException: Connection timed out

To work around this issue, in the System MBean Browser of Fusion Middleware Control, change the TransportProtocols attribute of the Plus Config MBean to "jrmp,http" (or "jrmp,https" if Discoverer Plus is accessed by using secure HTTP).

30.1.14 Error While Updating the Discoverer Web Services Configuration Parameter

When you update the web services configuration parameter (Maximum Sessions) using the Discoverer Web Services Configuration page of Fusion Middleware Control and click Apply, the following error message is displayed:

Applying changes - Failed.
Exception caught:

You can ignore the error message because the changes are applied even if the exception is thrown. Alternatively, you can update the MaxSessions attribute of the WebServicesConfig MBean in the System MBean Browser of Fusion Middleware Control.

30.1.15 Exception Logged for Discoverer Web-Based Applications in an Extended Domain

When you extend a domain and add Discoverer application in a remote machine, you may see the following exception in the WebLogic Server log:

java.lang.IllegalArgumentException: ODL-52057: The handler 'disco-server-handler' is not defined.

To work around this issue, modify the log_handlers and loggers elements in the logging.xml file located in the DOMAIN_HOME/config/fmwconfig/servers/WLS_DISCO folder of the machine where the domain exists.

In the log_handlers section, add the handlers as follows:

<log_handler name='discoverer-handler'
class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path'
value='${domain.home}/servers/${weblogic.Name}/logs/discoverer/diagnostic.log'
/>
<property name='maxFileSize' value='1048576'/>
<property name='maxLogSize' value='10485760'/>
<property name='format' value='ODL-Text'/>
<property name='useSourceClassAndMethod' value='false'/>
</log_handler>

<log_handler name='disco-server-handler'
class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path'
value='${domain.home}/servers/${weblogic.Name}/logs/discoverer/server/diagnost
ic.log'/>
<property name='maxFileSize' value='1048576'/>
<property name='maxLogSize' value='10485760'/>
<property name='format' value='ODL-Text'/>
</log_handler>

In the loggers sections, add the following elements:

<logger name='ORACLE.DISCOVERER.VIEWER' level='TRACE:32'
useParentHandlers='false'>
<handler name='discoverer-handler'/>
<handler name='odl-handler'/>
</logger>
<logger name='ORACLE.DISCOVERER.PORTLET_PROVIDER' level='TRACE:32'
useParentHandlers='false'>
<handler name='discoverer-handler'/>
<handler name='odl-handler'/>
</logger>
<logger name='ORACLE.DISCOVERER.MODEL' level='TRACE:32'
useParentHandlers='false'>
<handler name='discoverer-handler'/>
<handler name='odl-handler'/>
</logger>
<logger name='ORACLE.DISCOVERER.WEB_SERVICES' level='TRACE:32'
useParentHandlers='false'>
<handler name='discoverer-handler'/>
<handler name='odl-handler'/>
</logger>
<logger name='ORACLE.DISCOVERER.SERVER' level='TRACE:32'
useParentHandlers='false'>
<handler name='disco-server-handler'/>
<handler name='odl-handler'/>
</logger>

After adding these elements, save the logging.xml file, and restart the Administration Server and Discoverer Managed Servers.

30.1.16 Issue with Discoverer Application URL in Fusion Middleware Control after a Backup Recovery

When you recover the Oracle BI Discoverer middle tier from a backup, the Discoverer application URL in the Discoverer Home page of Fusion Middleware Control point to a wrong location.

You must configure the application URLs that appear on the Oracle BI Discoverer Home page in Fusion Middleware Control after recovering the Oracle BI Discoverer middle tier from a backup.

For more information, see "How to configure application URLs displayed on the Fusion Middleware Control Discoverer Home page" in the Oracle Business Intelligence Discoverer Configuration Guide.

30.1.17 Incorrect Version Number for Discoverer in Fusion Middleware Control 11g

In Fusion Middleware Control 11g, the Enterprise Manager Fusion Middleware Control pages display wrong version number (11.1.1.2.0) for the Oracle BI Discoverer application. The correct version number for Oracle BI Discoverer is 11.1.1.4.0.

30.1.18 Oracle BI Discoverer Startup Fails after Shutdown

When you first start up the Discoverer application from Oracle Enterprise Manager Fusion Middleware Control or Oracle WebLogic Administration Console after shutting down the application instance, the startup fails with error logs.

To work around this issue, start the Discoverer application again. The second time the application starts without any error message.

30.1.19 The Database Export and Import Utility does not Work with Applications Mode EUL

You cannot use the standard database export and import utilities to export or import the database, EUL tables and database objects referenced by the Applications Mode EUL definitions. The standard database export and import utility can be used only for standard EUL definitions.

To work around this issue, use the Discoverer Export Wizard in Discoverer Administrator to export EUL objects to an EUL export file (*.EEX). After exporting the EUL objects, you can import the .EEX file using the Discoverer Import Wizard.For more information, see "Creating and Maintaining End User Layers" in Oracle Fusion Middleware Administrator's Guide for Oracle Business Intelligence Discoverer.

30.1.20 Install-level Scripts are not Updated in Existing Instances after Patching

When you upgrade Oracle Discoverer 11gR1 PS1 to 11gR1 PS2 or 11gR1 PS3, the patch will be installed in the ORACLE_HOME folder. Therefore, script changes in the new patch set will not be available for existing Oracle Discoverer instances, which are located in the ORACLE_INSTANCE folder. However, new instances that are created after the patch upgrade will be updated.

To work around this issue, after a patch upgrade manually copy the new scripts to the existing ORACLE_INSTANCE folders. For example, copy the new discenv.sh script file from ORACLE_HOME to the ORACLE_INSTANCE/Discoverer/Discoverer_instance-name/util/ folder.

For more information about Discoverer file locations, see "Oracle BI Discoverer Configuration Files" in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

30.2 Issues Specific to Oracle BI Discoverer Plus Relational

This section describes issues that are specific to Oracle BI Discoverer Plus Relational. It includes the following topics:

- Section 30.2.1, "Text Appearing Truncated or Clipped"

- Section 30.2.2, "Non-ASCII Characters Not Saved Correctly in Title or Text Area"

- Section 30.2.3, "Canceling Query Causes Discoverer to Hang"

- Section 30.2.4, "Nonaggregable Values Not Displayed for Scheduled Workbooks"

- Section 30.2.5, "Migrating Oracle BI Discoverer Plus Relational Worksheets from Oracle BI Discoverer Desktop"

30.2.1 Text Appearing Truncated or Clipped

When you run Oracle BI Discoverer Plus Relational with Sun Java Plug-in 1.4.2_06, the Browser Look and Feel, and an Asian language (such as Korean or Chinese), you might notice that static text and text in buttons in the user interface appears truncated or clipped. To work around this issue, do one of the following:

- Change the Look and Feel to either Plastic or System.

- Use JInitiator 1.3.1.17 instead of the Sun Java Plug-in.

- Install Sun Java Plug-in version 1.4.2_10 or higher.

30.2.2 Non-ASCII Characters Not Saved Correctly in Title or Text Area

When you save a new workbook in Oracle BI Discoverer Plus, any text characters beyond the standard ASCII characters are not saved correctly when all the conditions that are described in the following list are met:

- You are logged in as an Oracle e-Business Suite user.

- The language for the computer is not English.

- Oracle BI Discoverer Plus is running against an Oracle e-Business Suite database that does not have that non-English language installed.

This issue has no workaround.

30.2.3 Canceling Query Causes Discoverer to Hang

If you cancel a query that is running in Oracle BI Discoverer Plus Relational, then you are prompted to either choose YES to undo the changes or NO to show a blank sheet. If you choose YES, then Oracle BI Discoverer Plus Relational hangs and you must close the window and restart.

To work around this issue, choose NO to show a blank worksheet. You can then refresh the sheet and continue working.

30.2.4 Nonaggregable Values Not Displayed for Scheduled Workbooks

Oracle BI Discoverer Plus Relational does not display nonaggregable values for scheduled workbooks. In other words, Oracle BI Discoverer Plus Relational processes scheduled workbooks as if you selected the Show values that cannot be aggregated as: <Non-aggregable label> option in the Worksheet Properties dialog: Aggregation tab.

Nonaggregable values include those based on the following SQL functions:

- A CASE SQL statement

- A DECODE SQL statement

- A PL/SQL function

- A DISTINCT SQL statement

- An analytic function

30.2.5 Migrating Oracle BI Discoverer Plus Relational Worksheets from Oracle BI Discoverer Desktop

If you use Oracle BI Discoverer Plus Relational to open a worksheet that was created using Oracle BI Discoverer Desktop Version 9.0.4 (or earlier), the size of the title area for that worksheet defaults to two lines in height. A title height of two lines might be a problem if a worksheet title requires more than or less than two lines. If you want to change the size of the title area, you must resize the title area manually and save the worksheet.

To resize the title area for a worksheet, open the worksheet and drag the bar at the bottom of the title area pane up or down.

30.3 Issues Specific to Oracle BI Discoverer Plus OLAP

This section describes issues that are specific to Oracle BI Discoverer Plus OLAP. It includes the following topics:

- Section 30.3.1, "Issues with Applet Download"

- Section 30.3.2, "Disabled Netscape and Mozilla Browsers"

- Section 30.3.3, "Tabbing Fails to Synchronize Menus"

- Section 30.3.4, "Esc Key Fails to Close Certain Dialogs"

- Section 30.3.5, "Link Tool Works Incorrectly in Some Locales"

- Section 30.3.6, "Memory Issues when Exporting Extremely Large Graphs"

- Section 30.3.7, "Issue While Printing Worksheets with Large Data Values"

- Section 30.3.8, "Issues with Titles and Text Areas"

- Section 30.3.9, "Errors with JAWS and Format Dialogs"

- Section 30.3.10, "Issue with Discoverer Plus OLAP Connections on Windows"

- Section 30.3.11, "Error when Authorizing Multiple Users to Access Discoverer Catalog"

30.3.1 Issues with Applet Download

There may be Oracle Business Intelligence Discoverer Plus applet download issues when caching has been enabled in the Sun Java Plug-In.

To avoid these issues, disable caching in the plug-in.

30.3.2 Disabled Netscape and Mozilla Browsers

When you are running Netscape 7.x or Mozilla browsers, the Netscape and Mozilla Mail clients and Web browser may become disabled when Oracle BI Discoverer Plus OLAP modal dialogs are displayed.

Dismissing the Oracle BI Discoverer Plus OLAP dialogs resumes normal operation for the Netscape and Mozilla tools.

30.3.3 Tabbing Fails to Synchronize Menus

When you use the Tab key to select items in a worksheet, the menus do not always synchronize to reflect the currently selected item.

This issue has no workaround.

30.3.4 Esc Key Fails to Close Certain Dialogs

The Esc key does not close the following dialogs: Totals, New Total, Parameter, and Manage Catalog.

Instead of using the Esc key, click the Close or OK button.

30.3.5 Link Tool Works Incorrectly in Some Locales

The Link tool, which enables users to drill out to external URLs from a crosstab cell, might not work correctly in all locales due to URL encoding issues.

This issue has no workaround.

30.3.6 Memory Issues when Exporting Extremely Large Graphs

Exporting extremely large graphs can cause memory issues, requiring a restart of the Oracle BI Discoverer Plus OLAP session.

This issue has no workaround.

30.3.7 Issue While Printing Worksheets with Large Data Values

When printing a worksheet that contains large numbers in the data cells, the string ####### may be printed instead of the actual numbers.

This issue has no workaround.

30.3.8 Issues with Titles and Text Areas

The following issues exist with titles and text areas:

- Nonempty titles and text areas are printed even if they are hidden in the worksheet.
This issue has no workaround.

- When you set the title or text area background to green and export the worksheet to an HTML file, the background is incorrectly set to red in the exported file.
This issue has no workaround.

30.3.9 Errors with JAWS and Format Dialogs

When you use JAWS, you will notice errors when you attempt to format graphs and crosstabs using the Format dialogs.

This issue has no workaround.

30.3.10 Issue with Discoverer Plus OLAP Connections on Windows

When you connect to Oracle BI Discoverer Plus OLAP on a Windows platform by providing only the TNS alias for the database string, errors will occur.

To work around this issue, add the following variable in the DOMAIN_HOME\bin\setDomainEnv.cmd file.

PATH=$ORACLE_HOME\BIN;%PATH%

30.3.11 Error when Authorizing Multiple Users to Access Discoverer Catalog

When you authorize multiple users or roles to access the Discoverer Catalog through Oracle Enterprise Manager Fusion Middleware Control, an error occurs and the authorization fails.

To work around this issue, in the Authorize Users window of the Fusion Middleware Control, select only one user at a time from the Available Users and Roles list. If you have multiple users, repeat the authorization procedure for each user. For more information, see "Authorizing user and role access to the Discoverer Catalog" in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

30.4 Issues Specific to Oracle BI Discoverer Portlet Provider

This section describes issues that are specific to Oracle BI Discoverer Portlet Provider. It includes the following topics:

- Section 30.4.1, "Inability to Turn Off Display of Range Min and Max as Labels"

- Section 30.4.2, "Using Oracle BI Discoverer Portlet Provider with Oracle Single Sign-On and Secure Sockets Layer (SSL) Modes"

- Section 30.4.3, "Issues with Discoverer Portlets in WebCenter"

- Section 30.4.4, "Issue while Publishing Discoverer WSRP Portlets in Portals Other than Oracle Portal and Oracle WebCenter"

- Section 30.4.5, "Issue with Portlet Titles in Discoverer WSRP Portlets Published on IBM WebSphere"

- Section 30.4.6, "Issue with Color and Date Pickers in Discoverer WSRP Portlets"

- Section 30.4.7, "Worksheet Parameter LOV is not Displayed in Discoverer WSRP Portlets on IBM WebSphere Portal"

- Section 30.4.8, "Issue with Worksheet Parameter LOV Pop-Up Window in Discoverer WSRP Portlets"

30.4.1 Inability to Turn Off Display of Range Min and Max as Labels

In the Display Options of a gauge portlet, the Minimum Value and Maximum Value range labels are selected but are also disabled so that you cannot deselect the display of those values. The values for the minimum and the maximum appear at the ends of every gauge in the set except for those gauges where the value to be gauged is out of the range of the minimum and the maximum values. For those gauges where the value to be displayed exceeds the range of the minimum and the maximum values, the gauge will automatically adjust to accommodate the value.

This issue has no workaround.

30.4.2 Using Oracle BI Discoverer Portlet Provider with Oracle Single Sign-On and Secure Sockets Layer (SSL) Modes

If you configure Oracle BI Discoverer Portlet Provider to work with Oracle Single Sign-On and SSL, then UIX images might not display correctly in Oracle BI Discoverer. For example, on the Connect to OracleBI Discoverer page, the expand icon (that is, the blue + symbol) in the Details column of the Discoverer connections list might not display correctly.

To address this issue, you must add certain server startup properties.

1. Start Enterprise Manager Fusion Middleware Control. For more information, see "Managing and Configuring Discoverer" in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

2. Navigate to the WebLogic Server node (for example, WLS_DISCO) node, and click the WebLogic Server Administration Console link.

3. Select the Server Start tab on the Configurations page of the WebLogic Server Administration Console.

4. In the Arguments field, append the following lines, if they do not exist.

- -Doracle.discoverer.applications.protocol=https

- -Doracle.discoverer.applications.port=port_no
Set port_no to the HTTPS port number that you want to use (for example, 4443).

5. Restart the server.

30.4.3 Issues with Discoverer Portlets in WebCenter

The following issues exist for Discoverer portlets displayed in Oracle WebCenter.

- When a Worksheet portlet is displayed in Oracle WebCenter, the links to navigate to the next set of records does not work.

- When a List of Worksheets portlet is displayed in Oracle WebCenter, the Expand All Icons link does not work.

To work around these issues, set the RenderPortletInIFrame attribute of the portlet tag to TRUE. For more information, see "Setting Attribute Values for the Portlet Tag" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.

30.4.4 Issue while Publishing Discoverer WSRP Portlets in Portals Other than Oracle Portal and Oracle WebCenter

When you publish Discoverer WSRP Portlets in portals other than Oracle Portal and Oracle WebCenter (such as Oracle WebLogic Portal and IBM WebSphere Portal), the pop-up windows for input selection will have the same page layout as the portal page with all navigation options. If you select any of these navigation options, the current portlet state will be lost. You might need to start publishing the portlet from the beginnng.

The issue has no workaround.

30.4.5 Issue with Portlet Titles in Discoverer WSRP Portlets Published on IBM WebSphere

You cannot dynamically change the portlet title of a Discoverer WSRP portlet in IBM WebSphere after it is published. Static title is rendered in the portal for each portlet instance.

To work around this issue, set a meaningful title for the portlet by editing the title using the Set Title or Description option in the WebSphere portal. For more information about changing the title of a portlet, see WebSphere documentation.

30.4.6 Issue with Color and Date Pickers in Discoverer WSRP Portlets

The Color and Date pickers in Discoverer WSRP Portlets do not work on portals other than Oracle WebCenter.

On portals such as Oracle Portal, Oracle WebLogic Portal and IBM WebSphere, to workaround this issue, set the value of the configuration parameter useInlineUIXPicker to true. The default value of this parameter is false. When you set the useInlineUIXPicker parameter to true, set the color and date as follows:

- Inline color pickers are enabled in the Gauges Selection page and you can select a color from the palette.

- You cannot select the color using the Format option of the Personalize menu of the worksheet. Use the Analyze option in the portlet window to change the color.

- The Date picker in the Refresh option will not be available. Enter the date manually.

30.4.7 Worksheet Parameter LOV is not Displayed in Discoverer WSRP Portlets on IBM WebSphere Portal

The Worksheet Parameter LOV icon is not displayed when you publish Discoverer WSRP portlets in IBM WebSphere portal.To work around this issue, enter parameter values manually.

30.4.8 Issue with Worksheet Parameter LOV Pop-Up Window in Discoverer WSRP Portlets

In Oracle Portal and Oracle WebLogic Portal, when you select values from the parameter LOV from a worksheet portlet published by using the Discoverer WSRP Portlet producer, the pop-up window is not getting closed on selection of values.You must explicitly close the pop-up window after selection of values.

30.5 Issues Specific to Oracle BI Discoverer Viewer

This section describes issues that are specific to Oracle BI Discoverer Viewer. It includes the following topics:

- Section 30.5.1, "Drill Icons Cannot Be Hidden in Oracle BI Discoverer Viewer"

- Section 30.5.2, "Error Displaying Page for Multiple SSO Users"

- Section 30.5.3, "Inability to Disable the Display of Row Numbers"

- Section 30.5.4, "Issues with Oracle BI Discoverer Viewer Embedded in Frames"

- Section 30.5.5, "Issue Exporting to PDF Under Certain Circumstances"

- Section 30.5.6, "Issue When Changing Colors for Oracle BI Discoverer Viewer in Fusion Middleware Control on Mac OS X"

- Section 30.5.7, "Known Bug with JAWS Prevents Drilling Using the Enter Key"

- Section 30.5.8, "JAWS Does Not Read Asterisks that Precede Fields"

- Section 30.5.9, "Oracle BI Discoverer Viewer Pages are not Cached by Oracle Web Cache"

30.5.1 Drill Icons Cannot Be Hidden in Oracle BI Discoverer Viewer

The pref.txt file contains a setting called ShowDrillIcon, which is not functioning properly. If you set ShowDrillIcon to False, then drill icons are still displayed in Oracle BI Discoverer Viewer.

The issue has no workaround.

30.5.2 Error Displaying Page for Multiple SSO Users

When an Oracle Single Sign-On (SSO) user tries to view a worksheet from a List of Worksheets Portlet by using the same browser window that is already being used by an SSO user to view that worksheet, the second user sees the following error message: "The page cannot be displayed".

To work around this issue, start a new browser session and view the worksheet.

30.5.3 Inability to Disable the Display of Row Numbers

Oracle BI Discoverer Viewer no longer offers the ability to disable the display of row numbers in a tabular worksheet.

30.5.4 Issues with Oracle BI Discoverer Viewer Embedded in Frames

Users might see JavaScript errors such as "Access Denied" or other unexpected behavior when both of the following conditions are met:

- When Oracle BI Discoverer Viewer is embedded in an IFRAME tag.

- When the domain of the server that hosts the HTML page with the IFRAME tag is different from the domain of the Oracle BI Discoverer server that is running Oracle BI Discoverer Viewer.

Use one of the following workarounds for this issue:

- Run the Oracle BI Discoverer server and the server that hosts the HTML page with the IFRAME tag in the same domain.

- Alter the Common2_2_20.js file on the Oracle BI Discoverer server using the following steps:

1. Use Fusion Middleware Control to stop all services on the middle tier for Oracle Business Intelligence.

2. Make a backup copy of the Common2_2_20.js file from the following directory:
domain\servers\managed_server\stage\discoverer\release\discoverer\discoverer.war\cabo\jsLib

domain is the path of directory that contains the domain.

managed_server is the name of the managed server on which the Discoverer application is deployed.

release is the release number of Discoverer. For example, 11.1.1.1.0.

3. Edit the Common2_2_20.js file and replace all occurrences of "parent._pprSomeAction" with "window._pprSomeAction".

4. Use Fusion Middleware Control to start all services on the middle tier for Oracle Business Intelligence.

5. Clear the browser cache on the client machine so that the new Common2_2_20.js file will be used.

30.5.5 Issue Exporting to PDF Under Certain Circumstances

If you are using Oracle BI Discoverer Viewer with Microsoft Internet Explorer, you might encounter an error message when you try to export to PDF a worksheet that is named with non-ASCII characters, a space, and a number. The export fails and you will see a message similar to the following one:

No %PDF- in a file header

Use one of the following methods to work around this issue:

- Use a browser other than Internet Explorer, such as one from Netscape or Mozilla.

- Remove the space between the non-ASCII characters and the number, or remove the number altogether.

- Continue to use Internet Explorer and leave the space in the worksheet name, but follow these steps:

1. Start the Adobe Reader.

2. From the Edit menu, choose Preferences, then click Internet.

3. Clear the Display PDF in browser box.

30.5.6 Issue When Changing Colors for Oracle BI Discoverer Viewer in Fusion Middleware Control on Mac OS X

You can use Fusion Middleware Control to change the look and feel of Oracle BI Discoverer Viewer. That page contains a color chooser, or palette. If you use Fusion Middleware Control on Mac OS X with the Safari browser, then the page does not correctly enter the color code when you select a color from the palette.

To work around this issue, you can either use the Firefox browser or you can enter a color code directly.

The color codes are standard HTML hexadecimal color codes. You can enter one of the 49 colors that are available in the color palette, or you can enter any valid HTML hexadecimal color code.

The following list provides examples of colors with their codes:

white #FFFFFF
grey #CCCCCC
black #000000
pink #FFCCCC
red #FF0000
light yellow #FFFFCC
yellow #FFFF00
light green #99FF99
dark green #00CC00
light blue #66FFFF
dark blue #3333FF
lavender #FF99FF
purple #CC33CC

30.5.7 Known Bug with JAWS Prevents Drilling Using the Enter Key

Oracle BI Discoverer can be used in conjunction with assistive technologies such as the JAWS screen reader. However, a bug in JAWS prevents the drilling feature from working correctly in Oracle BI Discoverer Viewer when querying a relational data source.

Assume that you use the keyboard to navigate to the drill icon beside an item in the worksheet header. When you press the Enter key to drill on that header item, the Drill page should be displayed as described in the "Worksheet Display page: (Page level tools and controls)" topic in the Help system and the Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Discoverer Viewer).

However, when JAWS is running, the Drill page is not displayed. Instead, the Drill popup menu is displayed. It is not possible to select items from this popup menu by using the keyboard, and JAWS does not read the items on the popup menu.

This issue has no workaround.

30.5.8 JAWS Does Not Read Asterisks that Precede Fields

In Oracle BI Discoverer Viewer, an asterisk that precedes a text field indicates that the user is required to enter a value into that text field. The JAWS screen reader does not read an asterisk that precedes a required text field and does not otherwise indicate that the field is required.

This issue has no workaround.

30.5.9 Oracle BI Discoverer Viewer Pages are not Cached by Oracle Web Cache

When using Oracle BI Discoverer with Oracle Web Cache, note the following:

- When Oracle Single Sign-On is enabled, Oracle Web Cache does not cache Oracle BI Discoverer Viewer pages, regardless of whether they are accessed using a public connection or a private connection.

- If an Oracle BI Discoverer Viewer page is accessed directly through a URL and the URL contains URL parameters that specify login details (for example, user name, database name), then Oracle Web Cache does not cache the page. For example, Oracle Web Cache does not cache worksheet "Sheet 1" in workbook "Workbook 2" that is displayed by using the following URL:
http://<host.domain>:<port>/discoverer/viewer?us=video5&db=db1&eul=VIDEO5&wbk=Workbook+2&ws=Sheet+1

Note:

In the example above, us= specifies the database user name, and db= specifies the database name.

However, Oracle Web Cache does cache worksheet "Sheet 1" in workbook "Workbook 2" if a user logs in manually to Oracle BI Discoverer Viewer by using the same login details, and navigates to the worksheet.

- You must increase the delays for Oracle BI Discoverer Viewer by at least 60 seconds for Oracle BI Discoverer Viewer to properly cache workbooks with Oracle Web Cache.
For more information, see "How to configure Discoverer Viewer to enable maximum caching" in the Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

30.6 Issues Specific to Oracle BI Discoverer EUL Command Line for Java

This section describes issues that are specific to Oracle BI Discoverer EUL Command Line for Java.

30.6.1 Issue with Exported Non-ASCII Data

When you export multibyte or Eastern European data (such as the names of items and business areas in Japanese or Russian characters) from Oracle BI Discoverer EUL Command Line for Java on a platform other than Windows, the exported data is corrupted.

To work around this issue, edit the discwb.sh file that is located in the ORACLE_HOME/discoverer directory before exporting. Change the character set value in the NLS_LANG variable to UTF8.

For example, if the original setting of the variable is:

NLS_LANG="GERMAN_GERMANY.WE8ISO8859P1"

Change the setting to:

NLS_LANG="GERMAN_GERMANY.UTF8"

30.7 Issues Specific to Oracle BI Discoverer Administrator

This section describes issues that are specific to Oracle BI Discoverer Administrator. It includes the following topic:

- Section 30.7.1, "Issue with Installation of Video Stores Tutorial"

30.7.1 Issue with Installation of Video Stores Tutorial

Before installing the video stores tutorial in Oracle Database 10g Enterprise Edition Release 2 (version 10.2.0.1 and higher), you must manually create the VIDEO5 user. If you attempt to install the video stores tutorial in Oracle Database 10g Enterprise Edition Release 2, then the installation will fail if the VIDEO5 user does not already exist. To work around this issue:

1. Create the VIDEO5 user manually by completing these steps:

1. Access Oracle Database 10g with SQL*Plus, Enterprise Manager, or any SQL command line tool.

2. Create the VIDEO5 user.

3. Grant CONNECT and RESOURCE privileges to the VIDEO5 user.

For more information about creating users and granting privileges, see the Oracle Database SQL Reference or your DBA

2. Connect to Discoverer Administrator as the EUL owner and install the tutorial. You must enter the VIDEO5 user password during installation.
For information about installing the video stores tutorial, see the Oracle Fusion Middleware Administrator's Guide for Oracle Business Intelligence Discoverer.

30.8 Documentation Errata

This section describes the issues in Oracle Discoverer documentation and it contains the following topics:

- Section 30.8.1, "Additional information for associating Oracle BI Discoverer installation with Oracle Identity Management"

- Section 30.8.2, "Missing steps in the procedure to configure Oracle Access Manager for Oracle BI Discoverer"

30.8.1 Additional information for associating Oracle BI Discoverer installation with Oracle Identity Management

The following information is missing in Section 13.8 "Using Discoverer with Oracle Identity Management Infrastructure" in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer.

- If you plan to use Oracle Single Sign-On (OSSO) 10g as a single sign-on solution for Oracle BI Discoverer 11g, you need to associate Oracle Identity Manager 11g with Oracle Single Sign-On (OSSO)10g before associating it with Oracle BI Discoverer 11g.

- If you plan to use Oracle Access Manager 11g for single sign-on, skip Oracle Identity Manager 11g association during the Oracle BI Discoverer configuration.

30.8.2 Missing steps in the procedure to configure Oracle Access Manager for Oracle BI Discoverer

Section 13.8.2.1 "Single Sign-On using Oracle Access Manager 11g" in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer lists a step to edit the osso.conf file. The osso.conf file is a binary file and it cannot be edited directly. The following additional steps are required to modify the osso.conf file for Oracle BI Discoverer:

1. Copy the file mod_osso.conf from the $MW_HOME/instance_name/config/OHS/ohs1/backup/disabled directory to the $MW_HOME/instance_name/config/OHS/ohs1/moduleconf directory.

2. Create a folder named 'osso' under the location $MW_HOME/instance_name/config/OHS/ohs1/ and copy the osso.conf file generated after registration.

3. Edit the mod_osso.conf file from the location $MW_HOME/instance_name/config/OHS/ohs1/moduleconf and add the following lines:

LoadModule osso_module "${ORACLE_HOME}/ohs/modules/mod_osso.so"

<IfModule osso_module>

OssoIpCheck off
OssoIdleTimeout off
OssoHttpOnly off
OssoSecureCookies off
OssoConfigFile MW_Home1/asinst_1/config/OHS/ohs1/osso/osso.conf

<Location /discoverer/plus>
require valid-user
AuthType Osso
</Location>

<Location /discoverer/viewer>
require valid-user
AuthType Osso
</Location>

<Location /discoverer/app>
require valid-user
AuthType Osso
</Location>

</IfModule>

4. Save the mod_osso.conf file.

5. Restart Oracle HTTP Server by running the following opmnctl commands located at ORACLE_INSTANCE\bin directory:

opmnctl stopall
opmnctl startall

31 Oracle Forms

This chapter describes issues associated with Oracle Forms. It includes the following topics:

- Section 31.1, "General Issues and Workarounds"

- Section 31.2, "Configuration Issues and Workarounds"

- Section 31.3, "Documentation Errata"

31.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 31.1.1, "Backwards Compatibility with Earlier Releases"

- Section 31.1.2, "Oracle Forms Builder Help Menu Displays Incorrect Operating System"

31.1.1 Backwards Compatibility with Earlier Releases

Included per bug xxxxxxx.

For information about upgrading from Forms 6i, see the "Upgrading to Oracle Forms Services 11g" chapter in Oracle Fusion Middleware Forms Services Deployment Guide. For information about changed or obsolete features, see the Oracle Forms Upgrading Oracle Forms 6i to Oracle Forms 11g Guide.

For upgrading from Oracle Forms 10g and prior releases, you can use the Upgrade Assistant. For more information, see the Oracle Fusion Middleware Upgrade Planning Guide and Oracle Fusion Middleware Upgrade Guide for Oracle Portal, Forms, Reports, and Discoverer.

Additional information about backwards compatibility is included in My Oracle Support Note 113987.1 at: http://myoraclesupport.oracle.com

Regardless from which version of Oracle Forms you are upgrading, you will need to recompile your applications and restart Oracle Forms.

Included as per bug 8205313, relnote bug 8296697

When using Forms Builder with JAWS, the shortcut keys Ctrl+Insert to create items are not working.

As a workaround, use the menu-mnemonics. Use Alt+e to open the Edit menu, then r to choose Create to create items.

Included as per bug 8362393

When Forms and Reports are configured in different instances, set the correct ORACLE_HOME and ORACLE_INSTANCE values at the shell and invoke the Forms Builder from the shell rather than from the Windows shortcut menu, otherwise invoking the Reports Builder from within the Forms Builder fails.

Included per bug 3219595

Included per bug 8453101

Before restarting the Oracle WebLogic managed server, all the JVM Controller processes (dejvm) started by that server must be stopped. Otherwise, WLS_FORMS will not restart after a shutdown.

Included per bug 8466820

When two Oracle instances with Forms Services are configured, using a single ORACLE_HOME on a Windows machine, then the FORMS_ORACLE_INSTANCE registry entry of the second ORACLE_INSTANCE takes precedence. It is recommended that the Forms Builder component is configured in the second ORACLE_INSTANCE.

Included as per bug 8978516

Oracle Forms from the first installation does not run by default on a Windows machine with more than one version of Forms. This is because when Fusion Middleware is installed on Windows, the new $ORACLE_HOME/bin is added to the beginning of the system variable PATH. Subsequent installations result in addition of $ORACLE_HOME/bin to the beginning of the system variable PATH. To run the prior installed versions, as a workaround, edit the system variable PATH. Move the $ORACLE_HOME/bin that you want to use to the front of the variable PATH.

31.1.2 Oracle Forms Builder Help Menu Displays Incorrect Operating System

When you run Oracle Forms Builder on Microsoft Windows x64 (64-Bit) systems, the operating system is displayed as Microsoft Windows (32-Bit) when you select the About Forms Builder option from the Help menu.

Workaround

Ignore the message as this does not affect the functionality.

31.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 31.2.1, "Non-Internet Explorer Browser Proxy Settings when Using One-Button-Run"

- Section 31.2.2, "WebUtil Client Files Allow Configuration of Destination Directory"

- Section 31.2.3, "webutil.properties Files Renamed for Different Libraries"

- Section 31.2.4, "Forms does not Work with JDK 1.6.0_12 on Client with WinRunner"

- Section 31.2.5, "JavaScript Communication Does not Work in IE for Framed HTML File"

- Section 31.2.6, "JavaScript Events Calling Forms Applications in a Safari 5 Browser Do not Work"

31.2.1 Non-Internet Explorer Browser Proxy Settings when Using One-Button-Run

If you encounter a FORBIDDEN error when using One-Button-Run with any of the supported browsers other than Internet Explorer, verify if 127.0.0.1 (localhost) is in the proxy settings for your browser. If 127.0.0.1 is not in the exceptions list, then add it. This ensures that the browser will bypass the proxy server.

31.2.2 WebUtil Client Files Allow Configuration of Destination Directory

WebUtil downloads install.syslib libraries into the bin directory of the JRE or JVM on Windows and into the lib directory of JRE on Linux. This location can be specified in the parameter install.syslib.location.client.<OS> = <Path on client machine> (where <Path on client machine> represents the path to the location where libraries used on the client by WebUtil are stored and is either absolute or relative to client user home) in webutil.cfg.

31.2.3 webutil.properties Files Renamed for Different Libraries

When install.syslib libraries are downloaded, WebUtil creates the webutil.properties file which is located in the client user home. Different webutil.properties files are maintained on client side to allow different servers to download and manage their libraries on client. The files are named webutil.<HOST>.<CONFIG>.properties on the client, where HOST is the server computer name and CONFIG is the name of configuration section in formsweb.cfg.

31.2.4 Forms does not Work with JDK 1.6.0_12 on Client with WinRunner

Forms does not run when using JDK 1.6.0_12 and later versions on a client that also has WinRunner installed.

As a workaround, rename the two environment variables _JAVA_OPTIONS and JAVA_TOOLS_OPTIONS. For example, rename them to test_JAVA_OPTIONS and test_JAVA_TOOLS_OPTIONS. This will disable WinRunner but allows Forms to run.

31.2.5 JavaScript Communication Does not Work in IE for Framed HTML File

JavaScript communication does not work in framed HTML file that is opened in Internet Explorer 7, or in Internet Explorer 8 with file:// protocol.

As a workaround, use the IP address instead of the machine name in the URL for the frame. For example in testform.htm, change:

<frame noresize="noresize"
src="http://testform.us.oracle.com:8888/forms/java/js2frm1.html" name="fr2"
frameborder="0">
<frame noresize="noresize"
src="http://testform.us.oracle.com:8888/forms/frmservlet?play=&record=forms&
form=js2frm1&userid=scott/tiger@adt10220" name="fr1" frameborder="0">

to

<frame noresize="noresize"
src="http://<IP address>:8888/forms/java/js2frm1.html" name="fr2"
frameborder="0">
<frame noresize="noresize"
src="http://<IP address>:8888/forms/frmservlet?play=&record=forms&form=js2fr
m1&userid=scott/tiger@adt10220" name="fr1" frameborder="0">

31.2.6 JavaScript Events Calling Forms Applications in a Safari 5 Browser Do not Work

When using JavaScript integration with a Forms application in a Safari 5 browser on Windows, the communication from Forms to JavaScript running in the browser works; however, the calls to the applet from JavaScript do not work.

As a workaround, perform the following:

1. Ensure you are using base.htm.

2. In base.htm, delete the <NOSCRIPT></NOSCRIPT> tags that are wrapping the <APPLET> tag.

31.3 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 31.3.1, "Passing userid in Secure Mode"

- Section 31.3.2, "JDAPI Programming Example"

31.3.1 Passing userid in Secure Mode

The following information on passing userid in secure mode must be added to Oracle Forms Builder online help.

Passing userid as an argument when using the Forms compiler (frmcmp or frmcmp_batch) may lead to security risks. In addition to the interactive dialog mode already available, the compiler can now accept the connect string via standard input. To pass the userid in a secure mode, perform the following:

1. Set the environment variable FORMS_STDIN_PASSWORD to 1.

2. Run the compiler without any connect string. Enter the connect string after the compiler has started.

3. Run the compiler using redirection to pass the password to the compiler. (This is especially useful in compiling several Forms in a script.) For example:

#!/bin/sh
echo "Enter userid"
read -s myuserid
for i in 'ls *.fmb'
do
echo Compiling Form $i ....
frmcmp_batch.sh batch=yes module=$i module_type=form compile_all=yes <<<
"$myuserid"
done

Note that this script is a sample that tries to protect the password, but on some platforms and configurations it may still lead to security risks.

31.3.2 JDAPI Programming Example

The JDAPI Programming Example in the Forms Developer Online Help must be updated to the following code:

import java.io.File;
import java.io.PrintWriter;
import java.io.FileWriter;
import java.text.MessageFormat;

import oracle.forms.jdapi.*;

/**
* Dumps passed forms JdapiObjects to an output stream as text.
*
* Set command line options for more output, else only the
* basic form tree structure will be dumped.
*
* See printUsage for command line options.
*/
public class FormDumper
{
/**
* Need this to parse the command line options
*
* The string represents valid command options as detailed in the
* Getopt class
*/

boolean m_dumpAllProps = false;
boolean m_dumpBoolProps = false;
boolean m_dumpNumProps = false;
boolean m_dumpTextProps = false;
boolean m_dumpPropNames = false;
String m_dumpPath = null;
/**
* Output stream, default to STDOUT */
private PrintWriter m_out = new PrintWriter(System.out, true);

/**
* Use this to indent children
*/
private String m_indentation = "";

/**
* Constructor
*/
public FormDumper()
{

}

/**
* Special constructor that does not take command line arguments.
*
* @param out The output writer where to send dump information.
*/
public FormDumper(PrintWriter out)
{
m_out = out;
m_dumpAllProps = true;
m_dumpBoolProps = true;
m_dumpNumProps = true;
m_dumpTextProps = true;
m_dumpPropNames = true;
}

/**
* Set the dump path.
*
* @param path The file where the dumper must send the information
*/
public void setDumpPath(String path)
{
m_dumpPath = path;
}

/**
* Indirect output
*/
public void println(String s)
{
m_out.println(s);
}

/**
* Dump a form to the output stream
*/
public void dumpForm(String filename)
throws Exception
{
FormModule fmb = FormModule.open(filename);
System.out.println("Dumping module " + fmb.getName());

if (m_dumpPath != null)
{
// use this form's FILE name to name the dump file
String thisFormName = new File(filename).getName();
thisFormName = thisFormName.substring(0, (thisFormName.length()-4));
StringBuffer dmpFilename = new StringBuffer();
dmpFilename.append(m_dumpPath);

if (!dmpFilename.toString().endsWith("/"))
{
dmpFilename.append("/");
}
dmpFilename.append(thisFormName);

m_out = new PrintWriter(new FileWriter(dmpFilename.toString()), true);
}

// Call the actual 'dump' method
dump(fmb);

// Dump the coordinate system used by the module
m_indentation = " ";
dump(new Coordinate(fmb));
m_indentation = "";
println("Dumped " + fmb.getName());

// Close the module
fmb.destroy();
}

/**
* Recursively dump a forms JdapiObject and its children to the output stream
*/
protected void dump(JdapiObject jo)
{
String className = jo.getClassName();

// print out a context line for the JdapiObject
// If it is a coordinate system, it does not have a name

if(className.equals("Coordinate"))
{
println(m_indentation + "Coordinate System ");
}
else
{
println(m_indentation + className + " " + jo.getName());
}

// Property classes need special treatment
if(className.equals("PropertyClass"))
{
dumpPropertyClass((PropertyClass)jo);
}
else // Generically dump the required property types only
{
if (m_dumpTextProps)
{
dumpTextProps(jo);
}
if (m_dumpBoolProps)
{
dumpBoolProps(jo);
}

if (m_dumpNumProps)
{
dumpNumProps(jo);
}
// Additionally, dump any Item list elements
if(className.equals("Item"))
{
dumpListElements((Item)jo);
}
}

// use Form's metadata to get a list of all the child JdapiObjects this
JdapiObject can have
JdapiMetaObject meta = JdapiMetadata.getJdapiMetaObject(jo.getClass());
JdapiIterator props = meta.getChildObjectMetaProperties();
JdapiMetaProperty prop = null;
JdapiIterator iter = null;
JdapiObject child = null;

// loop through every possible kind of child JdapiObject this JdapiObject
//can have
while(props.hasNext())
{
prop = (JdapiMetaProperty)props.next();
// only bother if we can access these JdapiObjects
if(!prop.allowGet())
{
continue;
}

// get the actual values for the current child JdapiObject type,
// e.g. get the Items on a Block
iter = jo.getChildObjectProperty(prop.getPropertyId());

// null is returned if there are no property values
if(iter != null)
{
// loop over every child value
while(iter.hasNext())
{
child = (JdapiObject)iter.next();
// recursively navigate to it
m_indentation += " ";
dump(child);
if(m_indentation.length()>2)
m_indentation = m_indentation.substring(0, m_indentation.length()-2)
;
}
}
}
}
/**
* Dump list elements
*
* The JdapiObject is an item; if it is a list item,
* dump the list elements.
*
* @param item
*/
private void dumpListElements(Item item)
{
if( item.getItemType() == JdapiTypes.ITTY_LS_CTID)
{
if (m_dumpPropNames)
{
println(m_indentation + "dumping list elements");
}
for(int i = 1; i <= item.getListElementCount(); i++)
{
String label = item.getElementLabel(i);
String value = item.getElementValue(i);
println( m_indentation + " " + i + ": '" + label + "' '" + value + "'");
}
}
}
/**
* Dump the property class properties
*/
private void dumpPropertyClass(PropertyClass pc)
{
String propertyVal = null;

// test for every single possible property
// this is a bit hacky :)
for(int propertyId = 1; propertyId < JdapiTypes.MAXIMUM_PTID; ++propertyId)
{
if(!pc.hasProperty(propertyId))
{
continue; // this property is not in the set
}
if(pc.hasDefaultedProperty(propertyId) && !m_dumpAllProps)
{
continue;
}
Class pt = JdapiMetaProperty.getPropertyType(propertyId);
if(pt == Boolean.class)
{
if(m_dumpBoolProps)
{
propertyVal = String.valueOf(pc.getBooleanProperty(propertyId));
}
}
else if(pt == Integer.class)
{
if(m_dumpNumProps)
{
propertyVal = String.valueOf(pc.getIntegerProperty(propertyId));
}
}
else if(pt == String.class)
{
if(m_dumpTextProps)
{
propertyVal = pc.getStringProperty(propertyId);
}
}
if(null != propertyVal)
{
if (m_dumpPropNames)
{
println(m_indentation + " " + JdapiMetaProperty.getPro
pertyName(propertyId) + " " +
propertyVal);
}
else
{
println(m_indentation + propertyVal);
}
propertyVal = null;
}
} // End loop over every property
}
/**
* Dump the source JdapiObject text properties
*/
private void dumpTextProps(JdapiObject jo)
{
JdapiMetaObject meta = JdapiMetadata.getJdapiMetaObject(jo.getClass());
JdapiIterator props = meta.getStringMetaProperties();
// for each text property
while(props.hasNext())
{
JdapiMetaProperty prop = (JdapiMetaProperty) props.next();
int propertyId = prop.getPropertyId();
String propertyVal = null;
try
{
propertyVal = jo.getStringProperty(propertyId);
}
catch(Exception e)
{
println(m_indentation + "Could_not_get_property " +
JdapiMetaProperty.getPropertyName(propertyId));
continue;
}
if ( jo.hasProperty(propertyId)
&& (m_dumpAllProps || !(jo.hasDefaultedProperty(propertyId)) ) )
{
if(m_dumpPropNames)
{
println( m_indentation + " " + JdapiMetaProperty.
getPropertyName(propertyId) + " " +
propertyVal);
}
else
{
println(m_indentation + propertyVal);
}
}
}
}
/**
* Dump the source JdapiObject boolean properties
*/
private void dumpBoolProps(JdapiObject jo)
{
JdapiMetaObject meta = JdapiMetadata.getJdapiMetaObject(jo.getClass());
JdapiIterator props = meta.getBooleanMetaProperties();
// for each boolean property
while(props.hasNext())
{
JdapiMetaProperty prop = (JdapiMetaProperty) props.next();
int propertyId = prop.getPropertyId();
boolean propertyVal = false;
try
{
propertyVal = jo.getBooleanProperty(propertyId);
}
catch(Exception e)
{
println(m_indentation + "Could_not_get_property " +
JdapiMetaProperty.getPropertyName(propertyId));
continue;
}
if ( jo.hasProperty(propertyId)
&& (m_dumpAllProps ) )
{
if(m_dumpPropNames)
{
println(m_indentation + " " + JdapiMetaProperty.
getPropertyName(propertyId) + " " +
propertyVal);
}
else
{
println(m_indentation + propertyVal);
}
}
}
}
/**
* Dump the source JdapiObject numeric properties
*/
private void dumpNumProps(JdapiObject jo)
{
JdapiMetaObject meta = JdapiMetadata.getJdapiMetaObject(jo.getClass());
JdapiIterator props = meta.getIntegerMetaProperties();
// for each numeric property
while(props.hasNext())
{
JdapiMetaProperty prop = (JdapiMetaProperty) props.next();
int propertyId = prop.getPropertyId();
int propertyVal = 0;
try
{
propertyVal = jo.getIntegerProperty(propertyId);
}
catch(Exception e)
{
println(m_indentation + "Could_not_get_property " +
JdapiMetaProperty.getPropertyName(propertyId));
continue;
}
if ( jo.hasProperty(propertyId)
&& (m_dumpAllProps || !(jo.hasDefaultedProperty(propertyId)) ) )
{
if (m_dumpPropNames)
{
println(m_indentation + " " + JdapiMetaProperty.getPropertyName(pr
opertyId) + " " +
propertyVal);
}
else
{
println(m_indentation + propertyVal);
}
}
}
}
/**
* Output usage info to STDOUT
*/
public void printUsage()
{
System.out.println("");
System.out.println("Jdapi Form Dumper Utility");
System.out.println("Valid arguments:");
System.out.println("-a : dump all properties, not just overridden ones");
System.out.println("-b : dump boolean properties");
System.out.println("-n : dump numeric properties");
System.out.println("-t : dump text properties");
System.out.println("-p : dump property names, not just values");
System.out.println("-o : file path to output to");
}
/**
* Main method
*/
public static void main(String[] args)
throws Exception
{
FormDumper dmp = new FormDumper();
for (int i = 0; i < args.length; i++)
{
dmp.dumpForm(args[i]);
}
System.out.println("");
System.out.println("Dumps complete");
System.out.println("");
}
}

32 Oracle Portal

This chapter describes issues associated with Oracle Portal. It includes the following topics:

- Section 32.1, "Before You Begin"

- Section 32.2, "General Issues and Workarounds"

- Section 32.3, "Upgrade Issues and Workarounds"

- Section 32.4, "Interoperability Issues and Workarounds"

- Section 32.5, "User Interface Issue and Workaround"

- Section 32.6, "Export and Import Issues and Workarounds"

- Section 32.7, "Portlet and Provider Issues and Workarounds"

- Section 32.8, "PDK Issue and Workaround"

- Section 32.9, "Globalization Support Issues and Workarounds"

- Section 32.10, "Documentation Errata"

32.1 Before You Begin

In addition to the known problems and workarounds described in this document, Oracle recommends that you read the My Oracle Support note 834615.1 - Oracle Fusion Middleware 11g Portal (11.1.1) Support Status and Alerts. This article contains known issues that were discovered after the release of Oracle Portal 11g Release 1 (11.1.1).

32.2 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 32.2.1, "Editing a Database Link Requires Password"

- Section 32.2.2, "Moving Content When Approval Is Enabled Does Not Require Approval"

- Section 32.2.3, "Firefox and Safari Browsers Do Not Display Tooltips on Oracle Portal Screens"

- Section 32.2.4, "Non-ASCII URLs Cannot be Decoded in Some Scenarios"

- Section 32.2.5, "Adding a Zip File with a Non-ASCII Character Name"

- Section 32.2.6, "Manual Changes to Oracle Portal Default Schema Objects"

- Section 32.2.7, "Oracle HTTP Server or Web Cache Does Not Start Due to Wallet Permissions"

- Section 32.2.8, "Portal Throws Discoverer Provider is Busy Error Message"

- Section 32.2.9, "Error When Creating RCU Portal Schema"

- Section 32.2.10, "Error When Adding Sample RSS Portlets to a Page"

- Section 32.2.11, "Internal Error when Using Portal Search With Oracle Text Enabled to Search for Pages"

- Section 32.2.12, "Cloning Utility Not Supported"

- Section 32.2.13, "Issue After Creating a Oracle Portal Schema"

- Section 32.2.14, "Updating Database Tables"

32.2.1 Editing a Database Link Requires Password

If the database where the portal schema is installed is version 10.2 or later, then users must re-enter the remote user's password when they rename or edit a database link from the Portal Navigator's Database Objects tab. This is applicable only for those database links that are created with the Specific User option.

32.2.2 Moving Content When Approval Is Enabled Does Not Require Approval

Moving content between pages or between regions of the same page does not trigger approvals. For example, when a target page is configured with an approval process and a contributor moves content from a source page to the target page, the moved content does not trigger the approval process on the target page, even when approval is required for all users.

32.2.3 Firefox and Safari Browsers Do Not Display Tooltips on Oracle Portal Screens

Firefox and Safari browsers do not support the display of tooltip text, which is set using the ALT attribute for image descriptions.

As a workaround, you can download and install browser-specific add-ons, such as Popup ALT Attribute for Firefox (see https://addons.mozilla.org/en-US/firefox/addon/1933).

32.2.4 Non-ASCII URLs Cannot be Decoded in Some Scenarios

If the JVM default character encoding is set to ISO8859-1, the Portal repository database character set must match with the JVM default character encoding. If this condition is not satisfied, non-ASCII URLs may become inaccessible.

32.2.5 Adding a Zip File with a Non-ASCII Character Name

If you are adding a zip file to a page under a pagegroup using non-ascii character name, and when you unzip the file, it throws the following exception:

IllegalArgumentException: null and unzip will be failed.

To avoid this exception, you must use ascii character as the zip file name.

32.2.6 Manual Changes to Oracle Portal Default Schema Objects

Any manual changes to Oracle Portal default objects, such as tables, views, packages, or indexes are not supported. Such changes may render Oracle Portal unusable. Note that the internal structure of Portal objects can change between versions.

For more information, see the 403179.1 My Oracle Support note.

32.2.7 Oracle HTTP Server or Web Cache Does Not Start Due to Wallet Permissions

OPMN runs as a service in Windows. By default, it runs as the SYSTEM user for starting Oracle HTTP Server and Oracle Web Cache. When you are using SSL wallets created through Oracle Wallet Manager or orapki utility for Oracle HTTP Server or Oracle Web Cache, you must grant read permissions for the wallet to the SYSTEM user.

32.2.8 Portal Throws Discoverer Provider is Busy Error Message

Portal throws an error message The Discoverer Provider is busy, please try again later. This occurs when you perform the following steps:

1. Click Edit Portlet defaults

2. Click Update for Database section

3. Change selection for User not logged sub-section

4. Click Next to fetch worksheet list

Workaround

To workaround this issue perform the following steps:

1. Add stall timeout to $DOMAIN_HOME/servers/WLS_PORTAL/
stage/portal/portal/configuration/appConfig.xml

For example: <stall>200</stall>

2. Restart WebLogic Server Portal

32.2.9 Error When Creating RCU Portal Schema

If RCU portal schema creation fails with the error message ORA-24246: empty access control list (ACL) not allowed, do the following:

1. Connect to the database as a SYS user.

2. At the SQL prompt, run the following command:

BEGIN
DBMS_NETWORK_ACL_ADMIN.drop_acl (
acl         => '/sys/acls/portal-permissions.xml');
COMMIT;
END;
/

32.2.10 Error When Adding Sample RSS Portlets to a Page

When you try to add the sample Scrolling RSS Portlet or the sample Simple RSS portlet to a Portal page, an error message is displayed.

The error occurs because the RSS used by the sample portlets are no longer available.

Currently, there is no workaround for this problem.

32.2.11 Internal Error when Using Portal Search With Oracle Text Enabled to Search for Pages

If you have Oracle Text enabled, the following internal server error may occur when you are searching for Pages:

Internal error (WWC-00006)
An unexpected error has occurred (WWS-32100)
Unknown Exception (WWC-45131)
User-Defined Exception (WWV-11230)
Unexpected error - ORA-00600: internal error code, arguments:
[qkeIsExprReferenced1], [], [], [], [], [], [], [] (WWC-35000)

If this error occurs, you must download and install the patch ID 7041059 from https://support.oracle.com/

32.2.12 Cloning Utility Not Supported

The colclone.bat utility is not supported on Windows platform. For cloning purposes, use the manual procedure.

32.2.13 Issue After Creating a Oracle Portal Schema

After creating the Oracle Portal schema, you may get the following error:

checkinstall2=Add ACL for network packages if DB is 11.1 or higher...
old   4:     schema varchar2(2000)   := upper('&&1');
new   4:     schema varchar2(2000)   := upper('CLASSIC17_PORTAL');
Package DBMS_NETWORK_ACL_ADMIN exists, assign ACL if not already assigned
Removing dangling principals,if any from the ACL privilege list ...
ERROR: when assigning network ACL
declare
*
ERROR at line 1:
ORA-24246: empty access control list (ACL) not allowed
ORA-06512: at "SYS.DBMS_NETWORK_ACL_ADMIN", line 421
ORA-06512: at line 1
ORA-01403: no data found
ORA-06512: at line 83

To fix this error, you must create a schema with a different prefix, and then run the following command to clean out the dangling ACL:

begin
DBMS_NETWORK_ACL_ADMIN.DELETE_PRIVILEGE('portal-permissions.xml','PREFIX_PORTA
L');
end;

PREFIX_PORTAL is replaced with the schema prefix used in the schema that was dropped.

You must run the Repository Creation Utility to install the new schema.

32.2.14 Updating Database Tables

In Oracle Portal database object, if you insert one row data which has MB character and then update the row, the update will not work. You must manually update the table and view in the database to avoid this issue and update the table and view successfully.

32.3 Upgrade Issues and Workarounds

This section describes the upgrade issues and workarounds. It discusses the following topics:

- Section 32.3.1, "Upgrading Portal 10g SSL Environment to Oracle Portal 11g Release 1 (11.1.1)"

32.3.1 Upgrading Portal 10g SSL Environment to Oracle Portal 11g Release 1 (11.1.1)

When you upgrade SSL environment from Oracle Portal 10g to Oracle Portal 11g Release 1 (11.1.1), you will not able to login to Oracle Portal, when you have SSO and Portal Midtier on the same hostname. Internet Explorer has a problem redirecting back and forth on the same hostname between two different ports under SSL mode. As a workaround, you can use Mozilla Firefox.

32.4 Interoperability Issues and Workarounds

This section describes the interoperability issues and workarounds. It discusses the following topics:

- Section 32.4.1, "Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.3"

- Section 32.4.2, "Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.4"

- Section 32.4.3, "Creating Webproviders in the Oracle Portal 11g Release 1 (11.1.1) Midtier Interoperability with Oracle Portal Repository 10g Release"

32.4.1 Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.3

For this interoperability scenario to work, you must download and install the patch ID 7685124 from https://support.oracle.com/and see note 816929.1 in My Oracle Support.

32.4.2 Interoperability Between Oracle Portal 11g Release 1 (11.1.1) with Secured Enterprise Search (SES) 10.1.8.4

For this interoperability scenario to work, you must download and install the patch ID 7971335 from https://support.oracle.com/

32.4.3 Creating Webproviders in the Oracle Portal 11g Release 1 (11.1.1) Midtier Interoperability with Oracle Portal Repository 10g Release

In Portal 11g 1 (11.1.1), you cannot create webproviders when you are using 11g midtier with 10g portal repository.

32.5 User Interface Issue and Workaround

This section describes issue and workaround related to the Oracle Portal user interface. It includes the following topic:

Cannot Set Privileges Using List View on Pages Inheriting Privileges from Parent or Template

If you use the List View to set access privileges for one or more pages, then privileges will not be set on pages inheriting privileges from a parent page or template. As a workaround, change the privileges for such pages individually, that is, using the Access tab for the subpage.

32.6 Export and Import Issues and Workarounds

This section describes issues and workarounds related to export and import in Oracle Portal. This section includes the following topics:

- Section 32.6.1, "Export and Import Does Not Support Reports Server Components"

- Section 32.6.2, "Saving the Transport Set"

- Section 32.6.3, "Error when importing a page group"

32.6.1 Export and Import Does Not Support Reports Server Components

If you include Reports Server Components within a transport set, then they are deleted on export and import. In addition, do not configure the Oracle Reports item type in any page groups intended for export and import. If you do, then the following error is displayed when you try to configure item types in the imported page group (by clicking the Content Type and Classifications Edit link on the Configure tab for the page group):

Internal error (WWC-00006)
Unexpected error - User-Defined Exception (WWC-35000)
Unexpected error - ORA-01403: no data found (WWC-35000)

32.6.2 Saving the Transport Set

After you complete the transport set transfer, click Display Manifest to display the transport set manifest. Ensure that you save the transport set before performing the precheck of the transferred data. This step takes the manifest changes.

32.6.3 Error when importing a page group

Importing a page group may fail with the following error message:

[Error:  (WWU-80338)] context = Schema Validation user =
ORCLADMIN There were some inconsistencies found and hence import process is aborted.Check the debug log for further details.Fix those inconsistencies, by running schema validation in cleanup mode to proceed

This problem might occur after deleting a page group containing shared portlets. You must run SVU in cleanup mode to ensure a smooth export or import process.

32.7 Portlet and Provider Issues and Workarounds

This section describes issues and workarounds related to OmniPortlet, Web Clipping, Simple Parameter Form, Page portlet, and WSRP providers. This section includes the following topics:

- Section 32.7.1, "Issue When Accessing Page Portlet Using Federated Portal Adapter"

- Section 32.7.2, "Error in JPS Portlet After Redeployment"

- Section 32.7.3, "SSL Support for Oracle Portal Integration Solutions (Microsoft Exchange)"

32.7.1 Issue When Accessing Page Portlet Using Federated Portal Adapter

The Federated Portal Adapter enables you to display remote portal pages in your portal. However, if both portal instances do not share the same Oracle Single Sign-On server, then you cannot display a remote portal page as a page portlet, even if the remote page is public. A message is displayed instead of the page portlet, as shown in the following example:

Portlet 257,75057 responded with content-type text/plain when the client was requesting content-type text/html

As a workaround, configure both portal instances to use the same Oracle Single Sign-On server.

32.7.2 Error in JPS Portlet After Redeployment

When you redeploy your portlets to the portlet container, all existing sessions between the producer and all of its consumers are lost. If a consumer tries to reuse an existing producer session, then it may receive an error message the first time it tries to contact the producer after redeployment, as shown in the following example:

Error: Could not get markup. The cookie or session is invalid or there is a runtime exception.

To reestablish the producer's session, refresh the portal page. You will not see this error message if you are reaccessing the portlet from a new browser session because it automatically establishes a new producer session.

32.7.3 SSL Support for Oracle Portal Integration Solutions (Microsoft Exchange)

SSL support is not available for Oracle Portal Integration Solutions (Microsoft Exchange). This is a known limitation.

32.8 PDK Issue and Workaround

Oracle Portal Developer Kit (PDK) version 10.1.2 is included with the Portal and Wireless installation. Release notes for the PDK-Java and PDK-PL/SQL can be found at the following middle-tier ORACLE_HOME locations:

- PDK-Java: ORACLE_HOME/portal/pdkjava/v2/pdkjava.v2.releasenotes.html

- PDK-PL/SQL: ORACLE_HOME/portal/pdkjava/v2/pdkplsql.release.notes.html

Latest Version of Oracle PDK

New versions of the Oracle PDK are released periodically providing new features, new APIs, and additional documentation. To take advantage of all the latest features, download the latest PDK from the PDK downloads page on the Oracle Technology Network (OTN) at http://www.oracle.com/technology/products/ias/portal/pdk.html.

Release notes for the latest Oracle PDK version are available on Oracle Portal on OTN and also in these PDK download locations:

- pdk\plsql\pdkplsql.release.notes.html

- pdk\jpdk\v2\pdkjava.v2.release.notes.html

32.9 Globalization Support Issues and Workarounds

This section describes issues and workarounds related to Globalization Support in Oracle Portal. It includes the following topics:

- Section 32.9.1, "Text Entry Always Right to Left in BiDi Languages"

- Section 32.9.2, "Non-ASCII Character Limitations in Oracle Portal"

- Section 32.9.3, "Multibyte Characters in Log Files"

32.9.1 Text Entry Always Right to Left in BiDi Languages

The direction of all text areas and fields is right to left (RTL). However, you may want some text areas to work left to right (LTR). Internet Explorer users can change this by pressing the left hand side Ctrl and Shift keys.

32.9.2 Non-ASCII Character Limitations in Oracle Portal

When you copy and paste an item URL containing non-ASCII characters from one browser Location or Address field into another, you may not be able to access the item if your login credentials have not been authenticated through OracleAS Single Sign-On.

As a workaround, log in to the portal before you access the item and copy the item URL.

32.9.3 Multibyte Characters in Log Files

In some scenarios, multibyte characters in log files may get corrupted.

For example, when the WLS_PORTAL managed server is started from the Oracle WebLogic Server Administration Console, multibyte characters, such as username, password, and is starting, may get corrupted.

Workarounds:

- Change -Dfile.encoding=iso-8859-1 to -Dfile.encoding=utf8 in the WLS_PORTAL start-up parameter through the Oracle WebLogic Server Administration Console.

- Change -Dfile.encoding=iso-8859-1 to -Dfile.encoding=utf8 in the setDomainEnv.cmd file (Located at MW_HOME\user_projects\domains\DomainName\bin).

For more information, see note 403179.1.

32.10 Documentation Errata

This section lists errors in the Oracle Portal 11g Release 1 documentation on OTN.

32.10.1 Limit for Parameters Per Portal Page

Section 22.3 "Adding a Parameter to a Page or Portal Template" of the Oracle® Fusion Middleware User's Guide for Oracle Portal describes the procedure to add parameters to a Portal page or template.

That section does not mention the maximum number of parameters that you can add. Note that you can add a maximum of 2000 parameters to a page.

If you add more than 2000 parameters, when the request is processed, the following error message is logged:

ERROR: Repository Gateway error: Request Processing Error: Too many arguments passed in. Got <n> parameters. Upper limit is 2000

32.10.2 Incorrect Database Keystore Location

Section 7.3.2.1.7 "Configuring and Registering Web Providers, Provider Groups, and WSRP Producers Exposed Over SSL" of the Oracle Fusion Middleware Administrator's Guide for Oracle Portal describes the steps for importing the producer SSL certificate into the database keystore.

The location of the database keystore mentioned in this section is incorrect. Note the following corrections:

1. Configuring and Registering Web Providers or Provider Groups Exposed Over SSL

- In step 1, the first bullet refers to the following directory:
ORACLE_HOME/jdk/jre/lib/security/

This path is incorrect. The following is the correct path:

$ORACLE_HOME/javavm/lib/security/

- In step 1, the third bullet refers to the following directory:
$ORACLE_HOME/jdk/bin/keytool -import -alias <aliasName> -file <root_certificate_file_name> -trustcacerts -v -keystore $ORACLE_HOME/jdk/jre/lib/security/cacerts

This path is incorrect. The following is the correct path:

$ORACLE_HOME/jdk/bin/keytool -import -alias <aliasName> -file <root_certificate_file_name> -trustcacerts -v -keystore $ORACLE_HOME/javavm/lib/security/cacert

2. Configuring and Registering WSRP Producers Exposed Over SSL

- Step 4a refers to the following directory:
ORACLE_HOME/jdk/jre/lib/security/

This path is incorrect. The following is the correct path:

$ORACLE_HOME/javavm/lib/security/

- Step 4c refers to the following directory:
$ORACLE_HOME/jdk/bin/keytool -import -alias <aliasName> -file <root_certificate_file_name> -trustcacerts -v -keystore $ORACLE_HOME/jdk/jre/lib/security/cacerts

This path is incorrect. The following is the correct path:

$ORACLE_HOME/jdk/bin/keytool -import -alias <aliasName> -file <root_certificate_file_name> -trustcacerts -v -keystore $ORACLE_HOME/javavm/lib/security/cacert

33 Oracle Reports

This chapter describes issues associated with Oracle Reports. It includes the following topics:

- Section 33.1, "General Issues and Workarounds"

33.1 General Issues and Workarounds

This section describes general issue and workarounds. It includes the following topic:

- Section 33.1.1, "Mapping Users and Roles to Reports Application"

- Section 33.1.2, "Configuration Fails While Starting WLS_Reports Server"

- Section 33.1.3, "Oracle Reports Builder Fails to Open the Data Model from Object Navigator"

33.1.1 Mapping Users and Roles to Reports Application

In Oracle Fusion Middleware 11g Release 1 (11.1.1.3.0) installations, roles and users are not added to the Reports application, by default. To run a report using JPS security, you must add roles and users to the Reports application.

For more information, see:

- "Managing Application Roles" in the Oracle Fusion Middleware Security Guide

- "Managing Users and Security Policies" in the Oracle Fusion Middleware Publishing Reports to the Web with Oracle Reports Services manual

33.1.2 Configuration Fails While Starting WLS_Reports Server

While starting managed weblogic server, WLS_REPORTS, configuration fails showing the following errors:

The input line is too long.
The syntax of the command is incorrect.

This occurs when user creates MW_HOME, ORACLE_HOME and domain directory with long names. Consequently the value for environment variable like JAVA_OPTIONS and CLASSPATH become very long, and the actual command for starting the WLS_REPORTS Managed Server exceeds the windows command maximum limit of 8191 characters.

To work around this issue, use short names for ORACLE_HOME, MW_HOME and domain directory on windows.

33.1.3 Oracle Reports Builder Fails to Open the Data Model from Object Navigator

On Microsoft Windows x64 (64-Bit) systems, Oracle Reports builder fails to open the Data Model view when you double-click the data model icon from the Object Navigator.

Workaround

From the File menu, select New, then select Report, and then select the Build a new report manually option to open the Data Model view.

Part X

Oracle WebCenter Content

Part X contains the following chapters:

- Chapter 34, "Oracle WebCenter Application Adapters"

- Chapter 35, "Oracle WebCenter Content Installation and Configuration"

- Chapter 36, "Oracle WebCenter Content: Imaging"

- Chapter 37, "Oracle Information Rights Management"

- Chapter 38, "Oracle WebCenter Content"

- Chapter 39, "Oracle WebCenter Content: Records"

34 Oracle WebCenter Application Adapters

This chapter describes issues associated with Oracle WebCenter application adapters. It includes the following topic:

- Section 34.1, "Configuration Issues and Workarounds"

34.1 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topic:

- Section 34.1.1, "Credential User Must Be Administrator for Successful AXF Call Using Microsoft LDAP"

34.1.1 Credential User Must Be Administrator for Successful AXF Call Using Microsoft LDAP

When implementing an AXF Solution using MS LDAP as a user repository, the credential user must be the administrator belonging to the Administrators group within the Builtin CN in MS LDAP. The AXF uses this credential user when making certain calls (for example, when retrieving a task list from SOA). In addition, you must configure the Group Base DN (in WLS Console, Provider Specific) to import CN=Builtin.

35 Oracle WebCenter Content Installation and Configuration

This chapter describes installation and configuration issues associated with Oracle WebCenter Content. It includes the following topics:

- Section 35.1, "Rebranding of Oracle Enterprise Content Management Suite to Oracle WebCenter Content"

- Section 35.2, "Documentation Errata"

For more information about Oracle WebCenter Content installation and configuration, see the Oracle WebCenter Content Installation Guide or the Oracle WebCenter Content Quick Installation Guide.

35.1 Rebranding of Oracle Enterprise Content Management Suite to Oracle WebCenter Content

Oracle Enterprise Content Management Suite has been changed to Oracle WebCenter Content in the Oracle Fusion Middleware 11g (11.1.1.6.0) release. Oracle WebCenter Content is part of the Oracle WebCenter product stack, to provide the most complete, open, and unified enterprise content management platform.

The software and documentation for most of the Oracle WebCenter Content products have been rebranded accordingly. Table 35-0 shows the new and previous names.

Table 35-1 Oracle WebCenter Content Names Rebranded from Oracle Enterprise Content Management Suite

New Name

New Short Name

Previous Name

Previous Short Name

Oracle WebCenter Content

None

Oracle Enterprise Content Management Suite

Oracle ECM

Oracle WebCenter Content

WebCenter Content

Oracle Universal Content Management

Oracle UCM

Oracle WebCenter Content Server

Content Server

Oracle Content Server

Content Server

Oracle WebCenter Content: Inbound Refinery

Inbound Refinery

Oracle Inbound Refinery

Oracle IBR

Oracle WebCenter Content: Imaging

Oracle WebCenter Imaging

Imaging

Oracle Imaging and Process Management

Oracle I/PM

Oracle WebCenter Content: Records

Records

Oracle Universal Records Management

Oracle URM

Oracle WebCenter Content: Desktop

Desktop

Oracle UCM Desktop Integration Suite

Oracle DIS

The following names remain unchanged:

- Oracle Information Rights Management (Oracle IRM)

- Oracle UCM Site Studio, or Oracle Site Studio (Site Studio)

- Oracle Universal Records Management Adapters

- Oracle Forms Recognition

- Oracle Document Capture

- Oracle Distributed Document Capture

35.2 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 35.2.1, "Location of Deinstaller"

- Section 35.2.2, "Managed Server Name for Oracle Information Rights Management"

35.2.1 Location of Deinstaller

The "Deinstalling Oracle WebCenter Content" section of the Oracle WebCenter Content Quick Installation Guide has a different location for the deinstaller than the Oracle WebCenter Content Installation Guide, which provides the correct location. The Quick Installation Guide should have the following instructions to start the deinstaller.

Start the Oracle Fusion Middleware 11g WebCenter Content Installer with the -deinstall option from the bin subdirectory of the oui directory in your WebCenter Content Oracle home:

- UNIX command: WC_CONTENT_ORACLE_HOME/oui/bin/runInstaller -deinstall

- Windows command: WC_CONTENT_ORACLE_HOME\oui\bin\setup.exe -deinstall

35.2.2 Managed Server Name for Oracle Information Rights Management

The "Starting Managed Servers" section of the Oracle WebCenter Content Quick Installation Guide has an error in this example of a Managed Server name for Oracle Information Rights Management:

IRM_server1 (Oracle I/PM)

The correct example follows:

IRM_server1 (Oracle IRM)

36 Oracle WebCenter Content: Imaging

This chapter describes issues associated with Oracle WebCenter Content: Imaging. It includes the following topics:

- Section 36.1, "General Issues"

- Section 36.2, "Browser Compatibility Issues"

- Section 36.3, "Accessibility Issues"

36.1 General Issues

This section describes general issues. It includes the following topics:

- Section 36.1.1, "Imaging Session Time Out When Using OSSO Requires Browser Refresh"

- Section 36.1.2, "Mixed Translations On Page"

- Section 36.1.3, "Deleting More Than 100 Documents Can Cause Http 404 Errors"

- Section 36.1.4, "Time Zone Based on Time Zone of Imaging Server"

- Section 36.1.5, "Imaging Documents May Be Visible Natively Within WebCenter"

- Section 36.1.6, "Removing Full-Text Search Capabilities From Defined Applications"

- Section 36.1.7, "Application Field Limitations When Using Oracle Text Search"

- Section 36.1.8, "Records Missing from Imaging Searches"

- Section 36.1.9, "WebLogic Server Listening Address and AXF Driver Page URL Must Reference the Same Domain"

- Section 36.1.10, "Must Start NFS Locking Service When Input Agent Used with Linux Shares"

- Section 36.1.11, "DefaultSecurityGroup MBean Allows For Assigning Administrator Rights to Security Group at First Log In"

- Section 36.1.12, "Input Mapping Error When Input Definition File Includes Blank Line"

- Section 36.1.13, "Differing Behavior of Decimals When Ingested Into Number or Decimal Fields"

- Section 36.1.14, "Using Browser Forward, Back, and Refresh Navigation Not Recommended"

- Section 36.1.15, "Document Upload or Update Failure if Content Server English-US Locale Not Enabled"

- Section 36.1.16, "Document Move Failure if Content Server Not Started with English-US Locale"

- Section 36.1.17, "Clearing Java Temporary Files of Cached Files"

- Section 36.1.18, "Solution Editor Enabled Only On Imaging Systems Using an Oracle Database"

36.1.1 Imaging Session Time Out When Using OSSO Requires Browser Refresh

When using Oracle Single Sign On and an Imaging session expires, WebLogic Server will return an internal server error. Refreshing the page returns to the Imaging log in page for reauthentication to start a new session.

36.1.2 Mixed Translations On Page

Oracle products support 10 standard languages for administrative tasks and 27 standard languages for user tasks. This means that in instances when a selected language is supported for user tasks and an administrative task is performed, multiple languages may be displayed in the user interface.

36.1.3 Deleting More Than 100 Documents Can Cause Http 404 Errors

There is a known issue with Microsoft Internet Explorer if attempting to delete more than 100 documents using a search results table. Doing so can cause Internet Explorer to return a 404 Page Not Found error or potentially lock. This is due to Internet Explorer limiting URL strings to a maximum of 2083 characters. If it is necessary to delete over 100 documents using a search results table, Mozilla Firefox supports URLs up to 65,000 characters.

36.1.4 Time Zone Based on Time Zone of Imaging Server

All time information is now based on the time zone of the Imaging server. This means that any date metadata generated by the Imaging system, such as document creation date, modify date, or other audit events, is governed by the time zone of the Imaging server, and not the user time zone. This can cause date data to be displayed differently to what may be expected on some documents because the time zone may cross midnight.

For example, if the Imaging server is in the Greenwich Mean Time (GMT) time zone and a document is created in the GMT+6 time zone on January 10th at 2:00 AM local time, the creation date that will be displayed in the user interface will be January 9th at 8:00 PM. This can have implications when searching for content based on creation and modification dates of documents.

36.1.5 Imaging Documents May Be Visible Natively Within WebCenter

If an Imaging document is viewed through WebCenter, then the document is cached in WebCenter. This means that if a document is viewed in WebCenter prior to being annotated, the non-annotated document is viewable until such time as the WebCenter cache is refreshed. Redacting a document after it has been cached in WebCenter does not cause the original document to be purged from the WebCenter cache, and so redacted content may be compromised. To help protect redacted content when Imaging is integrated with WebCenter, use the Viewer on the Upload page to redact documents prior to uploading to Imaging.

36.1.6 Removing Full-Text Search Capabilities From Defined Applications

Removing full-text search capabilities from a defined application can cause an error in any defined search against that application if the Document Content condition is not also removed from the search. When modifying an existing application to remove full-text indexing capabilities, ensure that you also remove all Document Content conditions from any defined searches against that application.

36.1.7 Application Field Limitations When Using Oracle Text Search

When Imaging is configured to use OracleTextSearch and an application is defined to do full-text indexing, a maximum limit of 20 SDATA fields for the Content Server repository is imposed on Imaging. SDATA fields are defined as optimized fields by the Oracle Text Search component and are typically non-text, non-memo fields, although other criteria can exist to define text fields as optimized SDATA fields.

When defining an application, Imaging queries the repository DOCMETA table for the number of available SDATA fields and does not allow the creation of any non-text fields within the application beyond the available number. However, additional components installed on the Content Server repository, such as Folders or Discussions, may reduce the total number of available SDATA fields. Because other configurations may consume SDATA outside of the DOCMETA table, you may be able to add fields to an application but get an error when trying to rebuild the search index in Content Server. If this occurs, you must redefine the application using a different Content Server connection with available SDATA fields. If no additional Content Server connection is defined, you can install and configure an additional Content Server and create a new connection to it in Imaging. Alternately, you can redefine the application using the original Content Server connection but with fewer non-text fields until you are able to successfully rebuild the search index.

36.1.8 Records Missing from Imaging Searches

Care should be taken when integrating Imaging with Oracle WebCenter Content: Records. If a document is uploaded into an Imaging application that has been configured to use a Records-only Retention Category and the user who uploaded the document does not have rights on the Content Server repository to see records, they will not be able to see any of the uploaded documents in an Imaging search. Rights to retention categories are determined in Records. If integrating Imaging and Records, ensure that all users needing rights to view records have the correct security, that Retention Categories are set correctly in all Imaging applications, and that users understand what can happen if the Records-only Retention Categories are used.

36.1.9 WebLogic Server Listening Address and AXF Driver Page URL Must Reference the Same Domain

If leveraging AXF functionality with Imaging, the Listen Address base domain configured in the WebLogic Server console must match how the domain is specified in the URL used to access AXF. Otherwise content may not load properly and users may not have access to AXF. To configure the Listen address in AXF, do the following:

1. Log in to the WebLogic Server administration console.

2. Under the Environment section of the ecm_domain, select Servers. The Summary of Servers page is displayed with the Configuration tab active.

3. Click imaging_server<number>. The Setting for imaging_server<number> page is displayed for the selected Imaging server with the Configuration and General tabs active.

4. Set the Listen Address to the preferred URL. The Listen Address specified should be the base domain without the protocol.

Note:

The Listen Address base domain and the URL base domain used to access AXF must be identical. If the fully qualified domain name is used for the Listen Address setting, then it must also be used for the access URL, even when inside the domain. For example, if the base domain server_name.domain.com is used in the Listen Address configuration setting, the access URL would be http://server_name.domain.com:<port>/.

36.1.10 Must Start NFS Locking Service When Input Agent Used with Linux Shares

When Input Agent is being used with Linux and NFS shares, the NFS locking service must be started in addition to the other NFS services. If the NFS locking service is not running, Input Agent fails to acquire file locks and displays an error message stating that no locks are available. If this happens, Input Agent cannot function until the NFS locking service is started.

36.1.11 DefaultSecurityGroup MBean Allows For Assigning Administrator Rights to Security Group at First Log In

The functionality of the DefaultSecurityGroup MBean has been augmented. In addition to being the default security group to use for document security when creating an application, this setting can also be used during security initialization to assign full administrative permissions to a specified group. If a value is specified in the DefaultSecurityGroup MBean prior to Imaging security being initialized, then when the first user logs in, the specified group is given full administrative permissions as well as the user logging in.

36.1.12 Input Mapping Error When Input Definition File Includes Blank Line

Note that when mapping an input definition file, the input field mapping page may display an error if it encounters a line with no data in the definition file. Should this occur, map the fields using a line in the definition file that contains data. You can move to a different line in the definition file using the Show Previous Line and Show Next Line icons in the Sample Data column of the input field mapping page.

36.1.13 Differing Behavior of Decimals When Ingested Into Number or Decimal Fields

When ingesting a decimal representation of a whole number into a number field, the decimal is stripped. For example, "1.0" is ingested as "1." When ingesting a decimal that is not whole, the ingestor does not round the value and an error occurs. For example, "1.1" is not ingested into a number field and causes an error.

When ingesting a decimal value into a decimal field, the decimal value must not exceed the precision specified in the application, even if the represented value is the same. For example, if the application specifies a scale of 2, then "123.45" is ingested correctly, where "123.450" would cause an error. This is because "123.450" exceeds the number of decimal places allowed by the application. This behavior is consistent with the conversion routines available in Java.

36.1.14 Using Browser Forward, Back, and Refresh Navigation Not Recommended

Using browser navigation such as Forward, Back, and Refresh does not provide navigation within a document, a document's panels, or between document tabs open in the Viewer. Instead, browser controls navigate outside of the Imaging Viewer. When viewing a document, it is recommended that all navigation within the Viewer be done using the navigation controls in the Viewer toolbar.

36.1.15 Document Upload or Update Failure if Content Server English-US Locale Not Enabled

The Content Server locale English-US must be enabled on the Content Server. Imaging documents will fail to upload or update if the English-US locale in the Content Server is disabled. It does not need to be set as the active locale, but it must be enabled.

36.1.16 Document Move Failure if Content Server Not Started with English-US Locale

The Content Server must be initially started with the active locale set to English-US or moving Imaging documents from one application to another fails. Once started, the active locale can be changed and documents can be successfully moved as necessary.

36.1.17 Clearing Java Temporary Files of Cached Files

When viewing files in advanced mode, some files are cached on the local client computer. If storage space is a concern on the client computer, manually delete any cached files in the client temp directory.

36.1.18 Solution Editor Enabled Only On Imaging Systems Using an Oracle Database

The Solution Editor is enabled in the Tools menu of the Navigator Pane provided that Imaging is using an Oracle database. If Imaging is using a database other than Oracle, access to the Solution Editor is not available.

36.2 Browser Compatibility Issues

This section describes browser compatibility issues. It includes the following topics:

- Section 36.2.1, "IE: Non-ASCII Characters Not Supported in Internet Explorer for ExecuteSearch"

- Section 36.2.2, "Firefox: Version and Download Dialog Boxes Appear Behind Viewer in Advanced Mode"

- Section 36.2.3, "Internet Explorer 9: Problem With Link to Install Java SE Runtime Environment Necessary for Viewer"

36.2.1 IE: Non-ASCII Characters Not Supported in Internet Explorer for ExecuteSearch

The Search URL Tool (ExecuteSearch) does not work in Microsoft Internet Explorer if non-ascii characters are used in the search name. If it is necessary for your search name to have non-ascii characters, you must use Mozilla Firefox version 3.5 or higher and set the following parameters:

- prefs.converted-to-utf8=true

- network.standard-url.escape-utf8=true

- network.standard-url.encode-utf8=true

- network.standard-url.encode-query-utf8=true

36.2.2 Firefox: Version and Download Dialog Boxes Appear Behind Viewer in Advanced Mode

There is a problem with how Firefox 3.6, 5.0 and higher handles layer order of page items in the advanced mode of the Viewer. This causes the main page region where documents are displayed to hide the Version and Download dialog boxes when a document is viewed using Firefox. To work around this issue, expand the Properties, History, or Sticky Notes panel into the main page region enough to allow the obscured items to be displayed prior to accessing dialog boxes. This is not an issue when using Microsoft Internet Explorer or Firefox 3.5.x and a workaround would be to use either of these browsers to view documents when using the advanced Viewer mode.

36.2.3 Internet Explorer 9: Problem With Link to Install Java SE Runtime Environment Necessary for Viewer

The Viewer requires a Java SE Runtime Environment (JRE) plug-in to be installed to view documents in advanced mode. If a JRE is not installed, the Viewer will prompt you to install the plug-in the first time it is used in advanced mode. If using Internet Explorer 9, the link to install the JRE plug-in fails. If using Internet Explorer 9, you must obtain and install the JRE plug-in manually to use the Viewer in advanced mode.

36.3 Accessibility Issues

This section describes accessibility issues. It includes the following topics:

- Section 36.3.1, "Button Activation Behavior Different Depending on Viewer Mode"

- Section 36.3.2, "Limitations of Sticky Note Contents"

- Section 36.3.3, "Skip to Content Link Added for Keyboard Navigation"

- Section 36.3.4, "Firefox: Skip to Applet Link Added for Keyboard Navigation in Advanced Viewer Mode"

- Section 36.3.5, "Internet Explorer 7: Focus Issue on Upload Document and Preferences Pages"

- Section 36.3.6, "Name of File Selected For Import Not Displayed in Screen Reader Mode"

- Section 36.3.7, "Issues Selecting From Calendar Using Keyboard"

- Section 36.3.8, "Focus Issue in Create Searches Wizard Using Keyboard"

- Section 36.3.9, "Annotations Not Recognized By JAWS"

- Section 36.3.10, "Date Selected From Calendar Lost Using Keyboard"

- Section 36.3.11, "Some Annotation Buttons Incorrectly Read by JAWS"

- Section 36.3.12, "Internet Explorer: Long Panels Not Visible In Screen Reader"

36.3.1 Button Activation Behavior Different Depending on Viewer Mode

The keyboard command to activate a button that has focus is different between basic and advanced Viewer modes. The enter key is used to activate a focused button when using the basic Viewer mode. The space key is used to activate a focused button when using the advanced Viewer mode.

36.3.2 Limitations of Sticky Note Contents

The contents of sticky notes are not downloaded or printed with the document, nor are they viewable through the REST Viewer. The contents of a sticky note can be printed, with limitations, by expanding the sticky note in the Sticky Notes Panel and printing the web page.

36.3.3 Skip to Content Link Added for Keyboard Navigation

The first link encountered on a page when using keyboard navigation in the Imaging user interface is a Skip to Content link at the top of the page. Selecting this link and pressing Enter takes the focus to the first item in the content region of the page. For example, if on the home page, the first content item is the help links. If a search has been executed and the results are displayed in the content region, then the Skip to Content link takes you to the first search tab.

36.3.4 Firefox: Skip to Applet Link Added for Keyboard Navigation in Advanced Viewer Mode

When viewing a document in the advanced Viewer mode, keyboard focus starts in the Viewer toolbar. However, in Firefox, if focus moves out of the toolbar, it will not return when cycling through the elements using the keyboard. To work around this, a Skip to Applet link is at the top of the page. To return keyboard focus to the Viewer toolbar, tab to the Skip to Applet link and press Enter.

36.3.5 Internet Explorer 7: Focus Issue on Upload Document and Preferences Pages

When using Internet Explorer 7, the keyboard appears not to focus on any command buttons on the Upload Document page (Open Viewer, Create, Reset, Close) or Preferences page (Apply, Revert, Close). Focus is achieved, however there is no indication which button is active. This issue does not occur in Internet Explorer 8.

36.3.6 Name of File Selected For Import Not Displayed in Screen Reader Mode

When in screen reader mode and selecting a file to import, the file is loaded and the Next button becomes available, but the name of the file to be imported is not displayed.

36.3.7 Issues Selecting From Calendar Using Keyboard

In Internet Explorer 7, when selecting dates from a calendar using the keyboard, you cannot select a day. This is not an issue in Firefox, Safari and later versions of Internet Explorer. In addition, the following buttons are skipped when tabbing: Previous month, Previous year, Month increase/decrease, and Year increase/decrease. An alternative to selecting the date with the keyboard is to manually enter the date with the number keys.

36.3.8 Focus Issue in Create Searches Wizard Using Keyboard

After completing fields in the Create New Search Wizard, the keyboard focus changes to the browser URL and you must tab through the banner and navigation before you can edit the current page.

36.3.9 Annotations Not Recognized By JAWS

When viewing a document with annotations while running JAWS, you can tab to an annotation, but no description is read by JAWS.

36.3.10 Date Selected From Calendar Lost Using Keyboard

When using the keyboard to select a date from a calendar control, the selected date is not retained. The workaround is to enter the date into the date field using the number keys on the keyboard.

36.3.11 Some Annotation Buttons Incorrectly Read by JAWS

When you first open a document in Advanced Viewer mode using screen reader mode, JAWS incorrectly adds the phrase Insert F1 Help Text after each button name.

36.3.12 Internet Explorer: Long Panels Not Visible In Screen Reader

When using Microsoft Internet Explorer and I use a screen reader is enabled on the user preferences page, some panels in the Navigation pane may not display, although the text of the panel title is still read. This is caused when the panel name is too long. Depending on the user interface language, this could happen to one or multiple panels. If you expand the panel above the hidden panel, the hidden panel is then displayed.

37 Oracle Information Rights Management

This chapter describes issues associated with Oracle IRM Server and Oracle IRM Desktop, together known as 'Oracle IRM'. Unless otherwise stated, the version of Oracle IRM to which these release notes apply is 11.1.1.5.0 (incorporating version 11.1.50 of Oracle IRM Desktop).

This chapter includes the following topics:

- Section 37.1, "General Issues and Workarounds"

- Section 37.2, "Configuration Issues and Workarounds"

- Section 37.3, "Documentation Errata"

37.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 37.1.1, "Some Functionality is Disabled or Restricted in Adobe Reader X and Adobe Reader 9"

- Section 37.1.2, "Limitations of Support for Microsoft SharePoint in this Release"

- Section 37.1.3, "Lotus Notes Email Message May be Lost if Context Selection Dialog is Canceled"

- Section 37.1.4, "Save As is Blocked in Microsoft Office 2000/XP for Sealed Files if the Destination is a WebDAV Folder"

- Section 37.1.5, "No Prompt to Use Local Drafts Folder for Sealed Files in SharePoint 2010"

- Section 37.1.6, "Incorrect Initial Display of Oracle IRM Fields in Microsoft Excel Spreadsheets When Used With SharePoint"

- Section 37.1.7, "Behavior of Automatic Save and Automatic Recovery in Microsoft Office Applications and SharePoint"

- Section 37.1.8, "Support for Microsoft Windows 2000 Has Been Removed"

- Section 37.1.9, "Unreadable Error Message Text When Client and Server Locales are Different"

- Section 37.1.10, "Changes Lost if Tab Changed Before Applying the Apply Button"

- Section 37.1.11, "Some File Formats are Not Supported When Using the Microsoft Office 2007 Compatibility Pack with Microsoft Office 2003"

- Section 37.1.12, "Microsoft Word May Hang if a Sealed Email is Open During Manual Rights Check-In"

- Section 37.1.13, "Sealed Emails in Lotus Notes will Sometimes Show a Temporary File Name"

- Section 37.1.14, "No Support for Sealing Files of 2GB or Larger in Size in Oracle IRM Desktop"

- Section 37.1.15, "Inappropriate Authentication Options After Failed Login on Legacy Servers When Setting Up Search"

- Section 37.1.16, "Opening Legacy Sealed Documents in Microsoft Office 2007 May Fail on First Attempt"

- Section 37.1.17, "Log Out Link Inoperative When Using OAM 11g for SSO"

- Section 37.1.18, "Double-byte Languages Cannot be Used for Entering Data with Legacy Servers"

- Section 37.1.19, "Use of SPACE Key Instead of Return Key in Oracle IRM Server"

- Section 37.1.20, "Calendar Controls in Oracle IRM Server Not Accessible Via the Keyboard"

37.1.1 Some Functionality is Disabled or Restricted in Adobe Reader X and Adobe Reader 9

To protect the security of sealed PDF documents, some Adobe Reader functionality is disabled or restricted, as described below.

Protected Mode in Adobe Reader X

Sealed PDF documents cannot be opened if Adobe Reader Protected Mode is active. If Protected Mode has not been disabled in advance, Oracle IRM will offer to disable Protected Mode when you attempt to open a sealed PDF document. You can choose not to accept, in which case Protected Mode will remain active and the sealed PDF document will not be opened.

Use of Toolbar and Other Controls in Adobe Reader X

When using a sealed PDF document in the traditional view, you cannot use the toolbar that is shown within Internet Explorer across the top of the document. Instead, you must switch to the Read-Mode view (using Ctrl+H) and use the buttons on the floating toolbar that appears in that view. You can use the buttons on the Read-Mode floating toolbar to save and print the sealed PDF document (if you have sufficient rights), and to page up and down, or to zoom in and out. You can also, subject to your rights, use the following keyboard shortcuts: Print (Ctrl+P), Save (Ctrl+Shift+S), and Copy (Ctrl+C).

Use of Toolbar and Other Controls in Adobe Reader 9

The following Adobe Reader 9 toolbar buttons do not function:

- Email

- Collaborate

- Create Adobe PDF using Acrobat.com

If you click these buttons, you will see a message that the associated function is unavailable.

All other Adobe Reader 9 controls are available if you have sufficient rights. If you do not have sufficient rights, you will see a message when you attempt to use the control.

A further restriction applies to controls added to the Adobe Reader 9 interface by users when they have a sealed PDF document open: the added control will be inactive until Adobe Reader is closed and reopened.

37.1.2 Limitations of Support for Microsoft SharePoint in this Release

Read-only support for Windows 2000/XP

Sealed documents will always open read-only when opened from Microsoft SharePoint using Microsoft Office 2000 or Microsoft Office XP. From Microsoft Office 2003 onwards, full checkout, edit, and save capabilities are supported. The following is the behavior when using a Microsoft SharePoint web site to browse and open sealed files:

- Microsoft Office 2000 "open" behavior. Clicking any file in Microsoft SharePoint will result in the option to open the file or save it locally. Sealed files will always open read-only unless saved locally.

- Microsoft Office 2000 "edit" behavior. The Edit in Microsoft Word [PowerPoint/Excel] option is not supported for any file (sealed or unsealed).

- Microsoft Office XP "open" behavior. In Microsoft SharePoint 2007, when clicking a sealed file, a download dialog will be presented offering the option to open the file or save it locally. Sealed files will always open read-only unless saved locally. In Microsoft SharePoint 2010, when clicking a sealed file, a download dialog will be presented offering only the option to save the file locally.

- Microsoft Office XP "edit" behavior. In Microsoft SharePoint 2007 and 2010, when choosing Edit in Microsoft Word [PowerPoint/Excel] from the drop- down list for the file, nothing will happen for the following sealed file types: .sppt, .spot, .sxlt, .sdot. All other sealed file formats will open read-only. In Microsoft SharePoint 2010, the Edit Document option is missing for sealed files when using the Datasheet view.

No support for merging

Files opened from Microsoft SharePoint that are locked for editing by another user will not offer the chance to edit a local copy and merge changes later. Oracle IRM Desktop forces the document to open read-only. In Microsoft Office 2010, the Office bar and Backstage view offer an Edit button to switch to edit mode: this is prevented for sealed documents. If you wish to edit the file, you will need to open it for editing from the Web browser: if it is not locked for editing elsewhere, it will open editable.

Microsoft Word 2010 files opened from SharePoint 2010 are read-only

The following Microsoft Word 2010 sealed file types cannot be edited if they are opened from SharePoint 2010: .sdocx, .sdocm, .sdotx, .sdotm. Other sealed Microsoft Word formats (for example, .sdoc) will open as normal. The workaround is to save a copy of the file locally, edit that file, then upload it to SharePoint.

The Check Out button is sometimes missing when opening a sealed Excel file in Protected Mode

If the Microsoft SharePoint Web site is running under Protected Mode in Internet Explorer on Microsoft Vista or Microsoft Windows 7, the Check Out button is not shown. To work around this issue, check out the file first from the Web browser, or open the file directly via Windows Explorer, the Open dialog (available by choosing Open on the File menu), or the most-recently-used (MRU) list.

Using Microsoft Outlook to work with SharePoint offline

Microsoft Office 2007 onwards supports the ability to open a SharePoint folder in Outlook. The SharePoint files can then be worked on while offline, and Outlook will handle the synchronization of any changes. There are known issues with this capability when working with sealed files because Outlook opens them differently to native Microsoft Office files. You may get the message "Outlook cannot track the program used to open this document. Any changes you make to the document will not be saved to the original document" when opening sealed files from this view, and changes made to the sealed file will not automatically upload to the server. A manual send/receive is required.

In Microsoft Office 2010 the sealed files are opened in a mode which is similar to email attachments and require the following protected view settings:

- Uncheck Enable Protected View for Outlook Attachments. This will allow opening of the server file from within the Outlook offline view.

- Uncheck Enable Protected View for file originating from the Internet. This will allow opening of files when they are being edited offline.

Using Windows Explorer to open sealed files from SharePoint

Microsoft Office 2003 on Windows Vista may have problems opening sealed files from the Windows Explorer view of SharePoint. Microsoft Office may display a message similar to the following:

Could not open http://<sp_server>/DavWWWRoot/Docs/MyFolder/file.sdoc

A workaround for this is to access the folder using UNC. For example:

\\<sp_server>\Docs\MyFolder

37.1.3 Lotus Notes Email Message May be Lost if Context Selection Dialog is Canceled

When using the base release of Lotus Notes version 8.5, if the context selection dialog is canceled when sending a sealed email, an error occurs and the message is lost. This does not occur in earlier versions of Lotus Notes. This issue is resolved in Lotus Notes version 8.5.2.

37.1.4 Save As is Blocked in Microsoft Office 2000/XP for Sealed Files if the Destination is a WebDAV Folder

The use of Save As is blocked in Microsoft Office 2000/XP for sealed files if the destination is a WebDAV folder (for example, in UCM). You'll need to save the sealed file to the local file system and upload it manually to the WebDAV folder. However, if you have the 11g UCM Desktop Integration Suite (DIS) installed, you can save sealed files as a new content item in UCM using the DIS menu in Microsoft Office.

The use of Save as Sealed, or of right-click Seal To (from Windows Explorer), will work when the destination is a WebDav folder.

37.1.5 No Prompt to Use Local Drafts Folder for Sealed Files in SharePoint 2010

When you check out unsealed files in SharePoint 2010, you are warned about the checkout and given the choice to use a local drafts folder. When you check out sealed files in SharePoint 2010, the file is checked out without giving the option to use a local drafts folder.

37.1.6 Incorrect Initial Display of Oracle IRM Fields in Microsoft Excel Spreadsheets When Used With SharePoint

This issue refers to Oracle IRM Fields set up using custom properties, as described in the Oracle IRM Desktop help, in the topic Adding Oracle IRM Fields in Microsoft Excel.

The problem occurs when using a combination of Microsoft Windows Vista, Microsoft Internet Explorer 7 or 8, Microsoft Office 2007, and Microsoft SharePoint 2007.

If you open a sealed Microsoft Excel spreadsheet that contains custom properties, when you go to edit the spreadsheet, the custom properties are initially shown with the placeholder #NAME? rather than with their correct values. The custom properties should update with their correct values when you start to edit the spreadsheet.

37.1.7 Behavior of Automatic Save and Automatic Recovery in Microsoft Office Applications and SharePoint

The behavior of automatic save and automatic recovery in Microsoft Office applications is as detailed below.

General

On automatic recovery, users are prompted to save the file to disk immediately in order to persist the recovered changes to a sealed file on disk. This is true for all versions and applications which support auto-recovery.

Word

- All supported versions: automatic save and recovery of sealed files should behave as normal, with the exception that automatic saving is blocked if the filename contains a dot that is not part of the extension (for example, my.filename.sdoc), or if the filename contains any double byte character.

- In Word 2010, automatically saved files recovered from the Recovery pane will not automatically prompt for a Save As: users will need to perform the Save As manually.

PowerPoint

- PowerPoint XP, 2003: automatic save and recovery of sealed files should behave as normal.

- PowerPoint 2007: the automatic saving of sealed files does not take place.

- PowerPoint 2000: automatic save is disabled if sealed files are open, meaning that, if the system crashes, any unsaved changes to any file (sealed or original) will be lost.

- PowerPoint 2010: Automatically saved files do not appear in the Recovery pane, but Microsoft Office 2010 creates auto-saved files that can be opened via the Backstage view, enabling changes to be recovered.

Excel

- All supported versions: automatically saved Excel files (.xar) will be sealed, but the recovery of these files does not happen automatically. To recover "lost" changes, users need to locate the .xar file and rename it to .sxls.

- Excel 2010: Automatically saved files do not appear in the Recovery pane, but Microsoft Office 2010 creates auto-saved files that can be opened via the Backstage view, enabling changes to be recovered.

Microsoft Office draft documents

- Microsoft Office keeps unsaved copies of files for a short period. These are accessible from the Backstage view. Oracle IRM treats these files as auto-saved files, and opening them users will be prompted to perform a Save As operation. To use the restored file in place of the original file, users must copy the saved version over the original.

Because of these restrictions, it is recommended that you do not rely on automatic save and recovery. Instead, save your work frequently when using these applications.

37.1.8 Support for Microsoft Windows 2000 Has Been Removed

Oracle IRM no longer supports the Microsoft Windows 2000 operating system.

37.1.9 Unreadable Error Message Text When Client and Server Locales are Different

Error messages are sent to the client (Oracle IRM Desktop) in the language of the server (Oracle IRM Server). Therefore, if the locale of the server is different to the locale of the client, the error code may be rendered in garbage characters. The error code remains readable, and can be provided to support services as necessary.

37.1.10 Changes Lost if Tab Changed Before Applying the Apply Button

On the Oracle IRM Server Management Console, if you make changes on a tabbed page that has an Apply button, and then move to another tab without using the Apply button, the changes will be lost. You will not be prompted to save the changes that you made.

37.1.11 Some File Formats are Not Supported When Using the Microsoft Office 2007 Compatibility Pack with Microsoft Office 2003

The following Microsoft PowerPoint and Microsoft Excel formats are not supported for sealing when using the Office 2007 Compatibility Pack with Office 2003 and earlier: SPOTM, SPOTX, SPPTM, SPPTX, SXLSX, and SXLTX. For these applications, use other file formats that are supported for sealing.

37.1.12 Microsoft Word May Hang if a Sealed Email is Open During Manual Rights Check-In

In Oracle IRM Desktop, if you attempt to check in your rights while a sealed email is open in Microsoft Word, Microsoft Word may hang. It is recommended that you do not check in your rights while a sealed email is open.

37.1.13 Sealed Emails in Lotus Notes will Sometimes Show a Temporary File Name

In Lotus Notes, if a sealed email has a communication thread with multiple messages or replies, the title bar may show a temporary file name instead of the correct subject name. You may also be prompted to save changes when you have not made any. No harm should arise from these anomalies.

37.1.14 No Support for Sealing Files of 2GB or Larger in Size in Oracle IRM Desktop

Sealing files of size 2GB or larger is not supported in the current release of Oracle IRM Desktop.

37.1.15 Inappropriate Authentication Options After Failed Login on Legacy Servers When Setting Up Search

When setting up indexed search, if you enter incorrect authentication credentials for a legacy server (for example, a 10g Oracle IRM Server) that has been set up for Windows NT authentication, the login retry dialog will show options for Windows basic authentication. You should not use Windows Authentication credentials to log in to legacy servers set up for Windows NT Authentication.

37.1.16 Opening Legacy Sealed Documents in Microsoft Office 2007 May Fail on First Attempt

If users attempt to open a legacy Microsoft Office 2007 document (a document sealed with an older version of Oracle IRM), and Oracle IRM Desktop has not been synchronized with the server against which the document was sealed, the attempt will fail. The sealed document will not be opened, and the user will not be prompted to authenticate against the server to which the document was sealed. A second attempt to open the sealed document should succeed, because the initial attempt should have synchronized Oracle IRM Desktop with the server. Alternatively, the user can synchronize to the server manually (using the Oracle IRM Desktop Options dialog) before opening a legacy sealed document.

37.1.17 Log Out Link Inoperative When Using OAM 11g for SSO

When using OAM (Oracle Access Management) 11g for SSO, the Log Out link on the Oracle IRM Server Management Console does not log the user out.

37.1.18 Double-byte Languages Cannot be Used for Entering Data with Legacy Servers

This release of Oracle IRM Desktop is available in many more languages than previous releases, including some double-byte languages. However, for legacy (10g) servers, as previously, data (user names, etc.) must still be entered using the 7-bit ASCII range of characters.

37.1.19 Use of SPACE Key Instead of Return Key in Oracle IRM Server

In some dialogs in the Oracle IRM Server Management Console, the Return key does not execute buttons. When this occurs, use the SPACE key instead.

37.1.20 Calendar Controls in Oracle IRM Server Not Accessible Via the Keyboard

In the Oracle IRM Server Management Console, the calendar controls are not accessible via the keyboard, and do not appear if the console is in Screen Reader mode. To enter a date using the keyboard, the date should be typed in.

37.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 37.2.1, "New JPS Configuration Properties for User and Group Searches"

- Section 37.2.2, "Mandatory Patch Number 12369706 For Release 11.1.1.5.0 of Oracle IRM Server, To Fix Role Edit Bug"

- Section 37.2.3, "Installing the 64-Bit Version of Oracle IRM Desktop"

- Section 37.2.4, "Reboot Necessary to Obtain New Online Information Button"

- Section 37.2.5, "Deploying Oracle IRM Using Oracle Access Manager Version 10g"

- Section 37.2.6, "LDAP Reassociation Fails if User and Group Names are Identical"

- Section 37.2.7, "Upgrading Oracle IRM Desktop From Versions Earlier Than 5.5"

- Section 37.2.8, "Synchronizing Servers After an Upgrade of Oracle IRM Desktop"

- Section 37.2.9, "Reapplying Lost Settings After an Upgrade of Oracle IRM Desktop"

- Section 37.2.10, "Changing Oracle IRM Account When Authenticated Using Username and Password"

- Section 37.2.11, "Post-Installation Steps Required for Oracle IRM Installation Against Oracle RAC"

- Section 37.2.12, "Enabling the Oracle IRM Installation Help Page to Open in a Non-English Server Locale"

37.2.1 New JPS Configuration Properties for User and Group Searches

The following new JPS configuration properties are supported in PS5. These settings allow the attributes used in the Oracle IRM Server Management Console user and group searches to be defined.

Property: oracle.irm.default.search.user.attributes

Valid values (one or more values are allowed, separated with a comma):

- NAME

- USER_NAME

- FIRST_NAME

- LAST_NAME

- BUSINESS_EMAIL

Default value = "NAME,USER_NAME,FIRST_NAME,LAST_NAME,BUSINESS_EMAIL"

Property: oracle.irm.default.search.group.attributes

Valid value:

- ROLE_NAME

Default value = "ROLE_NAME"

This complements the search filter attributes already supported in jps-config.xml.

Property: oracle.irm.default.search.filter

Valid values (one of the following):

- EQUALS

- BEGINS

- ENDS

- CONTAINS

Default value = "CONTAINS"

Example

An example JPS LDAP service instance entry:

<serviceInstance name="idstore.ldap" provider="idstore.ldap.provider">
<property name="idstore.config.provider" value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS" value="oracle.security.idm.providers.stdldap.JNDIPool"/>
<property name="oracle.irm.default.search.filter" value="BEGINS"/>
<property name="oracle.irm.default.search.user.attributes" value="USER_NAME,NAME,BUSINESS_EMAIL"/>
<property name="oracle.irm.default.search.group.attributes" value="ROLE_NAME"/>
</serviceInstance>

37.2.2 Mandatory Patch Number 12369706 For Release 11.1.1.5.0 of Oracle IRM Server, To Fix Role Edit Bug

The Oracle IRM Server Management Console has an issue that requires a patch to be applied to the installed or upgraded system. When selecting rights for a context, the Properties, Edit, and Remove buttons are always disabled and cannot be used. Selecting one or more rights will not enable the buttons.

Patch 12369706 fixes this issue. This patch can be downloaded from https://support.oracle.com

To install the patch:

1. Log onto https://support.oracle.com

2. Select Patches & Updates.

3. Enter the patch number 12369706 in the patch search.

4. Click Search.

5. Follow the installation instructions provided with the patch.

37.2.3 Installing the 64-Bit Version of Oracle IRM Desktop

For this release, you can choose to install a 64-bit version of the Oracle IRM Desktop client tool. There are no specific instructions for this installation, but if you attempt to install the 64-bit version in a 32-bit environment, you will see messages that this is not possible.

37.2.4 Reboot Necessary to Obtain New Online Information Button

After an upgrade from a previous release of Oracle IRM Desktop, the new Online Information button on the IRM tab in the Properties dialog (obtained by right-clicking Properties on a file in Windows Explorer) is missing until the system is rebooted. This does not affect new installations. A workaround is to restart after upgrading from a previous release of Oracle IRM Desktop, even though the installer does not prompt that a reboot is necessary.

37.2.5 Deploying Oracle IRM Using Oracle Access Manager Version 10g

Deploying Oracle IRM version 11gR1 in an environment using Oracle Access Manager version 10g requires additional configuration to process logout requests properly. For detailed information, see the section "Configuring Global Logout for Oracle Access Manager 10g and 10g WebGates" in the Oracle Fusion Middleware Application Security Guide.

37.2.6 LDAP Reassociation Fails if User and Group Names are Identical

When reassociating an LDAP identity store, the Oracle IRM process for exporting user and group information has an issue if user and group names are identical. If a user and group have identical names, the export process will lose either the user or the group details during the export step. This is because the user or group name is used as the file name, so one file overwrites the other. A post-reassociation workaround is to check user and group right assignments, and to manually reassign any that are missing.

37.2.7 Upgrading Oracle IRM Desktop From Versions Earlier Than 5.5

You can upgrade to this release from Oracle IRM Desktop version 5.5 onwards, by running the installation wizard on the computer that has the older version.

For versions earlier than 5.5, or from any version of SealedMedia Unsealer or Desktop, you can upgrade to this release only by uninstalling the older version and installing this release.

If you are upgrading to this release of Oracle IRM Desktop from a 10g release, you will lose the locally stored rights to use sealed documents (the rights that enable you to continue working when you are offline). When this happens, you will have to obtain new rights by going online and synchronizing with the server. For this reason, do not begin an upgrade unless you have online access to the server.

When upgrading on Windows Vista or Windows 7, you may encounter a file lock and be prompted to retry, ignore, or cancel. You can safely use the ignore option if this happens.

37.2.8 Synchronizing Servers After an Upgrade of Oracle IRM Desktop

If you are upgrading to this release of Oracle IRM Desktop from a 10g release, you will not be synchronized to any servers (Oracle IRM Server). This will show as a blank list on the Servers tab of the Oracle IRM Desktop Options dialog. Servers are automatically added to the list when you open sealed documents for which you have access rights. The easiest way to repopulate your list of servers is to open documents that have been sealed against servers on which you have rights.

37.2.9 Reapplying Lost Settings After an Upgrade of Oracle IRM Desktop

If you are upgrading to this release of Oracle IRM Desktop from a 10g release, your previous settings (as shown on the Oracle IRM Desktop Options dialog) are not applied to the new installation. These include support for email systems, so you should reset these before attempting to work with sealed emails in Microsoft Outlook and Lotus Notes.

37.2.10 Changing Oracle IRM Account When Authenticated Using Username and Password

Oracle IRM Desktop caches user rights in an offline database. In earlier releases, this database was shared by all users of a machine. In this release, there is one offline database per Windows user.

You are strongly advised to use only one Oracle IRM account with each Windows account.

If you authenticate to the server (Oracle IRM Server) with a username and password, you can change the account you use as follows:

1. On the Update Rights tab of the Oracle IRM Desktop Options dialog, check in rights for all servers by clicking Check in.

2. On the Servers tab of the Oracle IRM Desktop Options dialog, select the server to be updated and click Clear Password.

3. Quit from any Oracle IRM-enabled applications, such as Adobe Reader and Microsoft Office.
If you think that Oracle IRM-enabled applications may still be running, restart Microsoft Windows.

4. On the Update Rights tab of the Oracle IRM Desktop Options dialog, synchronize rights for all servers by clicking Synchronize.

Users who are automatically authenticated to the server using Windows authentication cannot change their Oracle IRM account.

Access to the offline database is protected by your Windows credentials. You are no longer required to additionally authenticate to Oracle IRM when working offline.

37.2.11 Post-Installation Steps Required for Oracle IRM Installation Against Oracle RAC

To use Oracle RAC with an Oracle IRM instance, the Oracle IRM data source needs to be altered using the WebLogic Administration Console and the following procedure:

1. From Services, select JDBC, then select DataSources.

2. Select the OracleIRM data source.

3. On the Transaction tab, check Supports Global Transactions, then check Emulate Two-Phase Commit.

4. Click Save.

This will set the global-transactions-protocol for Oracle IRM data-sources for Oracle RAC to EmulateTwoPhaseCommit.

37.2.12 Enabling the Oracle IRM Installation Help Page to Open in a Non-English Server Locale

Use the following procedure to enable the Oracle IRM installation help page to open in a non-English server locale:

1. Unzip the shiphome.

2. Extract all the non-HTM files (7 files in total) from help\en in the ecminstallhelp.jar file located in Disk1\stage\ext\jlib\

3. Put these 7 files into the folder jar for the locale in which you will install ECM.

4. Overwrite ecminstallhelp.jar with the modified version.

37.3 Documentation Errata

There are no known issues at this time.

38 Oracle WebCenter Content

This chapter describes issues associated with Oracle WebCenter Content. It includes the following topics:

- Section 38.1, "General Issues and Workarounds"

- Section 38.2, "Configuration Issues and Workarounds"

- Section 38.3, "Documentation Errata"

38.1 General Issues and Workarounds

This section describes general issues and workarounds. It includes the following topics:

- Section 38.1.1, "Standalone Inbound Refinery Application Executables on Windows 7"

- Section 38.1.2, "Folio Items With Content IDs Containing Multibyte Characters Do Not Display Correctly in Safari"

- Section 38.1.3, "Site Studio Does Not Support Multibyte Characters in Site IDs, Directory Names, and Page Names"

- Section 38.1.4, "Site Studio Publisher Does Not Support Multibyte Characters"

- Section 38.1.5, "Transferring Folder Archives Between Content Servers Fails If Server System Locales Do Not Match"

- Section 38.1.6, "Importing Folder Archives Fails If User Locale Did Not Match Server System Locale During Export"

- Section 38.1.7, "New Folio Page Does Not Work in French and Italian Languages"

- Section 38.1.8, "Oracle WebCenter Content Servers and IPv6 Support"

- Section 38.1.9, "Large File Check-ins May Cause Timeouts"

- Section 38.1.10, "Content Categorizer Trace Log Settings Discontinued"

- Section 38.1.11, "Using WebCenter Content with OAM Server Under Single Sign-on"

- Section 38.1.12, "Extra Lines Displayed Viewing Contribution Folders in Internet Explorer 8"

- Section 38.1.13, "WebDAV Connection Fails After Logout or Restart"

- Section 38.1.14, "LDAP Users Not Receiving Some Administrator Privileges"

- Section 38.1.15, "WinNativeConverter Requires .NET Framework"

- Section 38.1.16, "Detailed Oracle OpenOffice Configuration Settings"

- Section 38.1.17, "Clarification When Setting Classpath to OpenOffice Class Files"

- Section 38.1.18, "Inbound Refinery PDF Conversion May Differ Visually from the Original Content"

- Section 38.1.19, "Mismatching User and Server Locales Prevent Access to Oracle E-Business Suite and PeopleSoft Managed Attachment Pages in WebCenter Content"

- Section 38.1.20, "Connection Issues with Windows to WebDAV"

- Section 38.1.21, "Manual Addition of xdoruntime.ear Library for Records Management"

- Section 38.1.22, "Using HCSP Custom Elements with SSXA"

- Section 38.1.23, "Using Link Wizard with FCKEditor and Chrome"

- Section 38.1.24, "Link Wizard Display Errors When Using Chrome"

- Section 38.1.25, "Backing Up Site Studio Websites Using Chrome"

- Section 38.1.26, "DAM Video Storyboard Errors With Chrome and Safari"

- Section 38.1.27, "Issues Applying Table Styles When Using FireFox and FCK Editor"

- Section 38.1.28, "Content Information Server Is Not Supported for 11g"

- Section 38.1.29, "Window Size Using Trays with FireFox"

- Section 38.1.30, "Content Item Icon for Basket Item Appears Broken in Chrome"

- Section 38.1.31, "VB6 Component Dependency for Kofax 9"

- Section 38.1.32, "Offline Server Status Icon Overlay Not Displayed on Windows Vista and Windows 7"

- Section 38.1.33, "Opening an Older Managed File Revision Not Available in Microsoft Excel"

- Section 38.1.34, "Using URLs With SSP Include and Exclude Filters"

- Section 38.1.35, "Disabling the Folders_g Deprecation Alert"

- Section 38.1.36, "Dragging and Dropping Microsoft Office Documents in Windows Explorer"

- Section 38.1.37, "Accessing ZipRenditionStaticAccess Scheduled Job Information"

- Section 38.1.38, "Using Only Page 1 for Thumbnail Images of Documents"

- Section 38.1.39, "Check-in and Search Forms Pop Up Error Messages when UCM is in EBR Mode"

- Section 38.1.40, "View Publishing Errors Are Observed in Logs When UCM is in EBR Mode"

- Section 38.1.41, "Optimization Errors with External OracleTextSearch"

- Section 38.1.42, "Propagating the cwallet.sso Changes to Deployment Manager"

- Section 38.1.43, "UCM in EBR Mode Fails to Start when Dynamic Converter Component is Enabled"

38.1.1 Standalone Inbound Refinery Application Executables on Windows 7

On Windows 7, the standalone Oracle WebCenter Content: Inbound Refinery application executables are not automatically copied to the bin directory (Domain_Dir/ucm/ibr/bin). If you need to use standalone applications, you can copy and rename them from Idc_Home/bin. For example, to use System Properties, you should copy Idc_Home/bin/Installer.exe to Domain_Dir/ucm/ibr/bin/SystemProperties.exe.

Please note that Inbound Refinery is supported on Windows 7 in development environments only.

38.1.2 Folio Items With Content IDs Containing Multibyte Characters Do Not Display Correctly in Safari

If you use the Safari web browser to download content into a simple folio where one or more content IDs include multibyte characters, then these multibyte content IDs are displayed as '------'. To avoid this, you can either use Internet Explorer or Firefox, or avoid using multibyte characters in content IDs.

38.1.3 Site Studio Does Not Support Multibyte Characters in Site IDs, Directory Names, and Page Names

Oracle Site Studio does not support multibyte characters in any value that will be used in URLs, including site IDs, directory names, and page names.

38.1.4 Site Studio Publisher Does Not Support Multibyte Characters

Oracle Site Studio Publisher does not support multibyte characters.

38.1.5 Transferring Folder Archives Between Content Servers Fails If Server System Locales Do Not Match

If you transfer folder archives between two Oracle Content Server instances using the Archiver utility, then this will fail if these servers have different system locales. No folder will be created on the target server, and no items under that folder will be imported. To avoid this, make sure that the system locales of both content servers match.

38.1.6 Importing Folder Archives Fails If User Locale Did Not Match Server System Locale During Export

If you export a folder archive from the Folder Configuration page in Oracle Content Server and the user locale during export does not match the server system locale, then you will not be able to import that folder archive to the same or a different content server, even if the user and system locales on that server do match. To avoid this, make sure that the user and system locales match during the folder archive export.

38.1.7 New Folio Page Does Not Work in French and Italian Languages

If both the Folios and AppAdapterCore features are enabled, and the user language is set to either French or Italian, the New Folio page does not allow you to select a template and create a new folio.

38.1.8 Oracle WebCenter Content Servers and IPv6 Support

Oracle WebCenter Content servers are supported on IPv4/IPv6 dual-stack hosts, but not on"IPv6-only" hosts. The following topologies are supported:

- Oracle Database on IPv4 hosts

- Oracle WebCenter Content, Oracle WebCenter Content: Records, Oracle WebCenter Content: Inbound Refinery on IPv4/IPv6 dual-stack hosts

- Client (browser) on either IPv4 or IPv6 hosts

38.1.9 Large File Check-ins May Cause Timeouts

Large file check-ins often time out due to the amount of I/O that occurs. Database locks are held while the large file is written and this blocks subsequent check-ins. The IdcServerThreadQueryTimeout configuration setting can be used to lengthen the checkout time. The setting is expressed in seconds; to make the timeout 5 minutes, set IdcServerThreadQueryTimeout=300.

38.1.10 Content Categorizer Trace Log Settings Discontinued

The Content Categorizer-specific execution trace log settings are discontinued. Use the Content Server System Audit Information facility instead. To enable Content Categorizer execution trace, enter contentcategorizer in the Active Sections control of the Tracing Sections Information section of the Admin System Audit Information page.

38.1.11 Using WebCenter Content with OAM Server Under Single Sign-on

When WebCenter Content is used with Oracle Access Manager in a single sign-on environment, an entry to the config.cfg file must have the following lines added:

LogoutServerUrl=http://OAMserveraddress:port/ngam/server/logout?end_url=<$HttpBrowserFullWebRoot$>
RedirectHostsFilter=OAMserveraddress

38.1.12 Extra Lines Displayed Viewing Contribution Folders in Internet Explorer 8

When using Folders in Internet Explorer 8 with default settings, IE8 adds extra lines. This is solved by opening the Compatibility View Settings dialog and unselecting the Display intranet sites in Compatibility View checkbox.

38.1.13 WebDAV Connection Fails After Logout or Restart

In Windows 7 and Windows Vista clients, after logging out and logging back in or after restarting, the Network Place used to access WebCenter Content over WebDAV may no longer work. This is solved by deleting and recreating the connection.

38.1.14 LDAP Users Not Receiving Some Administrator Privileges

WebCenter Content inspects for the group "Administrators" on each user's login to grant WebCenter Content roles. If a user should have access to the WebCenter Content admin server, the WebCenter Content server requires that the user be a member in a group named "Administrators."

38.1.15 WinNativeConverter Requires .NET Framework

The Inbound Refinery component WinNativeConverter requires the vb.Net libraries included in the Microsoft .NET Framework 3.5 Service Pack 1 Redistributable Package for a Windows operating system. This package is available from the Microsoft Download Center at:

http://www.microsoft.com/downloads

Search for "Microsoft .NET Framework 3.5 Service Pack 1" and download and install the dotnetfx35setup.exe on your Windows operating system.

38.1.16 Detailed Oracle OpenOffice Configuration Settings

When configuring Inbound Refinery to convert content using Oracle OpenOffice, additional configuration details can be found in the Oracle 10g release of the PDF Converter Installation and Administration Guide. The complete guide is available for download in either PDF or HTML format from Oracle Technology Network at the following URL:

http://download.oracle.com/docs/cd/E10316_01/ouc.htm

Oracle OpenOffice configuration is detailed in the "OpenOffice" section of "Installing Third-Party Applications" in Chapter 4, "Installing PDF Converter" and can be accessed directly at the following URL:

http://download.oracle.com/docs/cd/E10316_01/refinery/refinery_doc_10/pdfconverter/wwhelp/wwhimpl/common/html/wwhelp.htm?context=install_admin_pdfc_10en&file=page_04_19.htm

Oracle OpenOffice configuration is detailed in the "OpenOffice" section of "Installing Third-Party Applications" in Chapter 4, "Installing PDF Converter" and can be accessed directly at the following URL:

http://download.oracle.com/docs/cd/E10316_01/refinery/refinery_doc_10/pdfconverter/wwhelp/wwhimpl/common/html/wwhelp.htm?context=install_admin_pdfc_10en&file=page_04_19.htm

38.1.17 Clarification When Setting Classpath to OpenOffice Class Files

In the Oracle Digital Asset Manager and Conversion Administration guide, chapter 2 "Managing Conversions" under the section "Configuring Content Server and Refinery Communication," step 2 asks you to enter:

JAVA_CLASSPATH_openoffice_jars=<OfficePath>/Basis/program/classes/unoil.jar:<OfficePath>/URE/java/ridl.jar:<OfficePath>/URE/java/jurt.jar:<OfficePath>/URE/java/juh.jar

Note that the true value for <OfficePath> is likely to include spaces and care must be taken when setting this in a Microsoft Windows environment.

Ensure that the paths are not enclosed in quotes, that slashes (/) are used for path separators and not backslashes (\), and that any space in the path is escaped using a backslash (\). For example, a properly formed classpath in a Windows environment could look like this:

JAVA_CLASSPATH_openoffice_jars=C:/Program\Files/OpenOffice.org\3/Basis/program/classes/unoil.jar:C:/Program\Files/OpenOffice.org\3/URE/java/ridl.jar:C:/Program\ Files/OpenOffice.org\3/URE/java/jurt.jar:C:/Program\ Files/OpenOffice.org\ 3/URE/java/juh.jar

38.1.18 Inbound Refinery PDF Conversion May Differ Visually from the Original Content

Oracle WebCenter Content: Inbound Refinery makes every effort to maintain the visual integrity and formatting of content being converted from its native format to PDF, but Oracle cannot guarantee that the resulting PDF will be an exact visual replication.

38.1.19 Mismatching User and Server Locales Prevent Access to Oracle E-Business Suite and PeopleSoft Managed Attachment Pages in WebCenter Content

For the Oracle E-Business Suite and PeopleSoft managed attachment function in WebCenter Content, users are not granted access to managed attachment pages if their user locale does not match the server locale, which means they cannot view these pages.

38.1.20 Connection Issues with Windows to WebDAV

Supported Windows operating systems may have difficulty connecting to a WebDAV server running over HTTP and using HTTP Basic authentication in some situations. To correct for this, you must edit the registry of the client computer to enable Basic authentication. For detailed information, see Microsoft Knowledge Base Article 841215 at http://support.microsoft.com/kb/841215.

38.1.21 Manual Addition of xdoruntime.ear Library for Records Management

If the Records Management feature is installed in an Oracle WebCenter Content product, xdoruntime.ear library needs to be added manually from the Oracle WebLogic administration console after a domain is created. A reference to the library must be added to the weblogic-application.xml file of the Oracle WebCenter Content EAR file before the managed server is started for the first time.

To add xdoruntime.ear to the WebLogic WebCenter Content domain, follow these steps:

1. After a domain is created, start the Admin Server only. If a managed WebCenter Content server has already been started, then the administrator will have to perform additional steps to add reference to the deployed WebCenter Content server instance later.

2. Open WebLogic console in browser. Click on Deployments in the left pane. Browse the pages to check if there is already a xdoruntime.ear file in the WebLogic administration console. If it is already present, then no more steps need to be performed.

3. If no xdoruntime.ear file is present, click Install on the Deployments display. A file selection dialog opens. Browse the available file system and select xdoruntime.ear in the following path:

/FMW_HOME/Oracle_ECM1/ucm/idc/components/ReportPublisher/lib/xdoruntime.ear

4. Click Next. The option page to select the file as library opens. Select "Install this deployment as a library" and click Next.

5. The Target Selection Screen opens. Select all targets and click Next.

6. The Deployment Name screen opens. In the Security section, select "DD Only: Use only roles and policies that are defined in the deployment descriptors." In the Source accessibility section, select "Copy this application onto every target for me" and click Next.

7. In the Additional Configuration section, select "Yes, Take me to the deployment's configuration screen" and click Finish. The library is now deployed in the environment.

To reference the deployed library from the WebCenter Content Enterprise Application library, follow these steps:

1. Extract the cs.ear file from the following path:

/FMW_HOME/Oracle_ECM1/ucm/idc/components/ServletPlugin/cs.ear

2. In the extracted directory modify META-INF/weblogic-application.xml and add the following line for library reference:

<library-ref>
<library-name>oracle.xdo.runtime</library-name>
</library-ref>

3. Create an archive file named cs.ear from the extracted modified directory and replace the file by the same name in the path it was retrieved from. This change will take for all undeployed WebCenter Content server instances.

4. Start the managed server.

If the managed server has been started at least once after the domain has been created, complete the following:

- Locate the weblogic-application.xml of the Oracle WebCenter Content enterprise application in the deployed WebCenter Content domain at a path similar to the following example:

/FMW_HOME/domain path/servers/UCM_server1/servers/UCM_server1/tmp/_WL_user/Oracle Universal Content Management - Content Server/k6ggd/META-INF/weblogic-application.xml

Modify the META-INF/weblogic-application.xml and add the following line for library reference:

<library-ref>
<library-name>oracle.xdo.runtime</library-name>
</library-ref>

If the UCM_server1 is not available in /FMW_HOME/domain path/servers/, then this step is not needed, as the managed server has not been started, which would have deployed the UCM_server1 at this location.

38.1.22 Using HCSP Custom Elements with SSXA

When a new custom element form is created from scratch (rather than copying an existing form to build an element from), it may have issues lading properly in SSXA.

To use HCSP custom elements within SSXA, you must include the following in the SSXA application's web.xml file:

<mime-mapping>
<extension>hcsp</extension>
<mime-type>text/html</mime-type>
</mime-mapping>

This will allow the files related to the custom element to be executed rather than downloaded.

38.1.23 Using Link Wizard with FCKEditor and Chrome

If the defined editor for Site Studio Contributor is FCK Editor, in some cases the Link Wizard may not launch properly when using Contributor via Chrome 9.0.

This is an issue with the FCK editor. You should either use CK editor for Site Studio, or use one of the recommended browsers for Site Studio (IE, Firefox, Safari) when using Site Studio Contributor.

38.1.24 Link Wizard Display Errors When Using Chrome

When making a link in the Link Wizard while using Chrome, in some cases JavaScript code is displayed rather than the link. The code continues to display even when looking at the web site outside of Contributor. This only happens when using Chrome, and not IE, Firefox, or Safari.

38.1.25 Backing Up Site Studio Websites Using Chrome

When backing up a Site Studio website using Chrome, and manage the archive and download as a ZIP file, the name of the ZIP file might not be as expected.

The name of an archive downloaded as a ZIP file should be in this format: server_DDMMYYYY_HHMMSS.zip. But when using Chrome, the name may be idcplg.zip.

38.1.26 DAM Video Storyboard Errors With Chrome and Safari

The storyboard links on the Rendition Info page for a video item (which should make the video start playing at a specific spot) are not working in Chrome or Safari browsers with Windows Media or QuickTime player plug-ins. Nothing happens when you click on the links. They do work in Chrome and Safari with the flash player, and they work with all plugins in Firefox and IE.

38.1.27 Issues Applying Table Styles When Using FireFox and FCK Editor

When using FCK editor and FireFox with Site Studio Contributor, it is difficult to apply available table styles to a table. This is a functionality missing from FCK editor, and not a limitation of FireFox or Site Studio.

38.1.28 Content Information Server Is Not Supported for 11g

Oracle Content Information Server (CIS) is not supported for WebCenter Content 11g connections in any formats.

38.1.29 Window Size Using Trays with FireFox

When using the Trays view with Site Studio on the Content Server, some screens viewed in FireFox may not correctly fill the browser window.

38.1.30 Content Item Icon for Basket Item Appears Broken in Chrome

When using Chrome with WebCenter Content, the icon for content items in the user's active basket appears broken. This only happens when using the Chrome browser.

38.1.31 VB6 Component Dependency for Kofax 9

Kofax 9 does not install VB6 components required for many of the Export Connectors. Install and register the required VB6 components to use the Export Connectors.

38.1.32 Offline Server Status Icon Overlay Not Displayed on Windows Vista and Windows 7

On Windows XP, Oracle WebCenter Content: Desktop shows a special icon overlay for offline content servers in the Oracle Content Servers tree in Windows Explorer (a red circle with a red diagonal line). This icon overlay is not displayed on Windows Vista and Windows 7. You can see if a server is offline in its details pane.

38.1.33 Opening an Older Managed File Revision Not Available in Microsoft Excel

The Microsoft Office integration provided by Oracle WebCenter Content: Desktop allows you to open an older revision of a managed file in the Office application. However, this feature is not available in Microsoft Excel. Please note this is not a bug in Desktop, but rather a limitation in Excel, which does not allow two files with the same file name to be opened simultaneously.

38.1.34 Using URLs With SSP Include and Exclude Filters

If URLs are used in the Include or Exclude Filters list then any periods ('.') will need to be escaped, otherwise the filter will fail. For example:

http://www\.oracle\.com/information/about\.html

Note the '.' have been escaped with '\'

38.1.35 Disabling the Folders_g Deprecation Alert

There is an alert displayed when Folders_g is enabled that says, "The Folders_g component is in use but is now deprecated. Folders_g is replaced with the FrameworkFolders component, which implements the Folders feature. Folders_g data can be migrated to the new Folders feature."

To prevent this alert from displaying, open the config.cfg file and set the following configuration value:

DisableFoldersgDeprecationMesssage=1

38.1.36 Dragging and Dropping Microsoft Office Documents in Windows Explorer

On a Windows 7 or Vista system, Microsoft Office documents may become corrupted if you drag and drop them from an Oracle WebCenter Content: Desktop content folder in Windows Explorer to a location outside Content Server, particularly documents in native Office 2007/2010 format (.docx, .xlsx, or .pptx extension).

If you want to edit a document, you should use the Check Out or Make Available Offline item on the context menu.

If you have administration privileges, you can disable the DesktopTag component before performing a drag and drop operation, to avoid document corruption.

38.1.37 Accessing ZipRenditionStaticAccess Scheduled Job Information

The ZipRenditionManagement component automatically creates a scheduled job to aid in the creation of static renditions. This job is sometimes created at the wrong time during the setup or configuration process, which causes an error when an administrator accesses the Administration > Scheduled Jobs Administration > Active Scheduled Jobs page. If the administrator deletes the job and restarts Content Server, the job will be recreated, and the Active Scheduled Jobs page will not throw an error.

38.1.38 Using Only Page 1 for Thumbnail Images of Documents

Both Oracle WebCenter Content: Inbound Refinery and Oracle WebCenter Content Server can generate thumbnail images of documents, and there is an option to set which page number of a document will be used for the thumbnail image. The default page number is 1, and this works, but using any other number does not work.

38.1.39 Check-in and Search Forms Pop Up Error Messages when UCM is in EBR Mode

When UCM is run in EBR more, the following errors pop up when opening check-in or search forms.

"Unable to generate data for the view websiteobjecttypelist. Unable to build where clause for for view WebsiteObjectTypeList. The field dKey does not exist in table OptionsList"

"Unable to generate data for the view pachagedconversionslist. Unable to build where clause for for view PachagedConversionsList. The field dKey does not exist in table OptionsList"

"Unable to generate data for the view pdfwtemplatetypelist. Unable to build where clause for for view PdfwTemplateTypeList. The field dKey does not exist in table OptionsList"

"Unable to generate data for the view videorenditionslist. Unable to build where clause for for view VideoRenditionsList. The field dKey does not exist in table OptionsList"

As a result, some dropdowns in the forms are not populated with data.

38.1.40 View Publishing Errors Are Observed in Logs When UCM is in EBR Mode

Once UCM managed server is started, errors of the kind !csSchemaUnableToPublishView can sometimes be seen. These errors happen only when UCM is in EBR mode.

38.1.41 Optimization Errors with External OracleTextSearch

When using OracleTextSearch using an Oracle 11.2.0.2.0 database as an external search provider, optimization errors may appear in the logs. It is an issue with the database, not UCM. This issuse is resolved in the 11.2.0.3.0 database.

38.1.42 Propagating the cwallet.sso Changes to Deployment Manager

The updates to the cwallet.sso file, in some cases, are not propagated from the UCM server to the Deployment Manager. In these cases, you must propagate the change manually.

The Oracle UCM server updates the cwallet.sso file located in

WAS_PROFILES/UCM_SERVER_NAME/config/cells/UCM_CELL_NAME/fmwconfig/

when it starts after completing configuration on the Post Install Configuation Page or after enabling PdfWatermark or BpelIntegration components. In these instances, propagate this change back to the Deployment Manager.

To do this, copy the cwallet.sso file to

WAS_PROFILES/DEPLOYMENT_MANAGER_NAME/config/cells/UCM_CELL_NAME/fmwconfig/

immediately after the start.

38.1.43 UCM in EBR Mode Fails to Start when Dynamic Converter Component is Enabled

When the UCM is in EBR mode, and Dynamic Converter is enabled, UCM managed server will not start due to an error with creating the HtmlConversions object. An ORA-00955 error will be referenced in this exception:

!csDbUnableToPerformAction_create,HtmlConversions!$ORA-00955: name is already used by an existing object

A possible workaround is to disable DynamicConverter component using ComponentWizard.

38.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

- Section 38.2.1, "Minimum JDBC Driver Version Required for Oracle Text Search Component"

- Section 38.2.2, "Manually Disabling 8.3 File Naming for Inbound Refinery on Windows 7"

- Section 38.2.4, "SSXA Required DC Version for Oracle Content Server 10gR3"

- Section 38.2.5, "Content Portlet Suite (SCPS) WebCenter as Producer Targeting Libraries"

- Section 38.2.6, "Logout URL for SSO Logout Integrating with Oracle Access Manager 11g"

- Section 38.2.7, "Using the Custom Truststore with the JPS Connection to ActiveDirectory"

- Section 38.2.8, "Using WebDAV on a Windows 7 Client"

- Section 38.2.9, "Setting the Connection Pool for an External LDAP ID Store on IBM WebSphere Application Servers"

- Section 38.2.10, "File Store Provider Storage Rule "Default Storage" is not the Default"

38.2.1 Minimum JDBC Driver Version Required for Oracle Text Search Component

The Oracle Text Search component that is part of WebCenter Content 11gR1 requires a JDBC driver version of 10.2.0.4 or higher. The component will not work with older JDBC driver versions.

38.2.2 Manually Disabling 8.3 File Naming for Inbound Refinery on Windows 7

When running Oracle WebCenter Content: Inbound Refinery on Windows platforms, you may see this alert:

"The weblayout directory is on a filesystem with 8dot3 semantics. Legacy 16-bit 8dot3 filenames conflict with revision labels and will cause file loss. Disable 8dot3 semantics by running Installer DisableNtfs8dot3 and then restarting Windows."

On Windows 7, running Installer DisableNtfs8dot3 does not resolve this. You must make the configuration change manually in the Windows registry.

To change the Windows registry, go to the following key:

HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Control/FileSystem

Then, set the value of the NtfsDisable8dot3NameCreation key to 1. You must restart Windows for the new setting to take effect.

Please note that Inbound Refinery is supported on Windows 7 in development environments only.

38.2.3 Setting Security Privileges for Modifying Folders

By default, users only need RW privileges to modify folders, where before the default was that RWD or owner was required unless collaboration was enabled.

Users explicitly relying on RWD privileges must set the environment variable to allow for this. WebCenter users and those with no upgrade issues are not affected.

For those who require RWD rather than RW, set the variable as:

FoldersModifyWithRW=false

38.2.4 SSXA Required DC Version for Oracle Content Server 10gR3

To use dynamic conversion of native documents on your Site Studio web sites running off of Oracle Content Server 10gR3, you must install and configure Dynamic Converter build version 8.1.0.736 or greater.

38.2.5 Content Portlet Suite (SCPS) WebCenter as Producer Targeting Libraries

When creating a custom managed server, the following libraries need to be targeted to the newly created managed server (for example, CPS_Portlet). Note that the libraries for 11gR1 PS2 (11.1.1.3) are different from the libraries for 11gR1 PS3 (11.1.1.4) and 11gR1 PS4 (11.1.1.5) installation of WebCenter.

Libraries for 11gR1 PS2 (11.1.1.3) installation of WebCenter:

- oracle-ridc-client-app-lib(10.3.2,10.3.2)

- oracle-ucm-spi-app-lib(10.3.2,10.3.2)

- p13n-app-lib-base(10.3.2,10.3.2)

- vcr-app-lib(10.3.2,10.3.2)

- oracle.webcenter.framework(11.1.1,11.1.1)

- oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

Libraries for 11gR1 PS3 (11.1.1.4) and 11gR1 PS4 (11.1.1.5) installation of WebCenter:

- oracle.ucm.ridc.app-lib(11.1.1,11.1.1)

- p13n-app-lib-base(10.3.2,10.3.2)

- oracle.webcenter.framework(11.1.1,11.1.1)

- oracle.webcenter.spaces.fwk(11.1.1,11.1.1)

- oracle.webcenter.framework.core(11.1.1,11.1.1)

When consuming Oracle Content Portlet Suite 11gR1 PS3 (11.1.1.4) on Oracle WebCenter 11gR1 PS3 (11.1.1.4), users will see the exception "java.lang.IllegalArgumentException:IdcContext.setUser() method not valid, do not use this method."

Contact Oracle support for the options available to resolve this issue.

38.2.6 Logout URL for SSO Logout Integrating with Oracle Access Manager 11g

When integrating WebCenter Content with Oracle Access Manager 11g, add the following to the Logout URL setting for the WebGate:

/oamsso/logout.html

38.2.7 Using the Custom Truststore with the JPS Connection to ActiveDirectory

JpsUserProvider should be up for WebCenter Content to be able to fetch users' roles/groups from the LDAP server. The JPS layer does not automatically pick up the SSL truststore configuration from WLS. Since a custom truststore is being used in the WLS configuration, the problem is that the JPS connection to ActiveDirectory is not using this custom truststore.

Therefore, set the following Java properties when starting UCM_server1:

Djavax.net.ssl.trustStore=<location of custom truststore>
Djavax.net.ssl.trustStorePassword=<truststore password>

If you start the server from the command line using startManagedWeblogic.sh you can set the environment variable EXTRA_JAVA_PROPERTIES before invoking startManagedWeblogic.sh.

If you start the server using the NodeManager, these can be set using the WLS Admin console by setting the Arguments in the Server Start tab for the Configuration of UCM_server1.

38.2.8 Using WebDAV on a Windows 7 Client

If you use WebDAV on a Windows 7 client, consider the following issues:

1. Registry changes are necessary for WebDAV use.

- Windows 7 will not connect to a WebDAV server running over HTTP and using HTTP basic authentication. To fix this, set these registry entries:

- Set HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel to 2.

- Set HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\UseBasicAuth to 2.

- By default, Office 2010 will not open documents over WebDAV using basic authentication over a non-SSL connection.
To get around this problem, you need to create a registry entry, HKEY_CURRENT_USER\Software\Microsoft\Office\14.0\Common\Internet\BasicAuthLevel, and set it to 2.

- The WebDAV implementation used by Windows 7 (Mini-Redirector) does not implement the WebDAV locking protocol correctly (still the case as of WebDAV version 6.1.7601.17514). This means that on a drag and drop using Explorer, you will get an error. The file will likely be checked in correctly, though.
To avoid the error, you can turn off the locking protocol through a registry setting. Set HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\SupportLocking to 0.

2. Drag and drop creates an empty first revision.
The WebDAV implementation used by Windows 7 (Mini-Redirector) creates an empty file for an initial revision on a drag and drop using Explorer. This just means that you will get two revisions for your first drag and drop of a file, and the first revision will be zero bytes.

3. The Network Location shortcut to WebDAV in Windows Explorer stops working.
The typical method for accessing and browsing the WebDAV share for Oracle WebCenter Content Server is through creating a network location in Explorer, as follows:

1. Select Computer in the Explorer navigation tree on the left, and select Add a network location on the right.

2. Enter the WebDAV URL to Content Server (http://..../_dav/cs/idcplg/webdav/).

3. Log in.

After you log in, a shortcut to the Content Server WebDAV URL will be displayed in Explorer under the list of drives for the client computer.

You will initially be able to access the WebDAV share for Content Server through this shortcut, as expected. However, once your session expires (typically after 2 hours of inactivity, as configured), you will not be able to access the WebDAV share through this shortcut again. The reason this occurs seems to be the way the shortcut data is stored and used for reconnecting.

If you delete the shortcut and re-create it the same way, it should work correctly.

4. Deleting a folder may cause a performance issue. The Windows 7 (Mini-Redirector) client will navigate the entire folder tree, deleting each item in the tree recursively. Microsoft's previous WebDAV client sent a single DELETE command to the server and relied on the server to perform the delete folder action. The new behavior may have performance and network traffic repercussions for large folder trees.

5. Deleting a folder shortcut will delete the contents of the entire tree. The base WebDAV protocol does not distinguish between shortcuts to folders and normal folders. That means deleting a folder shortcut will cause all the items contained in the target folder of the shortcut to be deleted. This will not typically happen with other WebDAV clients, like the Microsoft XP Web Folders implementation. The reason for this is the behavior described in item 4 above.

38.2.9 Setting the Connection Pool for an External LDAP ID Store on IBM WebSphere Application Servers

An LDAP server is not automatically installed and configured when you install Oracle WebCenter Content on IBM WebSphere Application Server - Network Deployment (ND) or IBM WebSphere Application Server. Before you can configure WebCenter Content, you must install and configure an external LDAP identity store for your WebCenter Content applications. For information about how to set up external LDAP identity stores, such as Oracle Internet Directory, see the "IBM WebSphere Identity Stores" section of the "Managing Oracle Fusion Middleware Security on IBM WebSphere" chapter of the Oracle Fusion Middleware Third-Party Application Server Guide.

After the LDAP identity store is set up for a cell, you must set the CONNECTION_POOL_CLASS property in the cell's jps-config.xml file to avoid excessive LDAP connections. You need to add the following property to the <serviceInstance> entry in the file:

<property name="CONNECTION_POOL_CLASS" value="oracle.security.idm.providers.stdldap.JNDIPool"/>

To set the connection pool for an external LDAP ID store on IBM WebSphere application servers:

1. Modify your cell's jps-config.xml file with a text editor:

1. Open the WAS_HOME/profiles/profile_name/config/cells/cell_name/fmwconfig/jps-config.xml file.
WAS_HOME is the location where the WebSphere application server is installed, DISK/IBM/WebSphere/Application Server by default, profile_name is the name of the WebSphere Deployment Manager profile for the cell, and cell_name is the name of the cell.

2. Specify the CONNECTION_POOL_CLASS property in the <serviceInstance> entry as follows:

<serviceInstance name="idstore.ldap.0" provider="idstore.ldap.provider">
<property name="subscriber.name" value="dc=us,dc=oracle,dc=com"/>
<property name="CONNECTION_POOL_CLASS" value="oracle.security.idm.providers.stdldap.JNDIPool"/>
<property name="bootstrap.security.principal.key" value="bootstrap_idstore"/>
<property name="idstore.type" value="OID"/>
<property name="ldap.url" value="ldap://example.com:3060"/>
<property name="bootstrap.security.principal.map" value="BOOTSTRAP_JPS"/>
<property name="user.login.attr" value="mail"/>
<property name="username.attr"  value="mail"/>
<extendedProperty>
<name>user.search.bases</name>
<values>
<value>cn=Users,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.search.bases</name>
<values>
<value>cn=Groups,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
</serviceInstance>

2. Synchronize all managed nodes.

3. Restart all the servers.

For more information about installing and configuring Oracle WebCenter Content on WebSphere application servers, see the "Managing Oracle WebCenter Content on IBM WebSphere Application Servers" chapter of the Oracle Fusion Middleware Third-Party Application Server Guide.

38.2.10 File Store Provider Storage Rule "Default Storage" is not the Default

The File Store Provider (FSP) storage rule named "Default Storage" was the default in a previous release and is included in the current release solely for backwards compatibility. The current default storage rule is DispByContentId ("Dispersion by ContentId").

38.3 Documentation Errata

This section describes documentation errata. It includes the following topics:

- Section 38.3.1, "EnableOptimizedLatestReleaseQuerying No Longer Valid in Idoc Script"

- Section 38.3.2, "Kofax Version Certification for WebCenter Content"

- Section 38.3.3, "Content Portlet Suite (CPS) WSRP URLs for WebCenter as Producer"

- Section 38.3.4, "No Support for 8.3 File Naming on Windows"

- Section 38.3.5, "Search-Based Content Folders in Desktop Cannot Be Made Available Offline"

- Section 38.3.6, "Server Connection Registry Entries for Desktop 11gR1"

- Section 38.3.7, "Internet-Style Search Disabled in 11g"

- Section 38.3.8, "Framework Folders Component Not Enabled by Default"

- Section 38.3.9, "Maximum Role Length Incorrect in WebCenter Content Server Help"

38.3.1 EnableOptimizedLatestReleaseQuerying No Longer Valid in Idoc Script

EnableOptimizedLatestReleaseQuerying is no longer a valid Idoc Script variable and should be disregarded.

38.3.2 Kofax Version Certification for WebCenter Content

Kofax versions 8.0 and 9.0 are both certified to work with WebCenter Content 11g.

38.3.3 Content Portlet Suite (CPS) WSRP URLs for WebCenter as Producer

After deploying the CPS EAR file to WebCenter as a producer, the WSDL URL for 11g PS2 (11.1.1.3) is different from the WSDL URL for PS3 (11.1.1.4) and PS4 (11.1.1.5). For more information, see the Deployment Guide for Content Portlet Suite, Section 3.1.4, Step 17.

WSRP URL for PS2 (11.1.1.3) installation of WebCenter:

http://Host_Name:Port/cps/portlets/wsrp1?wsdl

WSRP URL for PS3 (11.1.1.4) and PS4 (11.1.1.5) installations of WebCenter:

http://Host_Name:Port/cps/portlets/wsrp2?WSDL

38.3.4 No Support for 8.3 File Naming on Windows

The 8.3 file naming method used by default on many Windows systems is not supported. This should be disabled as part of the pre-installation procedures for WebCenter Content.

38.3.5 Search-Based Content Folders in Desktop Cannot Be Made Available Offline

The Oracle WebCenter Content User's Guide for Desktop states that content folders can be made available offline, but fails to mention that this does not apply to search-based folders (query folders and retention query folders). The contents of these folders do not actually exist in the folders; they are just grouped there because their metadata matches the search criteria. The actual content items may exist under a different folder location, or they may not even appear in a 'standard' folder at all. For content items in a folder to be made available offline, they must actually reside in the folder.

38.3.6 Server Connection Registry Entries for Desktop 11gR1

The information on the Windows Registry entries that administrators can use to set up Content Server connections for Oracle WebCenter Content: Desktop were inadvertently left out of the 11gR1 documentation. The information in the "Configuring Content Servers" section of the Desktop Integration Suite Installation Guide for 10gR3 also applies to 11gR1:

http://download.oracle.com/docs/cd/E17967_01/Desktop/Pdf/Desktop_Installation_Guide.pdf

38.3.7 Internet-Style Search Disabled in 11g

The documentation notes that Internet-style search is enabled by default. Internet-style search is not enabled by default in 11gR1.

38.3.8 Framework Folders Component Not Enabled by Default

Contrary to what is stated in the software help, the Framework Folders component is not enabled by default in Oracle WebCenter Content Server.

38.3.9 Maximum Role Length Incorrect in WebCenter Content Server Help

Contrary to what is stated in the Oracle WebCenter Content Server help, the maximum length of role names is 255 characters, not 30.

39 Oracle WebCenter Content: Records

This chapter describes issues associated with Oracle WebCenter Content: Records. It includes the following topics:

- Section 39.1, "General Issues and Workarounds"

- Section 39.2, "Configuration Issues and Workarounds"

- Section 39.3, "Documentation Errata"

In addition to the information discussed here, see the chapter in this release note documentation concerning Oracle WebCenter Content. Issues which affect WebCenter Content may also affect Records.

39.1 General Issues and Workarounds

This section describes general issues and workarounds. It contains the following sections:

- Section 39.1.1, "Role Report Output is Dependent on User Generating the Report"

- Section 39.1.2, "Items Returned When Using Screening"

- Section 39.1.3, "Oracle Text Search and Report Configuration Options"

- Section 39.1.4, "Upgrade from 10g Audit Trail Periods Missing"

- Section 39.1.5, "DB2 Databases and FOIA/PA Functionality"

- Section 39.1.6, "Sorting and Listing Retention Category Content"

- Section 39.1.7, "Using Firefox to Configure the Dashboard"

- Section 39.1.8, "Setting Security Group for Retention Items"

39.1.1 Role Report Output is Dependent on User Generating the Report

A role report can be generated by choosing Records then Reports then Role from the Main menu. Note that the output of the report may not show all data for all roles. The output is dependent on the user who is generating the report and the permissions given to that user.

39.1.2 Items Returned When Using Screening

It should be noted that screening is a retention feature that only returns content items with a life cycle or items that are frozen.

39.1.3 Oracle Text Search and Report Configuration Options

When using Oracle Text Search, an incompatibility existed with the options to exclude report templates and reports in search results. These options appear on the Configure Report Settings Page.

It is now possible to exclude reports in search results by selecting the Exclude Reports in Search Results checkbox. However, if the Exclude Report Template in Search Results checkbox is selected, templates are still included in searches. Oracle is aware of this issue and is working to fix it in a future release.

39.1.4 Upgrade from 10g Audit Trail Periods Missing

When upgrading this product from release version 10g to release version 11g, the complete audit trail dates are not available. The audit periods from 2001 to 2010 should be present after upgrading, but only periods between 2001 to 2006 are present. The missing years can be added manually. Oracle is aware of this issue and is working to fix it in a future release.

39.1.5 DB2 Databases and FOIA/PA Functionality

Due to the size of the database used with the Freedom of Information Act/Privacy Act (FOIA/PA) functionality, the FOIA/PA option is not supported for those sites using DB2 for their database.

39.1.6 Sorting and Listing Retention Category Content

When retention categories are sorted then listed, they are listed on a per-source basis. For example, if three sources are used (Source1, Source2, Source3), all items from Source1 are sorted as a separate group, items from Source2 are sorted as a separate group, and items from Source3 are sorted as a separate group. Then items from each source are displayed in a "round robin" style with the first item of Source1, the first item from Source2, and the first item from Source3, followed by the second item of each source.

39.1.7 Using Firefox to Configure the Dashboard

"Drag and drop" functionality to move dashboard panels is not available when using the Firefox browser. Instead, you should remove the panel and re-insert a new panel in the proper location.

39.1.8 Setting Security Group for Retention Items

Items created for use in the Retention Schedule should have the security group set to recordsgroup rather than Public. If set to Public, non-URM users may have access to items in the Retention Schedule when performing standard searches.

39.2 Configuration Issues and Workarounds

This section describes configuration issues and workarounds. It contains the following sections:

- Section 39.2.1, "Import FOIA Archive Error Message"

- Section 39.2.2, "Restart Required: Performance Monitoring and Reports"

- Section 39.2.3, "Audit Trail Sorting Results and Database Fulltext Search"

- Section 39.2.4, "Prefix Size Limitation When Using Offsite Storage"

- Section 39.2.5, "Enabling Email Metadata Component"

- Section 39.2.6, "Relative Web Root Must Be Changed"

- Section 39.2.7, "Configuring 10g Adapters for Version 11g"

- Section 39.2.8, "Configuring RSS Reader for Dashboard"

39.2.1 Import FOIA Archive Error Message

Importing the Freedom of Information Act (FOIA) archive from the Setup Checklist page may display a spurious error message stating Archiver is already running, please try again later.

This error may be safely ignored. It is generated because the click to initiate the archive is registered twice. Ignore the warning, wait fifteen minutes and then see if the alert notification for that task is removed. The import of the archive can also be confirmed by opening the Archiver and verifying that the FOIAPrivacyAct archive is present.

39.2.2 Restart Required: Performance Monitoring and Reports

After performance monitoring is selected and enabled, the Content Server must be restarted in order for monitoring to commence. Note that a restart is also required after configuration of the software in order for all report options to appear on the appropriate menus.

39.2.3 Audit Trail Sorting Results and Database Fulltext Search

When sorting the audit trail using Oracle DB, the output depends on the type of sort being performed.

When sorting with Database Fulltext Search, sorting is case-sensitive, meaning that upper case items will always appear first in a list. When sorting with Oracle Text Search, a case-insensitive search is performed.

39.2.4 Prefix Size Limitation When Using Offsite Storage

If offsite storage functionality is enabled on the system, the total size allowed for the content ID for a physical item is 11 characters. When setting up offsite storage, verify if automatic assignment of IDs is enabled and if so, make sure the content prefix is set to 5 characters or less.

39.2.5 Enabling Email Metadata Component

If the EmailMetadata component is installed for use with WebCenter Content, a configuration variable must be set in order for the user interface to be made available in Records.

Set the ShowEmailMetadataMenu variable to TRUE in the emailmetadata_environment.cfg file in the /components/EmailMetadata directory.

Restart Content Server after setting the variable then refresh or reload the browser. Options become available to map email fields to metadata fields. To use those options, choose Administration then Configure Email Metadata from the Main menu.

39.2.6 Relative Web Root Must Be Changed

When upgrading from the 10g version, the HttpRelativeWebRoot configuration parameter must be changed in the config.cfg file to the following:

HttpRelativeWebRoot=/urm/

It is critical to change the parameter exactly as shown.

39.2.7 Configuring 10g Adapters for Version 11g

A connection address must be changed to enable 10g adapters to work with version 11g.

Previous connection strings were similar to the following example:

http://myhost.mycompany.com:myport/URMinstance/idcplg

The new connection string should be similar to the following example:

http://myhost.mycompany.com:myport/_dav/URMinstance/idcplg

The addition of the _dav string is all that changes.

39.2.8 Configuring RSS Reader for Dashboard

The following configuration variables should be set in the config.cfg file to configure the RSS Reader in the Dashboard.

If the Content Server is used behind a proxy server, the proxy address and port number must be set:

RssProxyServerAutoDetected= content server network's proxy address

You must also configure the proxy port for the content server network:

RssProxyPortAutoDetected=content server network's proxy port

39.3 Documentation Errata

This section describes changes in the documentation. It contains the following sections:

- Section 39.3.1, "Menu Name Changes Not Reflected in Documentation"

- Section 39.3.2, "Physical Content Management Services Not Documented"

- Section 39.3.3, "Additional FTP Option for Offsite Storage"

39.3.1 Menu Name Changes Not Reflected in Documentation

The External Performance Monitoring menu listed in documentation should be changed to Performance Monitoring. This is accessed by choosing Records then Audit then Performance Monitoring from the Top menu.

39.3.2 Physical Content Management Services Not Documented

The following services were omitted from the PCM services documented in the Oracle WebCenter Content Services Reference Guide:

- GET_RELATED_CONTENT: retrieves a page used to show Related Links for the specified content. The following are additional required service parameters:

- dSource: source being used for the search (for example, "Physical").

- dID: the unique identifier of the external item.

- dLinkTypeID: the unique identifier for the related content type link.

- GET_EXTERNAL_ITEM_SEARCH_RESULTS: retrieves a page used to search physical items. The following are additional required service parameters:

- dSource: source being used for the search (for example, "Physical").

- QueryText: the text used for the search.

- ErmSearchTable: the source table name. This should be EXTERNAL_SOURCE for a Physical source.

- SearchEngineName: the search engine to use. Default is DATABASE.

- SearchQueryFormat: the search query format to use. Default is UNIVERSAL.

39.3.3 Additional FTP Option for Offsite Storage

The option to use sftp is now available (in addition to other options) as the FTP protocol when creating Offsite Storage. This was omitted from the documentation.

Part XI

Oracle Data Integrator

Part XI contains the following chapters:

- Chapter 40, "Oracle Data Integrator"

40 Oracle Data Integrator

This chapter describes issues associated with Oracle Data Integrator. It includes the following topics:

- Section 40.1, "Configuration Issues and Workarounds"

- Section 40.2, "Design-Time Environment Issues and Workarounds"

- Section 40.3, "Oracle Data Integrator Console Issues and Workarounds"

- Section 40.4, "Technologies and Knowledge Modules Issues and Workarounds"

- Section 40.5, "Oracle Data Profiling and Oracle Data Quality Issues and Workarounds"

40.1 Configuration Issues and Workarounds

This section describes the following issues and their workarounds:

- Section 40.1.1, "Generated Templates Including a Datasource With an Oracle RAC URL Fail to Deploy"

- Section 40.1.2, "Generated Templates Including Datasources Fail to Deploy"

- Section 40.1.3, "Setting Test Queries on WLS Datasources"

40.1.1 Generated Templates Including a Datasource With an Oracle RAC URL Fail to Deploy

Oracle WebLogic Configuration Wizard does not support Oracle RAC URLs for datasources. When a datasource is included in a Java EE Agent template that has been generated using Oracle Data Integrator Studio, this template fails to deploy, and raises the following exception is raised:

com.oracle.cie.wizard.WizardController - Uncaught Exception
java.lang.NullPointerException
atcom.oracle.cie.domain.jdbc.DatasourceXBeanAspectHelper.decomposeURL

As a workaround, do not include this datasource definition in the generated template and deploy the datasource from Oracle Data Integrator Studio.

40.1.2 Generated Templates Including Datasources Fail to Deploy

As the Oracle WebLogic Configuration Wizard uses specific code for parsing the URL and exposing its parameters in a user friendly format, it only supports a predefined set of JDBC URLs. If a JavaEE Agent template that has been generated using Oracle Data Integrator Studio contains a datasource with a URL or driver not included in this set, the Wizard fails to use this template with the following exception:

com.oracle.cie.wizard.WizardController - Uncaught Exception
java.lang.NullPointerException
atcom.oracle.cie.domain.jdbc.DatasourceXBeanAspectHelper.decomposeURL

As a workaround, do not include this datasource definition in the generated template, and deploy the datasource from Oracle Data Integrator Studio.

40.1.3 Setting Test Queries on WLS Datasources

The Clean Stale Sessions feature of the Agent relies on the stale or dead connections of the connection pool to be automatically cleaned up either through expiration or connection validations tests done by the connection pool implementation.

If the stale connections are not removed out by the connection pool, then the Clean Stale Sessions feature does not work even after the database has been restarted. None of the other requests of the agent will work after the database restart if the agent itself is not restarted.

In a WebLogic Server container, connections are validated every few seconds using a test query. It is recommended to verify and provide the table name used by the database to run the test query: select count(*) from <test_table_name>.

For Master Repositories and Work Repositories, datasources use SNP_LOC_REP and SNP_LOC_REPW as the test tables.

Alternatively, you can use the DUAL table for an Oracle repository.

40.2 Design-Time Environment Issues and Workarounds

This section describes the following issues and their workarounds:

- Section 40.2.1, "For File Datastores, the View Data operation always looks for global context"

- Section 40.2.2, "Quick Edit Editor deletes incorrect Joins when sorted"

- Section 40.2.3, "Quick Edit Editor displays a Source as removed regardless of the Selection made in the Warning Dialog"

- Section 40.2.4, "Inconsistent Behavior when Refreshing Load Plans"

- Section 40.2.5, "User Parameters are not Taken into Account by the Runtime Agents"

- Section 40.2.6, "Incorrect Non-ASCII File Names in Zip Export Files"

- Section 40.2.7, "Non-ASCII Characters Incorrectly Converted to Underscore Characters"

40.2.1 For File Datastores, the View Data operation always looks for global context

Within ODI Studio, when viewing data from within a data store, there must be a global context defined for the datastore.

com.sunopsis.core.SnpsInexistantSchemaException: ODI-17523: There is no connection for this logical schema / context pair: lg1 / GLOBAL.

As a workaround, define a global context for the datastore.

40.2.2 Quick Edit Editor deletes incorrect Joins when sorted

Within ODI Studio Quick Edit, when deleting a join, the incorrect join may be deleted if a join is selected and then the list of joins is sorted.As a workaround sort the join list prior to deleting the join with Quick Edit.

40.2.3 Quick Edit Editor displays a Source as removed regardless of the Selection made in the Warning Dialog

Within ODI Studio Quick Edit, when deleting a source, the source will appear as removed even if "No" is selected from the warning before the deletion.

As a workaround, refresh ODI Studio and open Quick Edit, the source will still be available.

40.2.4 Inconsistent Behavior when Refreshing Load Plans

Within ODI Studio, when refreshing Load Plan to pick latest Scenario reference in the Load Plan, the latest scenario is determined by the Scenario Creation timestamp. During ODI agent execution, the latest scenario is determined by alphabetical ascending order of the Scenario Version string value.

40.2.5 User Parameters are not Taken into Account by the Runtime Agents

The runtime agents do not take into account the user parameter values specified in the userpref.xml file. The default values are always used instead.

There is no generic workaround at this time.

40.2.6 Incorrect Non-ASCII File Names in Zip Export Files

Non-ASCII file names are incorrectly generated in Zip export files. Non-ASCII characters in these file names are replaced with underscores. Setting the Never transform non ASCII characters to underscores user parameter to Yes has no effect. As a workaround, export the files in a folder and compress this folder.

40.2.7 Non-ASCII Characters Incorrectly Converted to Underscore Characters

Non-ASCII characters are handled incorrectly in the following situations, even if the Never transform non ASCII characters to underscores user parameter is set to Yes:

- Non-ASCII characters are replaced with underscores in the Alias field of a column when using the fixed file reverse-engineering wizard.

- Non-ASCII characters from the header line are replaced with underscores in column names when doing a delimited file reverse-engineering.

As a workaround, manually modify the column definitions after the reverse process.

40.3 Oracle Data Integrator Console Issues and Workarounds

This section describes the following issues and their workarounds:

- Section 40.3.1, "Oracle Data Integrator Console Page Task Flow Resets When Another Tab Is Closed."

- Section 40.3.2, "Enterprise Manager Logout Does Not Propagate to Oracle Data Integrator Console"

40.3.1 Oracle Data Integrator Console Page Task Flow Resets When Another Tab Is Closed.

When the tab containing a page is closed in Oracle Data Integrator Console, all the tabs after this one reset their task flows (the navigation actions that were made). The pages in these tabs reset to the original object that was opened.

There is no workaround for this issue at this time.

40.3.2 Enterprise Manager Logout Does Not Propagate to Oracle Data Integrator Console

When Enterprise Manager Fusion Middleware Control (EM) is used in conjunction with Oracle Data Integrator Console with Single Sign-On (SSO) activated, a user logging out from SSO in Enterprise Manager might still be able to access Oracle Data Integrator Console pages from the same browser window by typing a direct URL.

This issue is caused by a cookie that is created by Oracle Data Integrator Console not being invalidated by the Enterprise Manager logout action.

As a workaround:

- Administrators should configure their Enterprise Manager and Oracle Data Integrator Console servers for access fronted by a gateway. The gateway automatically redirects the user that is not logged into SSO to the SSO Login page.

- If you're accessing Oracle Data Integrator Console or Enterprise Manager from a shared or public computer, close the session by logging out. For additional security, close the browser session.

40.4 Technologies and Knowledge Modules Issues and Workarounds

This section describes the following issues and their workarounds:

- Section 40.4.1, "For Microsoft Excel Target Datastores, column names must be in upper case"

- Section 40.4.2, "For File Datastores, reverse-engineering process cannot be canceled"

- Section 40.4.3, "SQL Keywords are not imported when importing a Technology in Duplication Mode"

- Section 40.4.4, "SQL Exception "Unknown Token" appears when using Complex File or XML as Staging Area"

- Section 40.4.5, "Adding Subscribers fails for Consistent Set JKMs when the Model Code Contains Non-ASCII Characters"

- Section 40.4.6, "IKM and LKM SQL Incremental Update (Row by Row) fail with Non-ASCII Characters"

- Section 40.4.7, "IKM SQL Incremental Update (Row by Row) Cannot Target Japanese Tables"

40.4.1 For Microsoft Excel Target Datastores, column names must be in upper case

When using Microsoft Excel as a target, column names must be in upper case.

[Microsoft][ODBC Excel Driver]COUNT field incorrect

As a workaround, rename column names within Microsoft Excel.

40.4.2 For File Datastores, reverse-engineering process cannot be canceled

Within ODI Studio, when reverse engineering new columns to an existing datastore, after reverse new columns are automatically saved when answering "No" to "<datastore> has been modified. Save changes?"

40.4.3 SQL Keywords are not imported when importing a Technology in Duplication Mode

Within ODI Studio, when importing a technology in duplication mode, the SQL Keywords are not imported.As as workaround, manually add the SQL Keywords to the technology properties.

40.4.4 SQL Exception "Unknown Token" appears when using Complex File or XML as Staging Area

When running interfaces and using a XML or Complex File schema as the staging area, the "Unknown Token" error appears. This error is caused by the updated HSQL version (2.0). This new version of HSQL requires that table names containing a dollar sign ($) are surrounded by quotes. Temporary tables (Loading, Integration, and so forth) that are created by the Knowledge Modules do not meet this requirement on Complex Files and HSQL technologies.

As a workaround, edit the Physical Schema definitions to remove the dollar sign ($) from all the Work Tables Prefixes. Existing scenarios must be regenerated with these new settings.

40.4.5 Adding Subscribers fails for Consistent Set JKMs when the Model Code Contains Non-ASCII Characters

When the Model code contains non-ASCII characters, adding subscribers does not work for Consistent Set Journalizing KMs. This applies to all Consistent Set JKMs. The Session completes successfully but no subscriber is added. Note that this issue does not occur when the Model code contains exclusively ascii characters.

There is no generic workaround at this time.

40.4.6 IKM and LKM SQL Incremental Update (Row by Row) fail with Non-ASCII Characters

When the source datastore contains non-ascii characters the interface using the IKM or LKM SQL Incremental Update (Row by Row) fails at the step Insert flow into I$ table with the following error message:

org.apache.bsf.BSFException: exception from Jython:
Traceback (most recent call last):  File "<string>", line 149, in <module>
UnicodeEncodeError: 'ascii' codec can't encode characters in position 6-7:
ordinal not in range(128)

There is no generic workaround at this time.

40.4.7 IKM SQL Incremental Update (Row by Row) Cannot Target Japanese Tables

IKM SQL Incremental Update (Row by Row) fails on task Flag rows for update if the target table name contains Japanese characters. In the generated code, the integration table name appears as "I$_??????" where "?" characters replaces a Japanese character.

As a workaround, replace this IKM with another IKM suitable for the technology. For example, 'IKM Oracle Incremental Update' for Oracle.

40.5 Oracle Data Profiling and Oracle Data Quality Issues and Workarounds

This section describes the following issues and their workarounds:

- Section 40.5.1, "Unable to Connect the Client to a Data Quality Server on UNIX"

- Section 40.5.2, "Menus Are in English When Starting the Client Using a .tss File."

40.5.1 Unable to Connect the Client to a Data Quality Server on UNIX

Included per bug 9812470.

When connecting from the Oracle Data Quality Client to a Data Quality Server installed on a UNIX machine the following error message may appear: "No support for client application "Admin" version 12.0.1".

To solve this issue re-install the metabase definitions using the following steps:

1. On the UNIX server go to the following directory:ODQ_HOME/oracledi/odp/Client/SvrSide

2. Run ./setup

3. At the prompt, enter the Metabase Installation location: ODQ_HOME/oracledq/metabase_server/

4. Enter the metabase admin user and password.

5. When the metabase definitions installation completes, restart the Scheduler service using the following command: ODQ_HOME/oracledq/metabase_server/metabase/bin/scheduler -restart

40.5.2 Menus Are in English When Starting the Client Using a .tss File.

When starting Oracle Data Quality Client by double-clicking on a saved .tss file, the menus appear in English independently of the client machine's locale.

As a workaround, open the client from the shortcut menu, then open the .tss file.

Part XII

Oracle Business Intelligence

Part XII contains the following chapters:

- Chapter 41, "Oracle Business Intelligence"

- Chapter 42, "Oracle Business Intelligence Applications and Data Warehouse Administration Console"

- Chapter 43, "Oracle Real-Time Decisions"

41 Oracle Business Intelligence

This chapter describes issues associated specifically with Oracle Business Intelligence. It includes the following topics:

- Section 41.1, "Patch Requirements"

- Section 41.2, "Oracle Business Intelligence Issues and Workarounds Identified Since the Last Revision"

- Section 41.3, "Oracle Business Intelligence Issues and Workarounds that Apply Only to Release 11.1.1.3"

- Section 41.4, "Oracle Business Intelligence General Issues and Workarounds"

- Section 41.5, "Oracle Business Intelligence Installation Issues and Workarounds"

- Section 41.6, "Oracle Business Intelligence Upgrade Issues and Workarounds"

- Section 41.7, "Oracle Business Intelligence Installation Guidelines for 64-Bit Platforms"

- Section 41.8, "Oracle Business Intelligence Analyses and Dashboards Issues and Workarounds"

- Section 41.9, "Oracle Business Intelligence Mobile Issues and Workarounds"

- Section 41.10, "Oracle BI Publisher Reporting and Publishing Issues and Workarounds"

- Section 41.11, "Oracle Business Intelligence Metadata Repository Development Issues and Workarounds"

- Section 41.12, "Oracle Business Intelligence System Administration Issues and Workarounds"

- Section 41.13, "Oracle Business Intelligence Integration and API Issues and Workarounds"

- Section 41.14, "Oracle Exalytics In-Memory Machine Issues and Workarounds"

- Section 41.15, "Oracle Business Intelligence Localization Issues and Workarounds"

- Section 41.16, "Oracle Business Intelligence Documentation Errata"

Depending on your Oracle Fusion Middleware implementation, some information in other chapters of this document might also be relevant, including:

- Chapter 2, "Installation, Patching, and Configuration"

- Chapter 3, "Upgrade"

- Chapter 4, "Oracle Fusion Middleware Administration"

- Chapter 5, "Oracle Enterprise Manager Fusion Middleware Control"

- Chapter 6, "Oracle Fusion Middleware High Availability and Enterprise Deployment"

41.1 Patch Requirements

This section describes patch requirements for Oracle Business Intelligence. It includes the following topic:

- Section 41.1.1, "Obtaining Patches from My Oracle Support"

41.1.1 Obtaining Patches from My Oracle Support

Periodically, Oracle Business Intelligence patches are released. Some patches are mandatory, other patches are optional.

To see the patches that are available, go to My Oracle Support (formerly OracleMetaLink) using the following URL:

http://support.oracle.com

To obtain a patch:

1. Log in to My Oracle Support.

2. Click the Patches & Updates tab.

3. In the Patch Search section, enter the patch number in the Patch ID or number is field, and enter your platform in the field after the and Platform is field.

4. Click Search.

5. On the Patch Search page, click the patch number in the Patch ID column.
The page content changes and displays detailed information about the patch.

6. Click Download to download the patch.

7. Install the patch by following the instructions in the README file that is included with the patch.

41.2 Oracle Business Intelligence Issues and Workarounds Identified Since the Last Revision

The issues and workarounds related to Oracle Business Intelligence that have been identified since the last revision of the Release Notes include:

- Section 41.4.2, "Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.4.22, "Messages May Be Garbled When Running WebLogic Command Files"
Impacted Releases: 11.1.1.6

- Section 41.4.23, "Rendering Issues Might Occur in Presentation Services When Using Microsoft Internet Explorer 9.x"
Impacted Releases: 11.1.1.6

- Section 41.5.12, "Ignore FAT File System Error Message When Performing an Enterprise Installation"
Impacted Releases: 11.1.1.6

- Section 41.5.13, "Job Manager May Fail to Launch from the Start Menu"
Impacted Releases: 11.1.1.6

- Section 41.5.14, "Job Manager Cannot Launch if the Client Tools Install Path Includes Multi-Byte Characters"
Impacted Releases: 11.1.1.6

- Section 41.5.15, "Error Occurs When RCU is Invoked For a Second Time to Create Only MDS/Platform Schemas on IBM DB/2"
Impacted Releases: 11.1.1.6

- Section 41.8.1.9, "In Selection Steps Search for Members in Hierarchical Columns That Are Non-Text Yields No Results"
Impacted Releases: 11.1.1.6

- Section 41.8.1.10, "Interactions on Right-Click Menus Are Not Translated"
Impacted Releases: 11.1.1.6

- Section 41.8.5.10, "Measure Column Labels May Display Incorrectly When Inserted into Microsoft Excel"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.11, "Stacked Graphs Do Not Display Negative Values"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.12, "Scatter Graphs with Lines Display as Default Scatter Graphs in Excel and PowerPoint"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.13, "Graphs With Section Edges Are Not Supported in Release 11.1.1.6.0"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.14, "Refreshing Table Views in Arabic or German Versions of Excel Result in Incorrect Data Values"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.15, "Inserting a View With a Grand Total Column or Row into Microsoft Office May Cause Issues"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.16, "Time Displayed in Table or Pivot View Title May Be Incorrect after Insertion"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.17, "Graphs May Be Displayed Differently After Insertion into Microsoft Office"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.18, "Legends in Bubble and Scatter Graphs May Display Differently After Insertion into Microsoft Office"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.8.5.19, "Help System Does Not Work When Running Oracle BI Office for PowerPoint in Norwegian or Polish"
Impacted Releases: 11.1.1.6

- Section 41.9.6, "Multitasking Gestures on iPad iOS 4 and iOS 5 Are Not Supported"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.9.7, "BI Publisher Prompts Viewed in BI Mobile Display Differently Than in the Desktop Application"
Impacted Releases: 11.1.1.6

- Section 41.10.1.9, "Boilerplate Templates in the Components Folder Do Not Display Table Borders Properly in Chrome Browsers"
Impacted Releases: 11.1.1.6

- Section 41.10.1.12, "Search May Return Incorrect Number of Results"
Impacted Releases: 11.1.1.6

- Section 41.10.1.13, "Schedule Report Option Does Not Appear Correctly for Non-Admin Users"
Impacted Release: 11.1.1.6

- Section 41.10.2.1, "Limitations for Administrator Username in LDAP Security Model"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.10.4.2, "URL in E-mail Notification of Recurring or Future-Dated Jobs May Fail to Display Job History for the Job"
Impacted Releases: 11.1.1.6

- Section 41.10.5.1, "RTF Templates in 11g Require Number Conversion on String Expressions"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.10.7.2, "Excel Analyzer Does Not Support 64-Bit Windows Platform"
Impacted Releases: 11.1.1.6

- Section 41.10.11.1.2, "Required Location of ICC Profile Data File for PDF/X and PDF/A Output Incorrectly Documented"
Impacted Release: 11.1.1.6

- Section 41.11.3.4, "Select Nullable Option for Root Member of Parent-Child Hierarchies from OLAP Sources"
Impacted Releases: 11.1.1.5

- Section 41.11.3.5, "The Administration Tool Fails to Launch from the Start Menu"
Impacted Releases: 11.1.1.6.0

- Section 41.15.1.7, "Excel2007 Output in BI Publisher Supports Gregorian Calendar Only"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.15.1.8, "Template Builder for Microsoft Word Chart Wizard Does Not Format Dates"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.15.1.9, "Number and Date Format Issues with Charts in BI Publisher Layout Templates"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.16.5.3, "Information about Oracle Hyperion Smart View for Office Must Be Ignored"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.16.5.10, "Error in the "New Filter dialog" Topic in Appendix E, "User Interface Reference""
Impacted Releases: 11.1.1.5

- Section 41.16.5.11, "Information on View Latest Version Feature in Error"
Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

- Section 41.16.7.11, "Information Now Available for All Import Metadata Wizard Screens"
Impacted Releases: 11.1.1.5

- Section 41.16.7.12, "Remove Smart View Mention in Appendix C"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.16.8.2, "Use of ps: Prefix in Elements Is Unnecessary"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.16.8.3, "Removal of Section 11.5, "Configuring to Download Oracle Hyperion Smart View for Office""
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.16.8.6, "MaxColumns Element Not Supported"
Impacted Releases: 11.1.1.5

- Section 41.16.9.3, "Error in Code Example for Refreshing User GUIDs"
Impacted Releases: 11.1.1.5, 11.1.1.6

- Section 41.16.15.1, "Incorrect Statement on Source Control Management and Multiuser Development in Administration Tool Online Help"
Impacted Releases: 11.1.1.6

41.3 Oracle Business Intelligence Issues and Workarounds that Apply Only to Release 11.1.1.3

A number of issues and workarounds related to Oracle Business Intelligence Release 11.1.1.3 were identified prior to the January 2011 revision of the Release Notes. To find out more about those issues and workarounds, see the Oracle Business Intelligence chapter in the Oracle Fusion Middleware Release Notes for 11g Release 1 (11.1.1) at:

http://download.oracle.com/docs/cd/E14571_01/relnotes.htm

Other issues and workarounds related to Oracle Business Intelligence that apply only to Release 11.1.1.3. are described in this chapter as well as issues and workarounds that apply to subsequent Oracle Business Intelligence releases and are also known to apply to Release 11.1.1.3.

41.4 Oracle Business Intelligence General Issues and Workarounds

This section describes general issues and workarounds related to Oracle Business Intelligence. It includes the following topics:

- Section 41.4.1, "Oracle BI Disconnected Analytics Not Included in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later"

- Section 41.4.2, "Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later"

- Section 41.4.3, "Issue with JAR File Size When Moving from a Test to a Production Environment"

- Section 41.4.4, "IBM LDAP Based Authentication is Not Supported on Linux x86-64 and Microsoft Windows x64 (64-Bit)"

- Section 41.4.5, "Oracle BI Server Fails to Start Due to Missing Connect String in tnsnames.ora File"

- Section 41.4.6, "Adobe Flash Player Version 10.1 or Later Required to View Graphs and Scorecards"

- Section 41.4.7, "The Microsoft ODBC Data Source Administrator Crashes While Closing"

- Section 41.4.8, "ODBC System DSN Set With a Wrong Driver Filepath on Microsoft Windows x64 (64-Bit)"

- Section 41.4.9, "Hyperion Financial Management Data Sources Only Available for Windows Deployments"

- Section 41.4.10, "Siteminder Not Supported with Full-Text Catalog Search"

- Section 41.4.11, "Windows Native Authentication Not Supported with Full-Text Catalog Search"

- Section 41.4.12, "Full-Text Search Not Finding BI Publisher Reports by Report Column"

- Section 41.4.13, "Hebrew Fonts May Display in the Wrong Direction on Windows"

- Section 41.4.14, "Problems Installing in Thai and Turkish Locales"

- Section 41.4.15, "Graph Subtypes Are Not Refreshed in BI Composer"

- Section 41.4.16, "Dashboards and Scorecards Whose Paths Contain Multibyte Characters Do Not Display on ADF Pages"

- Section 41.4.17, "Characters Supported in Folder Names by BI Presentation Services Not Supported by BI Publisher"

- Section 41.4.18, "Integrating with Essbase and Hyperion Financial Management Data Sources with No Shared Connection Pool"

- Section 41.4.19, "Patch Available to Hide Selected Consistency Check Warnings"

- Section 41.4.20, "Issues with WebLogic LDAP User Passwords"

- Section 41.4.21, "Configuring the GUID Attribute in the Identity Store"

- Section 41.4.22, "Messages May Be Garbled When Running WebLogic Command Files"

- Section 41.4.23, "Rendering Issues Might Occur in Presentation Services When Using Microsoft Internet Explorer 9.x"

41.4.1 Oracle BI Disconnected Analytics Not Included in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later

Impacted Releases: 11.1.1.5, 11.1.1.6

Oracle Business Intelligence Enterprise Edition 10g included the Oracle BI Disconnected Analytics component. The Oracle BI Disconnected Analytics component is not shipped in (and cannot be used with) Oracle Business Intelligence Enterprise Edition 11g, Releases 11.1.1.5 and later.

If you currently use Oracle BI Disconnected Analytics 10g and want to continue to do so, then do not install or upgrade to Oracle Business Intelligence Enterprise Edition 11g, Release 11.1.1.6.

41.4.2 Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later

Impacted Releases: 11.1.1.5, 11.1.1.6

Previous versions of Oracle Hyperion Smart View for Office, which provides analytic capabilities within a Microsoft Office environment, supported a set of capabilities based on Oracle BI EE. This feature allowed end users to query directly against an Oracle BI Server, create ad-hoc interactions, and use Microsoft Office based reporting. As of Oracle BI EE 11g Release 11.1.1.5, this feature is no longer available.

41.4.3 Issue with JAR File Size When Moving from a Test to a Production Environment

Impacted Releases: 11.1.1.5, 11.1.1.6

This issue is applicable when moving from a test environment to a production environment. The Oracle Business Intelligence installation creates a JAR file of approximately 5 GB. JDK version 6 (or earlier) has a file size limit of 4 GB. Therefore, when you un-jar the file using the AS command pasteBinary, a crash occurs.

The workaround is to force either the pasteBinary command to use JRockit, which does not have a file size limit, or use JDK version 7. For instructions, see Oracle Fusion Middleware Administrator's Guide.

41.4.4 IBM LDAP Based Authentication is Not Supported on Linux x86-64 and Microsoft Windows x64 (64-Bit)

IBM LDAP based authentication is not supported for Oracle Business Intelligence 11.1.1.3.0 release on Linux x86-64 and Microsoft Windows x64 (64-Bit).

To work around this issue, users must use Oracle WebLogic based authentication.

41.4.5 Oracle BI Server Fails to Start Due to Missing Connect String in tnsnames.ora File

Oracle Business Intelligence Server fails to start if the connect string used for the connection pool is missing in the $ORACLE_HOME/network/admin/tnsnames.ora file.

To work around this issue, ensure that a valid connect string is present in the tnsnames.ora file.

41.4.6 Adobe Flash Player Version 10.1 or Later Required to View Graphs and Scorecards

Impacted Releases: 11.1.1.5, 11.1.1.6

The Adobe Flash Player is a cross-platform browser-based application runtime environment and is required for rendering graphs and scorecard objects in a browser.

Users must have Adobe Flash Player version 10.1 or later installed on their browsers to correctly view all graphs and scorecards that are generated by Oracle BI EE. Users can obtain information about the version of the Adobe Flash Player that is running on their browser by going to http://www.adobe.com/software/flash/about/.

41.4.7 The Microsoft ODBC Data Source Administrator Crashes While Closing

While closing the Microsoft Open Database Connectivity (ODBC) Data Source Administrator after editing the DSNs, the application may crash.

You can ignore this issue since the changes made to DSNs were unaffected.

41.4.8 ODBC System DSN Set With a Wrong Driver Filepath on Microsoft Windows x64 (64-Bit)

After installing Oracle BI EE, the ODBC System DSN is set with a wrong driver file path:

Driver=..\manualInstall64bit\Oracle_BI1\bifoundation\server\bin\NQSODBC.dll

Instead of setting the DSN driver to nqsodbc64.dll, the installer sets it to nqsodbc.dll, which does not exist on the disk.

The DSN driver setting has no functional impact and hence can be ignored.

41.4.9 Hyperion Financial Management Data Sources Only Available for Windows Deployments

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

You can use Hyperion Financial Management as a data source for Oracle BI EE only when Oracle BI EE is running in a Windows-only deployment.

41.4.10 Siteminder Not Supported with Full-Text Catalog Search

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

The full-text catalog search feature of Oracle BI EE is not supported with Single Sign-On in Siteminder.

41.4.11 Windows Native Authentication Not Supported with Full-Text Catalog Search

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

The full-text catalog search feature of Oracle BI EE is not supported with Windows Native Authentication. If you use this authentication and if you configure the full-text catalog search with the Active Directory plug-in and the Oracle Fusion data source, then the full-text catalog search returns no search results.

41.4.12 Full-Text Search Not Finding BI Publisher Reports by Report Column

Impacted Releases: 11.1.1.5, 11.1.1.6

You can use the full-text catalog search feature to locate objects in the catalog. If you search for BI Publisher reports by report column names, then you might obtain no results. This issue can arise when you use Secure Enterprise Search Version 11.1.2.2.0.

To work around this issue, add the following line to the ORACLE_HOME/search/data/config/crawler.dat file:

MIMEINCLUDE application/octet-stream

41.4.13 Hebrew Fonts May Display in the Wrong Direction on Windows

Impacted Releases: 11.1.1.3, 11.1.1.5

On Windows, if you select the Install files for complex script and right-to-left languages (including Thai) option on the Languages tab of the Regional and Language Options dialog, Hebrew fonts display in the wrong direction, that is left to right rather than right to left.

The workaround is to deselect the Install files for complex script and right-to-left languages (including Thai) option as follows:

1. In the Control Panel, click the Regional & Language Options button to display the Regional and Language Options dialog.

2. Click the Languages tab.

3. Deselect the Install files for complex script and right-to-left languages (including Thai) option.

4. Click OK.

41.4.14 Problems Installing in Thai and Turkish Locales

Impacted Releases: 11.1.1.5, 11.1.1.6

Turkish and Thai users are recommended to install and run Oracle Business Intelligence using the English locale. Due to instability that might be encountered, the Turkish and Thai locales are not supported on the server side. Oracle Business Intelligence does support Turkish and Thai locales as clients.

41.4.15 Graph Subtypes Are Not Refreshed in BI Composer

Impacted Releases: 11.1.1.5

When you select a non-default graph subtype in the BI Composer Wizard: Create Analysis: Edit Graph panel and later change the view to a different graph type in the BI Composer Wizard: Create Analysis: Select Views panel, the graph subtype does not get refreshed.

The workaround is to select the first option in the Subtype box in the BI Composer Wizard: Create Analysis: Edit Graph panel. (The first option is the default subtype for the new graph type.)

41.4.16 Dashboards and Scorecards Whose Paths Contain Multibyte Characters Do Not Display on ADF Pages

Impacted Releases: 11.1.1.5, 11.1.1.6

Dashboards and scorecards whose paths contain multibyte characters do not display on ADF pages.

This issue has no workaround.

41.4.17 Characters Supported in Folder Names by BI Presentation Services Not Supported by BI Publisher

Impacted Releases: 11.1.1.5

Oracle BI Presentation Services supports a set of characters for catalog folder names that BI Publisher does not support. Characters not supported by BI Publisher are:

~, !, #, $, %, ^, &, *, +, `, |, :, ", \\, <, >, ?, ,, /

Folders named with these characters may exhibit unexpected behavior if you log in directly to BI Publisher; for example, the folder may not be visible, the folder may not expand properly, or the name may appear garbled.

To work around this issue, do not use these characters in folder names.

41.4.18 Integrating with Essbase and Hyperion Financial Management Data Sources with No Shared Connection Pool

Impacted Releases: 11.1.1.3

Note:

This issue first appeared in the Oracle Business Intelligence chapter of the Oracle Fusion Middleware Release Notes for 11g Release 1 (11.1.1) at:

http://download.oracle.com/docs/cd/E14571_01/relnotes.htm

The text in the originally published release note is incorrect. The correct text appears in this section.

If you want to use Essbase or Hyperion Financial Management as a data source for the Oracle BI Server, and you want to authenticate using a shared token rather than configuring shared credentials in the connection pool, you must first enable compatibility for shared tokens using the steps provided in this section. If you enable compatibility for shared tokens, do not select Shared logon in the connection pool. Note that the Oracle Business Intelligence user and the Enterprise Performance Management user must use the same identity store.

If you do not enable compatibility for shared tokens, and you also do not provide shared credentials in the connection pool, the Oracle BI Server will attempt to authenticate using the pass-through user credentials (in other words, the user name and password used to log on to Oracle Business Intelligence).

Before you begin, ensure that you have the database connection information available for the Oracle Business Intelligence database where you populated the BI Platform schemas using RCU. For example, ensure that you have the host name, port, SID, user name, and password for the database.

To enable CSS token generation for single sign-on from the Oracle BI Server to Essbase or Hyperion Financial Management data sources:

1. In the Oracle Business Intelligence environment, open setDomainEnv.sh (or setDomainEnv.bat on Windows) for editing. You can find this file at:

DOMAIN_HOME/bin

For example:

MW_HOME/user_projects/domains/bifoundation_domain/bin

2. Add the following entry:

ExtraJavaProperties=-DEPM_ORACLE_INSTANCE= ORACLE_INSTANCE

For example:

ExtraJavaProperties=-DEPM_ORACLE_INSTANCE= C:\My_MW_Home\instances\instance1

3. Save and close the file.

4. Download the patch for bug 10263740 from My Oracle Support to obtain the utility. See Section 41.1.1, "Obtaining Patches from My Oracle Support" for more information.

5. Extract the contents of the archive to:

ORACLE_INSTANCE/config/foundation/11.1.2.0

Create this directory if it does not already exist.

6. Edit epm_components_creation.sh (or epm_components_creation.bat on Windows) to provide required values for ORACLE_HOME, ORACLE_INSTANCE, and JAVA_HOME as appropriate for your environment.

7. On Linux systems, make epm_components_creation.sh executable using the following command:

chmod +x epm_components_creation.sh

8. Run the executable epm_components_creation.sh (or epm_components_creation.bat on Windows), and provide the database host name, port, SID, user name, and password as command-line arguments. For example:

epm_components_creation.sh db_hostname db_port sid db_user db_pwd

The following output is displayed:

Writing credentials to reg.properties file.
Credentials written to reg.properties file.
Creating Component Types.
Component Types Created.
Creating Basic Components
Basic Components Created
All tasks successfully completed.

9. To validate that the data was successfully populated in the EPM Registry, execute epm_components_creation.sh (or epm_components_creation.bat on Windows) and provide "validate" as a command-line argument. For example:

epm_components_creation.sh validate

The following output is displayed:

Following required properties are available for SHARED_SERVICES_PRODUCT in EPM Registry:-
mode=FUSIONAPPS
COMPATIBILITY=11120-

10. Restart the BI domain, including the Administration Server and Managed Servers.

41.4.19 Patch Available to Hide Selected Consistency Check Warnings

Impacted Releases: 11.1.1.3

You can download and apply patch 11810367 to hide selected warnings from the Consistency Check Manager. After applying the patch, the following warnings are hidden by default: 39009, 39054, 39055, 39057, and 39059. See Section 41.1.1, "Obtaining Patches from My Oracle Support" for more information about downloading patches.

To make these warnings visible again in the Consistency Check Manager, follow these steps:

1. Click the Options button in the Consistency Check Manager to open the Consistency Check Warnings dialog.

2. Deselect the warnings that you want the Consistency Check Manager to display.

3. Click OK.

You can also add additional warnings to the exclusion list in the Consistency Check Warnings dialog. To do this:

1. Go to the following directory:

ORACLE_INSTANCE/config/OracleBIServerComponent/coreapplication_obisn

2. In that directory, create a text file called warn_off.ini. This file must be in ASCII format.

3. Populate the file with contents similar to the following, listing the warning numbers that you want to add to the exclusion list in the Consistency Check Warnings dialog:

[CCOptions]
CC_WARNINGS_LIST = 39024,39077

Note the following:

- All excluded warnings must be on one line and can be separated by a comma, a semicolon, or a space.

- You cannot exclude errors. You can only exclude warnings from the Consistency Check Manager.

- If you add warning numbers from the default exclusion list (39009, 39054, 39055, 39057, and 39059), they are ignored.

4. Save and close the file.

5. Close and then re-open the Consistency Check Manager. The new warnings appear in the Consistency Check Warnings dialog and are selected by default, meaning that those warnings will be excluded from consistency checks.

41.4.20 Issues with WebLogic LDAP User Passwords

Impacted Releases: 11.1.1.3

If you experience issues with WebLogic LDAP user passwords that contain non-ascii characters, please contact Oracle Support and reference bug 9929485 for details of a patch.

41.4.21 Configuring the GUID Attribute in the Identity Store

Impacted Releases: 11.1.1.3

If you configure an alternative authentication provider such as Oracle Application Server or Active Directory, and you change the GUID attribute from its default value, then you must ensure that the value that you use in the Identity Store matches the changed value that you are using in the alternative authentication provider.

For example, if you are using Oracle Internet Directory and have changed the default value of the GUID attribute from orclguid to newvalue, you must set the value to newvalue in both the Identity Store and the authentication provider.

To configure the GUID attribute in the Identity Store:

1. In Fusion Middleware Control, navigate to \Weblogic domain\bifoundation_domain in the navigation pane.

2. Right-click bifoundation_domain and select Security, then Security Provider Configuration to display the Security Provider Configuration page.

3. In the Identity Store Provider area, click Configure to display the Identity Store Configuration page.

4. In the Custom Properties area, use the Add option to create a Custom Property called PROPERTY_ATTRIBUTE_MAPPING with a new value for the GUID attribute (for example, GUID=newvalue).

Table 41-1 Custom Properties

Property Name

Value

PROPERTY_ATTRIBUTE_MAPPING

Specify the GUID attribute value that is set in the authentication provider. For example, if the GUID attribute is set to newvalue in the authentication provider, then set this value to GUID=newvalue.

5. Click OK to save the changes.

6. Restart the Administration Server, Managed Server(s), and BI components.

41.4.22 Messages May Be Garbled When Running WebLogic Command Files

Impacted Releases: 11.1.1.6

In a Windows environment where the locale is not UTF-8, running WebLogic command files (either directly or from the Windows Start menu) on an Oracle BI EE system may garble messages shown in the terminal window. The fact that the messages are garbled does not affect the correct running of the system.

This issue has no workaround.

41.4.23 Rendering Issues Might Occur in Presentation Services When Using Microsoft Internet Explorer 9.x

Impacted Releases: 11.1.1.6

If you are using IE9.x, you might see the following issues when running Presentation Services:

- Truncate option does not truncate the title

- Deleting the Conditional property enlarges the screen

- Bars drop down when using the magnifying glass to zoom

- Graph title does not show in a graph view

- Graph views have a black background

- The Event Channels area in the Map Properties dialog is not empty as it should be by default

- Some arrow down keys do not line up correctly in the dialogs that are used for Business Intelligence formatting

- Some dialogs that are used for Business Intelligence formatting are oversized

- When hovering the mouse pointer in the right corner of the Filters section, the toolbar is invisible

- The New Filter dialog does not display in the browser

41.5 Oracle Business Intelligence Installation Issues and Workarounds

This section describes issues and workarounds related to installing Oracle Business Intelligence. It includes the following topics:

- Section 41.5.1, "Error When Installing Oracle Business Intelligence Against a SQL Server Database"

- Section 41.5.2, "Scale-Out Scenarios Are Not Supported on OS with Different Patch Levels"

- Section 41.5.3, "Antivirus Software May Block the Installation in a Windows Environment"

- Section 41.5.4, "Oracle Business Intelligence Installer Stops at Administrator User Details Screen"

- Section 41.5.5, "Issues When Installing Oracle Business Intelligence on Windows 2008"

- Section 41.5.6, "Installing Oracle Business Intelligence on a Shared Drive Might Fail"

- Section 41.5.7, "Configuring DB2 to Support Multibyte Data"

- Section 41.5.8, "Using Multibyte Data Causes Issues with Microsoft SQL Server 2005/2008 Driver in Oracle BI Scheduler"

- Section 41.5.9, "Job Manager Does Not Start Due to Insufficient Permissions on Windows Operating Systems"

- Section 41.5.10, "Oracle Essbase Fails to Start on Microsoft Windows x64 (64-Bit)"

- Section 41.5.11, "Missing Locale Causes Oracle Business Intelligence Installation to Fail on UNIX"

- Section 41.5.12, "Ignore FAT File System Error Message When Performing an Enterprise Installation"

- Section 41.5.13, "Job Manager May Fail to Launch from the Start Menu"

- Section 41.5.14, "Job Manager Cannot Launch if the Client Tools Install Path Includes Multi-Byte Characters"

- Section 41.5.15, "Error Occurs When RCU is Invoked For a Second Time to Create Only MDS/Platform Schemas on IBM DB/2"

Depending on your Oracle Fusion Middleware implementation, some information in Chapter 2, "Installation, Patching, and Configuration" might also be relevant.

41.5.1 Error When Installing Oracle Business Intelligence Against a SQL Server Database

Impacted Releases: 11.1.1.5, 11.1.1.6

If you are using an MS SQL Server database when installing Oracle Business Intelligence, then the mds-owsm and bip_datasource JDBC data sources has an invalid test table. This stops the WebLogic Server automatic connection testing from functioning. For example, if the database stops, WebLogic Server does not recognize a hanging or invalid connection.

The workaround is to edit the Test Table Name parameter to allow a SQL string to be executed to test the connection. To do so, set the parameter in the WebLogic Server Administration Console to SQL select 1.

41.5.2 Scale-Out Scenarios Are Not Supported on OS with Different Patch Levels

Impacted Releases: 11.1.1.5, 11.1.1.6

Scale-out scenarios of the BI domain are not supported on computers that have the same operating system but different patch levels. All computers must have the same operating system patch level.

41.5.3 Antivirus Software May Block the Installation in a Windows Environment

Impacted Releases: 11.1.1.5, 11.1.1.6

If you are deploying to a mapped network drive on a computer running a supported Windows operating system, then ensure that the antivirus software is not set to block the remote creation of autorun.inf files.

41.5.4 Oracle Business Intelligence Installer Stops at Administrator User Details Screen

Impacted Releases: 11.1.1.5, 11.1.1.6

If you attempt to install on a Windows system that is using DHCP, does not have a primary DNS suffix, and does not have a loopback adapter configured, then the Oracle Business Intelligence installer stops at the screen that prompts for the Administrator user details. This is displayed as a red cross in the tree on the left-hand side of the installer. This issue is caused by the installer not being able to resolve the IP address to a host name.

The workaround is to configure a loopback adapter or primary DNS suffix.

41.5.5 Issues When Installing Oracle Business Intelligence on Windows 2008

Impacted Releases: 11.1.1.5, 11.1.1.6

When you install Oracle Business Intelligence on Windows 2008, you may experience issues such as OPMN failing to start processes.

The workaround is to run the installation and configuration steps with the Run as Administrator option.

41.5.6 Installing Oracle Business Intelligence on a Shared Drive Might Fail

Impacted Releases: 11.1.1.5, 11.1.1.6

Attempting to install Oracle Business Intelligence on a shared drive might fail, resulting in the following error message:

Installation Failed. Prepare Session failed You may not have enough space on your drive for a successful install. Do you still want to continue?

To avoid this issue when installing Oracle Business Intelligence on a shared drive, start the Oracle Business Intelligence installer from the command line using the ignoreDiskWarning option. For example, on Linux, use the following command:

./runInstaller -ignoreDiskWarning

41.5.7 Configuring DB2 to Support Multibyte Data

Impacted Releases: 11.1.1.5, 11.1.1.6

When installed with an IBM DB2 database, the Oracle Business Intelligence installer configures the system with an ODBC 2.0 driver. In such systems, issues will occur if multibyte data is used. To avoid this issue, use Oracle Enterprise Manager to configure the Oracle Business Intelligence system to use the native DB2 CLI driver instead.

To configure Oracle Business Intelligence to use DB2 CLI driver with IBM DB2:

1. Install the DB2 client software on the machines where Oracle Business Intelligence resides, and create data source to your scheduler db.

2. After you install Oracle Business Intelligence, log into the system through Oracle Enterprise Manager.

3. Navigate to the Scheduler tab for the Oracle Business Intelligence server.

4. Click Lock and Edit Configuration.

5. Click the Call Interface drop-down list and select DB2 CLI - Unicode.

6. In the Data Source field, enter your data source name.

7. Click Apply, and then Activate Changes.

41.5.8 Using Multibyte Data Causes Issues with Microsoft SQL Server 2005/2008 Driver in Oracle BI Scheduler

Impacted Releases: 11.1.1.5, 11.1.1.6

When installed with a Microsoft SQL Server 2005/2008 database, the Oracle Business Intelligence installer configures Oracle BI Scheduler with a SQL Server 2005/2008 driver. If multibyte data is used, scheduled jobs might fail. To avoid this issue, use Oracle Enterprise Manager to configure the Oracle Business Intelligence system to use a SQL Server 7.0/2000 driver instead.

To configure Oracle BI Scheduler to use the SQL Server 7.0/2000 driver with Microsoft SQL Server 2005/2008:

1. After you install Oracle Business Intelligence, log into the system through Oracle Enterprise Manager.

2. Navigate to the Scheduler tab for the Oracle Business Intelligence server.

3. Click Lock and Edit Configuration.

4. Click the Database drop-down list and select SQL Server 7.0/2000.

5. Click Apply.

41.5.9 Job Manager Does Not Start Due to Insufficient Permissions on Windows Operating Systems

Impacted Releases: 11.1.1.5, 11.1.1.6

If certain permission settings are insufficient, then Job Manager does not open when you attempt to start it. You can resolve this issue by changing the permission settings on the bifoundation folder. This folder can be found in the Oracle Business Intelligence Enterprise Edition Plus Client installation directory.

To resolve this issue:

1. In Windows Explorer, access the bifoundation folder, found in the directory where you installed Oracle Business Intelligence Enterprise Edition Plus Client. Typically, you can find this folder in the following directory:
C:\Program Files\Oracle Business Intelligence Enterprise Edition Plus Client\oraclebi\orainst\bifoundation

2. Right-click the bifoundation folder, and then click Properties.

3. Click the Security tab.

4. Click Edit.

5. Click Add. The Select Users, Computers, or Groups dialog window opens.

6. Click Authenticated Users, and then click OK.

7. In the Users or Groups pane, click Authenticated Users.

8. In the Permissions pane, click the Modify and Write check boxes so that check marks appear in them.

9. Click OK.

10. Start Job Manager either from the Start menu or the command line.

41.5.10 Oracle Essbase Fails to Start on Microsoft Windows x64 (64-Bit)

Oracle Essbase fails to start on Microsoft Windows x64 (64-Bit) platform. It shows the following error:

Network Error [10048]: Unable to Bind Host Server Socket On Port [9501]

This error occurs when Oracle Process Management and Notification (OPMN) components are started on both the cluster nodes of Oracle Essbase cluster environment, and the Essbase component that is stopped on the active cluster node1 tries to fail over to cluster node2 or back to cluster node1.

At this time, OPMN spawns Oracle Essbase and passes two command line arguments as ports. They are as follows:

1. Its main listening port (1423 - as configured in opmn.xml).

2. A ping port, where OPMN keeps pinging Essbase.

For the second command line argument, OPMN does a port scan to find a free port from a dynamic range specified in opmn.xml file from the following attribute:

<port id="essbase-port-range" range="9500-9999"/>

The port scan reports port 9501 as a free port. This result is incorrect, as OPMN is already listening on port 9501. Thus, when OPMN sends the startup arguments to Essbase with a ping port of 9501, Essbase fails to start and shuts down.

To work around this issue, specify the range in opmn.xml file as:

<port id="essbase-port-range" range="9502-9999"/>

41.5.11 Missing Locale Causes Oracle Business Intelligence Installation to Fail on UNIX

Impacted Releases: 11.1.1.5

The Oracle Business Intelligence installation fails on UNIX if the locale en_US.UTF-8 does not exist on the installation computer. To avoid this issue, make sure that the locale en_US.UTF-8 exists on the installation computer before you install Oracle Business Intelligence.

41.5.12 Ignore FAT File System Error Message When Performing an Enterprise Installation

Impacted Releases: 11.1.1.6

When performing an Enterprise Installation, under certain circumstances, you might see the error message "Middleware Home Location is in FAT file system". This message can occur when you install on an NTFS file system. You can click Yes to safely proceed with the installation.

41.5.13 Job Manager May Fail to Launch from the Start Menu

Impacted Releases: 11.1.1.6

Job Manager may fail to launch from the Start menu if the client tools were installed in a default folder on a French or Korean 64-bit Windows 7 operating system. This happens because users do not have privileges to create temporary directories.

The workaround is to do one of the following:

- Create a temporary directory manually and add the current user to the Administrator group on that temporary directory.

- Install the client tools in a specific directory, not the default directory.

41.5.14 Job Manager Cannot Launch if the Client Tools Install Path Includes Multi-Byte Characters

Impacted Releases: 11.1.1.6

When running the Oracle Business Intelligence Enterprise Edition Plus Client Installer, if the install path contains any multi-byte characters Job Manager cannot launch. To avoid this issue you must change the install path if it contains any multi-byte characters. Make sure that the install path contains only ASCII characters.

41.5.15 Error Occurs When RCU is Invoked For a Second Time to Create Only MDS/Platform Schemas on IBM DB/2

Impacted Releases: 11.1.1.6

To prevent RCU displaying an EPM schema error when running RCU for the second time to create only MDS/BIPLATFORM schemas on IBM DB/2, you must first delete two lines of text from the ComponentInfo.xml file.

To prevent an EPM schema error occurring when using RCU for a second time to create only MDS/Platform schemas on IBM DB/2:

1. Open the file ComponentInfo.xml file which is located in rcu/config.

2. Delete the following two lines from the ComponentInfo.xml file:

<!ENTITY epm SYSTEM "../integration/epm/epm_ComponentInfo.xml">
&epm;

RCU uses these lines to display components listed in the selection tree for the Select Components page.

3. Save the ComponentInfo.xml file.

4. Run RCU for the second time.

41.6 Oracle Business Intelligence Upgrade Issues and Workarounds

This section describes issues and workarounds related to upgrading Oracle Business Intelligence from previous releases. It includes the following topics:

- Section 41.6.1, "General Upgrade Issues and Workarounds"

- Section 41.6.2, "Security-related Upgrade Issues and Workarounds"

Depending on your Oracle Fusion Middleware implementation, some information in Chapter 3, "Upgrade" might also be relevant.

41.6.1 General Upgrade Issues and Workarounds

This section describes general issues and workarounds related to upgrading Oracle Business Intelligence from previous releases. It includes the following topic:

- Section 41.6.1.1, "Conditional Formatting Might Not Work After Upgrading from Oracle Business Intelligence Release 10g to Release 11g"

41.6.1.1 Conditional Formatting Might Not Work After Upgrading from Oracle Business Intelligence Release 10g to Release 11g

Impacted Releases: 11.1.1.5

If an attribute column's Value Suppression setting (in the Column Format tab of the Column Properties dialog) is not set to Repeat, then the measure is aggregated to the grain as defined by the position of the column with the format defined. This might cause a change in the conditional formatting after upgrading from Oracle Business Intelligence Release 10g to Release 11g. If the Value Suppression setting is set to Repeat, then the measure column that the conditional format is based on always uses the detail grain of the table view, in which case the conditional formatting works as expected.

41.6.2 Security-related Upgrade Issues and Workarounds

This section describes issues and workarounds related to security when upgrading Oracle Business Intelligence from previous releases. It includes the following topics:

- Section 41.6.2.1, "Warnings Might Be Reported When Upgrading an RPD with Non-English User or Group Names"

- Section 41.6.2.2, "Users or Groups With Names Containing Invalid Characters Are Not Upgraded"

- Section 41.6.2.3, "RPD Upgrade Process Fails If the 10g Administrator UserID or Password Contains any Non-Native Characters"

41.6.2.1 Warnings Might Be Reported When Upgrading an RPD with Non-English User or Group Names

Impacted Releases: 11.1.1.5, 11.1.1.6

When upgrading a repository with non-English user or group names, warnings might be reported in the log file, such as "Group name ??? isn't valid in WLS/LDAP : not migrating this group" or "User name ??? isn't valid in WLS/LDAP : not migrating this user" (where ??? is garbled text).

The workaround is to manually create the users or groups. To do so, see the following instructions in Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition:

- For a group:

- Create the group as described in Section 2.3.4, "Creating a Group in the Embedded WebLogic LDAP Server."

- Create an Application Role as described in Section 2.4.2, "Creating Application Roles Using Fusion Middleware Control."

- Add the group to the application role as described in Section 2.4.2.2, "Creating an Application Role."

If the repository group was a member of another repository group, then create the same Group and Application Role hierarchy.

- For a user:

- Create the user as described in Section 2.3.3, "Creating a New User in the Embedded WebLogic LDAP Server."

- Assign the user to the required groups as described in Section 2.3.5, "Assigning a User to a Group in the Embedded WebLogic LDAP Server."

41.6.2.2 Users or Groups With Names Containing Invalid Characters Are Not Upgraded

Impacted Releases: 11.1.1.5, 11.1.1.6

When upgrading a repository, users or groups with names that contain the following invalid characters are not upgraded:

- ,

- +

- =

- "

- \

- <

- >

- ;

The workaround is to manually create the users or groups after upgrade is complete, with new names that do not contain the invalid characters. Note that the new names must not contain invalid characters under any circumstances. Failure to follow this instruction requires you to re-install Oracle Business Intelligence.

41.6.2.3 RPD Upgrade Process Fails If the 10g Administrator UserID or Password Contains any Non-Native Characters

Impacted Releases: 11.1.1.5, 11.1.1.6

The repository upgrade process from Oracle Business Intelligence 10g to Oracle Business Intelligence 11g fails if the 10g Administrator user ID or password contains any non-native characters, and the operating system is Windows or Non-UTF8 Linux. For example, "Administrator/bi10g-éíô" fails to upgrade. The upgrade utility might run to completion, but with error messages, and users cannot log on if you try to run the system using the upgraded repository. You must change the Administrator user ID, password, or both the user ID and password to one that uses only native characters before running the repository upgrade command line utility or Upgrade Assistant wizard.

41.7 Oracle Business Intelligence Installation Guidelines for 64-Bit Platforms

- Section 41.7.1, "Prerequisites for Software Only Installation on 64-Bit Platforms"

- Section 41.7.2, "Supported Installation Types for Oracle Business Intelligence on 64-Bit Platforms"

- Section 41.7.3, "Considerations and Limitations of Enterprise Install Type for Scaling Out Existing Installations"

41.7.1 Prerequisites for Software Only Installation on 64-Bit Platforms

Prior to Oracle Business Intelligence software only installation, you must install the latest Oracle WebLogic Server wls1033_generic.jar in MW_Home with 64-bit JDK. Then install Oracle Business Intelligence in the same MW_Home.

41.7.2 Supported Installation Types for Oracle Business Intelligence on 64-Bit Platforms

Different types of installation options available for Oracle Business Intelligence are as follows:

- Simple Install
This installs 32-bit JVM and 32-bit Oracle WebLogic Server. Oracle Business Intelligence Server is a 64-bit system on 64-bit platforms. Simple Install is supported on the following 64-bit Platforms only:

- Linux x86-64

- Windows x86-64

However, for production the recommended installation type is software only install with 64-bit Oracle WebLogic Server and 64-bit JDK.

- Software Only Install
This installs software binary files in an Oracle home for later configuration as part of the Oracle Fusion Middleware deployment process. This installation type is required if you want to install Oracle Business Intelligence with a 64-bit JVM on a supported 64-bit operating system.

Recommended installation steps for 64-bit platforms are as follows:

- Install 64-bit Oracle WebLogic Server with 64-bit JDK.

- Choose Oracle Business Intelligence Software Only Install option.

- Once software only install process is complete, select Configure.

- Enterprise Install
Since 11.1.1.6.0 release, Enterprise Install for Oracle Business Intelligence is supported on 64-bit systems. For details, refer to Section 4.5.2, "Enterprise Install for New Installations" in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence.

41.7.3 Considerations and Limitations of Enterprise Install Type for Scaling Out Existing Installations

To scale out an existing installation with a 64-bit JVM on a supported 64-bit operating system, do not select the Enterprise Install type option. Select the Software Only Install type instead.

For details, refer to Section 4.4.4, "Software Only Install" in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence.

41.8 Oracle Business Intelligence Analyses and Dashboards Issues and Workarounds

This section describes issues and workarounds related to Oracle Business Intelligence analyses and dashboards. It includes the following topics:

- Section 41.8.1, "General Analyses and Dashboards Issues and Workarounds"

- Section 41.8.2, "Actions Issues and Workarounds"

- Section 41.8.3, "Scorecards and KPI Issues and Workarounds"

- Section 41.8.4, "Agents Issues and Workarounds"

- Section 41.8.5, "Microsoft Office Integration Issues and Workarounds"

41.8.1 General Analyses and Dashboards Issues and Workarounds

This section describes general issues and workarounds related to Oracle Business Intelligence analyses and dashboards. It includes the following topics:

- Section 41.8.1.1, "Existing Dashboard Prompts Based on Columns Renamed in the Business Model Do Not Work"

- Section 41.8.1.2, "Gauge Views May Be Cut Off and Not Visible Under Certain Conditions"

- Section 41.8.1.3, "Numerical Units on a Dashboard Prompt Slider Might Not Be Translated Correctly"

- Section 41.8.1.4, "After Printing a Dashboard Page Using the Safari Browser on Windows, the Page No Longer Responds to Certain Left Clicks"

- Section 41.8.1.5, "Scorecard Diagrams on Dashboard Pages May Print as Tables"

- Section 41.8.1.6, "Using Maps with Column Selectors"

- Section 41.8.1.7, "Support for Rendering Small Form-Factor Graphs"

- Section 41.8.1.8, "Analyses Whose Paths Contain Latin Supplement Characters Fail to Open on Dashboard Pages"

- Section 41.8.1.9, "In Selection Steps Search for Members in Hierarchical Columns That Are Non-Text Yields No Results"

- Section 41.8.1.10, "Interactions on Right-Click Menus Are Not Translated"

41.8.1.1 Existing Dashboard Prompts Based on Columns Renamed in the Business Model Do Not Work

Impacted Releases: 11.1.1.5, 11.1.1.6

If a column is renamed in the Business Model, then existing dashboard prompts based on that column do not work with newly created analyses.

The workaround is to use Catalog Manager to rename the column in the catalog.

41.8.1.2 Gauge Views May Be Cut Off and Not Visible Under Certain Conditions

Impacted Releases: 11.1.1.5

Under certain conditions, if the size of the canvas assigned to a gauge view is very small, and the legend is set to display on the left, then some of the gauges in the gauge view may be cut off and not visible.

The workaround is to edit the gauge view and change the Legend position to Right, Top, or Bottom. Alternatively, you can increase the size of the gauge view canvas so that all gauges display.

41.8.1.3 Numerical Units on a Dashboard Prompt Slider Might Not Be Translated Correctly

Impacted Releases: 11.1.1.5, 11.1.1.6

The numerical units (such as million or billion) that are displayed on a dashboard prompt slider might not be translated correctly.

The workaround is to modify the obiprp.promptcomponents.xml file as follows:

1. Open the obiprp.promptcomponents.xml file for editing. You can find the file here:
ORACLE_INSTANCE\bifoundation\web\msgdb\l_XX\messages\uicmsgs

2. Ensure that each entry for a numerical unit (such as tag name kmsgSliderBillion, kmsgSliderMillion, or kmsgSliderDecillion) is translated correctly.

3. Restart the Managed Servers, the Administration Server and all Oracle Business Intelligence Java components, and the Oracle Business Intelligence system components. For information on how to restart the Managed Servers, the Administration Server and all Oracle Business Intelligence Java components, and the Oracle Business Intelligence system components, see Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

41.8.1.4 After Printing a Dashboard Page Using the Safari Browser on Windows, the Page No Longer Responds to Certain Left Clicks

Impacted Releases: 11.1.1.5, 11.1.1.6

After you print a dashboard page in PDF or HTML format using the Safari browser on Windows, the dashboard page no longer responds to certain left clicks, for example, a left click to print again or to change tabs.

The workaround is to exit and reopen the dashboard page. Alternatively, press and hold down the Ctrl key and then left-click.

41.8.1.5 Scorecard Diagrams on Dashboard Pages May Print as Tables

Impacted Releases: 11.1.1.5, 11.1.1.6

When you print a dashboard page that contains multiple scorecard diagrams (for example a strategy tree, strategy map, custom view, and cause & effect map) in PDF or HTML format, some of the diagrams might print as tables rather than diagrams.

The workaround is to scroll down the page and wait until all the diagrams have fully rendered before printing.

41.8.1.6 Using Maps with Column Selectors

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

If you want to use a column selector view with map views, then ensure that you add all map views to the analysis before you add the column selector view.

41.8.1.7 Support for Rendering Small Form-Factor Graphs

Impacted Releases: 11.1.1.5

This release includes support for rendering small form-factor graphs, for example, graphs that are 75 pixels X 25 pixels or 68 pixels X 18 pixels. Small form-factor graphs are also referred to as micrographs.

To render a small form-factor graph:

1. Edit the analysis.

2. Edit the graph.

3. Click the Edit graph properties toolbar button to display the Graph Properties dialog.

4. In the General tab, make the following settings:

- In the Legend Location box, select None.

- Deselect the Animate graph on Display box.

5. Click the Style tab and make the following settings:

- In the Style box in the Graph Data area, select Default.

- In the Plot area, select the Specify option for Gridlines.

- For Major Grid, deselect the Horizontal Lines and Vertical Lines boxes.

- For Minor Grid, deselect the Horizontal Lines box.

- In the Legend area, deselect the Transparent box.

- In the Canvas Colors and Borders area, deselect the Gradient box.

6. Click the Titles and Labels tab and make the following settings:

- In the Graph Title area, deselect the Use measure name as graph title box.

- In the Axis titles area, deselect the following boxes:

- Use measure name as axis title for Vertical Axis 1 Title

- Use measure name as axis title for Vertical Axis 2 Title

- Use column name as axis title for Horizontal Axis Title

7. Click OK to close the Graph Properties dialog.

8. Click Done to close the Graph editor.

9. Click the Analysis editor: Advanced tab.

10. Save a copy of the existing XML in the XML Code box as a backup.

11. In the XML Code box in the Analysis XML area, add the following attribute to the display element for the graph that you want to render as a small form-factor graph:

useAutoLayout="false"

For example:

<saw:display type="line" subtype="default" renderFormat="flash" mode="online" xAxisLiveScrolling="false" yAxisLiveScrolling="false" clientEventEnabled="false"  animateOnDisplay="false" useAutoLayout="false">

Important:

Do not use this setting for a graph that is a reasonable size, such as, a graph that is 400 pixels X 300 pixels. Doing so may result in undesirable graph behavior or loss of information.

12. Click Apply XML.

13. Click Save Analysis.

41.8.1.8 Analyses Whose Paths Contain Latin Supplement Characters Fail to Open on Dashboard Pages

Impacted Releases: 11.1.1.5, 11.1.1.6

Analyses whose paths contain Latin Supplement characters fail to open on dashboard pages when the locale is Chinese, Japanese, Korean, Hebrew, or Arabic and you are using Internet Explorer 7 as the Web browser.

The workaround is to append &charset=utf-8 to the URL.

41.8.1.9 In Selection Steps Search for Members in Hierarchical Columns That Are Non-Text Yields No Results

Impacted Releases: 11.1.1.6

When working with selection steps, if you search for members in hierarchical columns that are non-text (for example, date or time), then the search will yield no results.

This issue has no workaround.

41.8.1.10 Interactions on Right-Click Menus Are Not Translated

Impacted Releases: 11.1.1.6

The interactions on right-click menus for table views and pivot table views are not translated.

41.8.2 Actions Issues and Workarounds

This section describes issues and workarounds related to actions. It includes the following topic:

- Section 41.8.2.1, "EJBs in Action Framework Must Be Deployed to the WebLogic Managed Server"

41.8.2.1 EJBs in Action Framework Must Be Deployed to the WebLogic Managed Server

Impacted Releases: 11.1.1.5, 11.1.1.6

A limitation currently exists in the Action Framework functionality when creating actions to invoke Java methods in EJBs. Only EJBs deployed within the same J2EE container as the Action Framework services (by default the WebLogic Managed Server) are available to the Action Framework.

The workaround is to invoke a target EJB. To do so, implement one of the following methods:

- Deploy the target EJB to the WebLogic Managed Server in the BI domain (adhering to any license restrictions for WebLogic Server).

- Deploy a gateway EJB/Web service on the WebLogic Managed Server specifically to invoke the remote EJB.

- Expose the remote EJB as a Web service.

- Deploy a gateway Web service on the remote location to invoke the EJB.

41.8.3 Scorecards and KPI Issues and Workarounds

This section describes issues and workarounds related to scorecards and KPIs. It includes the following topics:

- Section 41.8.3.1, "No Results Returned When Searching in the Related Documents of Scorecards or Scorecard Components"

- Section 41.8.3.2, "Item Stale Error When Editing a Shared Scorecard in Parallel"

41.8.3.1 No Results Returned When Searching in the Related Documents of Scorecards or Scorecard Components

Impacted Releases: 11.1.1.5, 11.1.1.6

You can use the full-text catalog search functionality to search in most catalog objects and related documents. Currently, the full-text catalog search functionality searches in scorecards themselves and in the names of related documents, but it does not search in the content of related documents for scorecards.

41.8.3.2 Item Stale Error When Editing a Shared Scorecard in Parallel

Impacted Releases: 11.1.1.5, 11.1.1.6

When using a shared Oracle BI Presentation Catalog and a scaled-out configuration of Oracle BI Presentation Services, users might see "Item Stale : <scorecard path>" errors, when they edit a shared scorecard in parallel.

The workaround to prevent this error is to turn off the Oracle BI Presentation Services Catalog Attribute Cache. To do so, set the following in the instanceconfig.xml file:

<ps:Cache xmlns:ps="oracle.bi.presentation.services/config/v1.1">
<ps:CatalogAttributes>
<ps:Enabled>false</ps:Enabled>
</ps:CatalogAttributes>
</ps:Cache>

For more information on the cache, see Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

41.8.4 Agents Issues and Workarounds

This section describes issues and workarounds related to agents. It includes the following topics:

- Section 41.8.4.1, "Agent Deliveries Fail with Microsoft Active Directory and Oracle Virtual Directory"

- Section 41.8.4.2, "Agent Incorrectly Delivers Content to Active Delivery Profile When Only the Home Page and Dashboard Option Is Selected"

41.8.4.1 Agent Deliveries Fail with Microsoft Active Directory and Oracle Virtual Directory

Impacted Releases: 11.1.1.5, 11.1.1.6

If you are using Microsoft Active Directory and Oracle Virtual Directory, then agent deliveries fail.

The workaround is to apply the Oracle Virtual Directory Patch Number 9904956 - GUID Returned for AD User Cannot Be Used in Search Filter.

41.8.4.2 Agent Incorrectly Delivers Content to Active Delivery Profile When Only the Home Page and Dashboard Option Is Selected

Impacted Releases: 11.1.1.5, 11.1.1.6

When you specify that an agent is to deliver content only to the Home page and dashboard pages by selecting the Home Page and Dashboard option and deselecting the Devices option in the Destination tab of the Agent editor, there is a known issue where the agent delivers content to the active delivery profile even though the Devices option is deselected.

The workaround is to set the priority of the agent so that it does not match an existing delivery profile.

41.8.5 Microsoft Office Integration Issues and Workarounds

This section describes issues and workarounds related to the integration between Oracle Business Intelligence and Microsoft Office. It includes the following topics:

- Section 41.8.5.1, "Using Microsoft Office 2007 with Oracle BI Add-in for Microsoft Office"

- Section 41.8.5.2, "Server Connections Are Not Automatically Shared by Microsoft Excel and PowerPoint"

- Section 41.8.5.3, "Previous Installation of Oracle BI Add-in for Microsoft Office Must Be Manually Uninstalled"

- Section 41.8.5.4, "Install a Language Pack for Non-English Languages"

- Section 41.8.5.5, "Errors in the Online Help for Oracle BI Add-In for Microsoft Office"

- Section 41.8.5.6, "Refreshing Table or Pivot Table Views with Double Columns in Page Edge Might Result in Error"

- Section 41.8.5.7, "Double Column Cascading Results in Incorrect Display Values"

- Section 41.8.5.8, "Intermittent Timeout Errors"

- Section 41.8.5.9, "Lack of Support for Vary Color By Target Area"

- Section 41.8.5.10, "Measure Column Labels May Display Incorrectly When Inserted into Microsoft Excel"

- Section 41.8.5.11, "Stacked Graphs Do Not Display Negative Values"

- Section 41.8.5.12, "Scatter Graphs with Lines Display as Default Scatter Graphs in Excel and PowerPoint"

- Section 41.8.5.13, "Graphs With Section Edges Are Not Supported in Release 11.1.1.6.0"

- Section 41.8.5.14, "Refreshing Table Views in Arabic or German Versions of Excel Result in Incorrect Data Values"

- Section 41.8.5.15, "Inserting a View With a Grand Total Column or Row into Microsoft Office May Cause Issues"

- Section 41.8.5.16, "Time Displayed in Table or Pivot View Title May Be Incorrect after Insertion"

- Section 41.8.5.17, "Graphs May Be Displayed Differently After Insertion into Microsoft Office"

- Section 41.8.5.18, "Legends in Bubble and Scatter Graphs May Display Differently After Insertion into Microsoft Office"

- Section 41.8.5.19, "Help System Does Not Work When Running Oracle BI Office for PowerPoint in Norwegian or Polish"

41.8.5.1 Using Microsoft Office 2007 with Oracle BI Add-in for Microsoft Office

Impacted Releases: 11.1.1.5, 11.1.1.6

If you use Microsoft Office 2007 with Oracle BI Add-in for Microsoft Office, then ensure that Office 2007 SP1 at minimum is installed. If you do not, you might encounter file interchangeability issues between Microsoft Office 2007 and Microsoft Office 2003.

For more detailed information on versions, see the certification document available on Oracle Technology Network (OTN):

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

41.8.5.2 Server Connections Are Not Automatically Shared by Microsoft Excel and PowerPoint

Impacted Releases: 11.1.1.5, 11.1.1.6

Microsoft Excel and PowerPoint on the same computer share Oracle BI Add-in for Microsoft Office connections. If you create a connection in Excel, then that connection is also available in PowerPoint. However, if you create an Oracle BI Add-in for Microsoft Office connection in Excel while PowerPoint is open, then the connection is not displayed in PowerPoint, and vice versa.

The workaround to create a connection to be shared between Excel and PowerPoint is to ensure that the other Microsoft Office application is closed. Alternatively, you can close both Excel and PowerPoint, and reopen them as needed in order to see connections available in both Excel and PowerPoint.

41.8.5.3 Previous Installation of Oracle BI Add-in for Microsoft Office Must Be Manually Uninstalled

Impacted Releases: 11.1.1.5, 11.1.1.6

The Oracle BI Add-in for Microsoft Office 11g installer does not uninstall previous versions of Oracle BI Add-in for Microsoft Office. Therefore, you must manually uninstall any previous Oracle BI Add-in for Microsoft Office installations before installing Oracle BI Add-in for Microsoft Office.

For more information on installing Oracle BI Add-in for Microsoft Office, see Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition.

41.8.5.4 Install a Language Pack for Non-English Languages

To use the Oracle BI Add-in for Microsoft Office for a non-English language, you must install the appropriate language pack for Microsoft Office and set the regional language settings using the Control Panel. Go to the following URL to download and install the appropriate language pack:

http://office.microsoft.com/en-us/downloads/office-language-interface-pack-lip-downloads-HA001113350.aspx

41.8.5.5 Errors in the Online Help for Oracle BI Add-In for Microsoft Office

Impacted Releases: 11.1.1.5, 11.1.1.6

The following errors are in the online help for Oracle BI Add-in for Microsoft Office:

- In the "Creating a Connection to the Oracle BI Office Server" topic, in Step 1, "From the ribbon, select New" is incorrect. The correct instruction for Step 1 is "From the Ribbon, select Preferences. From Preferences, select the New tab." (This applies to Excel and PowerPoint.)

- In the "Changing the Default Style Template" topic, in Step 1, the location given for the default template is valid only for Windows 32-bit installations. In Windows 64-bit installations, the default location is <BI Office installation directory>\ BIOfficeExcel|Template. (This applies to Excel.)

- The "Setting Log Levels" topic should state that users must have proper access permission to the log file location. (This applies to Excel and PowerPoint.)

41.8.5.6 Refreshing Table or Pivot Table Views with Double Columns in Page Edge Might Result in Error

Impacted Releases: 11.1.1.5

In Oracle BI Add-in for Microsoft Excel, you cannot refresh table views or pivot table views with double columns in the page edge. To work around this issue, ensure that double columns are not in the page edge (also called table prompt in table views and the pivot prompt in pivot table views).

41.8.5.7 Double Column Cascading Results in Incorrect Display Values

Impacted Releases: 11.1.1.5, 11.1.1.6

If double columns are used in cascaded prompts for both columns, then you might see code being displayed instead of the correct display values.

41.8.5.8 Intermittent Timeout Errors

Impacted Releases: 11.1.1.5, 11.1.1.6

If the BI Office Server is configured to connect to Presentation Services through Oracle HTTP Server (OHS), then you might see intermittent error messages that are caused by the timeout of a request. To work around this issue, increase the Keepalive timeout value for OHS to 15 seconds or more.

41.8.5.9 Lack of Support for Vary Color By Target Area

Impacted Releases: 11.1.1.5

If you use the Vary Color By target area for graph views when creating analyses in Oracle BI EE, then you might find that the results are displayed incorrectly in Microsoft Excel and PowerPoint.

41.8.5.10 Measure Column Labels May Display Incorrectly When Inserted into Microsoft Excel

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Measure column labels in the section edge or the page edge (also called table prompt in table views and the pivot prompt in pivot table views) of table and pivot table views may display incorrectly when inserted into Microsoft Excel.

The workaround is to not use measure columns in the section edge or page edge.

41.8.5.11 Stacked Graphs Do Not Display Negative Values

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Stacked graphs do not display negative values when they are inserted into Microsoft Excel or PowerPoint. This happens because the default Microsoft graph engine, which governs these graphs, does not display negative values.

41.8.5.12 Scatter Graphs with Lines Display as Default Scatter Graphs in Excel and PowerPoint

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

When you select the scatter graph with lines graph style to insert into Microsoft Excel or PowerPoint, the default scatter graph (without lines) is displayed instead. This happens because Microsoft does not support scatter graphs with lines.

41.8.5.13 Graphs With Section Edges Are Not Supported in Release 11.1.1.6.0

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Release 11.1.1.6.0 of Oracle BI Add-In for Microsoft Office Release does not support graphs with section edges. Therefore, if a graph with section edges was inserted using Release 11.1.1.5.0 of Oracle BI Add-In for Microsoft Office Release, an error will be returned when it is refreshed in Release 11.1.1.6.0.

41.8.5.14 Refreshing Table Views in Arabic or German Versions of Excel Result in Incorrect Data Values

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

In German or Arabic Versions of Microsoft Excel 2007 or 2010, number formatting may be lost after table views that have been secured are refreshed.

41.8.5.15 Inserting a View With a Grand Total Column or Row into Microsoft Office May Cause Issues

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Views that use the "before" location to show row-level grand totals overwrite values in the first column of the analysis when they are inserted into Microsoft Excel.

Views that use the "before" location to show column-level grand totals return errors when they are inserted into Microsoft PowerPoint.

The workaround is to use the "after" location instead.

41.8.5.16 Time Displayed in Table or Pivot View Title May Be Incorrect after Insertion

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

If "Display time to be shown in the title" is selected for a table or pivot view, the time shown in the title after the table or pivot is inserted into Microsoft Office may be incorrect.

41.8.5.17 Graphs May Be Displayed Differently After Insertion into Microsoft Office

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Graphs that are inserted into Microsoft Office may be plotted differently in Microsoft Office than they are in Oracle BI EE. In horizontal bar graphs, the horizontal-axis series may be displayed in reverse order. In stacked graphs, the stack order may be reversed. This is caused by the Microsoft graph engine.

41.8.5.18 Legends in Bubble and Scatter Graphs May Display Differently After Insertion into Microsoft Office

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

Legends in bubble and scatter graphs displayed in Microsoft Office do not include coordinate values on the horizontal axis. This means that the number of legends as well as the colors displayed for each data series may not match those displayed in Oracle BI EE.

This issue has no workaround.

41.8.5.19 Help System Does Not Work When Running Oracle BI Office for PowerPoint in Norwegian or Polish

Impacted Releases: 11.1.1.6

When running Oracle BI Office for PowerPoint in Norwegian or Polish, clicking Oracle BI Help has no effect. The expected behavior is to display the help system in English.

The workaround is as follows:

1. Navigate to the <Oracle BI Office installation folder>\BIOfficePowerPoint\Help directory. For example, C:\Program Files\Oracle\BIOfficePowerPoint\Help.

2. Copy powerpointaddin_help.chm, paste it twice, and rename one powerpointaddin_helpno.chm and the other powerpointaddin_helppl.chm.

41.9 Oracle Business Intelligence Mobile Issues and Workarounds

This section describes issues and workarounds related to Oracle Business Intelligence Mobile. It includes the following topics:

- Section 41.9.1, "No Scrolling to View Offscreen Content If User Language is Arabic or Hebrew"

- Section 41.9.2, "Bi-directional Text Layout Not Supported by BI Mobile Client Shell UI"

- Section 41.9.3, "Mobile Device Accessibility Features May Not Work With Oracle BI Mobile Application"

- Section 41.9.4, "Failure of ODBC Data Source Administrator on Windows Server"

- Section 41.9.5, "Briefing Books Content Visible in User's Catalog Is Not Viewable in the Mobile Application"

- Section 41.9.6, "Multitasking Gestures on iPad iOS 4 and iOS 5 Are Not Supported"

- Section 41.9.7, "BI Publisher Prompts Viewed in BI Mobile Display Differently Than in the Desktop Application"

41.9.1 No Scrolling to View Offscreen Content If User Language is Arabic or Hebrew

Impacted Releases: 11.1.1.5, 11.1.1.6

This visibility issue applies only to BI content that would be hidden offscreen until scrolling over to see it. If the user language has been set to Arabic or Hebrew, then you cannot drag or scroll to view further BI content in the Oracle Business Intelligence Mobile application on your iPhone or iPad.

41.9.2 Bi-directional Text Layout Not Supported by BI Mobile Client Shell UI

Impacted Releases: 11.1.1.5, 11.1.1.6

When using the Oracle Business Intelligence Mobile client with a bi-directional language like Hebrew or Arabic, the client shell does not show the layout correctly.

41.9.3 Mobile Device Accessibility Features May Not Work With Oracle BI Mobile Application

Impacted Releases: 11.1.1.5, 11.1.1.6

Apple iPhone and iPad accessibility features such as VoiceOver and Mono Audio might not work or might work only partially in the Oracle Business Intelligence Mobile application.

This issue has no workaround.

41.9.4 Failure of ODBC Data Source Administrator on Windows Server

After creating a system DSN, ODBC Data Source Administrator fails to work on Windows 2008 R2 x64 bit servers and Windows 7 x64 bit servers.

Though the tool malfunctions, the creation of DSN and its connectivity works fine.

The workaround is to ignore the ODBC Data Source Administrator failure.

41.9.5 Briefing Books Content Visible in User's Catalog Is Not Viewable in the Mobile Application

Impacted Releases: 11.1.1.5

Briefing books content is not supported in the Oracle Business Intelligence Mobile application in Release 11.1.1.5.0.

Users are unable to open a briefing book or view any content from a briefing book on the Oracle BI Mobile application. However, briefing books' titles might appear in the mobile application in a user's catalog or in a list of favorites.

41.9.6 Multitasking Gestures on iPad iOS 4 and iOS 5 Are Not Supported

Impacted Releases: 11.1.1.5, 11.1.1.6

Oracle Business Intelligence Mobile does not support the iOS 4 and iOS 5 fast application-switching multitasking feature. Therefore, if you switch from the Oracle BI Mobile application to another application and then return to the Oracle BI Mobile application, the Oracle BI Mobile application restarts. The Oracle BI Mobile application's state, resources, and user interface are not saved.

41.9.7 BI Publisher Prompts Viewed in BI Mobile Display Differently Than in the Desktop Application

Impacted Releases: 11.1.1.6

This issue applies only to BI Publisher reports. When you use a Release 11.1.1.5.0 or 11.1.1.6.0 BI Mobile client against a Release 11.1.1.6.0 server, some BI Publisher prompts behave differently than they do in the desktop application. For example:

- Text prompt. The prompt shows a list with default values; the prompt does not show the filter icon for changing the value.

- Date prompt. The prompt shows a list with default values; the prompt does not show the filter icon for changing the value.

- Radio buttons prompt. The prompt shows a list with default values; the prompt does not show the filter icon for changing the value.

- Checkboxes prompt. The prompt shows a menu allowing selection of a single value, rather than the multiple-value selection allowed in the desktop application.

41.10 Oracle BI Publisher Reporting and Publishing Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher. It includes the following topics:

- Section 41.10.1, "General Oracle BI Publisher Issues and Workarounds"

- Section 41.10.2, "Oracle BI Publisher Security Issues and Workarounds"

- Section 41.10.3, "Oracle BI Publisher Delivery Manager Issues and Workarounds"

- Section 41.10.4, "Oracle BI Publisher Scheduler Issues and Workarounds"

- Section 41.10.5, "Oracle BI Publisher RTF Template Issues and Workarounds"

- Section 41.10.6, "Oracle BI Publisher Excel Template Issues and Workarounds"

- Section 41.10.7, "Oracle BI Publisher Desktop Tools Issues and Workarounds"

- Section 41.10.8, "Oracle BI Publisher Layout Editor Issues and Workarounds"

- Section 41.10.9, "Oracle BI Publisher Data Model Issues and Workarounds"

- Section 41.10.10, "Oracle BI Publisher Report Building Issues and Workarounds"

- Section 41.10.11, "Oracle BI Publisher Documentation Errata"

41.10.1 General Oracle BI Publisher Issues and Workarounds

This section describes general issues and workarounds related to Oracle BI Publisher. It includes the following topics:

- Section 41.10.1.1, "JDBC Driver Throws Unsupported Function for setBigDecimal"

- Section 41.10.1.2, "Searching the Catalog from the Oracle BI Publisher User Interface Does Not Work When BI Publisher Is Integrated with Oracle BI Enterprise Edition"

- Section 41.10.1.3, "Data Source List in BI Publisher Administration Page Includes Data Sources That Are Not Supported"

- Section 41.10.1.4, "Menu Items Do Not Display When Using Internet Explorer 7 with a Bidirectional Language Preference"

- Section 41.10.1.5, "Data Source Definition for Microsoft SQL Server 2008 Analysis Services Does Not Get Saved"

- Section 41.10.1.6, "Issues with Viewing Some Report Formats on Apple iPad"

- Section 41.10.1.7, "BI Publisher Objects Exhibit Unexpected Behavior When Located Inside a Folder Named with a Single Quote Character"

- Section 41.10.1.8, "Components Folder Missing from SampleApp Lite Web Catalog"

- Section 41.10.1.9, "Boilerplate Templates in the Components Folder Do Not Display Table Borders Properly in Chrome Browsers"

- Section 41.10.1.10, "Local Policy Attachments (LPAs) Removed from Web Services in Release 11.1.1.5"

- Section 41.10.1.11, "Oracle BI Publisher Requires Oracle WebLogic Server to Run in en_US Locale"

- Section 41.10.1.12, "Search May Return Incorrect Number of Results"

- Section 41.10.1.13, "Schedule Report Option Does Not Appear Correctly for Non-Admin Users"

41.10.1.1 JDBC Driver Throws Unsupported Function for setBigDecimal

Impacted Releases: 11.1.1.5, 11.1.1.6

Data models that include a link between a data set of SQL query type against an Oracle database and a data set of SQL query type against the BI Server based on a numeric database column (used to create a parent-child hierarchical XML data structure with the SQL query against the Oracle database as the parent data set) fail to execute and return the following error: "Java.sql.SQLException: unsupported function at oracle.bi.jdbc.AnaJdbcPreparedStatement.setBigDecimal."

41.10.1.2 Searching the Catalog from the Oracle BI Publisher User Interface Does Not Work When BI Publisher Is Integrated with Oracle BI Enterprise Edition

Impacted Releases: 11.1.1.5

When Oracle BI Publisher is installed in integrated mode with Oracle BI EE, searching the catalog from the BI Publisher user interface (that is, the URL is of the form "http://<host>:<port>/xmlpserver/...") does not work and the following message is returned:

Result Not found
Your search - <search criteria> - did not match any documents.

The workaround is to search the catalog from the Oracle BI EE user interface (that is, the URL is of the form "http://<host>:<port>/analytics/...").

41.10.1.3 Data Source List in BI Publisher Administration Page Includes Data Sources That Are Not Supported

Impacted Releases: 11.1.1.5

When configuring a JDBC data source connection or an OLAP connection, the list provided in the BI Publisher Add Data Source page may include data sources that are not supported in this release. For the most current list of supported data sources, refer to the "System Requirements and Supported Platforms for Oracle Business Intelligence Suite Enterprise Edition 11gR1." The system requirements document is available from this link:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

It is listed with the documents grouped under the Product Area "Additional Oracle Fusion Middleware 11g Release 1 (11.1.1.x) Certifications."

41.10.1.4 Menu Items Do Not Display When Using Internet Explorer 7 with a Bidirectional Language Preference

Impacted Releases: 11.1.1.5, 11.1.1.6

If you are using Internet Explorer 7 as the Web browser and you have selected a bidirectional language for your user interface preference (such as Arabic or Hebrew), then the menu options from the global header do not display.

To work around this problem, use Internet Explorer 8 or another supported Web browser.

41.10.1.5 Data Source Definition for Microsoft SQL Server 2008 Analysis Services Does Not Get Saved

Impacted Releases: 11.1.1.3, 11.1.1.5

When you create an OLAP data source connection to a Microsoft SQL Server 2008 Analysis Services data source in the BI Publisher Administration interface, the data source is not saved after you click the Apply button, even though the connection test succeeds.

To work around this issue, select "Microsoft SQL Server 2005 Analysis Services" as the OLAP Type from the list. Enter the same connection information and click Apply.

41.10.1.6 Issues with Viewing Some Report Formats on Apple iPad

Impacted Releases: 11.1.1.5, 11.1.1.6

The Apple iPad does not provide a default viewer for the following output formats:

- MHTML (impacts Excel and PowerPoint)

- RTF

The viewer provided for PowerPoint 2007 might distort the layout of characters.

The default PDF viewer has the following issues:

- Form fields are ignored
The iPad PDF reader cannot support editable PDF form fields, however, you can still generate the report with static text in the fields. To generate the report with static text, set the report property "Remove PDF fields from output" to True. For information on setting report properties see "Configuring Report Properties" in Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher.

- Secured PDF files do not display at all

- Signature fields are ignored

- Bookmarks are ignored

- Attachments are ignored

- Flush does not work

- "Read Out Loud" accessibility feature does not work

Note that these issues are limitations of the provided iPad file readers and cannot be resolved by Oracle.

41.10.1.7 BI Publisher Objects Exhibit Unexpected Behavior When Located Inside a Folder Named with a Single Quote Character

Impacted Releases: 11.1.1.3, 11.1.1.5

In the Oracle BI Presentation Catalog, if a folder name contains the single quote character (') BI Publisher reports that reside in that folder do not run and data models might throw unexpected errors. The behavior varies depending on the Web browser.

To work around this issue, do not include single quotes in the names of folders that contain BI Publisher objects.

41.10.1.8 Components Folder Missing from SampleApp Lite Web Catalog

Impacted Releases: 11.1.1.5

Version 11.1.1.5 of the SampleApp Lite Web catalog is missing the Components folder. As a result, shared boilerplates are unavailable when user creates a new BI Publisher type layout for a BI Publisher report. To work around this issue:

1. Log in with administrator credentials and navigate to the BI Publisher Administration > Server Configuration page.

2. Under the Catalog region, ensure that the BI Publisher Repository field points to the default path:
<Install_Home>/user_projects/domains/bifoundation_domain/config/bipublisher/repository

Then click the Upload to BI Presentation Catalog button.

3. Navigate to the Catalog page and verify that the Components folder is present under Shared Folders.

Note that this also installs additional BI Publisher sample reports included in the Samples folder. Many of these reports require that the Demo JDBC connection to the OE sample schema, included in Oracle Database, is configured.

41.10.1.9 Boilerplate Templates in the Components Folder Do Not Display Table Borders Properly in Chrome Browsers

Impacted Releases: 11.1.1.6

Several of the Boilerplate templates in the Components folder included in version 11.1.1.6 of the SampleApp Lite OBIEE Web catalog, when used as the starting point to create an XPT layout, do not display table borders properly in Chrome Browsers. To correct this behavior, replace the Components folder in SampleApp Lite OBIEE Web catalog with the one included with the BI Publisher standalone repository. To do so:

1. Log in with administrator credentials and navigate to the BI Publisher Administration > Server Configuration page.

2. Under the Catalog region, ensure that the BI Publisher Repository field points to the default path:
<Install_Home>/user_projects/domains/bifoundation_domain/config/bipublisher/repository

Then click the Upload to BI Presentation Catalog button.

3. Navigate to the Catalog page and verify that the Components folder is present under Shared Folders.

Note that this also installs additional BI Publisher sample reports included in the Samples folder. Many of these reports require that the Demo JDBC connection to the OE sample schema, included in Oracle Database, is configured.

41.10.1.10 Local Policy Attachments (LPAs) Removed from Web Services in Release 11.1.1.5

Impacted Releases: Upgrades from 11.1.1.3 to 11.1.1.6

In Release 11.1.1.5, the local policy attachments were removed from the BI Publisher Web services. If you were using the BI Publisher Web services in Release 11.1.1.3 and you upgrade to 11.1.1.5, then you must perform the following to add a Global Policy Attachment (GPA):

1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

2. In the left pane, click WegLogic Domain, and then click bifoundation_domain.

3. In the right pane, click the WebLogic Domain menu and select Web Services and then Policy Sets.

4. Click Create to create a new policy set.

5. Enter the following general information:

- Name - enter any name you choose

- Enabled - select this box

- Type of Resources - Web Service Endpoint

- Description: This GPA will be applied for all JRF-based Web services
Click Next.

6. Enter "*" for the Domain Name value. Click Next.

7. Select the following policy, then click Attach:
oracle/wss11_saml_or_username_token_with_message_protection_service_policy

8. Click Next, then click Save. Wait for WebLogic Server to pick up the changes.

9. In a browser, enter the following URL to verify that the policy you entered is available in the WSDL:
http://server:port/xmlpserver/services/PublicReportWSSService?wsdl

41.10.1.11 Oracle BI Publisher Requires Oracle WebLogic Server to Run in en_US Locale

Impacted Release: 11.1.1.3

The XDK used by Oracle BI Publisher requires the JVM of the Oracle WebLogic Server to run in en-US locale. Otherwise, functions (such as sum) generate values that cannot be formatted with its number format functions.

To work around this problem, in the script startWebLogic.cmd add the following line to set the required options:

set JAVA_OPTIONS=-Dfile.encoding=UTF-8 -Duser.language=en -Duser.region=US %JAVA_OPTIONS%

For information on setting Java options in the Oracle WebLogic Server Administration Console, see the topic "Set Java options for servers started by Node Manager" in the Oracle Fusion Middleware Oracle WebLogic Server Administration Console Online Help.

41.10.1.12 Search May Return Incorrect Number of Results

Impacted Release: 11.1.1.6

Searching for catalog items may yield more results than there actually are. For example, a search on all types of catalog items using "Salary" may show well over 100 results on the first page of the search results, even though there are far fewer actual results.

To find the correct set of results, click the Next button at the bottom of the Result page, then page through the results to find the item that you want.

41.10.1.13 Schedule Report Option Does Not Appear Correctly for Non-Admin Users

Impacted Release: 11.1.1.6

Users with a role other than Administrator (for example: BI Author and BI Consumer) will not see the Schedule action link under report entries in the catalog; nor will they see the Schedule option under the Action menu when viewing a report.

To work around this issue, users can schedule report jobs by using the "New" menu from the global header or by selecting "Report Job" under the Create section on the Home page.

41.10.2 Oracle BI Publisher Security Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher security. It includes the following topic:

- Section 41.10.2.1, "Limitations for Administrator Username in LDAP Security Model"

41.10.2.1 Limitations for Administrator Username in LDAP Security Model

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

If you are using LDAP security model for standalone BI Publisher, the LDAP Administrator Username that you enter on the BI Publisher Security Configuration page must be one of the following.

- Admin User defined under "Distinguished Name for Users"

- Admin User with only cn (like cn=Directory Manager) without dc=...

If the Administrator Username entered is not one of the supported options, scheduled jobs will fail with an impersonation error.

41.10.3 Oracle BI Publisher Delivery Manager Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher Delivery Manager.

There are no known issues at this time.

41.10.4 Oracle BI Publisher Scheduler Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher Scheduler. It includes the following topics:

- Section 41.10.4.1, "Scheduler Does Not Support Multibyte Characters When Schema Installed on Microsoft SQL Server"

- Section 41.10.4.2, "URL in E-mail Notification of Recurring or Future-Dated Jobs May Fail to Display Job History for the Job"

41.10.4.1 Scheduler Does Not Support Multibyte Characters When Schema Installed on Microsoft SQL Server

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

If you are using Microsoft SQL Server as the BI Publisher scheduler database, using multibyte characters in the Schedule Report Job page might result in a garbled character display. To work around this issue, do not use multibyte characters in the Schedule Report Job submission page.

41.10.4.2 URL in E-mail Notification of Recurring or Future-Dated Jobs May Fail to Display Job History for the Job

Impacted Releases: 11.1.1.6

During upgrade, the data in 10g scheduler schema will be migrated to 11g scheduler schema. If a report was scheduled in 10g as a recurring job or as a future-dated job and the e-mail notification was set for this job for successful completion/completion with warning/failure, then, after upgrade, the e-mail notification View History URL still points to the 10g server. Clicking the URL in the notification will fail to display job history for the job.

To work around this issue:

1. After invoking the browser to display the View History page, manually edit the server name and port in the browser address bar to point to the 11g environment and then press Enter.

2. Log in to the 11g server when prompted to view the report history.

41.10.5 Oracle BI Publisher RTF Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher RTF templates. It includes the following topic:

- Section 41.10.5.1, "RTF Templates in 11g Require Number Conversion on String Expressions"

41.10.5.1 RTF Templates in 11g Require Number Conversion on String Expressions

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

The XPath expression in 10g RTF templates that uses XDK 10g allows automatic type conversion for number to string conversion and for string to number conversion. The XPath expression in 11g RTF templates that uses XDK 11g has disabled the automatic type conversion as per the W3C specifications of XSL 2.0. Therefore, expressions that worked in 10g may not work in 11g.

Example 1:

In 10g the following expression returns the expected results:

concat(((ceiling(substring(Order_Date,6,2) div 3) * 3) - 2), '/',   substring(Order_Date,1,4))

In 11g, this expression will fail for the following reasons:

- The XPath "substring(Order_Date,6,2) div 3" is invalid in XSL 2.0 because the value from substring(...) is a string type, and the DIV operator cannot operate on a string value.

- The result of XPath "((ceiling(substring(Order_Date,6,2) div 3) * 3) - 2)" is a number type. The concat(...) function expects a list of string type parameters

To achieve the desired results in 11g, enter the following instead:

concat(string((ceiling(number(substring(Order_Date,6,2)) div 3) * 3) - 2),   '/', substring(Order_Date,1,4))

Example 2:

The following functions return a string data type and any calculation in 10g will work on these functions:

xdoxslt:minimum(...)
xdoxslt:maximum(...)

In 11g, to perform a calculation on these functions, you must convert them into a number data type as follows:

number(xdoxslt:minimum(...))
number(xdoxslt:maximum(...))

41.10.6 Oracle BI Publisher Excel Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher Excel templates. It includes the following topic:

- Section 41.10.6.1, "Limitations for Excel Template Output on Apple iPad"

41.10.6.1 Limitations for Excel Template Output on Apple iPad

Impacted Releases: 11.1.1.5, 11.1.1.6

Due to limitations with the native Excel reader on the Apple iPad, Excel template output documents will have the following limitations when viewed on the iPad:

- Formulas intended to dynamically calculate in the output will not work

- Macros will not execute

- Pivot tables cannot be refreshed

- Hyperlinks will not work

- Workbook headers and footers will not display

- If using the Oracle Business Intelligence Mobile application on an iPad, the parameters will not show. However, if accessing the report via the Safari browser, the parameters will display.

41.10.7 Oracle BI Publisher Desktop Tools Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher desktop tools. It includes the following topics:

- Section 41.10.7.1, "Oracle BI Publisher's Template Builder for Microsoft Word Is Not Compatible with Microsoft Office Live Add-in"

- Section 41.10.7.2, "Excel Analyzer Does Not Support 64-Bit Windows Platform"

41.10.7.1 Oracle BI Publisher's Template Builder for Microsoft Word Is Not Compatible with Microsoft Office Live Add-in

Impacted Releases: 11.1.1.5, 11.1.1.6

Oracle BI Publisher´s Template Builder for Microsoft Word is not compatible with Microsoft Office Live Add-in. The presence of Microsoft Office Live Add-in might cause errors when attempting to install the Template Builder or other unexpected behavior.

To work around this issue, uninstall Microsoft Office Live Add-in.

41.10.7.2 Excel Analyzer Does Not Support 64-Bit Windows Platform

Impacted Releases: 11.1.1.6

Oracle BI Publisher´s desktop tool, the Analyzer for Excel does not support installation on Windows 64-bit platform. Support for 32-bit Windows platform is only available at this time.

41.10.8 Oracle BI Publisher Layout Editor Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher layout editor. It includes the following topic:

- Section 41.10.8.1, "Editing an XPT Layout and Clicking Return in Layout Editor Results in Exception"

41.10.8.1 Editing an XPT Layout and Clicking Return in Layout Editor Results in Exception

Impacted Releases: 11.1.1.3, 11.1.1.5

When viewing a report using a layout that is not set as the Default Layout, and you select Edit Layout from the Report Viewer's action drop-down menu to open the layout in the layout editor, and then you click Return, you might encounter the following issue: The Report Viewer tries to open the report using the default output format (PDF, HTML, and so on) specified for the default layout. This might cause the report to fail with the following error if the default output format for the default layout is not one of the output formats allowed for the selected layout:

The report cannot be rendered because of an error, please contact the administrator. Error Detail oracle.xdo.servlet.data.DataException: Invalid format requested: html

41.10.9 Oracle BI Publisher Data Model Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher data models. It includes the following topics:

- Section 41.10.9.1, "Data Model Is Not Editable When Created by Upgrade Assistant"

- Section 41.10.9.2, "After Editing a View Object Data Set, the Elements Are Duplicated"

41.10.9.1 Data Model Is Not Editable When Created by Upgrade Assistant

Impacted Releases: 11.1.1.5, 11.1.1.6

A report that is upgraded from Release 10g to 11g will have a report and a data model created by the Upgrade Assistant. The upgraded data model when seen in the data model editor will not show diagram, data structure and the equivalent code for the data structure. Moreover, the developer or administrator will not be able to edit the data structure. This means that the data model will not allow the developer or administrator to use the Release 11g features editable XML View and Business View.

The workaround is as follows:

1. Open the data model for editing.

2. Copy the SQL query statement from the data set.

3. Create a new data set in the same data model. The following warning is displayed:
"Adding this type of Data Set may break layouts that refer to this data model."

4. Click OK.

5. Paste the SQL query into the new data set dialog.

6. Enter a name for the dataset.

7. Click OK.

8. Delete the original data set. The following warning is displayed:
"This item is set as main dataset. Do you want to delete this item?"

9. Click OK.

10. Change the data structure in XML View to reflect ROWSET/ROW structure of XML.

11. Save the data model.

41.10.9.2 After Editing a View Object Data Set, the Elements Are Duplicated

Impacted Releases: 11.1.1.3, 11.1.1.5

In the data model editor if you edit a data set of the type View Object, after you click OK, all the elements in the data set will be duplicated.

To work around this issue, you must delete the data set and recreate it.

41.10.10 Oracle BI Publisher Report Building Issues and Workarounds

This section describes issues and workarounds related to building reports with Oracle BI Publisher. It includes the following topic:

- Section 41.10.10.1, "No Direct Conversion Between Oracle Reports and Oracle BI Publisher 11g"

41.10.10.1 No Direct Conversion Between Oracle Reports and Oracle BI Publisher 11g

Impacted Releases: 11.1.1.5, 11.1.1.6

There is no direct conversion between Oracle Reports and Oracle BI Publisher 11g. To convert a report created in Oracle Reports to an Oracle BI Publisher report, follow the two step process:

1. Convert the Oracle Reports report to an Oracle BI Publisher 10g report following the instructions in Oracle Business Intelligence Publisher Report Designer's Guide(10g):
http://download.oracle.com/docs/cd/E12844_01/doc/bip.1013/e12187/T518230T518393.htm

2. Upgrade Oracle BI Publisher 10g to Oracle BI Publisher 11g following the instructions in Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence 11g Release 1 (11.1.1).

41.10.11 Oracle BI Publisher Documentation Errata

This section describes Oracle BI Publisher documentation errata. It includes the following topics:

- Section 41.10.11.1, "Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher"

- Section 41.10.11.2, "Oracle Fusion Middleware Administrator's Guide for Oracle Business Intelligence Publisher"

41.10.11.1 Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher

This section describes documentation errata in Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher. It includes the following topics:

- Section 41.10.11.1.1, "Syntax Error in "Column Formatting" Section of the "Creating an RTF Template" Chapter"

- Section 41.10.11.1.2, "Required Location of ICC Profile Data File for PDF/X and PDF/A Output Incorrectly Documented"

41.10.11.1.1 Syntax Error in "Column Formatting" Section of the "Creating an RTF Template" Chapter

In the "Creating an RTF Template" chapter, under the topic "Conditional Formatting," and subtopic "Column Formatting," the example contains a syntax error.

Impacted Releases: 11.1.1.3, 11.1.1.5

In the table that begins on page 74-68 of the PDF version of the book, the second "IF" statement entry (that precedes the entry "20") incorrectly shows the Form Field Entry as <?if@column:/items/@type="PRIVATE"?>

The correct entry is:

<?if@cell:/items/@type="PRIVATE"?>

41.10.11.1.2 Required Location of ICC Profile Data File for PDF/X and PDF/A Output Incorrectly Documented

Impacted Release: 11.1.1.6

BI Publisher includes a set of run-time properties to configure the new output types PDF/A and PDF/X. The PDF/X output type requires the setting of the property "PDF/X ICC Profile Data". For PDF/A, the setting of "PDF/A ICC Profile Data" is optional. The description of these properties in the "Setting Report Processing and Output Document Properties" chapter incorrectly states that the value of each property must be the path to the profile data file. Instead, the profile data file must be placed under <bi publisher repository>/Admin/Configuration and the value of the property must be the file name. Table 41-2 provides a detailed revision of the two required PDF/X properties: PDF/X ICC Profile Data and PDF/X output condition identifier.

Table 41-2 PDF/X Output Properties

Property Name

Description

PDF/X ICC Profile Data

Default: None

Description: (Required) The name of the ICC profile data file, for example: CoatedFOGRA27.icc.

The ICC (International Color Consortium) profile is a binary file describing the color characteristics of the intended output device. (For more information, see the article at http://en.wikipedia.org/wiki/ICC_profile). For production environments, the color profile may be provided by your print vendor or by the printing company that prints the generated PDF/X file. The file must be placed under <bi publisher repository>/Admin/Configuration.

Profile data is also available from Adobe (http://www.adobe.com/support) or colormanagement.org (http://www.colormanagement.org/).

Internal Name: pdfx-dest-output-profile-data

PDF/X output condition identifier

Default: None

Description: (Required) The name of one of the standard printing conditions registered with ICC (International Color Consortium). The list of standard CMYK printing conditions to use with PDF/X-1a is provided on the following ICC website: http://www.color.org/chardata/drsection1.xalter. The value that you enter for this property is a valid "Reference name," for example: FOGRA43.

Choose the appropriate value for the intended printing environment. This name is often used to guide automatic processing of the file by the consumer of the PDF/X document, or to inform the default settings in interactive applications.

Internal Name: pdfx-output-condition-identifier

For PDF/A output, if you choose to set the "PDF/A ICC Profile Data" property, the ICC profile data file must also be placed under <bi publisher repository>/Admin/Configuration and the value of the property must be the file name.

41.10.11.2 Oracle Fusion Middleware Administrator's Guide for Oracle Business Intelligence Publisher

This section describes documentation errata in Oracle Fusion Middleware Administrator's and Developer's Guide for Oracle Business Intelligence Publisher.

There are no known issues at this time.

41.11 Oracle Business Intelligence Metadata Repository Development Issues and Workarounds

This section describes issues and workarounds related to developing Oracle Business Intelligence metadata repositories. It includes the following topics:

- Section 41.11.1, "General Metadata Repository Development Issues and Workarounds"

- Section 41.11.2, "Oracle BI Server Issues and Workarounds"

- Section 41.11.3, "Oracle BI Administration Tool Issues and Workarounds"

41.11.1 General Metadata Repository Development Issues and Workarounds

This section describes general issues and workarounds related to developing Oracle Business Intelligence metadata repositories. It includes the following topics:

- Section 41.11.1.1, "Use of NQClient (BI ODBC Client) Utility Is Deprecated"

- Section 41.11.1.2, "Update Logical Table Source Modeling when Using paint.rpd for Testing"

- Section 41.11.1.3, "FIRST and LAST Aggregation Rules Cause Inconsistent Sorting for Time Dimensions"

- Section 41.11.1.4, "Oracle OLAP Jars on JavaHost Computer Must Be Updated When Using Oracle OLAP 11.2.x"

- Section 41.11.1.5, "Must Use JDBC Connection String When Importing from Oracle OLAP"

41.11.1.1 Use of NQClient (BI ODBC Client) Utility Is Deprecated

Impacted Releases: 11.1.1.5

The NQClient (BI ODBC Client) utility was fully deprecated in Release 11g (11.1.1.3) and should not be used. Instead, use the nqcmd utility or one of the many widely available third-party ODBC/JDBC tools to satisfy previous NQClient functionality.

41.11.1.2 Update Logical Table Source Modeling when Using paint.rpd for Testing

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

In paint.rpd, aggregated data at different levels is stored in the same fact table, which means that the same physical fact table is mapped to the logical table at different levels. To ensure that only rows from one level are returned, WHERE clause filters such as LEVELX = 'MONTH' or LEVELX = 'YEAR' exist in the logical table sources.

In releases prior to Oracle BI EE 11g Release 1 (11.1.1.3), if two logical table sources for the same logical table were mapped to the same physical table, and both logical table sources were used in a query, and both logical table sources had a WHERE clause filter, then the filter from only one of the logical table sources was applied. The other WHERE clause filter was ignored.

Starting with Oracle BI EE 11g Release 1 (11.1.1.3), in this situation, the WHERE clause filters from both logical table sources are applied to the query. Because of this, when paint.rpd queries select attributes from multiple levels, then the query hits multiple logical table sources, and the WHERE clause filters added to the query contradict one another. For example, the following condition is always false because LEVELX cannot be both MONTH and YEAR at the same time:

T863.LEVELX = 'MONTH' and T863.LEVELX = 'YEAR'

If you use paint.rpd for testing, then use one of the following methods to correct the modeling:

- Use physical table aliases to ensure that the same physical table is not mapped to the logical table at different levels.

- Disable the higher-level logical table source so that the query hits only the detailed logical table source.

Note that paint.rpd is not optimized for this release of Oracle BI EE and should not be used as a basis for any repositories in production environments. Consider using SampleApp.rpd instead. You can find the full version of SampleApp.rpd at:

http://oracle.com/technetwork/middleware/bi-foundation/obiee-samples-167534.html

41.11.1.3 FIRST and LAST Aggregation Rules Cause Inconsistent Sorting for Time Dimensions

Impacted Releases: 11.1.1.3, 11.1.1.5

The FIRST and LAST aggregation rules always use the primary level key to determine the sort order of the dimension members. This might cause inconsistent sort order for time dimensions, because the primary level key is used for the sort rather than the chronological key.

To work around this issue, specify the same column used for the chronological key as the primary level key.

41.11.1.4 Oracle OLAP Jars on JavaHost Computer Must Be Updated When Using Oracle OLAP 11.2.x

Impacted Releases: 11.1.1.5, 11.1.1.6

Currently, Oracle BI EE includes the 11.1.x version of the OLAP API jar file (olap_api.jar). If you are using Oracle OLAP version 11.2.x as a data source for Oracle BI EE, you must update the OLAP API jar file on all computers running the JavaHost process to version 11.2.x.

To update the olap_api.jar file used by Oracle Business Intelligence Enterprise Edition to version 11.2.x:

1. Back up the current olap_api.jar file used by Oracle Business Intelligence Enterprise Edition at:

ORACLE_BI_EE_HOME/bifoundation/javahost/lib/obisintegration/aw/11g

2. Copy the olap_api.jar file from your Oracle Database home at:

ORACLE_DB_HOME/product/11.2.0/dbhome_1/olap/api/lib

3. Paste the copied jar to the Oracle BI EE location:

ORACLE_BI_EE_HOME/bifoundation/javahost/lib/obisintegration/aw/11g

41.11.1.5 Must Use JDBC Connection String When Importing from Oracle OLAP

Impacted Releases: 11.1.1.5, 11.1.1.6

Because the Administration Tool uses the JavaHost process to connect to Oracle OLAP data sources for metadata import, which uses JDBC to connect rather than OCI, you must provide a fully-qualified JDBC connection string (host:port:sid) for Data Source Name in the Import Wizard in the Administration Tool when importing from Oracle OLAP sources. Ensure that the JavaHost process can connect to the Oracle OLAP data source using this connection string.

After import is complete, you must update the connection pool object in the Physical layer for the Oracle OLAP source to change the Data Source Name to a valid OCI value, either a net service name or a full OCI connect string.

41.11.2 Oracle BI Server Issues and Workarounds

This section describes issues and workarounds related to the Oracle BI Server. It includes the following topic:

- Section 41.11.2.1, "Oracle Call Interface (OCI) Issue Causes Oracle BI Server Crash on Windows when Under Heavy Load and Connecting to Oracle Database 11g"

41.11.2.1 Oracle Call Interface (OCI) Issue Causes Oracle BI Server Crash on Windows when Under Heavy Load and Connecting to Oracle Database 11g

Impacted Releases: 11.1.1.5, 11.1.1.6

Due to an issue in the Oracle Call Interface (OCI) client for the Oracle Database 11g, unexpected Oracle BI Server crashes might occur when the BI Server is running on Microsoft Windows platform and there are a significant number of concurrent users attempting to connect to the Oracle Database 11g.

The workaround is to apply a Windows patch bundle for Oracle Database Client 11.1.0.7, patch bundle 27 or higher.

41.11.3 Oracle BI Administration Tool Issues and Workarounds

This section describes issues and workarounds related to the Oracle BI Administration Tool. It includes the following topics:

- Section 41.11.3.1, "Administration Tool Incorrectly Displays Option for Generate Deployment File"

- Section 41.11.3.2, "Issue with Online Import Object Checkout"

- Section 41.11.3.3, "Ignore RPD Consistency Warnings Related to Required Database Feature Changes for Oracle OLAP"

- Section 41.11.3.4, "Select Nullable Option for Root Member of Parent-Child Hierarchies from OLAP Sources"

- Section 41.11.3.5, "The Administration Tool Fails to Launch from the Start Menu"

41.11.3.1 Administration Tool Incorrectly Displays Option for Generate Deployment File

Impacted Releases: 11.1.1.5, 11.1.1.6

The Administration Tool provides an option in the Tools > Utilities window for Generate Deployment File. This option appears in error and should not be used.

41.11.3.2 Issue with Online Import Object Checkout

Impacted Releases: 11.1.1.5, 11.1.1.6

When using the Administration Tool to import objects in online mode, related objects are not properly checked out. This can lead to repository corruption.

The workaround is to check out all objects before performing the import in online mode. To check out all objects, from the menu bar, select Tools, then select Check Out All.

41.11.3.3 Ignore RPD Consistency Warnings Related to Required Database Feature Changes for Oracle OLAP

Impacted Releases: 11.1.1.5, 11.1.1.6

When using Oracle OLAP as a data source, the database type is set to Oracle 11g. However, Oracle OLAP data sources might require changes to the default set of database features for Oracle 11g, such as setting ISDESCENDANT_SUPPORTED to YES to enable parent-child hierarchies.

When the set of database features is changed from the default set, RPD consistency warnings occur when running the Consistency Checker. These warnings should be ignored.

41.11.3.4 Select Nullable Option for Root Member of Parent-Child Hierarchies from OLAP Sources

Impacted Releases: 11.1.1.5

For parent-child hierarchies in the Physical layer from OLAP data sources, you must manually select the Nullable option in the Physical Cube Column dialog for the root member. This option must be selected for the root member for parent-child hierarchies (also called value-based hierarchies) to work correctly.

Alternatively, you can download and apply patch 12897870 as an alternative to manually setting the Nullable option. See Section 41.1.1, "Obtaining Patches from My Oracle Support" for more information about downloading patches.

41.11.3.5 The Administration Tool Fails to Launch from the Start Menu

Impacted Releases: 11.1.1.6.0

The Administration Tool fails to launch from Start menu in a non-English Windows 7 64-bit client installation. This is caused by the SERVER EVENT MSG MISSED.

The workaround is to launch the Administration Tool from ORACLE_HOME\bifoundation\server\bin directly as follows:

1. In Windows Explorer, go to the following location:

ORACLE_HOME/bifoundation/server/bin

2. Double-click bi-init.cmd to display a command prompt that is initialized to your Oracle instance.

3. At the command prompt, type admintool and press Enter.

41.12 Oracle Business Intelligence System Administration Issues and Workarounds

This section describes issues and workarounds related to Oracle Business Intelligence system administration. It includes the following topics:

- Section 41.12.1, "General System Administration Issues and Workarounds"

- Section 41.12.2, "Configuration Issues and Workarounds"

- Section 41.12.3, "Deployment, Availability, and Capacity Issues and Workarounds"

- Section 41.12.4, "Sign-in and Security Issues and Workarounds"

- Section 41.12.5, "Oracle BI Scheduler Issues and Workarounds"

Depending on your Oracle Fusion Middleware implementation, some information in Chapter 4, "Oracle Fusion Middleware Administration" and Chapter 5, "Oracle Enterprise Manager Fusion Middleware Control" might also be relevant.

41.12.1 General System Administration Issues and Workarounds

This section describes general issues and workarounds related to Oracle Business Intelligence system administration.

There are no known issues at this time.

41.12.2 Configuration Issues and Workarounds

This section describes issues and workarounds related to configuring Oracle Business Intelligence components (including Answers, Dashboards, Agents, and the Oracle BI Presentation Catalog). It includes the following topic:

- Section 41.12.2.1, "Removal of DefaultImageType and HardenXSS Elements"

41.12.2.1 Removal of DefaultImageType and HardenXSS Elements

Impacted Releases: 11.1.1.5

In Release 11.1.1.5, the following elements are no longer supported and should be removed from the instanceconfig.xml file:

- DefaultImageType element

- HardenXSS element

If the instanceconfig.xml file includes the HardenXSS element when a user starts Oracle BI EE, then an error message is displayed. The error log file will state that startup was affected by the inclusion of the HardenXSS element.

The workaround is to remove the HardenXSS element from the instanceconfig.xml file.

41.12.3 Deployment, Availability, and Capacity Issues and Workarounds

This section describes issues and workarounds related to enterprise deployments of Oracle Business Intelligence where high availability, capacity, and performance are typically a priority.

These issues are described in Chapter 6, "Oracle Fusion Middleware High Availability and Enterprise Deployment" of this document.

41.12.4 Sign-in and Security Issues and Workarounds

This section describes issues and workarounds related to security and signing in to Oracle Business Intelligence.

Note:

If you are experiencing security-related issues after upgrading from an earlier release, then also refer to Section 41.6.2, "Security-related Upgrade Issues and Workarounds".

This section includes the following topic:

- Section 41.12.4.1, "Permission Required to Open Catalog Manager in Online Mode"

41.12.4.1 Permission Required to Open Catalog Manager in Online Mode

Impacted Releases: 11.1.1.5

Only users with the OPSS permission oracle.bi.presentation.catman.manageCatalog can open the Catalog Manager in online mode.

41.12.5 Oracle BI Scheduler Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Scheduler.

There are no known issues at this time.

41.13 Oracle Business Intelligence Integration and API Issues and Workarounds

This section describes issues and workarounds related to integrating Oracle Business Intelligence with other products, including the use of Oracle Business Intelligence APIs. It includes the following topics:

- Section 41.13.1, "General Integration Issues and Workarounds"

- Section 41.13.2, "Oracle Business Intelligence API Issues and Workarounds"

41.13.1 General Integration Issues and Workarounds

This section describes general issues and workarounds related to integrating Oracle Business Intelligence with other products.

There are no known issues at this time.

41.13.2 Oracle Business Intelligence API Issues and Workarounds

This section describes issues and workarounds related to the use of Oracle Business Intelligence APIs.

There are no known issues at this time.

41.14 Oracle Exalytics In-Memory Machine Issues and Workarounds

This section describes issues and workarounds related to Oracle Exalytics In-Memory Machine. It includes the following topic:

- Section 41.14.1, "Manually Editing Properties for Full-Text Search"

41.14.1 Manually Editing Properties for Full-Text Search

Impacted Releases: 11.1.1.6

If you configure the Full-Text Search on the Exalytics Machine, you must manually edit the BISearchConfig.properties file so that the following properties point to the proper external IP addresses:

- BIServerUrl

- BISearchServerUrl

- ECSF_DataServiceURL

- ECSF_RedirectServiceURL

- ECSF_SecurityServiceURL

For information on editing the file, see "Configuring Properties for Full-Text Catalog Search Manually" in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

41.15 Oracle Business Intelligence Localization Issues and Workarounds

This section describes issues and workarounds related to integrating Oracle Business Intelligence with other products, including the use of Oracle Business Intelligence APIs. It includes the following topics:

- Section 41.15.1, "Product Localization Issues and Workarounds"

- Section 41.15.2, "Help System Localization Issues and Workarounds"

41.15.1 Product Localization Issues and Workarounds

This section describes issues and workarounds related to the localization of Oracle Business Intelligence products. It includes the following topics:

- Section 41.15.1.1, "Unable to Save Strings with Multibyte Characters to an External File Using ANSI Encoding"

- Section 41.15.1.2, "BI Publisher User Interface Components Do Not Support Supplementary Characters"

- Section 41.15.1.3, "Non-English Log Files Displayed Incorrectly in Fusion Middleware Control"

- Section 41.15.1.4, "Error Messages in BI Publisher Data Model Editor Honor Server Locale Setting"

- Section 41.15.1.5, "Incorrect Layout in Tables and Pivot Tables in PDF Files and PowerPoint Presentations When Locale for BI Server Is Arabic or Hebrew"

- Section 41.15.1.6, "Excel2007 Output in BI Publisher Does Not Honor Locale Settings for Number and Date Format"

- Section 41.15.1.7, "Excel2007 Output in BI Publisher Supports Gregorian Calendar Only"

- Section 41.15.1.8, "Template Builder for Microsoft Word Chart Wizard Does Not Format Dates"

- Section 41.15.1.9, "Number and Date Format Issues with Charts in BI Publisher Layout Templates"

41.15.1.1 Unable to Save Strings with Multibyte Characters to an External File Using ANSI Encoding

Impacted Releases: 11.1.1.5

When trying to export externalized strings that contain multibyte characters, the option to save the file using ANSI encoding does not work properly.

To work around this problem, save the file using UTF-8 or Unicode encoding.

41.15.1.2 BI Publisher User Interface Components Do Not Support Supplementary Characters

Impacted Releases: 11.1.1.3, 11.1.1.5

BI Publisher does not support supplementary characters in object names in the user interface, for example, report name, data model name, layout name, and so on. The data model editor does not support supplementary characters in SQL queries. The scheduler does not support supplementary characters in input fields such as e-mail subject and message fields.

To work around this issue, do not use supplementary characters in the BI Publisher user interface. If your database table and column names already include supplementary characters, you cannot use the data model editor to retrieve the data from these.

41.15.1.3 Non-English Log Files Displayed Incorrectly in Fusion Middleware Control

Impacted Releases: 11.1.1.5

You might have log files for Presentation Services, Oracle BI Scheduler, and Cluster Controller that have been translated to languages other than English. You might find that the content of these log files is not displayed correctly in the Diagnostic Log table and in tooltips in Fusion Middleware Control.

To work around this issue, enter the following property for logreader in the component-logs.xml file in the ORACLE_INSTANCE/config directory:

<property name="encoding" value="UTF-8"/>

Add the property in the component-logs.xml file in the following subdirectories: OracleBIPresentationServicesComponent, OracleBISchedulerComponent, and OracleBIClusterControllerComponent.

41.15.1.4 Error Messages in BI Publisher Data Model Editor Honor Server Locale Setting

Impacted Releases: 11.1.1.5, 11.1.1.6

Error messages invoked while working in the BI Publisher data model editor may display according to the server locale setting rather than the user interface locale setting.

This issue has no workaround.

41.15.1.5 Incorrect Layout in Tables and Pivot Tables in PDF Files and PowerPoint Presentations When Locale for BI Server Is Arabic or Hebrew

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

If the locale for the Oracle BI Server is Arabic or Hebrew, then no matter what the client locale for Presentation Services is, you will notice the following issues with tables and pivot tables in PDF files and PowerPoint presentations:

- The printed layout for tables and pivot tables is always Right to Left.

- Digit glyphs (such as number/date values) are always displayed as Arabic characters for Arabic only.

To work around this issue, perform the following steps:

1. Update the opmn.xml file in the following directory:
MWHOME/instances/instance1/config/OPMN/opmn/opmn.xml

2. Locate the XML node called <ias-component id="coreapplication_obijh1">.
The node should contain an XML node called

<process-type id="OracleBIJavaHostComponent" module-id="CUSTOM">

3. Under this process-type node, modify the value attribute of the node:
<data id="start-args" value="-server...

Add the following to the value attribute:

-Duser.language=en -Duser.region=US

4. Save your changes to the file and restart the JavaHost component.

41.15.1.6 Excel2007 Output in BI Publisher Does Not Honor Locale Settings for Number and Date Format

Impacted Releases: 11.1.1.5

The Excel2007 output format does not honor locale settings for some number and date fields coded to be locale-sensitive in the layout template.

41.15.1.7 Excel2007 Output in BI Publisher Supports Gregorian Calendar Only

Impacted Releases: 11.1.1.5, 11.1.1.6

The following calendars are not supported for Excel 2007 output format. The report output will revert to use the GREGORIAN calendar.

- ARABIC_HIJRAH

- ENGLISH_HIJRAH

- JAPANESE_IMPERIAL

- THAI_BUDDHA

- ROC_OFFICIAL (Taiwan)

41.15.1.8 Template Builder for Microsoft Word Chart Wizard Does Not Format Dates

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

When you drag and drop a date type value (for example: "1900-12-31T14:15:16.178-04:00") to the label of a chart, the value is not formatted according to the locale setting; instead, the value displays as given (that is, 1900-12-31T14:15:16.178-04:00").

To work around this issue, format the date in the data model; or, if you are familiar with XSL-T, manually change the date field using the function, for example: xdoxslt:xdo_format_date($_XDOXSLTCTX, (.//date)[1], 'MEDIUM')

41.15.1.9 Number and Date Format Issues with Charts in BI Publisher Layout Templates

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

When editing a BI Publisher layout template, if you add a number type column to the y-axis of a chart (for example, a vertical bar chart), the number format does not reflect the UI language. At runtime, the proper locale will be displayed in the Report Viewer.

When you add a date column to the x-axis, the raw data is displayed in the chart (that is, no format is applied at all). At run time, the date does respect the report locale for output types other than interactive and PowerPoint.

41.15.2 Help System Localization Issues and Workarounds

This section describes issues and workarounds related to the localization of Oracle Business Intelligence help systems. It includes the following topic:

- Section 41.15.2.1, "Oracle Business Intelligence Help Systems Are Not Translated"

41.15.2.1 Oracle Business Intelligence Help Systems Are Not Translated

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

In Release 11.1.1.3 and Release 11.1.1.5, none of the Oracle Business Intelligence help systems are translated.

In Release 11.1.1.6, the following Oracle Business Intelligence help systems are translated:

- Oracle BI Presentation Services Online Help

- Oracle Marketing Segmentation Online Help

- Oracle BI Add-in for Microsoft Office Online Help

For details of the languages into which the help systems have been translated, refer to the Oracle Business Intelligence certification document at:

http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

41.16 Oracle Business Intelligence Documentation Errata

This section describes errata in Oracle Business Intelligence documentation and help systems. It includes the following topics:

- Section 41.16.1, "General Oracle Business Intelligence Documentation Errata"

- Section 41.16.2, "Oracle Fusion Middleware Quick Installation Guide for Oracle Business Intelligence"

- Section 41.16.3, "Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence"

- Section 41.16.4, "Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.5, "Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.6, "Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Mobile"

- Section 41.16.7, "Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.8, "Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.9, "Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.10, "Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence"

- Section 41.16.11, "Oracle Fusion Middleware Developer's Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.12, "Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.13, "Oracle Fusion Middleware Installation and Administration Guide for Oracle Exalytics In-Memory Machine Guide"

- Section 41.16.14, "Oracle Fusion Middleware XML Schema Reference for Oracle Business Intelligence Enterprise Edition"

- Section 41.16.15, "Oracle Business Intelligence Help System Errata"

41.16.1 General Oracle Business Intelligence Documentation Errata

This section describes general errata in the Oracle Business Intelligence documentation.

There are no known issues at this time.

41.16.2 Oracle Fusion Middleware Quick Installation Guide for Oracle Business Intelligence

This section describes documentation errata in Oracle Fusion Middleware Quick Installation Guide for Oracle Business Intelligence.

There are no known issues at this time.

41.16.3 Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence

This section describes documentation errata in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence. It includes the following topic:

- Section 41.16.3.1, "List of Supported Oracle BI Client Tools for Microsoft Windows x64"

- Section 41.16.3.2, "Installation Guide Contains Misinformation About Installing the Client Tools"

41.16.3.1 List of Supported Oracle BI Client Tools for Microsoft Windows x64

Section 4.6.1, "Installing Oracle Business Intelligence Client Tools" of the Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence, incorrectly lists the following as not supported on Microsoft Windows x64:

- Oracle Business Intelligence ODBC Driver

- Oracle Business Intelligence JDBC Driver

41.16.3.2 Installation Guide Contains Misinformation About Installing the Client Tools

Impacted Releases: 11.1.1.5

Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence contains the following misinformation in regard to installing the Oracle Business Intelligence clients:

- Section 5.1.1, "About Oracle Business Intelligence Client Tools," states:
"32-bit versions of the Oracle Business Intelligence client tools are installed automatically when you install Oracle Business Intelligence on a computer running a 32- or 64-bit Windows operating system."

The previous statement incorrectly implies that the Oracle Business Intelligence 11g Installer always installs 32-bit versions of the client tools. Rather, 32-bit versions of the Oracle Business Intelligence 11g Installer install 32-bit versions of the client tools, while 64-bit versions of the Oracle Business Intelligence 11g Installer install 64-bit versions of the client tools.

- Section 5.1.2, "Considerations for Installing Oracle Business Intelligence Client Tools" states:
"The Oracle Business Intelligence Enterprise Edition Plus Client Installer installs 32-bit versions of the client tools."

The previous statement incorrectly implies that the Oracle Business Intelligence Enterprise Edition Plus Client Installer always installs all of the available client tools. Rather, it installs just two client tools—the Oracle Business Intelligence Administration Tool and Oracle Business Intelligence Job Manager. It does not install the Oracle Business Intelligence Catalog Manager. Only the Windows version of the Oracle Business Intelligence 11g Installer installs all three client tools.

Therefore, if you want or require the Oracle Business Intelligence Catalog Manager, you must install the client tools using the Oracle Business Intelligence 11g Installer, and not the Oracle Business Intelligence Enterprise Edition Plus Client Installer.

41.16.4 Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence.

There are no known issues at this time.

41.16.5 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition. It includes the following topics:

- Section 41.16.5.1, "Oracle BI Mobile: Embedding a Dashboard or Answers Report Link in an E-mail"

- Section 41.16.5.2, "Oracle BI Mobile: Easy Access to Dashboards"

- Section 41.16.5.3, "Information about Oracle Hyperion Smart View for Office Must Be Ignored"

- Section 41.16.5.4, "Columns from Multiple Subject Areas Included in a Single Query Must Be Compatible"

- Section 41.16.5.5, "Error in the "How Will Prompts Created in Previous Versions Be Upgraded?" Topic in Chapter 6, "Prompting in Dashboards and Analyses""

- Section 41.16.5.6, "Content Missing from Appendix E, "User Interface Reference," "Edit Page Settings dialog" Topic, Prompt Buttons Field"

- Section 41.16.5.7, "Incorrect Default Pixel Value Specified in Chapter 6, "Prompting in Dashboards and Analyses" and Appendix E, "User Interface Reference""

- Section 41.16.5.8, "Error in the "Actions that Invoke Operations, Functions or Processes in External Systems" Topic in Chapter 10, "Working with Actions""

- Section 41.16.5.9, "Error in the "Show More Columns dialog" Topic in Appendix E, "User Interface Reference""

- Section 41.16.5.10, "Error in the "New Filter dialog" Topic in Appendix E, "User Interface Reference""

- Section 41.16.5.11, "Information on View Latest Version Feature in Error"

41.16.5.1 Oracle BI Mobile: Embedding a Dashboard or Answers Report Link in an E-mail

Impacted Releases: 11.1.1.5

The Oracle Business Intelligence Mobile application allows you to e-mail a link to the BI content you are viewing. When viewing an Answers report or a dashboard page, tap the Email icon to launch an e-mail window; a link to the Answers report or Dashboard is then embedded in the body of the e-mail.

On the iPad, the Email icon appears at the bottom of the Oracle BI Mobile application. On the iPhone, tap the Actions icon to access the Email icon.

This feature works only if you have set up an e-mail account on your iPhone or iPad device.

41.16.5.2 Oracle BI Mobile: Easy Access to Dashboards

Impacted Releases: 11.1.1.5

When you tap the Catalog icon in the Oracle Business Intelligence Mobile application on the iPad or iPhone, you see two tabs at the top of the screen: a Catalog tab and a Dashboards tab. Tap the Dashboards tab to display a list of top-level dashboards you have access to. This list is identical to the list of dashboards you see when logged into Oracle BI EE with the desktop application.

41.16.5.3 Information about Oracle Hyperion Smart View for Office Must Be Ignored

Impacted Releases: 11.1.1.5, 11.1.1.6

Various sections of Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Enterprise Edition include mention of Oracle Hyperion Smart View for Office. All mentions of Smart View must be ignored, as described in Section 41.4.2, "Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later."

41.16.5.4 Columns from Multiple Subject Areas Included in a Single Query Must Be Compatible

Impacted Releases: 11.1.1.3, 11.1.1.5

The following additional information is available for the topic "What Are Subject Areas and Columns?" in Chapter 2, "Creating Analyses:"

Typically, when you query a single subject area, all the columns exposed in that subject area are compatible with all the dimensions exposed in the same subject area. However, when you combine columns and dimensions from multiple subject areas, you must ensure that you do not include combinations of columns and dimensions that are incompatible with one another.

For example, a column in one subject area might not be dimensioned by Project. If columns from the Project dimension from another subject area are added to the request along with the columns that are not dimensioned by Project, then the query might fail to return results, or cause the Oracle BI Server error "No fact table exists at the requested level of detail: XXXX."

41.16.5.5 Error in the "How Will Prompts Created in Previous Versions Be Upgraded?" Topic in Chapter 6, "Prompting in Dashboards and Analyses"

Impacted Releases: 11.1.1.5

The "How Will Prompts Created in Previous Versions Be Upgraded?" topic in Chapter 6, "Prompting in Dashboards and Analyses" contains an incorrect reference to the Text Field Width field. This topic should instead reference the Choice List Value field. The revised paragraph should read as follows:

The Choice List Value field located in the "New Prompt dialog" is set by default to 120 pixels. Note that this value is different if your Administrator modified the default pixel value in the Oracle BI EE configuration file.

41.16.5.6 Content Missing from Appendix E, "User Interface Reference," "Edit Page Settings dialog" Topic, Prompt Buttons Field

Impacted Releases: 11.1.1.5

Information that describes the Prompt Buttons field is missing from the "Edit Page Settings dialog" topic. The following paragraph includes information about the field:

Prompt Buttons

Use this field to specify if you want the Apply and Reset buttons to display beside the prompt field or above the prompt field.

41.16.5.7 Incorrect Default Pixel Value Specified in Chapter 6, "Prompting in Dashboards and Analyses" and Appendix E, "User Interface Reference"

Impacted Releases: 11.1.1.5

In the "How Will Prompts Created in Previous Versions Be Upgraded?" topic in Chapter 6, "Prompting in Dashboards and Analyses," the default pixel value specified for the Choice List Width field and for the Set width of all prompts to field is incorrect. The default pixel value is 120, not 250.

In Appendix E, "User Interface Reference," the default pixel value specified for the Choice List Width field in the "New Prompt dialog" topic and for the Set width of all prompts to field in the "Edit Page Settings" dialog is incorrect. The default pixel value is 120, not 250.

41.16.5.8 Error in the "Actions that Invoke Operations, Functions or Processes in External Systems" Topic in Chapter 10, "Working with Actions"

Impacted Releases: 11.1.1.5

The "Actions that Invoke Operations, Functions, or Processes in External Systems" topic in Chapter 10, "Working with Actions" includes a Note referencing the USERSCRIPT.ADFAction function. This Note, which is included in the bullet that describes the Invoke a Browser Script action, is in error. The USERSCRIPT.ADFAction function is not supported in this release.

41.16.5.9 Error in the "Show More Columns dialog" Topic in Appendix E, "User Interface Reference"

Impacted Releases: 11.1.1.3, 11.1.1.5

The definitions of Variance and % Variance in Table E-7, Commonly Used KPI Data Columns in the "Show More Columns dialog" topic in Appendix E, "User Interface Reference" contain an error and need to be corrected (the example variance should be -50,000, not 50,000 and the example % variance should be -7.7%, not 7.7%).

The definitions should read as follows:

- Variance: Displays the value by which the KPI's actual value differs from its target value. For example if the actual value for a Net Profit KPI is 600,000 and its target is 650,000, then the variance is -50,000.

- % Variance: Displays the percent by which the KPI's actual value differs from its target value. For example if the actual value for a Net Profit KPI is 600,000 and its target is 650,000, then the variance as a percent is -7.7%

41.16.5.10 Error in the "New Filter dialog" Topic in Appendix E, "User Interface Reference"

Impacted Releases: 11.1.1.5

The "New Filter dialog" topic requires the following corrections: The topic states that if your repository is configured for double columns, then you can specify to display code values if you use the "is between" operator. This statement is incorrect. You cannot display or select code values nor can you filter by code values with the "is between" operator. You can display, select, and filter by only display values with that operator.

The topic includes mention of the Select by Code Column and Filter by Code Column fields. These fields are not available with the "is between" operator.

41.16.5.11 Information on View Latest Version Feature in Error

Impacted Releases: 11.1.1.3, 11.1.1.5, 11.1.1.6

The "BI Publisher Report Properties dialog" topic and the "Selecting a BI Publisher Report for a Dashboard Page" topic in Appendix E, "User Interface Reference" provide information on the View Latest Version feature in error. This feature is not currently available.

41.16.6 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Mobile

This section describes documentation errata in Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Mobile.

There are no known issues at this time.

41.16.7 Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition. It includes the following topics:

- Section 41.16.7.1, "Important Changes to Essbase Preconfiguration Instructions"

- Section 41.16.7.2, "Manual opmn.xml Edits Needed to Use Teradata as a Data Source"

- Section 41.16.7.3, "Updates to Text for Consistency Check Warnings 39009 and 39059"

- Section 41.16.7.4, "Other Changes to List of New Consistency Check Warnings"

- Section 41.16.7.5, "Select the Virtual Private Database Option when Authenticating Against Essbase or Hyperion Financial Management Using a Shared Token"

- Section 41.16.7.6, "Manually Updating the Master MUD Repository"

- Section 41.16.7.7, "Configuration Required for Client Installations of the Administration Tool to Perform Offline Imports from Oracle OLAP and Hyperion Financial Management Data Sources"

- Section 41.16.7.8, "Database Client Installation Required for Client Installations of the Administration Tool when Importing from Oracle Database and Oracle OLAP Sources"

- Section 41.16.7.9, "Initialization Block Failure at Server Start-Up Causes Connection Pool to be Blacklisted"

- Section 41.16.7.10, "Merge Local Changes Step Does Not Lock the Master Repository"

- Section 41.16.7.11, "Information Now Available for All Import Metadata Wizard Screens"

- Section 41.16.7.12, "Remove Smart View Mention in Appendix C"

41.16.7.1 Important Changes to Essbase Preconfiguration Instructions

Impacted Releases: 11.1.1.3, 11.1.1.5

Note the following changes to the topic "Setting Up Essbase Data Sources" in Chapter 4, "Importing Metadata and Working with Data Sources" in Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition:

- The Administration Tool requires Essbase client libraries version 11.1.2.x. Do not use other client versions. Although other versions of the Essbase client libraries might work with the Oracle BI Server, the recommended approach for Oracle BI Server connectivity to Essbase is to use the bundled 11.1.2.x client.

- By default, Oracle Business Intelligence is configured to use the bundled version of the Essbase client libraries in ORACLE_HOME/clients/epm/Essbase/EssbaseRTC. You do not typically need to make manual changes to opmn.xml on the Oracle BI Server computer for Essbase setup. However, the bi-init.cmd changes described in the topic "Setting Up Essbase Data Sources" are still required.

- If you have installed the Administration Tool using the Client install type, you must ensure that the Essbase client is present on the Administration Tool client computer. You must then update bi-init.cmd to include required variable and path information, as described in the topic "Setting Up Essbase Data Sources."

41.16.7.2 Manual opmn.xml Edits Needed to Use Teradata as a Data Source

Impacted Releases: 11.1.1.3, 11.1.1.5

The following section should have appeared in the topic "Performing Data Source Preconfiguration Tasks" in Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition:

Setting Up Teradata Data Sources To use Teradata as a data source for Oracle Business Intelligence on Windows systems, you must manually edit opmn.xml on each computer running the Oracle BI Server to include required Teradata variables.

To update opmn.xml to include Teradata variables on Windows:

1. Open opmn.xml for editing. You can find opmn.xml at:

ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml

2. Locate the ias-component tag for the Oracle BI Server process. For example:

<ias-component id="coreapplication_obis1" inherit-environment="true">

3. Under the Oracle BI Server ias-component tag, add the required Teradata variables TERA_HOME, TERAGSS_HOME, and TERAICU_HOME, and also update the PATH variable, as shown in the following example. Replace the example values with the installed location for your Teradata client:

<ias-component id="coreapplication_obis1" inherit-environment="true">
<environment>
...
<variable id="TERA_HOME" value="C:/Progra~1/Teradata/Client/13.10/
ODBCDR~1" />
<variable id="TERAGSS_HOME" value="C:/Progra~1/Teradata/TERADA~1/nt-i386/
131000~1.02" />
<variable id="TERAICU_HOME" value="C:/Progra~1/Teradata/Client/13.10/
SHARED~1" />
<variable id="PATH" value="$TERA_HOME/lib$:$TERAICU_HOME/lib$:$TERAGSS_
HOME/bin$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/
bifoundation/web/bin$:$ORACLE_HOME/clients/epm/Essbase/EssbaseRTC/
bin$:" append="true" />
...
</environment>

Important:

If you use the default location when installing the Teradata client, then the PATH variable might exceed the 1024 character limit imposed by Windows. To avoid this issue, install the Teradata client in a directory with a shortened path name (such as C:\TD), or use shortened 8.3 file names (such as "C:\PROGRA~1\Teradata\Client\13.10\ODBCDR~1\Bin" instead of "C:\Program Files\Teradata\Client\13.10\ODBC Driver for Teradata\Bin").
To determine the correct 8.3 file names, run "dir /x" from the appropriate directory. For example:

C:\>dir /x
Volume in drive C has no label.
Volume Serial Number is 0000-XXXX
Directory of C:\
08/25/2008  03:36 PM   <DIR>    DATAEX~1    DataExplorer
04/20/2007  01:38 PM   <DIR>                dell
08/28/2010  10:49 AM   <DIR>    DOCUME~1    Documents and Settings
07/28/2008  04:50 PM   <DIR>    ECLIPS~2    EclipseWorkspace
09/07/2007  11:50 AM   <DIR>                Ora92
09/07/2007  11:50 AM   <DIR>                oracle
05/21/2009  05:15 PM   <DIR>                OracleBI
05/21/2009  05:12 PM   <DIR>    ORACLE~1    OracleBIData
03/02/2011  04:51 PM   <DIR>    PROGRA~1    Program Files

4. Save and close the file.

5. Restart OPMN.

6. Repeat these steps on each computer that runs the Oracle BI Server process. If you are running multiple Oracle BI Server instances on the same computer, be sure to update the ias-component tag appropriately for each instance in opmn.xml (for example, ias-component id="coreapplication_obis1", ias-component id="coreapplication_obis2", and so on).

41.16.7.3 Updates to Text for Consistency Check Warnings 39009 and 39059

Impacted Releases: 11.1.1.5

In the section "New Features for Oracle BI EE 11g Release 1 (11.1.1.3)" in Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition, a list of new consistency check warnings is provided. Note the following changes for warnings 39009 and 39059 in Release 11.1.1.5:

- The information about the consistency check warning 39009 is valid for Release 11.1.1.3, but does not apply to Release 11.1.1.5. This warning no longer occurs due to underlying changes in the code.

- In Release 11.1.1.5, the description for the consistency check warning 39059 should read as follows:
"Even though this fact logical table source has an aggregate grain set in this dimension, no join was found that connects to any logical table source in this dimension (or a potentially invalid join was found).

This means that either no join exists at all, or it does exist but is potentially invalid because it connects a higher-level fact source to a lower-level dimensional source. Such joins are potentially invalid because if followed, they might lead to double counting in query answers.

For example, consider Select year, yearlySales. Even if a join exists between monthTable and yearlySales table on yearId, it should not be used because such a join would overstate the results by a factor of 12 (the number of months in each year).

If you get a 39059 warning after upgrade, verify that the join is as intended and does not result in incorrect double counting. If the join is as intended, then ignore the 39059 warning."

41.16.7.4 Other Changes to List of New Consistency Check Warnings

Impacted Releases: 11.1.1.3, 11.1.1.5

In the section "New Features for Oracle BI EE 11g Release 1 (11.1.1.3)," a list of new consistency check warnings is provided. Note the following changes to this list. These changes apply to Release 11.1.1.3 and Release 11.1.1.5:

- The consistency check warning 39055 should appear in its own row in the table, with the following description:
"This warning indicates that there is a physical join between the given fact and dimension sources, but there is not a corresponding logical join between the fact table and the dimension table."

- The description for consistency check errors 38012 and 38001 should read as follows:
"Logical columns that are not mapped to any logical table source are reported as consistency errors, because the logical table source mappings are invalid and would cause queries to fail.

Both of the given validation rules are related to the same issue."

- The description for consistency check warning 39003 should read as follows:
"This warning indicates that the given column is only mapped to logical table sources that are disabled. The warning brings this issue to the repository developer's attention in case the default behavior is not desired."

41.16.7.5 Select the Virtual Private Database Option when Authenticating Against Essbase or Hyperion Financial Management Using a Shared Token

Impacted Releases: 11.1.1.5

This additional information applies when you authenticate against Essbase or Hyperion Financial Management data sources using a shared token. After selecting SSO using CSS Token in the data source connection pool in the Oracle BI repository, you should also select the Virtual Private Database option in the corresponding database object to protect cache entries.

41.16.7.6 Manually Updating the Master MUD Repository

Impacted Releases: 11.1.1.5

During the course of Oracle BI repository development in a Multiuser Development (MUD) environment, it might be necessary to make manual changes to the master repository. Because of the highly controlled nature of the MUD process, you need to be careful when performing any manual steps because there is accounting information stored in the MUD history log (.mhl) file. To manually work on the master repository, you must work on the repository in a separate directory from your MUD directory. Then, you must replace both the master RPD and the latest versioned repository in the MUD directory.

For example, follow these steps to manually update a repository named master.rpd:

1. Copy the master repository (master.rpd) out of the MUD directory into a local directory.

2. Use the Oracle BI Administration Tool to make the changes necessary to the local copy of the master repository (master.rpd).

3. When manual edits are complete, copy master.rpd to the MUD directory as master.rpd. For example:

copy c:\local\master.rpd c:\mud\master.rpd

4. In the MUD directory, identify the latest repository with a version number. For example, master.7011.

5. Copy master.rpd to the MUD directory and overwrite the latest versioned repository. For example:

copy c:\local\master.rpd c:\mud\master.7011

41.16.7.7 Configuration Required for Client Installations of the Administration Tool to Perform Offline Imports from Oracle OLAP and Hyperion Financial Management Data Sources

Impacted Releases: 11.1.1.5

If you install the Administration Tool using the Oracle Business Intelligence Enterprise Edition Plus Client Installer, you must perform additional configuration before you can perform offline imports from Oracle OLAP or Hyperion Financial Management data sources. To import from either of these data sources in offline mode, the Administration Tool must point to the location of a running JavaHost.

Follow these steps to point the Administration Tool at a running JavaHost:

1. Close the Administration Tool, if it is open.

2. On the same computer as the Administration Tool, open the local NQSConfig.INI file in a text editor. You can find this file at:

ORACLE_INSTANCE/config/OracleBIServerComponent/coreapplication_obisn

3. Locate the JAVAHOST_HOSTNAME_OR_IP_ADDRESSES parameter, near the bottom of the file. Update this parameter to point to a running JavaHost, using a fully-qualified host name or IP address and port number. For example:

JAVAHOST_HOSTNAME_OR_IP_ADDRESSES = "myhost.example.com:9810"

Note that in a full (non-client) Oracle Business Intelligence installation, you cannot manually edit this setting because it is managed by Oracle Enterprise Manager Fusion Middleware Control.

4. Save and close the file.

41.16.7.8 Database Client Installation Required for Client Installations of the Administration Tool when Importing from Oracle Database and Oracle OLAP Sources

If you install the Administration Tool using the Oracle Business Intelligence Enterprise Edition Plus Client Installer, you must install the Oracle Database Client on the Administration Tool computer before you can import from Oracle Database or Oracle OLAP sources. Use either the Administrator or Runtime client install option.

If you are running a 32-bit Administration Tool, you must install the 32-bit Oracle Database Client. If you are running a 64-bit Administration Tool, you must install the 64-bit Oracle Database Client.

After installing the Oracle Database Client, create an environment variable called ORACLE_HOME and set it to the Oracle home for the Oracle Database Client. Then, create an environment variable called TNS_ADMIN and set it to the location of the TNSNAMES.ORA file (ORACLE_HOME\network\admin).

41.16.7.9 Initialization Block Failure at Server Start-Up Causes Connection Pool to be Blacklisted

Impacted Releases: 11.1.1.5

During Oracle BI Server start-up, if an initialization block fails for a particular connection pool, no more initialization blocks using that connection pool are processed. Instead, the connection pool is blacklisted and subsequent initialization blocks for that connection pool are skipped. This behavior ensures that the Oracle BI Server starts in a timely manner, even when a connection pool has a large number of associated initialization blocks or variables.

If this occurs, a message similar to the following appears in the server log:

[OracleBIServerComponent] [ERROR:1] [43143] Blacklisted connection pool conn_pool_name

If you see this error, check the initialization blocks for the given connection pool to ensure that they are correct.

41.16.7.10 Merge Local Changes Step Does Not Lock the Master Repository

In Release 11.1.1.5, when working in a multiuser development environment, the master repository is not locked when you merge local changes. Instead, the master repository is locked during the Publish to Network step. This change reduces the total time that the master repository is locked to avoid lock contention issues.

With this change, the publish step now checks that no other developer published changes to the master between the time you merged local changes and the time you published to network. If the MUD logic discovers that another repository developer published to the network in this time period, the system will automatically redo the merge with the master. To redo the merge, the system must roll back to the RPD version you used for the Merge Local Changes step, and will then merge it with the new master.

Because of this change, you must always merge all local changes before publishing to the network. Otherwise, you might lose any changes you made between merge and publish if a rollback becomes necessary for a merge redo.

41.16.7.11 Information Now Available for All Import Metadata Wizard Screens

Impacted Releases: 11.1.1.5

The description for the Map to Logical Model and Publish to Warehouse screens of the Import Metadata Wizard in the Administration Tool states that these screens are reserved for a future release. This is no longer correct. Instead, refer to Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition (Oracle Fusion Applications Edition) in the Oracle Fusion Applications Technology Library for information about these screens.

41.16.7.12 Remove Smart View Mention in Appendix C

Impacted Releases: 11.1.1.5, 11.1.1.6

The opening paragraphs of Appendix C, "Logical SQL Reference" mention Oracle Hyperion Smart View for Office as a client for the Oracle BI Server. All mentions of Smart View must be ignored, as described in Section 41.4.2, "Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later."

41.16.8 Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition. It includes the following topics:

- Section 41.16.8.1, "Event Polling Tables Must Be Created Using the Repository Creation Utility (RCU)"

- Section 41.16.8.2, "Use of ps: Prefix in Elements Is Unnecessary"

- Section 41.16.8.3, "Removal of Section 11.5, "Configuring to Download Oracle Hyperion Smart View for Office""

- Section 41.16.8.4, "Error for Configuring the Data Source for the Full-Text Catalog Search"

- Section 41.16.8.5, "Removal of Section 19.7.2.6, "Including Links with Analyses on Dashboards""

- Section 41.16.8.6, "MaxColumns Element Not Supported"

- Section 41.16.8.7, "Error in Section 22.3.2, "Specifying Defaults for Styles and Skins""

- Section 41.16.8.8, "Clarification of CaseInsensitiveMode Element"

- Section 41.16.8.9, "Updates of Information About the Catalog"

41.16.8.1 Event Polling Tables Must Be Created Using the Repository Creation Utility (RCU)

Impacted Releases: 11.1.1.3, 11.1.1.5

Section 7.8.1, "Setting Up Event Polling Tables on the Physical Databases," explains that you can manually create event polling tables using CREATE TABLE statements. This statement is incorrect.

Instead, to create an event polling table, run the Repository Creation Utility (RCU) to create the Business Intelligence Platform (BIPLATFORM) schemas in your physical database. RCU creates an event polling table called S_NQ_EPT. See Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence for information about running the Repository Creation Utility.

41.16.8.2 Use of ps: Prefix in Elements Is Unnecessary

Impacted Releases: 11.1.1.5, 11.1.1.6

The guide includes four sections that contain code examples to show how to edit the instanceconfig.xml file for the Catalog element. In these examples, the ps: prefix is included before element names, which is unnecessary. The guide must be updated to not include the string "ps:" in tags, and the Catalog element should begin with the <Catalog> tag.

41.16.8.3 Removal of Section 11.5, "Configuring to Download Oracle Hyperion Smart View for Office"

Impacted Releases: 11.1.1.5, 11.1.1.6

Section 11.5, "Configuring to Download Oracle Hyperion Smart View for Office," must be ignored, as described in Section 41.4.2, "Oracle Hyperion Smart View for Office Not Supported in Oracle Business Intelligence 11g, Releases 11.1.1.5 and Later."

41.16.8.4 Error for Configuring the Data Source for the Full-Text Catalog Search

Impacted Releases: 11.1.1.5

Section 17.11.4.4 describes how to configure the data source for the full-text catalog search. Step 5 of that procedure describes how to specify the Display URL Prefix. The step includes an incorrect line for Secure Enterprise Search 11.2.1 or later. The line should read as follows:

http://host:port/bisearch/urlbuilder/ (for Secure Enterprise Search 11.2.1, 11.1.2.2, or later)

41.16.8.5 Removal of Section 19.7.2.6, "Including Links with Analyses on Dashboards"

Impacted Releases: 11.1.1.3

Chapter 19, "Configuring and Managing Analyses and Dashboards" of the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3 includes Section 19.7.2.6, "Including Links with Analyses on Dashboards." This section is not applicable and must be removed from the guide.

41.16.8.6 MaxColumns Element Not Supported

Impacted Releases: 11.1.1.5

Chapter 20, "Configuring Advanced Options for Mapping and Spatial Information," includes descriptions of the MaxColumns element. This element is not supported. If this element is included in the instanceconfig.xml file, then you might see an error message when trying to start Presentation Services.

41.16.8.7 Error in Section 22.3.2, "Specifying Defaults for Styles and Skins"

Impacted Releases: 11.1.1.3

Section 22.3.2, "Specifying Defaults for Styles and Skins" in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3 contains sample code from the instanceconfig.xml file for working with the DefaultStyle and DefaultSkin elements. The parent element for these elements should be UI, so the sample code should read as follows:

<ServerInstance>
<UI>
<DefaultStyle>myStyle</DefaultStyle>
<DefaultSkin>mySkin</DefaultSkin>
</UI>
</ServerInstance>

41.16.8.8 Clarification of CaseInsensitiveMode Element

Impacted Releases: 11.1.1.3

Appendix E in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3 provides an example of the section of the instanceconfig.xml file in which you can include the CaseInsensitiveMode element. The correct parent element of QueryManager is missing for CaseInsensitiveMode. The proper syntax is as follows:

<ServerInstance>
<QueryManager>
<CaseInsensitiveMode>false</CaseInsensitiveMode>
</QueryManager>
</ServerInstance>

41.16.8.9 Updates of Information About the Catalog

The following sections provide information for inclusion in Chapter 18, "Configuring and Managing the Oracle BI Presentation Catalog" in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3:

- Section 41.16.8.9.1, "Guidelines for Object Names"

- Section 41.16.8.9.2, "Handling Users of the Catalog"

- Section 41.16.8.9.3, "Handling Heterogeneous Nodes"

- Section 41.16.8.9.4, "Handling Catalog Files on Various Platforms"

- Section 41.16.8.9.5, "Known Issues with Catalog Files"

- Section 41.16.8.9.6, "Validating the Catalog"

- Section 41.16.8.9.7, "Performing a Basic Validation of the Catalog"

- Section 41.16.8.9.8, "Specifying the Elements for Validating the Catalog"

- Section 41.16.8.9.9, "Updates for XML Files and Text Strings"

41.16.8.9.1 Guidelines for Object Names

Impacted Releases: 11.1.1.3

Each object in the catalog is stored in its own file. For example, an analysis called Analysis 1 is stored in a file named Analysis1. The object name that is visible to users, such as Analysis 1, is referred to as the logical object name.

The following list provides guidelines for object names:

- No restrictions exist on which characters are allowed in the logical name of an object in the catalog, as long as the characters are valid Unicode characters. The following are valid logical names:

Hello World
Profit / Loss
% Sales * $ Cost ~~ $ "Expense"?

- The length of the logical object name must not exceed 256 Unicode characters.
For more information on Unicode, see Section 41.16.8.9.4, "Handling Catalog Files on Various Platforms."

- The length of the logical path name for an object must not exceed 16000 Unicode characters.

- The number of directory segments in a logical path name for an object must be not exceed 255 segments.
For example, a directory with a name such as /n1/n2/n3/n4/…./n253/n254/n255 is acceptable, while a name such as /n1/n2/n3/n4/…./n254/n255/n256 is unacceptable.

- When you pass the path name of an object using SOAP, you must escape the following characters:

Forward slash (/)
Backward slash (\)
Tilde (~)
Asterisk (*)
Question mark (?)

The following logical path names are all valid:

/shared/test/Hello World
/shared/test/Profit \/ Loss
/shared/test/% Sales \* $ Cost \~\~ $ "Expense"\?

Use care when building a catalog path. It is very common to see code that assumes the forward slash (/) is always a path separator. Always verify your path code with an object name such as "Profit / Loss".

- When you pass a catalog search filter using SOAP, you must escape the following characters:

Forward slash (/)
Backward slash (\)
Tilde (~)
Asterisk (*)
Question mark (?)
Caret (^)
Dollar sign (?)

The following search filters are all valid:

Hello World
Profit \/ Loss
% Sales \* \$ Cost \~\~ \$ "Expense"\?

41.16.8.9.2 Handling Users of the Catalog

Impacted Releases: 11.1.1.3

The catalog is designed to scale to thousands of concurrent users. To achieve this, the catalog adheres to the following guidelines:

- The average user typically only reads from the catalog and rarely, if ever, writes to it. In Release 11g, each user is constantly and automatically updating his or her Most Recently Used file, but each user's "read" operations still far outweigh the user's "writes" operations. Therefore, the read-to-write ratio is typically at least 100 to 1.

- While a locking mechanism guarantees that only one user can write to an object at a time, it is rare for multiple users to attempt to write simultaneously to the same object. A feature called "lazy locking" allows users to continue reading an object even when another user is updating that object.

- Modern file systems cache "small" files directly inside the directory record, such that reading any information on a directory simultaneously loads all small files directly into the operating system's memory cache. Therefore, it is good practice to keep files in the catalog "small," especially the frequently "read" .atr metadata files. When these metadata files remain small, then all the .atr files in a directory are loaded into memory with one physical hard disk read. Every file that exceeds the "small" threshold adds another physical hard disk read, which can cause a 100% degradation for each large file. In other words, use care when considering storing arbitrary "Properties" in .atr files.

- Reading an object's .atr metadata file using NFS is far slower than reading it directly from a local disk. For this reason, Presentation Services additionally caches all .atr files internally. This cache can become briefly "stale" when another node in the cluster writes data to the file that is newer than the data that is cached by the current node. Therefore, all nodes are refreshed as per the MaxAgeMinutes element in the instanceconfig.xml file, whose default for a cluster is 5 minutes. This default setting commonly achieves the best trade-off between the possibility of stale data and the known performance impact. (The default for an environment without clusters is 60 minutes.)

41.16.8.9.3 Handling Heterogeneous Nodes

Impacted Releases: 11.1.1.3

To allow heterogeneous nodes in a cluster, the catalog adheres to the following guidelines:

- The maximum length for the name of an object on disk is 256 bytes, which is 64 Unicode characters. The logical name is restricted to 256 Unicode characters. To adhere to this restriction, logical names greater than 32 characters are hashed.

- The maximum length for the name of a path on disk is 32KB, which is 8000 Unicode characters. The logical path is restricted to 16000 Unicode characters.

- All path names on disk are all lowercase. The logical path name allows mixed case, but is still case-insensitive.

- Certain characters are not allowed for path names on disk, while the logical path name allows all characters. For example, Windows systems disallow certain characters such as the colon (:), so those characters are mapped using standard HTML escape sequences. For example, the period character (.) becomes "%2e".

- Certain file names are not allowed on disk, while the logical object name has no restrictions. For example, Windows systems disallow certain file names such as COM, so those names are mapped using standard HTML escape sequences. For example, "com" becomes "co%6d".

41.16.8.9.4 Handling Catalog Files on Various Platforms

Impacted Releases: 11.1.1.3

Keep the following points in mind when handling catalog files on various platforms:

- For UNIX Platforms: UNIX kernels must commonly be configured to allow more than 4000 subdirectories per directory. See Chapter 18 for information on the HashUserHomeDirectories element.

- For Windows Platforms:
When users want to navigate catalog files using a tool such as Microsoft Windows Explorer, then they want the catalog structure based on a short path name such as c:/obi/demo, rather than the long default path name. Note that such navigation is not recommended.

- FAT is not supported, and NTFS is required.

- Performance on Windows platforms degrades noticeably when more than 8000 files exist in a single directory. Because each catalog object has two files (the data file and the .atr metadata file), it is strongly recommended that you not store more than 4000 catalog objects in a single directory. See Chapter 18 for information on the HashUserHomeDirectories element.

- Windows Explorer does not handle long path names properly, and it is recommended to not Windows Explorer to navigate the internal structure of the catalog. While the file system can handle path names as long as 32KB and Presentation Services is not negatively affected, you cannot use Windows Explorer with any path name that is longer than approximately 2KB.
Because a single Unicode character can require as many as 4 bytes, you might be unable to use Windows Explorer with path names of only 500 Unicode characters. This limitation does not affect Presentation Services. Because of this limitation, place the catalog in a top-level directory, such as c:\mycatalog\sales.

41.16.8.9.5 Known Issues with Catalog Files

Impacted Releases: 11.1.1.3

The following issues are known when working with catalog files:

- Locking across NFS systems is difficult, but Presentation Services provides an effective locking mechanism in recent patches. Obtain key patches to update older versions of Oracle BI EE as necessary.
For more information, see Section 41.16.8.9.6, "Validating the Catalog."

- Various third-party FTP programs have issues handling '%' escape sequences, which often results in a renamed file that is doubly escaped. For example, a file that is named sa%2epaint (whose logical name is SA.Paint) is incorrectly renamed to sa%252epaint (whose logical name is SA%2ePaint).
Avoid using an FTP program directly against a catalog. Instead, download and use the 7-Zip utility to compress the catalog files, then use an FTP program to transfer the resulting compressed file.

41.16.8.9.6 Validating the Catalog

Impacted Releases: 11.1.1.3

Over time, inconsistencies can develop in the catalog as links are broken, users are deleted, or NFS file system issues are encountered. These inconsistencies can eventually lead to incorrect behavior, such as the inability to edit an agent's recipient list. You can periodically take the production system offline and validate the catalog, to be informed of and to take corrective action on inconsistencies.

41.16.8.9.7 Performing a Basic Validation of the Catalog

Impacted Releases: 11.1.1.3

Use the following procedure to perform a basic validation of the catalog.

To validate the catalog:

1. Stop Presentation Services.
For information, see Chapter 4 of the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3.

2. Refresh the user GUIDs for the catalog. See Chapter 3 of the Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3 for information

Caution:

Ensure that you regenerate the user GUIDs before validating the catalog. Failure to do so can result in the removal of all accounts, permissions, and privileges from the catalog.

3. Back up the catalog by using the 7-Zip utility to create a compressed file for it.

4. Create a backup copy of the instanceconfig.xml file.

5. Edit the instanceconfig.xml file so that it contains the appropriate elements for performing the validation.
For information on these elements, see Section 41.16.8.9.8, "Specifying the Elements for Validating the Catalog."

6. Start Presentation Services to run the validation according to the values that you specified in the instanceconfig.xml file.

7. Stop Presentation Services.

8. Create a backup copy of the instanceconfig.xml file in which you added the validation elements, renaming the file similar to instanceconfig_validate.xml. In this way, you have a version of the file to use as a starting point for subsequent validations.

9. Restore the backup version of the instanceconfig.xml that you created earlier to use as the current version.

10. Start Presentation Services.

41.16.8.9.8 Specifying the Elements for Validating the Catalog

Impacted Releases: 11.1.1.3

As part of the process of validating the catalog, you include elements in the instanceconfig.xml file that run the validation when you restart Presentation Services. The following procedure describes how to edit the instanceconfig.xml file to include these elements.

To specify the element for validating the catalog:

1. Open the instanceconfig.xml file for editing.

2. Locate the Catalog section in which you must add the elements that are described in Table 41-3.

3. Include the elements and their ancestor element as appropriate, as shown in the following example. In this example, the validation runs when Presentation Services starts. Inconsistent accounts (for example, deleted users), links, and objects are removed. Inconsistent users' home directory names are logged but directories are not removed.

<ServerInstance>
<ps:Catalog xmlns:ps="oracle.bi.presentation.services/config/v1.1">
<ps:Validate>OnStartupAndExit</ps:Validate>
<ps:ValidateAccounts>Clean</ps:ValidateAccounts>
<ps:ValidateHomes>Report</ps:ValidateHomes>
<ps:ValidateItems>Clean</ps:ValidateItems>
<ps:ValidateLinks>Clean</ps:ValidateLinks>
</ps:Catalog>
</ServerInstance>

Caution:

Include only one Catalog element in the instanceconfig.xml file or unexpected results might occur. Unless expressly noted, include most nodes in an XML document only once.

4. Save your changes and close the file.

Table 41-3 Elements for Validating the Catalog

Element

Description

Default Value

Validate

Performs the validation of the catalog according to the values of the other Validate-related elements in this section. Values are described in the following list:

- None — Performs no validation.

- OnStartup — Performs the validation when Presentation Services starts.

- OnStartupAndExit — Performs the validation when Presentation Services both starts and stops. This value allows re-running of the validation, performing as many cycles of Report and Clean until the catalog is as clean as appropriate.

If this value is not None, then all privileges and each object's ACLs in the entire catalog are cleaned of dead accounts, regardless of the settings of the other Validate-related elements.

None

ValidateAccounts

Verifies that all information about users, roles, and groups in the catalog is consistent. Values are described in the list after this table.

None

ValidateHomes

Verifies that all information about home directories in the catalog is consistent. Values are described in the list after this table.

None

ValidateItems

Verifies that all information about objects in the catalog is consistent. Values are described in the list after this table.

None

ValidateLinks

Verifies that all information about links in the catalog is consistent. Values are described in the list after this table.

None

The elements have the values that are described in the following list:

- None — Specifies that no validation is performed.

- Report — Specifies that details about each inconsistent object are written to the sawlog.log file.

- Clean — Specifies that details about each inconsistent object are written to the sawlog.log file and that each object is removed from the catalog.

41.16.8.9.9 Updates for XML Files and Text Strings

Impacted Releases: 11.1.1.3

Section 18.8.2.1 "XML File Format for Searching for and Replacing Text Strings" in the Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition, Release 11.1.1.3 must be replaced with the following text.

In the search and replace XML file, you use an action element to identify each text string to search for and replace. The action elements are contained in a commands element.

The action element has the following attributes:

- command — Specifies the text to replace. The valid value is:

- textReplace — Replaces all the text that matches in an XML file, such as a column name.

- oldValue — Specifies the text string to search for.
When you specify this attribute for the textReplace command for the search and replace XML file, you must use the full Java regex syntax, which is not like a normal string. To replace a string, you must do the following:

1. Escape any special Java regex characters (such as brackets, parentheses, dollar signs, and carets).

2. Escape any special "normal" string characters (such as backslashes and quotes).

3. Because you are working in an XML file, escape any special HTML characters (such as quotes and ampersands).

The full Java regex syntax is described in the following document: http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html.

Table 41-4 provides sample strings for use with the regex syntax in search criteria.

Table 41-4 Using regex Syntax in Search Criteria

Search String Entered

Result

a

Adds wildcards before and after your search string (for example, *a*), enabling the search to return results that contain the letter "a".

^a

Adds a wildcard after your search string (for example, a*), enabling the search to return results that begin with the letter "a".

a$

Adds a wildcard before your search string (for example, *a), enabling the search to return results that end with the character "a".

a\*

Searches explicitly for strings containing a character followed by an asterisk (*) for example, "a*".

?

Use a question mark (?) with a character and an asterisk (*) to return zero (0) or more occurrences of a character. For example ?a* returns zero or more occurrences of the character "a".

- newValue — Specifies the replacement text.

- ignoreCase — Ignores case when set to true, but becomes case-sensitive when set to false. The default value is false.

The following is a partial example of an XML file for searching for and replacing a text string:

<?xml version="1.0" encoding="utf-8"?>
<actions>
<action command="textReplace" oldValue="boots" newValue="HoleyShoes" ignoreCase="true"/>
</actions>

41.16.9 Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition. It includes the following topics:

- Section 41.16.9.1, "SASchInvoke Always Prompts for the Password in 11.1.1.5"

- Section 41.16.9.2, "Setup Multiple Authentication Providers"

- Section 41.16.9.3, "Error in Code Example for Refreshing User GUIDs"

41.16.9.1 SASchInvoke Always Prompts for the Password in 11.1.1.5

Impacted Releases: 11.1.1.5

Section 5.5.1 "Using SASchInvoke When BI Scheduler is SSL-Enabled" in revision E10543-03 describes using the SASchInvoke command to invoke the BI Scheduler when SSL is enabled. A caution paragraph suggested that a password prompt appears when you run the command under SSL, but a password prompt appears regardless of SSL-enablement. The caution was confusing and has been removed for the E10543-04 revision.

41.16.9.2 Setup Multiple Authentication Providers

Impacted Releases: 11.1.1.5

Chapter 3 did not explain how to configure multiple authentication providers, so a new section 3.2.3.3 "Configuring BI with Multiple Authentication Providers" was created for revision E10543-03. Chapter 5 did not explain how to set up SSL when multiple authenticators are configured, so a new section 5.6.6, "Configuring SSL When Using Multiple Authenticators" was created for revision E10543-04.

41.16.9.3 Error in Code Example for Refreshing User GUIDs

Impacted Releases: 11.1.1.5, 11.1.1.6

Section 3.8 "Refreshing User GUIDs" includes Step 3b on updating the Catalog element. The sample code for updating the element must be modified as follows:

<Catalog>
<UpgradeAndExit>false</UpgradeAndExit>
<UpdateAccountGUIDs>UpdateAndExit</UpdateAccountGUIDs>
</Catalog>

41.16.10 Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence

This section describes documentation errata in Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence.

These issues are described in Section 6.4.4, "Documentation Errata for the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle Business Intelligence" of this document.

41.16.11 Oracle Fusion Middleware Developer's Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware Enterprise Developer's Guide for Oracle Business Intelligence Enterprise Edition. It includes the following topic:

- Section 41.16.11.1, "Error in the "Passing Business Intelligence Content with the Oracle BI EE Contextual Event Action" Topic in Chapter 1, "Embedding Business Intelligence Objects in ADF Applications""

41.16.11.1 Error in the "Passing Business Intelligence Content with the Oracle BI EE Contextual Event Action" Topic in Chapter 1, "Embedding Business Intelligence Objects in ADF Applications"

Impacted Releases: 11.1.1.5

The following sentence in the "Passing Business Intelligence Content with the Oracle BI EE Contextual Event Action" topic is incorrect: "At design time, the analysis designer determines which column should contain the Oracle BI EE contextual event action, adds an Invoke a Browser Script action type to the column, and browses for and selects USERSCRIPT.ADFAction."

Instead, this sentence should read: "At design time, the analysis designer determines which column should contain the Oracle BI EE contextual event action and from the New Action Link menu, selects ADF Contextual Event."

The "Passing Business Intelligence Content with the Oracle BI EE Contextual Event Action" topic should also state that the Administer must modify Oracle BI EE's instanceconfig.xml file so that the ADF Contextual Event option displays in the New Action Link menu within Presentation Services. To enable the action type to display in the New Action Link menu, the Administrator must add the ActionLinks setting to the <ServerInstance> tag as follows:

<ActionLinks>
<Enable EnableADFContextualEvent>true</EnableADFContextualEvent>
</ActionLinks>

41.16.12 Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition.

There are no known issues at this time.

41.16.13 Oracle Fusion Middleware Installation and Administration Guide for Oracle Exalytics In-Memory Machine Guide

This section describes documentation errata in Oracle Fusion Middleware Installation and Administration Guide for Oracle Exalytics In-Memory Machine Guide.

There are no known issues at this time.

41.16.14 Oracle Fusion Middleware XML Schema Reference for Oracle Business Intelligence Enterprise Edition

This section describes documentation errata in Oracle Fusion Middleware XML Schema Reference for Oracle Business Intelligence Enterprise Edition.

There are no known issues at this time.

41.16.15 Oracle Business Intelligence Help System Errata

This section describes errata in the Oracle Business Intelligence help systems. It includes the following topic:

- Section 41.16.15.1, "Incorrect Statement on Source Control Management and Multiuser Development in Administration Tool Online Help"

41.16.15.1 Incorrect Statement on Source Control Management and Multiuser Development in Administration Tool Online Help

Impacted Releases: 11.1.1.6

In the Administration Tool online help, in the topic "About Using a Source Control Management System with the Administration Tool," the following statement appears:

"As an alternative to using the Multiuser Development (MUD) environment described in Chapter 3, you can instead choose to integrate the Administration Tool with a third-party source control management system, such as Subversion or Rational ClearCase."

This statement is incorrect. Integration with a source control management system can be used with MUD and complements the MUD process, but source control management integration cannot replace the advanced features of using a MUD environment.

This statement has been corrected in Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition. See this book for the latest text.

42 Oracle Business Intelligence Applications and Data Warehouse Administration Console

This chapter describes issues associated specifically with Oracle Business Intelligence Applications and Oracle Business Intelligence Data Warehouse Administration Console (DAC). It includes the following sections:

- Section 42.1, "Oracle Business Intelligence Applications Release Notes"

- Section 42.2, "Oracle Business Intelligence Data Warehouse Administration Console (DAC) Platform Release Notes"

- Section 42.3, "Patch Requirements for Oracle Business Intelligence Applications and DAC"

Note:

Issues relating the DAC metadata are located in Section 42.1, "Oracle Business Intelligence Applications Release Notes". Issues relating to DAC platform are located in Section 42.2, "Oracle Business Intelligence Data Warehouse Administration Console (DAC) Platform Release Notes".

42.1 Oracle Business Intelligence Applications Release Notes

This chapter describes issues associated specifically with Oracle Business Intelligence. It includes the following sections:

- Section 42.1.1, "Oracle Business Intelligence Issues and Workarounds Identified Since the Previous Revision"

- Section 42.1.2, "General Issues and Workarounds for Oracle Business Intelligence"

- Section 42.1.3, "Installation Issues and Workarounds for Oracle Business Intelligence"

- Section 42.1.4, "Upgrade Issues and Workarounds for Oracle Business Intelligence"

- Section 42.1.5, "Oracle Business Intelligence Offering/Module-specific Issues"

- Section 42.1.6, "Oracle Business Intelligence Configuration Manager and FSM Issues"

- Section 42.1.7, "Security-related Issues for Oracle Business Intelligence Applications"

- Section 42.1.8, "Oracle Business Intelligence Documentation Errata"

42.1.1 Oracle Business Intelligence Issues and Workarounds Identified Since the Previous Revision

The issues and workarounds related to Oracle Business Intelligence that have been identified since the previous revision of the Release Notes include:

- Information is provided about an obsolete functional configuration Task in FSM, for more information, see Section 42.1.5.10, "Issues for Oracle Supply Chain and Order Management Analytics Offering".

- Workaround for configuring connection pool for Oracle BI Applications Configuration Manager. For more information, see Section 42.1.2.2, "CONFIGURE_RPD.PY Script Does Not Set Connection Pool for Oracle BI Applications Configuration Manager".

42.1.2 General Issues and Workarounds for Oracle Business Intelligence

This section describes general issues and workarounds related to Oracle Business Intelligence.

42.1.2.1 About Issues For Both Oracle Fusion Transactional Business Intelligence and Oracle Business Intelligence Applications

Some issues that apply to Oracle Fusion Transactional Business Intelligence may also apply to Oracle Business Intelligence Applications. Such issues and their workarounds, if any, are documented in the Oracle Fusion Applications release notes and not in this chapter. To quickly locate issues that apply to both Oracle Fusion Transactional Business Intelligence and Oracle Business Intelligence Applications, you can search the Oracle Fusion Applications release notes for the text string "This issue also applies to Oracle Business Intelligence Applications."

42.1.2.2 CONFIGURE_RPD.PY Script Does Not Set Connection Pool for Oracle BI Applications Configuration Manager

This issue affects Releases 11.1.1.5.1 and 11.1.1.5.2.

The setup script configure_rpd.py does not configure the connection pool for Oracle BI Applications Configuration Manager in the Oracle BI Applications RPD file. You must configure the connection pool manually, as described in the workaround below.

Workaround

1. Use the Oracle BI Server Administration Tool to open the repository.

2. From the Manage menu, select Variables.

3. Locate and provide values for the variables CM_DSN and CM_USER.

1. For CM_DSN, provide the complete connect string in the Default Initializer box.

2. For CM_USER, provide the same information as the Data Warehouse Schema user in the Default Initializer box, enclosed in single quotation marks.

4. In the Physical layer, navigate to and click on BI Applications Configuration Data Source, and then click on Catalog.

5. Provide the password of the Configuration Manager schema user in the dialog that opens.

42.1.3 Installation Issues and Workarounds for Oracle Business Intelligence

This section describes issues and workarounds related to installing Oracle Business Intelligence.

There are no known issues at this time.

42.1.4 Upgrade Issues and Workarounds for Oracle Business Intelligence

This section describes issues and workarounds related to upgrading Oracle Business Intelligence from previous releases.

There are no known issues at this time.

42.1.5 Oracle Business Intelligence Offering/Module-specific Issues

This section describes issues and workarounds related to specific Offerings or Modules in Oracle Business Intelligence. It includes the following topics:

- Section 42.1.5.1, "Issues for Oracle Customer Data Management Analytics Offering"

- Section 42.1.5.2, "Issues for Oracle Financial Analytics Offering"

- Section 42.1.5.3, "Issues for Oracle Human Resources Analytics Offering"

- Section 42.1.5.4, "Issues for Oracle Marketing Analytics Offering"

- Section 42.1.5.5, "Issues for Oracle Partner Analytics Offering"

- Section 42.1.5.6, "Issues for Oracle Product Information Management Analytics Offering"

- Section 42.1.5.7, "Issues for Oracle Procurement and Spend Analytics Offering"

- Section 42.1.5.8, "Issues for Oracle Project Analytics Offering"

- Section 42.1.5.9, "Issues for Oracle Sales Analytics Offering"

- Section 42.1.5.10, "Issues for Oracle Supply Chain and Order Management Analytics Offering"

42.1.5.1 Issues for Oracle Customer Data Management Analytics Offering

This section describes issues and workarounds related to Oracle Customer Data Management Analytics Offering.

There are no known issues at this time.

42.1.5.2 Issues for Oracle Financial Analytics Offering

This section describes issues and workarounds related to Oracle Financial Analytics Offering.

There are no known issues at this time.

42.1.5.3 Issues for Oracle Human Resources Analytics Offering

This section describes issues and workarounds related to Oracle Human Resources Analytics Offering.

42.1.5.3.1 Incorrect Metrics Showing Current Year

The following metrics are incorrectly showing the current year, not the prior year value:

Length of Service (Years) YAGO

Average Length of Service (Years) YAGO

% Change Average Length of Service (Years) YAGO

Workaround

There is no workaround for this issue.

42.1.5.4 Issues for Oracle Marketing Analytics Offering

This section describes issues and workarounds related to Oracle Marketing Analytics Offering.

There are no known issues at this time.

42.1.5.5 Issues for Oracle Partner Analytics Offering

This section describes issues and workarounds related to Oracle Partner Analytics Offering.

There are no known issues at this time.

42.1.5.6 Issues for Oracle Product Information Management Analytics Offering

This section describes issues and workarounds related to Oracle Product Information Management Analytics Offering.

There are no known issues at this time.

42.1.5.7 Issues for Oracle Procurement and Spend Analytics Offering

This section describes issues and workarounds related to Oracle Procurement and Spend Analytics Offering.

There are no known issues at this time.

42.1.5.8 Issues for Oracle Project Analytics Offering

This section describes issues and workarounds related to Oracle Project Analytics Offering.

There are no known issues at this time.

42.1.5.9 Issues for Oracle Sales Analytics Offering

This section describes issues and workarounds related to Oracle Sales Analytics Offering.

There are no known issues at this time.

42.1.5.10 Issues for Oracle Supply Chain and Order Management Analytics Offering

This section describes issues and workarounds related to Oracle Supply Chain and Order Management Analytics Offering.

- Obsolete Task in Supply Chain and Order Management Analytics Fusion Edition in Releases 11.1.1.5.1 and 11.1.1.5.2.
In Functional Setup Manager for Oracle BI Applications, the "Supply Chain and Order Management Analytics Fusion Edition" task list > "Order Management Functional Area Specific Configurations" task list displays the following task:

"Configure Reporting Parameters for Default Aging Method displayed in AR Aging Reports"

This task is obsolete and should be ignored. No functional configuration is required for this task. Invoking this task via the 'Go to Task' button displays the Reporting Parameters UI with no rows.

42.1.6 Oracle Business Intelligence Configuration Manager and FSM Issues

This section describes issues and workarounds related to Oracle Business Intelligence Configuration Manager.

There are no known issues at this time.

42.1.7 Security-related Issues for Oracle Business Intelligence Applications

This section describes issues and workarounds related to upgrading Oracle Business Intelligence from previous releases.

There are no known issues at this time.

42.1.8 Oracle Business Intelligence Documentation Errata

This section describes errata in Oracle Business Intelligence documentation and help systems. It includes the following topics:

- Section 42.1.8.1, "General Oracle Business Intelligence Documentation Errata"

- Section 42.1.8.2, "Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Applications"

- Section 42.1.8.3, "Oracle BI Applications Configuration Manager Help System"

- Section 42.1.8.4, "Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications"

42.1.8.1 General Oracle Business Intelligence Documentation Errata

This section describes general errata in the Oracle Business Intelligence documentation.

There are no known issues at this time.

42.1.8.2 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Applications

This section describes documentation errata in Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Applications for Release 11.1.1.5.2.

There are no known issues at this time for Release 11.1.1.5.1.

- Section 4.3.2.1 'Creating Oracle BI Applications Schemas Using Oracle BI Applications RCU' should include the following information about the location of the Oracle BI Applications RCU zip file:
The Oracle BI Applications RCU zip file named rcuHomeBIApps.zip is located in the Fusion Applications software repository under installers/biapps_rcu/<OS - either Linux or Window>. (The Fusion Applications software repository is obtained when you download and unzip the Oracle Fusion Applications 11g parts available in the Oracle Fusion Applications Media Pack on the Oracle Software Delivery Cloud.) Extract this zip file into a folder, for example, BIA_RCU_HOME.

- Section 4.3.4.2 'Locations of Installation Files for Informatica PowerCenter and Hotfix 11' should read as follows:
The Informatica PowerCenter 8.6.1 and HotFix 11 installation files, license key, and user documentation are provided as zip files. These zip files are located in the Fusion Applications software repository under /installers/powercenter. (The Fusion Applications software repository is obtained when you download and unzip the Oracle Fusion Applications 11g parts available in the Oracle Fusion Applications Media Pack on the Oracle Software Delivery Cloud.)

The powercenter folder contains four Informatica PowerCenter zip files. Informatica PowerCenter 8.6.1 Client Tools install files are available in V22464-01_1of2.zip. The HotFix 11 files for PowerCenter Client Tools are available in V22464-01_2of2.zip. The other two zip files contain the operating system-specific files for Informatica PowerCenter Services. The first of these zip files in each media pack (1of2.zip) includes the Informatica PowerCenter Services 8.6.1 install files. The second of the zip files (2of2.zip) includes the Informatica documentation, the license key, and the HotFix 11 installation file for PowerCenter Services.

- Section 4.3.5 'Step 5: Install Oracle BI Administration Tool', should include the following information about the location of the Oracle BI Client Installer executable:
You install Oracle BI Administration Tool using the Oracle Business Intelligence Enterprise Edition Plus Client Installer. The Oracle BI Client Installer executable is named biee_client_install.exe and this file is available in the installed BI Middleware Home: bi/clients/biserver.

- Section 4.3.12 'Step 12: Install DAC Client' should include the following information about the location of the Oracle BI Applications Client installer:
Step 1 should be: Download the part for the Oracle BI Applications Client Installer from the Oracle Fusion Applications Media Pack on Oracle Software Delivery Cloud.

- In Section 4.3.7 Step 7: Configure the Oracle BI Repository File (RPD), the description for the DW_DB_CONNECT value includes a JDBC string as an example. This example should include the following OCI/TNS string:
(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=orcl)))

42.1.8.3 Oracle BI Applications Configuration Manager Help System

This section describes documentation errata in the Oracle BI Applications Configuration Manager Help System.

There are no known issues at this time.

42.1.8.4 Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications

This section describes documentation errata in Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications.

There are no known issues at this time.

42.2 Oracle Business Intelligence Data Warehouse Administration Console (DAC) Platform Release Notes

This chapter describes issues associated specifically with Oracle Business Intelligence Data Warehouse Administration Console platform. It includes the following sections:

- Section 42.2.1, "DAC Issues and Workarounds Identified Since the Previous Revision"

- Section 42.2.2, "DAC General Issues and Workarounds"

- Section 42.2.3, "DAC Installation Issues and Workarounds"

- Section 42.2.4, "DAC Upgrade Issues and Workarounds"

- Section 42.2.5, "DAC Documentation Errata"

42.2.1 DAC Issues and Workarounds Identified Since the Previous Revision

There are no known issues identified since the previous revision.

42.2.2 DAC General Issues and Workarounds

This section describes general issues and workarounds related to DAC.

There are no known issues at this time.

42.2.3 DAC Installation Issues and Workarounds

This section describes issues and workarounds related to installing DAC.

There are no known issues at this time.

42.2.4 DAC Upgrade Issues and Workarounds

This section describes issues and workarounds related to upgrading DAC from previous releases.

There are no known issues at this time.

42.2.5 DAC Documentation Errata

This section describes errata in DAC documentation and help systems. It includes the following topics:

- Section 42.2.5.1, "Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Data Warehouse Administration Console"

- Section 42.2.5.2, "DAC Client Help System"

42.2.5.1 Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Data Warehouse Administration Console

This section describes documentation errata in Oracle Fusion Middleware User's Guide for Oracle Business Intelligence Data Warehouse Administration Console.

There are no known issues at this time.

42.2.5.2 DAC Client Help System

This section describes documentation errata in DAC Client Help System.

There are no known issues at this time.

42.3 Patch Requirements for Oracle Business Intelligence Applications and DAC

Periodically, patches are released for Oracle Business Intelligence and DAC. Some patches are mandatory, other patches are optional.

To see the patches that are available, go to My Oracle Support (formerly OracleMetaLink) using the following URL:

http://support.oracle.com

For instructions on obtaining and applying patches, see chapter 'Oracle BI Applications Patching' in Oracle Fusion Middleware Reference Guide for Oracle Business Intelligence Applications.

43 Oracle Real-Time Decisions

This chapter describes issues associated with Oracle Real-Time Decisions (Oracle RTD). It includes the following topics:

- Section 43.1, "Oracle RTD General Issues and Workarounds"

- Section 43.2, "Oracle RTD Installation Issues and Workarounds"

- Section 43.3, "Oracle RTD Upgrade Issues and Workarounds"

- Section 43.4, "Oracle RTD Configuration Issues and Workarounds"

- Section 43.5, "Oracle RTD Security Issues and Workarounds"

- Section 43.6, "Oracle RTD Administration Issues and Workarounds"

- Section 43.7, "Oracle RTD Integration Issues and Workarounds"

- Section 43.8, "Oracle RTD Decision Studio Issues and Workarounds"

- Section 43.9, "Oracle RTD Decision Center Issues and Workarounds"

- Section 43.10, "Oracle RTD Performance Monitoring Issues and Workarounds"

- Section 43.11, "Oracle RTD Externalized Objects Management Issues and Workarounds"

- Section 43.12, "Oracle RTD Localization Issues and Workarounds"

- Section 43.13, "Oracle RTD Documentation Errata"

- Section 43.14, "Oracle RTD Third-Party Software Information"

Depending on your Oracle Fusion Middleware implementation, some information in other chapters of this document might also be relevant, including:

- Chapter 2, "Installation, Patching, and Configuration"

- Chapter 3, "Upgrade"

- Chapter 4, "Oracle Fusion Middleware Administration"

- Chapter 5, "Oracle Enterprise Manager Fusion Middleware Control"

- Chapter 6, "Oracle Fusion Middleware High Availability and Enterprise Deployment"

43.1 Oracle RTD General Issues and Workarounds

This section describes general issues and workarounds related to Oracle RTD. It includes the following topics:

- Section 43.1.1, "Transient Likelihood Problems"

- Section 43.1.2, "Use Development Deployment State Only"

- Section 43.1.3, "Error Deploying Inline Services from Command Line if Inline Service Uses Certain Functions"

- Section 43.1.4, "Ensuring Unique Batch Names Across a Cluster"

43.1.1 Transient Likelihood Problems

There are cases where non-mature predictive models will return an actual likelihood rather than NaN during the early life of a model. There are also some cases where mature predictive models will return NaN as opposed to actual likelihoods when the Randomize Likelihood option is enabled for a model. These situations are transient in nature and, in the latter case, do not outweigh the benefits of the Randomize Likelihood feature.

43.1.2 Use Development Deployment State Only

Deployment states will be deprecated in a future release. Until then, do not use any deployment state other than Development.

43.1.3 Error Deploying Inline Services from Command Line if Inline Service Uses Certain Functions

An Inline Service that uses one or more of the built-in functions Days Since Last Event, Days Since Last Event on Channel, Number of Recent Events, or Number of Recent Events on Channel cannot be deployed using the command-line deployer.

The workaround is as follows:

1. Navigate to the unzipped RTDdeploytool folder, for example, C:\<myDir>\OracleBI\RTDdeploytool.

2. Copy the includes folder from RTD_HOME\eclipse\plugins\com.sigmadynamics.studio_11.1.1.5.0 (for example, C:\OracleBI\RTD\eclipse\plugins\com.sigmadynamics.studio_11.1.1.5.0\includes) into the unzipped RTDdeploytool folder.

43.1.4 Ensuring Unique Batch Names Across a Cluster

It is a standard requirement for Inline Service names and batch names to be unique within a cluster.

After an Inline Service is copied within a cluster, batch names registered in the Inline Service can be changed manually to achieve uniqueness. This manual step is not required if the batch registration code in the Inline Service automatically generates the batch name from the new Inline Service name, as in the following generic examples:

batchAgent.registerBatch(
batchAgent.getInlineService().getName() + ".FeedBackBatchJob",
"com.<mycompany>.rtd.batch.FeedBackBatchJob",
FeedBackBatchJob.description,
FeedBackBatchJob.paramDescriptions,
FeedBackBatchJob.paramDefaults);

or

batchAgent.registerBatch(
Application.getApp().getName() + ".FeedBackBatchJob",
"com.<mycompany>.rtd.batch.FeedBackBatchJob",
FeedBackBatchJob.description,
FeedBackBatchJob.paramDescriptions,
FeedBackBatchJob.paramDefaults);

Note that all programs that may call the batch need to be made aware of the new batch name.

43.2 Oracle RTD Installation Issues and Workarounds

There are no known issues at this time.

43.3 Oracle RTD Upgrade Issues and Workarounds

There are no known issues at this time.

43.4 Oracle RTD Configuration Issues and Workarounds

There are no known issues at this time.

43.5 Oracle RTD Security Issues and Workarounds

This section describes general issues and workarounds related to Oracle RTD and security. It includes the following topic:

- Section 43.5.1, "Decision Center Logout Not Redirected Correctly for Oracle Access Manager (OAM) 11g Form-Based Authentication"

43.5.1 Decision Center Logout Not Redirected Correctly for Oracle Access Manager (OAM) 11g Form-Based Authentication

When Webgate 10g against Oracle Access Manager (OAM) 11g is configured as the SSO provider for Oracle RTD Decision Center access, logging out of, then back into Decision Center should ask users for their user name and password credentials on the re-login. To ensure that this occurs correctly, you must configure the following Oracle RTD Decision Center resources in OAM/Webgate as public (unprotected or anonymous access): 1. Decision Center logout URI /ui/do/logout 2. Decision Center images /ui/images/*

For information on how to perform the configuration, see the topic "Managing Policies to Protect Resources and Enable SSO" in Oracle Fusion Middleware Administrator's Guide for Oracle Access Manager at the location:

http://download.oracle.com/docs/cd/E14571_01/doc.1111/e15478/app_domn.htm#CHEIDJAF

43.6 Oracle RTD Administration Issues and Workarounds

There are no known issues at this time.

43.7 Oracle RTD Integration Issues and Workarounds

This section describes issues and workarounds related to Oracle RTD integration. It includes the following topic:

- Section 43.7.1, "Java Smart Client Run Configuration Changes Required for Different Properties Files"

43.7.1 Java Smart Client Run Configuration Changes Required for Different Properties Files

When setting up the Java Smart Client example, depending on the properties file you are using, you must make some changes to the run configuration in Decision Studio before you run the example.

Note:

<RTD_HOME> refers to the directory where you installed the client-side files, for example, C:\RTD_Tools.
The changes you must make in the Arguments tab require you to enter an explicit, full path name. Make sure that you replace <RTD_HOME> with the exact name of your client-side files installation directory.

If you are using sdclient.properties for your properties file, perform the following change:

- In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

- -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\sdclient.properties"

If you are using sdjrfclient.properties for your properties file, perform the following changes:

- In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

- -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\sdjrfclient.properties"

If you are using clientHttpEndPoints.properties for your properties file, perform the following changes:

- In the Arguments tab, add the following in the Program arguments box, replacing <RTD_HOME> with the exact name of your client-side files installation directory:

- -u "<RTD_HOME>\client\Client Examples\Java Client Example\lib\clientHttpEndPoints.properties"

- In the Classpath tab:

- Remove the existing project

- Add the following jar files: commons-code.jar, commons-httpclient.jar, commons-logging.jar, j2ee-client.jar, and rtd-ds-client.jar (if not already present).

- Add the project with defaults

43.8 Oracle RTD Decision Studio Issues and Workarounds

This section describes issues and workarounds related to Oracle RTD Decision Studio. It includes the following topics:

- Section 43.8.1, "Mapping Array Attributes in a Multi-Level Entity Hierarchy"

- Section 43.8.2, "Issues When Trying to Enable Caching for Some Entities"

- Section 43.8.3, "Terminate Active Sessions in Cluster Works Only on Decision Server Receiving Deployment Request"

43.8.1 Mapping Array Attributes in a Multi-Level Entity Hierarchy

A "parent-child" entity hierarchy is typically defined with the child entity as an attribute of the parent entity. When the child entity is an Array attribute, be careful to map the child Array attribute to its data source in the direct parent entity only. Assume, for example, a Customer with many Accounts, each of which has many Contracts. In Decision Studio, the Customer entity's Mapping tab may display the complete hierarchy as follows: - The Customer entity contains the Account entity as an Array attribute - The Account attribute contains the Contract entity as an Array attribute The Account entity's Mapping tab contains the Contract entity as an Array attribute.With this example, only map the Contract attribute in the Account entity's Mapping tab. Do not map the Contract attribute in the Customer entity's Mapping tab.

43.8.2 Issues When Trying to Enable Caching for Some Entities

There are known issues, which may result in compilation and runtime errors, with enabling entity caching where a number of design factors coincide:

- You have a multi-level entity hierarchy, and a child entity is an array attribute of a parent entity

- The data source for the child entity has no Input column defined

- You want to enable caching on the child entity

If possible, simplify the structure of the child entity, specifically the attributes that are mapped to the sources. If this is not possible, contact Oracle Support with details of your particular design configuration.

43.8.3 Terminate Active Sessions in Cluster Works Only on Decision Server Receiving Deployment Request

Deploying an Inline Service to a cluster with the "Terminate active sessions" option selected will terminate sessions on only the Decision Server that receives the Inline Service deployment request.

43.9 Oracle RTD Decision Center Issues and Workarounds

There are no known issues at this time.

43.10 Oracle RTD Performance Monitoring Issues and Workarounds

There are no known issues at this time.

43.11 Oracle RTD Externalized Objects Management Issues and Workarounds

There are no known issues at this time.

43.12 Oracle RTD Localization Issues and Workarounds

There are no known issues at this time.

43.13 Oracle RTD Documentation Errata

This section describes errata in Oracle RTD documentation and help systems. It includes the following topic:

- Section 43.13.1, "Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions"

- Section 43.13.2, "Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions"

43.13.1 Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions

There are no known documentation errata at this time in the Oracle Fusion Middleware Administrator's Guide for Oracle Real-Time Decisions.

43.13.2 Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions

This section describes documentation errata in the Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions. It includes the following topic:

- Section 43.13.2.1, "External Rules Development Helper Mismatch between Code and Manual Description"

- Section 43.13.2.2, "Save Choice IDs in Inline Services Rather Than Choices"

43.13.2.1 External Rules Development Helper Mismatch between Code and Manual Description

The External Rules Development Helper, currently released with the DC_Demo Inline Service, does not function as described in Section 17.2.8, "Setting Up the External Interface and Embedded Rule Editor" and Section 17.3, "Example of End to End Development Using Dynamic Choices and External Rules."

43.13.2.2 Save Choice IDs in Inline Services Rather Than Choices

The Getting Started tutorial chapters within Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions store choices in session-tied entities. It is recommended that configurations only save IDs of choices instead of the full choice objects.

43.14 Oracle RTD Third-Party Software Information

This section provides third-party software information. It includes the following topic:

- Section 43.14.1, "Displaytag Download Location"

43.14.1 Displaytag Download Location

The third-party package Displaytag can be downloaded from http://displaytag.sourceforge.net.

Copyright © 2012, Oracle and/or its affiliates. All rights reserved.