Skip Headers
Oracle® Fusion Middleware Release Notes
11g Release 1 (11.1.1) for Oracle Solaris

Part Number E14772-25
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

54 Oracle Business Intelligence

This chapter describes issues associated specifically with Oracle Business Intelligence. It includes the following topics:

Depending on your Oracle Fusion Middleware implementation, some information in other chapters of this document might also be relevant, including:

54.1 Patch Requirements

This section describes patch requirements for Oracle Business Intelligence. It includes the following topic:

54.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.

54.2 Oracle Business Intelligence General Issues and Workarounds

This section describes general issues and workarounds related to Oracle Business Intelligence. It includes the following topics:

54.2.1 Oracle BI Disconnected Analytics Not Included in Oracle Business Intelligence 11g, Release 11.1.1.3

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, Release 11.1.1.3.

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.3.

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

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 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 the pasteBinary command to use JRockit, which does not have a file size limit. For instructions, see Oracle Fusion Middleware Administrator's Guide.

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

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/.

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

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.

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 54.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.

See also Section 54.12.6.2, "Connecting to Hyperion Financial Management Data Sources with an 11g Client."

54.2.5 Hyperion Financial Management Data Sources Only Available for Windows Deployments

You can only use Hyperion Financial Management as a data source for Oracle BI EE when Oracle BI EE is running in a Windows-only deployment.

54.3 Oracle Business Intelligence Installation Issues and Workarounds

This section describes issues and workarounds related to installing Oracle Business Intelligence. It includes the following topics:

Depending on your Oracle Fusion Middleware implementation, some information in Chapter 2, "Installation, Patching, and Configuration" might also be relevant.

54.3.1 Error When Installing Oracle Business Intelligence Against a SQL Server Database

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.

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

Scale-out scenarios of the BI domain are not supported on machines that have the same operating system but different patch levels. All machines must have the same operating system patch level.

54.3.3 Schema Name and Tablespace Name Issues When Installing on a DB2 Database in a Linux Environment

When using the Repository Creation Utility (RCU) to install the BIPLATFORM and MDS schemas on a DB2 database in a Linux environment, note the following:

  • Ensure that the schema names are eight characters or less.

    Note: The prefix for both the BIPLATFORM and MDS schema names must be the same.

    For example, if you use the prefix "dev," you must edit the default schema name of "dev_BIPLATFORM" to be eight characters or less. You can shorten the suffix, but the prefix for both schema names must be the same. You can edit the schema name by clicking the name to make it an editable field.

    If you do not shorten the schema name to eight characters or less, then RCU returns an error on the Password page that states, "Please enter valid username/password." This is the same error that is returned if the user on the DB2 instance does not have the same password as entered in RCU.

  • There may be a name length restriction for the temporary tablespace name. If the BIPLATFORM tablespace name is too long, then see Oracle Fusion Middleware Repository Creation Utility User's Guide for information about creating a new tablespace with a shorter name. You can also use the same tablespace as that for the new MDS schema.

54.3.4 When Using Repository Creation Utility (RCU) with an IBM DB2 Database, Oracle BI Scheduler Fails to Start

When using Repository Creation Utility (RCU) with an IBM DB2 Database, ensure that the database schemas created by RCU have the required permissions to use the DataDirect ODBC drivers. If these permissions are not set, then Oracle BI Scheduler fails to start because it cannot query the Oracle BI Scheduler tables. You can find the correct permissions in the DataDirect driver documentation at the following location:

http://www.datadirect.com/developer/odbc/docs/odbcdb2bind.pdf

54.3.5 Scale Out in Silent Mode Fails When Using Configuration Assistant

When scaling out an Oracle Business Intelligence system in silent mode, add the following variables to the [GENERIC] section of the silent mode response file (.rsp):

  • CONFIG_MW_HOME

  • CONFIG_ORACLE_HOME

  • CONFIG_WEBLOGIC_HOME

The values of these variables should be set the same as that of the existing MW_HOME, ORACLE_HOME and WEBLOGIC_HOME variables so that a section of the response file looks similar to the following:

#Specify the Middleware Home location.
MW_HOME=/scratch/biee
CONFIG_MW_HOME=/scratch/biee

#Give the name of the Oracle Home directory. The Oracle Home directory name may only contain alphanumeric , hyphen (-) , dot (.) and underscore (_) characters, and it must begin with an alphanumeric character.
ORACLE_HOME=/scratch/biee/Oracle_BI1
CONFIG_ORACLE_HOME=/scratch/biee/Oracle_BI1

#Give the complete path to a valid WebLogic Server Home.
WEBLOGIC_HOME=/scratch/biee/wlserver_10.3
CONFIG_WEBLOGIC_HOME=/scratch/biee/wlserver_10.3

54.3.6 Need to Correctly Create the Oracle Central Inventory in a UNIX Environment

When installing Oracle Business Intelligence on a computer running a supported UNIX operating system with no other Oracle software, ensure that you create the Oracle central inventory correctly. This action ensures correct patching functionality.

54.3.7 Oracle Enterprise Manager Fusion Middleware Control Topology Viewer Status

The status of the Oracle Business Intelligence components shows as Unknown in the Fusion Middleware Control topology viewer page.

There is no workaround for this issue.

54.3.8 Oracle Business Intelligence Installer Stops at Administrator User Details Screen

If you attempt to install on a Windows machine 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 hostname.

The workaround is to configure a loopback adapter or primary DNS suffix.

54.3.9 JRockit Might Become Unstable When Installing Oracle Business Intelligence onto a Shared Network Drive

When installing Oracle Business Intelligence onto a shared network drive, under certain circumstances, JRockit might become unstable.

The workaround is to first install Oracle WebLogic Server in custom mode and only install the Sun JDK (that is, deselect JRockit). The next step is to install Oracle Business Intelligence following the instructions for a 'Software Only Install'.

54.3.10 If Oracle Business Intelligence Installation Fails, Might Need to Increase the MaxPermSize Parameter

If the Oracle Business Intelligence installation fails at the creation of ASInstance, then you might need to increase the MaxPermSize parameter. The failure at the creation of ASInstance is indicated by the following log file entry:

An internal operation has failed: PermGen space

To increase the MaxPermSize parameter:

  1. Perform a Software Only installation as described in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence.

  2. Before running the configuration phase, do the following:

    1. Open the file MW_HOME/ORACLE_HOME/oui/oraparam.ini in a text editor.

    2. Locate the following line:

      JRE_MEMORY_OPTIONS=" -mx512m -XX:MaxPermSize=512m" 
      
    3. Increase the numbers for allocating more memory, for example:

      JRE_MEMORY_OPTIONS=" -mx1024m -XX:MaxPermSize=1024m"
      

      or

      JRE_MEMORY_OPTIONS=" -mx2048m -XX:MaxPermSize=2048m" 
      
    4. Save the oraparam.ini file.

  3. Continue to run the config.bat script as described in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence.

54.3.11 Installing Oracle Business Intelligence on a Shared Drive Might Fail

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

54.4 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:

Depending on your Oracle Fusion Middleware implementation, some information in Chapter 3, "Upgrade" might also be relevant.

54.4.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 topics:

54.4.1.1 Conditional Formatting Might Not Work After Upgrading to Oracle Business Intelligence

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 to Oracle Business Intelligence. 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.

54.4.1.2 Translated Upgrade Assistant Help Files Are Not Available

Translated help files for the Oracle Business Intelligence Upgrade Assistant are not available. When running the Upgrade Assistant in a language other than English, clicking Help displays an error.

There is no workaround.

54.4.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:

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

When upgrading an RPD 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.4.4, "How to Create a Group in the Embedded WebLogic LDAP Server."

    • Create an Application Role as described in Section 2.5.2, "Creating Application Roles Using Fusion Middleware Control."

    • Add the group to the application role as described in Section 2.5.2.2, "How to Create an Application Role."

    If the RPD group was a member of another RPD group, then create the same Group and Application Role hierarchy.

  • For a user:

    • Create the user as described in Section 2.4.3, "How to Create a User in the Embedded Weblogic LDAP Server."

    • Assign the user to the required groups as described in Section 2.4.5, "How to Add a User to a Group in the Embedded Weblogic LDAP Server."

54.4.2.2 Users or Groups With Names Containing Invalid Characters Are Not Upgraded

When upgrading an RPD, 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.

54.5 Oracle Business Intelligence Installation Guidelines for 64-Bit Platforms

54.5.1 Prerequisites for Software Only Installation on 64-Bit Platforms

Before performing Oracle Business Intelligence software only installation, you must install the latest Oracle WebLogic Server wls1034_generic.jar in MW_Home with 64-bit JDK. Then install Oracle Business Intelligence in the same MW_Home.

54.5.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

    • Microsoft Windows x64 (64-Bit)

    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

    This installation type is not supported when installing with a 64-bit JVM on a supported 64-bit operating system. Instead, select the Software Only Install type option.

    For details, refer to Section 4.4.4, "Software Only Install" in Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence.

54.5.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.

54.6 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:

54.6.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:

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

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.

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

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.

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

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.

54.6.1.4 Some Total Rows in Table View Display Incorrect Totals for Level-Based Measures

In some cases, total rows added to the table view of a report display incorrect totals for level-based measures. When the dimension level of the total is at or below the level pinned in the logical column's levels tab for that dimension, the total row should show the pinned (level-based) value. In other words, the detail rows and the total row should all show the same value. However, the table view in these cases incorrectly shows a sum of the detail rows in the total row.

To work around this issue, use a hierarchical column to display the dimension, when possible.

54.6.2 Actions Issues and Workarounds

This section describes issues and workarounds related to actions. It includes the following topics:

54.6.2.1 Action to Invoke a Web Service Cannot Use WSDL on HTTPS

A limitation currently exists in the Action Framework functionality when creating an action to invoke a Web service. If the WSDL file for the target Web service is accessible using the HTTPS protocol, then the Action Framework cannot introspect the WSDL file.

The workaround is to make the WSDL file available over HTTP. Secure the target Web service using an appropriate security policy.

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

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.

54.6.3 Scorecards and KPI Issues and Workarounds

This section describes issues and workarounds related to scorecards and KPIs. It includes the following topics:

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

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.

54.6.3.2 Item Stale Error When Editing a Shared Scorecard in Parallel

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.

54.6.4 Agents Issues and Workarounds

This section describes issues and workarounds related to agents. It includes the following topics:

54.6.4.1 Agent Deliveries Fail with Microsoft Active Directory and Oracle Virtual Directory

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.

54.6.4.2 Agent Deliveries Fail If the Secure Socket Layer (SSL) Is Enabled

If the Secure Socket Layer (SSL) is enabled, then agent deliveries fail.

This issue has no workaround.

54.6.4.3 Loss of Agent Customizations If Agent Folder Is Renamed

If you rename a folder that contains an agent that has been published for subscription and that can be customized by subscribers, then any agent customizations that subscribers have done are lost.

This issue has no workaround.

54.6.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:

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

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/technology/software/products/ias/files/fusion_certification.html

54.6.5.2 Funnel Views Can Be Inserted As Images and Flash Objects

The online help for Oracle BI Add-in for Microsoft PowerPoint states that the funnel view can be inserted only as an image. This is incorrect. The funnel view can also be inserted as a Flash object.

54.6.5.3 Default Title Views or Default Data Formatting Not Imported Into Excel and PowerPoint

Default title views or data formatting might not be imported successfully into Microsoft Excel or PowerPoint.

In case of data formatting, this happens especially when the default data formatting is saved using Save as the system-wide default for <column> or Save as the system-wide default for this datatype in the Column Properties dialog in Oracle BI EE.

The workaround for both title views and data formatting is to clear the default box and specify the required data formatting or contents for the title views explicitly.

54.6.5.4 Server Connections Are Not Automatically Shared by Microsoft Excel and PowerPoint

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.

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

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 11.1.1.3.0.

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.

54.6.5.6 Data Mismatch Might Occur Between Oracle BI EE and the Same View Imported into Microsoft Excel or PowerPoint

Data mismatch might occur between results displayed in Oracle BI EE and the same view imported into Microsoft Excel or PowerPoint. The mismatch might fall into one or more of the following categories:

  • The views imported into Excel or PowerPoint use a different sort order compared to the ones displayed in Oracle BI EE.

  • When filters and prompts are applied, subtotals and grand totals are calculated using report-based totals.

  • When filters and prompts are applied on measures, and one or more columns are unselected while inserting the view in Excel or PowerPoint, the view displayed might not match the one that is displayed in Oracle BI EE. This happens due to the change in the granularity of the analysis as a result of omitting columns, forcing aggregation of measures and applying the filter and prompts next, thus resulting in a different view of the same data.

The workaround is as follows:

  • In the case of a graph view, insert the view as an image or a Flash object. Flash is supported only in Oracle BI Add-in for Microsoft PowerPoint.

  • Ensure that there are no excluded columns in the view definition as compared to the criteria definition.

54.7 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:

54.7.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:

54.7.1.1 JDBC Driver Throws Unsupported Function for setBigDecimal

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."

54.7.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

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/...").

54.7.1.3 Guest Sign In from URL .../xmlpserver Not Supported When Integrated with Oracle BI Presentation Catalog

When BI Publisher is configured to use the Oracle BI Presentation Catalog as the report repository, the Guest Sign In from the .../xmlpserver URL is not supported.

A user attempting to sign in to the BI Publisher Guest account encounters the following error: "Error 500 - Internal Server Error."

The workaround to avoid this error is to switch to .../analytics URL and sign in with a named user account.

54.7.1.4 After Manual Upload of BI Publisher Repository to Oracle BI Presentation Catalog, the BI Publisher Repository Path Displayed Reverts to Default

If you manually enter a repository path to upload the BI Publisher Repository to the Oracle BI Presentation Catalog from the Administration > Server Configuration page, then after you upload the BI Publisher Repository and restart the BI Publisher sever, the path shown for the BI Publisher repository in the Server Configuration page reverts to the default path. However, this does not impact the proper upload of the repository to the Oracle BI Presentation Catalog.

54.7.1.5 Data Model Is Not Editable When Created by Upgrade Assistant

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.

54.7.1.6 Error May Occur When Users Attempt to Use BI Publisher When It Is Integrated with the Oracle BI Presentation Catalog

Attempting to connect to BI Publisher shortly after restarting Oracle Process Management and Notification (OPMN) may result in the following error:

"Error Unauthorized Access: please contact the administrator."

After OPMN is started and running, it takes 3 to 5 minutes to start all the Presentation Services processes needed to log in to BI Publisher.

The workaround is to wait 4 to 5 minutes after OPMN is running before attempting to log in. If the error is encountered, then clear the browser cache before attempting to log in again.

54.7.1.7 When Installing Oracle BI Publisher Only, BI Publisher Scheduler Is Not Configured

During installation of Oracle Business Intelligence, if you choose to install only Business Intelligence Publisher (in the Configure Component Screen), then BI Publisher scheduler is not configured by the installer. To configure the scheduler follow these steps:

  1. Login to BI Publisher as administrator.

  2. Click the Administration link and navigate to Scheduler Configuration in the System Maintenance section.

  3. Make these settings:

    • In the Scheduler Selection region, select Quartz as the Scheduler from the list.

    • In the Database Connection region, set the Database ConnectionType to jndi and enter the JNDI name as jdbc/bip_datasource.

  4. Click the Test Connection button to verify the scheduler database connection.

  5. In the JMS Configuration region, select WebLogic as the JMS Provider. A default WebLogic JNDI URL "t3://localhost:9704" will be populated.

  6. If the port number for your installation is different, then edit the JNDI URL.

  7. Click the Test JMS button to verify the JMS setup.

  8. Click the Apply button.

  9. Select the Scheduler Diagnostics tab to check the updated scheduler status.

54.7.1.8 Missing Data and Charts in the BI Publisher Sales History Report

The BI Publisher report Sales History Report, which is included with the Oracle BI EE 11g, Release 11.1.1.3 samples in the /Shared Folders/Sample Lite/Published Reporting/Reports folder, has missing data and charts.

The workaround is as follows:

  1. Edit the Oracle BI EE analysis Sales by Brand in the /Shared Folders/Sample Lite/Published Reporting/Analyses folder.

  2. From the Subject Areas pane of the Criteria tab, drag and drop the Billed Quantity column from the Base Facts folder of the Sample Sales Lite subject area to the left of the Revenue column in the Selected Columns pane.

  3. Save the Sales by Brand analysis.

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

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 may cause errors when attempting to install the Template Builder or other unexpected behavior.

The workaround is to uninstall Microsoft Office Live Add-in.

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

When configuring a JDBC data source connection or an OLAP connection, the list provided in the BI Publisher Add Data Source page includes 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/technology/software/products/ias/files/fusion_certification.html

It is listed with the documents grouped under the Product Area "Additional Oracle Fusion Middleware 11g Release 1 (11.1.1.x) Certifications."

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

If you are using Internet Explorer 7 as your 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.

54.7.1.12 WSDL Endpoint URL Incorrect in BI Publisher Web Services

In release 11.1.1, BI Publisher exposes four Web services:

  • v2/ScheduleService

  • v2/ReportService

  • v2/SecurityService

  • v2/CatalogService

The list of standalone Web services offered is accessible via http://[hostname]:[portnumber]/[application contextname]/services.

In the WSDL for each Web service, the endpoint for the WSDL URL location (that is, the value for the <wsdlsoap:address location> element) may be incorrectly set to http://localhost:8080, instead of the correct location of the BI Publisher server installation: [machine name] and [port number].

To work around this problem, navigate to the your xmlpserver deployment directory under webapps\xmlpserver and manually update the <wsdlsoap:address location> element in the following files:

  • CatalogService.wsdl

  • ReportService.wsdl

  • ScheduleService.wsdl

  • SecurityService.wsdl

54.7.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:

54.7.2.1 Additional Configuration Required to Secure JMS Queues

By default, the BI Publisher scheduler is configured to use WebLogic Server JMS. The JMS queues are not secured automatically when you configure Oracle Fusion Middleware Security. To secure the JMS queues, you must perform the following:

  • Enable mutual SSL authentication on bi_server1

  • Change BI Publisher Scheduler to use T3S protocol for the JMS connection

To enable mutual SSL authentication on bi_server1:

  1. Login to the weblogic console, http://hostname:port/console (that is, http://mymachine:7001/console).

  2. Select Lock & Edit.

  3. Under Domain Structure, select Environment, then Servers, and then from the list of available servers, select bi_server1.

  4. On the Configuration/General tab:

    1. Select the SSL Listen Port Enabled box.

    2. In the SSL Listen Port field, enter the port (that is, 9804).

    3. Click Save.

  5. On the Configuration/SSL tab:

    1. Click Advanced.

    2. In the Two Way Client Cert Behavior box, select Client Cents Requested and Enforced.

    3. Click Save.

  6. Select Release Configuration and activate your changes.

To change BI Publisher Scheduler to use T3S protocol for the JMS connection:

  1. Login to BI Publisher (http://hostname:9704/xmlpserver).

  2. Select Administration.

  3. Select Scheduler Configuration.

  4. In the JMS Configuration region, in the Weblogic JNDI URL field, enter t3s://hostname:9804. This port needs to match the SSL Listen port set in WebLogic.

  5. Click the Test JMS button to verify.

  6. Click Apply.

Please refer to the WebLogic document on how to disable connecting BI Publisher JMS queues from non-SSL port (that is, 9704).

54.7.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.

54.7.4 Oracle BI Publisher Scheduler Manager Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher Scheduler Manager.

There are no known issues at this time.

54.7.5 Oracle BI Publisher RTF Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher RTF templates.

There are no known issues at this time.

54.7.6 Oracle BI Publisher PDF Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher PDF templates.

There are no known issues at this time.

54.7.7 Oracle BI Publisher Desktop Tools Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher desktop tools.

There are no known issues at this time.

54.7.8 Oracle BI Publisher Flash Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher Flash templates.

There are no known issues at this time.

54.7.9 Oracle BI Publisher Data Template Issues and Workarounds

This section describes issues and workarounds related to Oracle BI Publisher data templates.

There are no known issues at this time.

54.7.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:

54.7.10.1 No Direct Conversion Between Oracle Reports and Oracle BI Publisher 11g

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).

54.7.11 Oracle BI Publisher Documentation Errata

This section describes Oracle BI Publisher documentation errata. It includes the following topics:

54.7.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.

There are no known issues at this time.

54.7.11.2 Oracle Fusion Middleware Administrator's and Developer'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.

54.8 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:

54.8.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:

54.8.1.1 Note about Disallow Online RPD Updates Option in Fusion Middleware Control

The Disallow Online RPD Updates option in the Performance tab of the Capacity Management page in Fusion Middleware Control affects whether you can perform both online and offline updates to repository files, using the Administration Tool or other utilities.

54.8.1.2 Use of NQClient (BI ODBC Client) Utility Is Deprecated

The NQClient (BI ODBC Client) utility is 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.

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

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/technology/products/bi/enterprise-edition.html

54.8.2 Oracle BI Server Issues and Workarounds

This section describes issues and workarounds related to the Oracle BI Server. It includes the following topic:

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

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 11.1.0.7, patch bundle 27 or higher.

54.8.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:

54.8.3.1 Administration Tool Incorrectly Displays Option for Generate Deployment File

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.

54.8.3.2 Issue with Online Import Object Checkout

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.

54.8.3.3 MUD History Must Be Manually Upgraded in Oracle Business Intelligence Release 11g (11.1.1.3)

The Oracle BI Administration Tool multiuser development (MUD) environment enables users to obtain historical information about repository changes, as follows:

  • Subset changes prior to merge are stored as modified subset repositories.

  • Each version in the MUD location is stored as repository_name.version_number.

In this release of Oracle Business Intelligence, RPD files are now encrypted with a user-specified repository password. As a result, the Administration Tool can only open repository files that have been fully upgraded and encrypted.

To enable the Administration Tool to open versioned MUD repository files and access MUD history, upgrade all repositories in the MUD directory. Upgrade all repository files in the MUD directory with the following naming patterns, where ddd is the version number:

  • modified subset of repository_name.ddd

  • repository_name.ddd

To upgrade MUD repositories so that you can access MUD history:

  1. Run bi-init.cmd (or bi-init.sh on UNIX) to launch a command prompt or shell window that is initialized to your Oracle instance. You can find this utility in:

    ORACLE_INSTANCE/bifoundation/OracleBIApplication/coreapplication/setup
    
  2. Run obieerpdmigrateutil from the resulting shell window with the desired options, as follows:

    obieerpdmigrateutil -I input_repository_path -O output_repository_path
    -L ldif_output_path -U 10g_administrator_username
    

    Where:

    input_repository_path is the name and location of the RPD you want to upgrade and encrypt.

    output_repository_path is the name and location of the upgraded and encrypted RPD. This value can be the same as the input repository path.

    ldif_output_path is the path of the LDIF output file generated by the utility. It contains the users and groups from the old RPD for importing into your LDAP Identity Store.

    10g_administrator_username is the Administrator user name for the repository in the previous release.

    For example:

    obieerpdmigrateutil -I C:\mud_dir\my_repos.001 -O C:\upgr\my_repos.001
    -L C:\upgr\ldif\my_ldif.ldif -U Administrator
    
  3. When prompted, enter the 10g administrator password and a new repository encryption password. Do not forget the repository password, because you cannot open the repository without it. To avoid errors, use the same repository password for all repository files in your MUD environment.

Tip: If you have a large number of MUD repositories, then you might want to create a script to automate the MUD repository migration tasks.

54.8.3.4 Patch Available to Hide Selected Consistency Check Warnings

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 54.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.

54.9 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:

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.

54.9.1 General System Administration Issues and Workarounds

This section describes general issues and workarounds related to Oracle Business Intelligence system administration. It includes the following topic:

54.9.1.1 Log File Entries for Agents Might Show Different Execution Context IDs (ECIDs)

Log file entries for agents might show different Execution Context IDs (ECIDs) from those that appear in Oracle Fusion Middeware Control.

This issue has no workaround.

54.9.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).

There are no known issues at this time.

54.9.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.

54.9.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 54.4.2, "Security-related Upgrade Issues and Workarounds".

This section includes the following topics:

54.9.4.1 Permission Required to Open Catalog Manager in Online Mode

Only users with the OPSS permission oracle.bi.presentation.catman.manageCatalog can open the Catalog Manager in online mode.

54.9.4.2 Sign-in Might Fail If Username or Password Contains Multibyte Characters

If a user tries to sign in to Oracle Business Intelligence using a user name or a password that contains multibyte characters, then the sign-in might fail. This is also the case if Oracle Business Intelligence is configured to work with Oracle Single Sign-On.

This issue has no workaround.

54.9.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.

54.10 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:

54.10.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.

54.10.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.

54.11 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:

54.11.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:

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

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.

54.11.1.2 Oracle BI Publisher Requires Oracle WebLogic Server to Run in en_US Locale

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.

54.11.1.3 User Names with Superscript Letters Cannot Perform Expected Functions

If a user name contains superscript letters, then the user cannot perform basic functions within Oracle Business Intelligence. For example, creating a data model for published reporting, uploading a layout template, or scheduling a job.

To work around this problem, do not include superscript letters in a user name.

54.11.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:

54.11.2.1 Oracle Business Intelligence Help Systems Are Not Translated in Release 11.1.1.3

None of the Oracle Business Intelligence help systems are translated in Release 11.1.1.3.

54.12 Oracle Business Intelligence Documentation Errata

This section describes errata in Oracle Business Intelligence documentation and help systems. It includes the following topics:

54.12.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.

54.12.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.

54.12.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:

54.12.3.1 ODBC and JDBC Drivers Incorrectly Included in List of Administration Clients

In Section 4.6.1, "Installing Oracle Business Intelligence Client Tools" of Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence, the following components were incorrectly included in the list of administration clients:

  • Oracle Business Intelligence ODBC Driver

  • Oracle Business Intelligence JDBC Driver

54.12.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. It includes the following topic:

54.12.4.1 Error in Chapter 4, "Upgrading Oracle Business Intelligence Enterprise Edition", Incorrect Version Number Mentioned

There is an error in the first paragraph of Chapter 4, "Upgrading Oracle Business Intelligence Enterprise Edition" in Oracle Fusion Middleware Upgrade Guide for Oracle Business Intelligence. The paragraph incorrectly reads:

"This chapter describes how to upgrade your existing Oracle Business Intelligence Enterprise Edition (Oracle BI EE) 10g Release 3 (10.3.2 or later) environment to Oracle Business Intelligence 11g."

The release number mentioned in the paragraph is incorrect. The paragraph should read:

"This chapter describes how to upgrade your existing Oracle Business Intelligence Enterprise Edition (Oracle BI EE) 10g Release 3 (10.1.3.2 or later) environment to Oracle Business Intelligence 11g."

54.12.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:

54.12.5.1 Error in Chapter 3, Section Entitled "Adding Totals to Tables and Pivot Tables"

Chapter 3 contains a section named "Adding Totals to Tables and Pivot Tables." That section contains a four-step procedure for adding totals to a view. Step 4 was included in that procedure in error and must be removed.

54.12.5.2 Information on Taking Ownership of Objects

The Properties dialog contains an Ownership area in which you can take ownership of an object in the catalog. The options in this area are not described in the documentation. This area displays only if the proper privileges were assigned to the user, group, or role. You can click links to set the ownership of an object or of an object and all its sub-objects.

54.12.6 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:

54.12.6.1 Error in Appendix A, "Managing the Repository Lifecycle in a Multiuser Development Environment"

Appendix A, "Managing the Repository Lifecycle in a Multiuser Development Environment" includes the following sentence:

"The RCU tables can be shared by multiple development sandboxes without conflict."

This sentence is incorrect. Each separate Oracle Business Intelligence system requires its own set of RCU database schemas. See Oracle Fusion Middleware Installation Guide for Oracle Business Intelligence for information about RCU schema requirements.

54.12.6.2 Connecting to Hyperion Financial Management Data Sources with an 11g Client

Oracle Fusion Middleware Metadata Repository Builder's Guide for Oracle Business Intelligence Enterprise Edition provides information about connecting to Hyperion Financial Management data sources. The instructions work if you are using a Hyperion Financial Management 9.3.1 client, but do not work for Hyperion Financial Management 11g clients.

Follow these steps to connect to Hyperion Financial Management data sources with an 11g client:

  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 JavaHost process. For example:

    <ias-component id="coreapplication_obijh1">
    
  3. Within the environment tag, add new variables required for Hyperion Financial Management, using the following example as a guide. Update the actual values as appropriate for your installation.

    <variable id="HYPERION_HOME" value="C:/oracle/Middleware/EPMSystem11R1"/>
    <variable id="EPM_HOME" value="C:/MW_Home/Oracle_BI1/common/jlib/11.1.2.0"/>
    <variable id="ADM_HOME" value="C:/MW_Home/Oracle_BI1/common/ADM/11.1.2.0"/>
    <variable id="HFM_HOME" value="$HYPERION_HOME/products/FinancialManagement/Client"/>
    <variable id="ADM_ESS_NATIVE_HOME" value="$ADM_HOME/"/>
    <variable id="CSS_HOME" value="c:/MW_Home/Oracle_BI1/common/CSS/11.1.2.0"/>
    
  4. Update the PATH variable to include ADM_HOME/bin and the client and common subdirectories of HYPERION_HOME. For example:

    <variable id="PATH" value="C:\oracle\product\10.2.0\db_1\BIN$:$ADM_HOME/bin$:$HYPERION_HOME/products/FinancialManagement/Common$:$HYPERION_HOME/products/FinancialManagement/Client$:$ORACLE_HOME/common/ODBC/Merant/5.3/lib$:$ORACLE_HOME/bifoundation/server/bin$:$ORACLE_HOME/bifoundation/web/bin$:$ORACLE_HOME/bifoundation/odbc/lib$:$ORACLE_INSTANCE$:$ORACLE_HOME/lib" append="true"/>
    
    
  5. Locate the data id="start-args" tag and update the classpath attribute to include the location of required jar files. For example:

    <data id="start-args" value="-Xmx1024M -Djava.security.manager=default -DXDO_
    FONT_DIR=$ORACLE_HOME/common/fonts -Djava.security.policy=$ORACLE_
    INSTANCE/config/$COMPONENT_TYPE/$COMPONENT_NAME/java.policy 
    -Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration 
    -Doracle.core.ojdl.logging.config.file=$ORACLE_INSTANCE/config/$COMPONENT_
    TYPE/$COMPONENT_NAME/logging-config.xml -Doracle.home=$ORACLE_HOME 
    -Doracle.instance=$ORACLE_INSTANCE -Doracle.component.type=$COMPONENT_TYPE 
    -Doracle.component.name=$COMPONENT_NAME -classpath $COMMON_COMPONENTS_
    HOME/modules/oracle.odl_11.1.1/ojdl.jar$:$ORACLE_
    HOME/bifoundation/javahost/lib/core/sautils.jar$:$ORACLE_
    HOME/bifoundation/javahost/lib/core/mad.jar$:$ORACLE_
    HOME/bifoundation/javahost/lib/core/sawconnect.jar$:$ORACLE_
    HOME/bifoundation/javahost/lib/core/javahost.jar$:$COMMON_COMPONENTS_
    HOME/modules/oracle.xdk_11.1.0/xmlparserv2.jar$:$ORACLE_
    HOME/opmn/lib/ons.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_
    11.1.1/jps-manifest.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_
    11.1.1/jps-api.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_
    11.1.1/jps-common.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.jps_
    11.1.1/jps-internal.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_
    11.1.0/orai18n.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_
    11.1.0/orai18n-collation.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.nlsrtl_
    11.1.0/orai18n-mapping.jar$:$COMMON_COMPONENTS_HOME/modules/oracle.dms_
    11.1.1/dms.jar$:$EPM_HOME/epm.jar$:$ADM_HOME/lib/adm.jar$:$ADM_HOME/lib/ap.jar$:$CSS_HOME/lib/css.jar$:$CSS_HOME/lib/common-model.jar$ com.siebel.analytics.javahost.standalone.Main"/>
    
  6. Save and close the file.

  7. Go to the directory ORACLE_HOME/bifoundation/javahost/lib/obisintegration/adm and delete all jar files except for admintegration.jar and admimport.jar.

  8. Restart the JavaHost process.

54.12.7 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:

54.12.7.1 Error in Section 19.3.2, "Manually Configuring for Graphs and Gauges"

Section 19.3.2, "Manually Configuring for Graphs and Gauges," describes the DefaultImageType element. This element is no longer supported, and its description must be removed from the guide.

54.12.7.2 Clarification of CaseInsensitiveMode Element

Appendix E 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>

54.12.7.3 Error in Section 22.3.2 "Specifying Defaults for Styles and Skins"

Section 22.3.2 "Specifying Defaults for Styles and Skins" 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>

54.12.7.4 Changing Ownership of Catalog Objects

Section 18.6.4 describes how to work with the properties of objects in the catalog. The section includes a step for selecting the owner of an object. The section must be updated to state that the Owner list now includes the name that you used to log into Catalog Manager. Therefore, you can use this list to select yourself as the owner of the object, if you have the appropriate permissions. You can select Apply Recursively to take ownership of the object and all its sub-objects.

54.12.7.5 Updates of Information About the Catalog

The following sections provide information for inclusion in Chapter 18, "Configuring and Managing the Oracle BI Presentation Catalog."

54.12.7.5.1 Guidelines for Object Names

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 54.12.7.5.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"\?
    
54.12.7.5.2 Handling Users of the Catalog

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, 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.)

54.12.7.5.3 Handling Heterogeneous Nodes

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".

54.12.7.5.4 Handling Catalog Files on Various Platforms

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 noticably 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.

54.12.7.5.5 Known Issues with Catalog Files

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 54.12.7.5.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.

54.12.7.5.6 Validating the Catalog

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.

54.12.7.5.7 Performing a Basic Validation of the Catalog

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.

  2. Refresh the user GUIDs for the catalog. See Chapter 3 of the Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition 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 54.12.7.5.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.

54.12.7.5.8 Specifying the Elements for Validating the Catalog

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 54-1.

  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</Validate>
        <ps:ValidateAccounts>Clean</ValidateAccounts>
        <ps:ValidateHomes>Report</ValidateHomes>
        <ps:ValidateItems>Clean</ValidateItems>
        <ps:ValidateLinks>Clean</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 54-1 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.

54.12.7.5.9 Updates for XML Files and Text Strings

Section 18.8.2.1 "XML File Format for Searching for and Replacing Text Strings" 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 whether you want to replace text, a column name, a subject area name, a table formula, or an entire formula. Valid values are:

    • textReplace — Replaces text other than the name of a table, column, formula, or subject area.

      The textReplace action occurs first, before other node-specific actions (for example, before renameSubjectArea).

    • renameTable — Renames the table part of a formula alone.

    • renameColumn — Replaces the name of a column.

    • renameFormula — Renames the entire formula.

    • renameSubjectArea — Replaces the name of a subject area.

    • subjectArea — Apply this optional attribute to renameTable, renameColumn, or renameFormula.

  • 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 because that syntax links documents. 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 54-2 provides sample strings for use with the regex syntax in search criteria.

    Table 54-2 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.

54.12.7.6 Removal of Section on Including Links with Analyses on Dashboards

The "Configuring and Managing Analyses and Dashboards" chapter of the guide includes the "Including Links with Analyses on Dashboards" section. This section is not applicable for this release and must be removed from the guide.

54.12.8 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 topic:

54.12.8.1 Incorrect Information in Section 5.3, "Configuring the Web Server to Use HTTPS Protocol"

Section 5.3, "Configuring the Web Server to Use HTTPS Protocol" contains the following information:

These properties are set by editing MW_Home/user/projects/domains/bifoundation_domain/bin/startManagedWebLogic.sh (or .bat), and adding the properties to the end of the JAVA_OPTIONS value. Note that any \ character in a path must be escaped with another \ character.

For example, the following edits are made if using the demonstration Oracle WebLogic Server certificate:

set JAVA_OPTIONS=%JAVA_OPTIONS% -Djavax.net.ssl.trustStore="C:/biee/wlserver_10.3/server/lib/DemoTrust.jks" -Djavax.net.ssl.trustStorePassword=""  

If this step is omitted, then Web Services for SOA and BI Search fail.

This information is incorrect. It should read as follows:

These properties are set by:

  • Editing the following:

    • In Linux, MW_Home/user_projects/domains/bifoundation_domain/bin/setDomainEnv.sh

    • In Windows, MW_Home\user_projects\domains\bifoundation_domain\bin\setDomainEnv.cmd

  • Adding the properties to the end of the JAVA_OPTIONS value

Note that any \ character in a path must be escaped with another \ character.

For example, the following edits are made if using the demonstration Oracle WebLogic Server certificate:

  • In Linux:

    JAVA_OPTIONS="${JAVA_OPTIONS} -Djavax.net.ssl.trustStore=MW_Home/wlsserver_10.3/server/lib/DemoTrust.jks -Djavax.net.ssl.trustStorePassword=" 
    
  • In Windows:

    set JAVA_OPTIONS=%JAVA_OPTIONS% -Djavax.net.ssl.trustStore="MW_Home/wlserver_10.3/server/lib/DemoTrust.jks" -Djavax.net.ssl.trustStorePassword="" 
    

If these options are not set, then login fails.

54.12.9 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.

54.12.10 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:

54.12.10.1 Incorrect Information Regarding the Integration with Oracle WebCenter

The "New Features" section and Chapter 3, "Integrating Oracle Business Intelligence Presentation Services With Oracle WebCenter" provide information on using JDeveloper to create and configure a WebCenter application that integrates with the Oracle BI Presentation Catalog. This information is in error.

Also in error is the information on the WebCenter in the following sections:

  • Section 1.4.1.2, "Installing the Required JDeveloper Extensions"

  • Section 1.8, "Adding or Modifying a Presentation Services Connection After Deployment"

  • Section 1.8.1.2, "Adding or Modifying a Presentation Services Connection"

A fully productized integration of Oracle Business Intelligence with Oracle JDeveloper and Oracle WebCenter is not available with this Oracle Business Intelligence release and the 11.1.1.3.0 releases of Oracle JDeveloper and Oracle WebCenter.

54.12.11 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.

54.12.12 Oracle Business Intelligence Help System Errata

This section describes errata in the Oracle Business Intelligence help systems.

There are no known issues at this time.