Skip Headers
Oracle® Business Intelligence Applications Installation and Configuration Guide
Version 7.9.4
E10742-01
  Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

H Troubleshooting Oracle Business Intelligence Applications

This chapter details some common problems related to the Oracle Business Analytics Warehouse and suggests possible solutions. It contains the following topics:

Note: When you troubleshoot installation and configuration issues, use the following log information:

On Windows:

On UNIX:

H.1 Oracle Business Analytics Warehouse Installation and Initial Configuration Issues

Table H-1 provides information about problems and solutions related to the installation and initial configuration of the Oracle Business Analytics Warehouse.

Table H-1 Oracle Business Analytics Warehouse Installation and Configuration Issues

Symptom/Error Message Probable Cause/Solution

Cannot connect to the Oracle Business Analytics Warehouse running on DB2.

Make sure that the DB2 configuration matches the requirements listed in Section 3.4, "IBM DB2 UDB-Specific Database Guidelines for Oracle Business Analytics Warehouse".

After installing Informatica's ODBC driver (V3.5) on a Windows computer, you cannot open the Query Analyzer, and the Enterprise Manager shows an error message.

The ODBC driver installation replaces the odbcbcp.dll file with an older version. The Informatica documentation contains the procedure for correcting this problem.

Cannot connect to Oracle Business Analytics Warehouse from Informatica.

Make sure that the server running the Informatica Server software has an ODBC connection to the Oracle Business Analytics Warehouse using a Siebel ODBC driver and an ODBC connection to the Oracle Business Analytics Warehouse using the Merant Closed 3.5 32-bit driver.

Error: ORA-12541: TNS:no listener.

Check the Compatibility tab in Informatica service configuration. It should be Oracle 8. If it is not set to Oracle 8, change it and restart the Informatica server.

Error 2140 (Informatica service failed to start).

The server may not be started or the Informatica Service may not be started. See Informatica's installation and configuration guide on Siebel eBusiness Third-Party Bookshelf for detailed information.

Informatica installation fails with an Unhandled Exception error and displays a message similar to this: "Error Number: 0x80040707. Description: Dll function call crashed: ISRT._DoInstall."

The computer is probably running out of virtual memory. Restart the computer and reinstall Informatica.

After selecting "Warehouse Default Amount (Yen)" as the currency symbol, the dollar sign ($) is still displayed.

The currencies.xml file must be edited. For instructions, see Appendix B, "Changing the Default Currency in Analytics Applications".


H.2 Informatica and Loading Issues

Table H-2 provides information about problems and solutions related to issues with Informatica and loading. To view the Informatica log file details, double-click the workflow.

Table H-2 Informatica and Loading Issues

Symptom/Error Message Probable Cause/Solution

Double-clicking the workflow yields a Workflow Manager error message: "The system cannot find the file specified."

The session log files are not set up properly. You also may need to change the text editor.

Using Oracle, some mappings hang while running when performance statistics are switched on.

When running some Informatica mappings for loading the Oracle Business Analytics Warehouse, turning on the Performance Statistics can cause the mapping to hang. The only workaround is to increase the values of the LMSharedMemory and MaxSessions variables in Informatica. The risk of increasing the LMSharedMemory too much is that it may start to have a serious effect on overall performance of the machine that the Informatica server is running on.

When you execute a workflow on the Informatica Workflow Manager, Informatica returns the following error message:

"Request to start workflow (workflow name) on server (server name) not successful."

This can happen due to a server time-out property that is usually set to 20 or 40 seconds. When you try to run a large workflow, every session in that workflow is fetched into the server's memory. If this takes longer than the server time-out property, the server returns a message that the workflow was unable to run. However, the workflow is running, but the server just needs time to complete fetching the sessions into memory. Double-click the workflow to view the log file details.

Informatica (RDBMS is DB2) gives the following error message:

Error occurred unlocking [SDE_ServiceRequestDimension1].

An error occurred while accessing the repository[[IBM][CLI Driver][DB2/6000] SQL0955C

Sort memory cannot be allocated to process the statement. Reason code = "".

SQLSTATE=57011]

DB2 Fatal Error[FnName: ExecuteDirect -- SQLSTATE=57011 [IBM][CLI Driver][DB2/6000]

The DB2 parameter "SHEAPTHRES" is too small.

When loading the data warehouse, Informatica reports a lock problem.

Either someone has a session open or there is a dead session. Make sure no one has any open sessions. If no sessions are open, then follow the Informatica documentation on removing locks caused by dead sessions.

Session SDEINC_RecordExtractStart fails due to unique constraint error while executing a Refresh workflow.

This could be because the previous load or refresh did not complete successfully. Fix the problem that caused the previous refresh session to fail. Make sure you start the process from last entry of %RestartNextWorkflow # before the failed session, and restart the workflow process from that point.

The session fails and you receive the following error code:

Error "TE_7042 Aggregate Error: File Operation Error

This is due to a disk space limitation. Check the /Informatica/PowerMart/Cache/Check directory for available disk space, also check the limits (ulimit) of the account used to start PowerMart.

Informatica sessions get deadlocked and eventually fail when they try to do a "select" from the repository table OPB_OBJECT_LOCKS. This problem sometimes occurs on MSSQL server databases.

This is possibly caused by a limited number of resources on the MSSQL Database Server. The workaround is to execute the following MSSQL specific SQL command on the Oracle Business Analytics Warehouse:

DROP INDEX OPB_OBJECT_LOCKS.OPB_OBJ_LOCKS_IDX

DROP INDEX OPB_OBJECT_LOCKS.OPB_OBJ_LOCKS_IDX2

DROP INDEX OPB_OBJECT_LOCKS.OPB_OBJ_LOCKS_IDX3

Upon completion of executing these commands, continue executing the workflow processes to load the Oracle Business Analytics Warehouse.

An error may occur when trying to send a post session email notification using MS Outlook 2000. Refer to Informatica release notes for further information.

After installing Informatica Server on Windows, copy the file mapi32.dll from winnt\\system32 to the bin folder where the Informatica Server is installed, overwriting the existing mapi32.dll in that directory. Start the Informatica Server so that the Informatica Server can use the new mapi32.dll.

The Extended MAPI Error. MAPILogonEx failed[2147746065] error indicates that the logon is not configured correctly. Check the following:

  1. Choose Services, then Informatica, then Logon, and make sure the login (domain\username) and password are correct.

  2. Choose Control Panel, then Mail (it may also be called Mail and Fax or Exchange), then Services, then Show Profiles, and make sure the mail profile is correct.

  3. Choose Programs, then Informatica Server, then Informatica Server Setup, then Miscellaneous, and make sure the MS Exchange profile is correct.

While creating a custom session, bulk load mode does not work properly with SQL Server.

Change the mode to "normal" in Informatica repository for the session. The "normal" mode must be used everywhere for SQL Server in all of your custom sessions.

Outlook closes when sending out a notification of finishing the ETL process.

Informatica is closing Outlook. This issue is known to Informatica and is scheduled to be resolved in an upcoming release. Until then, create a second profile in Outlook and add that profile name to the Informatica server setup.

Oracle 8i sessions running in bulk mode fail and return an error message similar to:

WRITER_1_1_1> CMN_1022 Database driver error...

CMN_1022 [

ORA-00600: internal error code, arguments: [kpodpmop_01], [2], [], [], [], [],[], []

Or

MAPPING> TE_7022 TShmWriter: Initialized

MAPPING> Sat Jan 26 13:54:45 2002

MAPPING> TE_7001 Internal error: Failed to allocate a target slot. Sat

MAPPING> Jan 26 13:54:45 2002 TE_7017

Failed to Initialize Server

MAPPING> Transformation

BLK_ALL_DATATYPES1 Sat Jan 26 13:54:45

2002MAPPING> TM_6006 Error initializing DTM for session...MAPPING> TM_6020 Session [s_BULK_LONG] completed at [Sat Jan 26 13:54:45 2002]

This problem is an Oracle 8i defect. It has been resolved in Oracle 9i. The workaround is to run the session in Normal mode. To do so, in Workflow Manager navigate to the Targets window, and change the Target Load type to Normal.

During an ETL execution, when Informatica and DAC servers use DB2 Connect version 7 to talk to DB2/390 version 7 OLTP and data warehouse databases, you receive an error message similar to the following:

SEVERE: [IBM][CLI Driver][DB2] SQL0191N Error occurred because of a fragmented MBCS character. SQLSTATE=22504

103 SEVERE Tue May 11 21:37:29 CDT 2004 [IBM][CLI Driver][DB2] SQL0191N Error occurred because of a fragmented MBCS character. SQLSTATE=22504

This problem is a DB2 Connect version 7 (IBM) defect related to code page conversion. The problem has been resolved in DB2 Connect version 8.

To correct the problem, do the following:

  1. Download the file IBM01140.ucs from

    ftp://ftp.software.ibm.com/ps/products/db2/fixes/english/siebel/siebel7/Conversion_Files

    to the /sqllib/conv directory.

  2. Make a copy of the file and rename it to IMB05348.ucs.

When an ETL process is running and tasks fail, Informatica returns an error similar to the following:

Error while running Workflow Description: ERROR : TM_6292 : (3040|4868) Session task instance REP_12400 [Repository Error ([REP_51055] Repository agent connection failed. [System Error (errno = 121): The semaphore timeout period has expired. . (Cannot read message. Read 5824 bytes.)])]

This issue is related to the network. The workaround is to increase the Timeout parameter values in the Informatica Repository Server Administration Console.

  1. In the left pane of the Repository Server Administration Console window, right click your repository and select Edit Connection.

  2. In the Network tab, enter 9 as the value for the parameters MessageReceiveTimeout and MessageSendTimeout.

  3. Stop and start the Informatica Repository Server.

  4. Start the Informatica Server.

[IBM][CLI Driver] CLI0102E Invalid conversion. SQLSTATE=07006 sqlstate = 07006 [IBM][CLI Driver][DB2/AIX64] SQL0303N A value cannot be assigned to a host variable in the SELECT, VALUES, or FETCH statement because the data types are not compatible. SQLSTATE=42806 sqlstate = 42806This issue comes up when you use 'Unicode' data movement in Informatica.

The target table that the mapping is inserting into is a non-unicode table. Make sure the table is created as an Unicode table.

The ELT run fails with one of the following errors:

FATAL ERROR : Caught a fatal signal [11]. Will abort this server process shortly. INFO : CMN_1131 : (3644|1) System shared memory [360454] for [Load Manager Shared Memory] removed.

FATAL ERROR : Aborting this server process due to a fatal signal [11].

If you want to perform ETL runs in Informatica on HP-UX Itanium 2 64-bit, you need to install one of the following patches:

HP-UX 11.11 Itanium 64-bit systems require Patch PHSS_33033 or higher.

HP -UX 11.23 Itanium 64-bit systems require Patch PHSS_33349 or higher.


H.3 Unicode Issues with Informatica and the Oracle Business Analytics Warehouse

Table H-3 provides information about problems and solutions related to Unicode issues with Informatica and the Oracle Business Analytics Warehouse.

Table H-3 Unicode Issues with Informatica and Oracle Business Analytics Warehouse

Symptom/Error Message Probable Cause/Solution

Task fails and generates the error message: "TRANSF_1_1_1_1> TE_7073 Aggregate Error: Expecting keys to be ascending." Tasks known to fail are SDE_DtlForecastFact and SDE_CostList

In Informatica Mapping Designer, open the corresponding mapping and in the Aggregator transformation, remove the check from the Sortedinput check box.

In the Windows 2000 environment, with a double-byte language, such as Japanese, when you try to input the path for the directory where Informatica is installed for the value $PMRootDir in the Workflow Manager, the double-byte characters are converted to question marks. This causes the ETL to fail because it cannot find the Informatica Server folder and its subdirectories.

Share the folder under a new name with no double-byte characters, and use the network share as the value for $PMRootDir.

When Configuring the Informatica Server or Informatica Repository Server, there are major truncations in some of the tabs.

For example, in the Server tab and the Repository tab in the Configure Informatica Service screen (choose Start, then Programs, then Informatica Server, then Informatica Server Setup, then Configure Informatica Service), the field names are truncated.

Informatica 6.x does not support non-English messages and resources. Delete the following files to display all messages in English.

PC/PM client folder\*411.dll

PMServer folder\bin\*411.dll

PMRepServer folder\bin\*411.dll

Unable to start the Informatica repository with the Informatica Repository Server on UNIX.

The Oracle_BI_DW_Base (MS Windows Japanese and superset of Shift-JIS) is not compatible with that of pmrepagent (UTF-8 encoding of Unicode).

Make sure Japanese locales are installed on the UNIX machine. The environment variables on the UNIX machine are not complete. Set the environment variable PM_CODEPAGENAME to MS932. For other languages, set the variable appropriately.

The database connection code page is incorrect for Unicode/Non-Latin code pages.

The database connection code page has to be set manually through the Informatica Workflow Manager.

  1. Start the Workflow Manager.

  2. Connect to the Oracle_BI_DW_Base using Administrator as the user.

  3. Click Menu Connection, then Select Relational.

  4. Select the appropriate OLTP connection (DB2_OLTP for DB2, ORA_OLTP for Oracle, MSSQL_OLTP or ODBC_OLTP for MSSQL).

  5. For the code page select the UTF-8 encoding of Unicode or the appropriate code page, and then click OK.

  6. Select the OLAP connection (DB2_OLAP for DB2, ORA_OLAP for Oracle, MSSQL_OLAP or ODBC_OLTP for MSSQL).

  7. For the code page select the UTF-8 encoding of Unicode or the appropriate code page, and then click OK.

Unable to install Informatica PowerMart on non-English UNIX locales (for example, ESN, DEU, FRA, ITA). The following error message appears: "FATAL ERROR during initialization, Invalid language specified, Application terminated."

This error will occur when the locale environment variables are set inconsistently or not at all. These settings are determined by entering the command locale at the UNIX command prompt. Make sure the correct locales are installed on the UNIX machine. Set the environment variable PM_CODEPAGENAME correctly (For example set it to MS932 for Japanese).


H.4 UNIX Installation Issues with the Oracle Business Analytics Warehouse

Table H-4 provides information about issues related to installing the Oracle Business Analytics Warehouse on UNIX.

Table H-4 UNIX Installation Issues with Oracle Business Analytics Warehouse

Symptom/Error Message Probable Cause/Solution

When starting Informatica in pmserver.log, the following error messages appear:

FATAL ERROR: LM_36023 [Tue Mar 11 23:12:41 2003]: (9968|1) The IP address [172.0.129.141] for this machine did not match the IP address [172.20.94] in the repository for server [ORACLE_BI_DW_SERVER].

FATAL ERROR: SF_34014 [Tue Mar 11 23:13:41 2003]: (9968|1) Server initialization failed.

INFO: SF_34014 [Tue Mar 11 23:13:41 2003]: (9968|1) Server shut down.

Launch Workflow Manager, then right-click on Oracle_BI_DW_Base and click More. Make sure the Host Name is the machine name where the Informatica Repository Server resides.

When connecting to the Informatica Repository Server from the Repository Administration Console, the following error messages appear:

  • Oracle databases running on Solaris or HP:

    Database Connection Error: Database driver event...Error occurred loading library [Bad magic number for shared library: /export/home/oracle/9.0.1.3/lib/libclntsh.sl]Database driver event...Error occurred loading library [libpmora8.sl]

  • DB2 databases running on AIX:

    (17764|1) Database Connection Error: Database driver event...Error occurred loading library [No such file or directory] Database driver event...Error occurred loading library [libpmdb2.a]

Use Oracle 32-bit library.

  1. Set the environment variable as follows: LD_LIBRARY_PATH=/export/home/oracle/9.0.1.3/lib32

  2. Restart the Informatica Repository Server service.

DB2 databases running on AIX:

Database Connection Error: Database driver event...Error occurred loading library [No such file or directory] Database driver event...Error occurred loading library [libpmdb2.a]

  • Set the environment variable as follows:

    For DB2 v8:

    setenv LIBPATH ${LIBPATH}:/usr/opt/db2_08_01/lib

  • For DB2 v7:

    setenv LIBPATH ${LIBPATH}:/usr/lpp/db2_07_01/lib

  • Restart the Informatica Repository Server service, after setting the variable.

When restoring the Informatica Repository, the following error message appears in the dwdb.log:

ERROR: OBJM_54543 [Tue Mar 25 17:47:16 2003]: (164|2484) DataBase error:

ORA-01461: can bind a LONG value only for insert into a LONG column

The database is Unicode and the environment variable is needed.

  1. For Unicode UTF8, set the environment variable to:

    American_America.UTF8

  2. For Unicode AL32UTF8, set the environment variable to:

    American_America.AL32UTF8

When starting pmserver on UNIX, the following error message appears:

INFO: LM_36039 [Thu Mar 27 11:40:29 2003]: (6772|1) The maximum number of sessions that can run simultaneously is [10].

FATAL ERROR: CMN_1011 [Thu Mar 27 11:40:29 2003]: (6772|1) Error allocating system shared memory of [3000000] bytes for [Load Manager Shared Memory]. Error is [0]: []

FATAL ERROR: SF_34004 [Thu Mar 27 11:40:29 2003]: (6772|1) Server initialization failed.

INFO: SF_34014 [Thu Mar 27 11:40:29 2003]: (6772|1) Server shut down.

In the pmserver.cfg file, change MaxSessions to 15 and change LMSharedMem to 3000000.

Note: For each 10 count increase of MaxSessions, increase the LMSharedMem by 2000000 bytes.

A session fails (any session), and the following error message appears:

TM_6227 Error: codepage incompatible in session [SDE_RecordExtractStart]. The source database DB2_OLTP and server ORACLE_BI_DW_SERVER do not have compatible code pages. (One way compatibility is required).

For Informatica servers running on UNIX, in the pmserver.cfg file, set ValidateDataCodePages to No.

For Informatica servers running on Windows, navigate to Informatica Server setup, then Configuration, and remove the check from the Validate Data CodePages check box.

When trying to start the Informatica Server, the following error message appears:

sdcb50a125{qauser7a}/> pmserver

exec(): 0509-036 Cannot load program pmserver because of the following errors:

0509-150 Dependent module libpmcef.a could not be loaded.

0509-022 Cannot load module libpmcef.a.

0509-026 System error: A file or directory in the path name does not exist.

Set the environment parameters as follows:

setenv PATH /export/home/informatica/pm:.:${PATH}

setenv LD_LIBRARY_PATH /export/home/informatica/ pm:${LD_LIBRARY_PATH}


H.5 Oracle Business Analytics Warehouse Upgrade Issues

Table H-5 provides information about problems and solutions related to issues with upgrading the Oracle Business Analytics Warehouse.

Table H-5 Upgrade Issues

Symptom/Error Message Probable Cause/Solution

When upgrading from Oracle Business Analytics Warehouse version 7.5.3 to version 7.7, duplicate rows are inserted into a mini dimension table from the dimension table.

Before upgrading, all leading and trailing spaces need to be removed from the data.

Before running the workflow for the mini dimension that appears in the upgrade folder, modify the data to remove leading and trailing spaces by using the RTRIM and LTRIM functions. For example: set(col)=rtrim(col)

In cases where you find leading and trailing spaces, modify the SQL override for the mini dimension mapping in the main folder as shown in the example below:

SELECT DISTINCT
     CASE WHEN G1.VAL IS NULL THEN RTRIM(LTRIM(DS.AREA)) ELSE G1.VAL END AS AREA,
     CASE WHEN G1.NAME IS NULL THEN RTRIM(LTRIM(DS.AREA)) ELSE G1.NAME END AS AREA_I,
     CASE WHEN G2.VAL IS NULL THEN RTRIM(LTRIM(DS.SUB_AREA)) ELSE G2.VAL END AS SUB_AREA
     CASE WHEN G2.NAME IS NULL THEN RTRIM (LTRIM(DS.SUB_AREA)) ELSE G2.NAME END AS SUB_AREA_I
     CASE WHEN G3.VAL IS NULL THEN RTRIM(LTRIM(DS.SEV_CD)) ELSE G3.VAL END AS SEV_CD
     CASE WHEN G3.NAME IS NULL THEN RTRIM (LTRIM(DS.SEV_CD)) ELSE G3.NAME END AS SEV_CD_I
     CASE WHEN G4.VAL IS NULL THEN RTRIM(LTRIM(DS.PRIO_CD)) ELSE G4.VAL END AS PRIO_CD
     CASE WHEN G4.NAME IS NULL THEN RTRIM (LTRIM(DS.PRIO_CD)) ELSE G4.NAME END AS PRIO_CD_I
FROM
     W_SRVREQ_DS DS,
     W_LOV_G G1,
     W_LOV_G G2,
     W_LOV_G G3,
     W_LOV_G G4
WHERE
     W_SRVREQ_DS
     LEFT OUTER JOIN V_LOV_G G1 ON
         DS.AREA = G1.NAMEVAL AND
         G1.TYPE = 'SR_AREA'
     LEFT OUTER JOIN W_LOV_G G2 ON
         DS.SUB_AREA = G2.NAMEVAL AND
         G2.TYPE = 'SR_AREA'
     LEFT OUTER JOIN W_LOV_G G3 ON
         DS.SEV_CD = G3.NAMEVAL AND
         G3.TYPE = 'SR_SEVERITY'
     LEFT OUTER JOIN W_LOV_G G4 ON
         DS.PRIO_CD = G4.NAMEVAL AND
          G4.TYPE = 'SR_PRIORITY'}

H.6 Oracle BI Interactive Dashboard Issues

Table H-6 provides information about problems and solutions related to Oracle BI Interactive Dashboards.

Table H-6 Oracle BI Dashboard Issues

Symptom/Error Message Probable Cause/Solution

Error Codes: OPR4ONWY:U9IM8TAC:OI2DL65P File: ./project/webodbcaccess/odbcstatementimpl.cpp, Line: 186 State: S1000. Code: 10058. [NQODBC] [SQL_STATE: S1000] [nQSError: 10058] A general error has occurred. [nQSError: 17001] Oracle Error code: 4030, message: ORA-04030: out of process memory when trying to allocate 246284 bytes (hash-join subh,kllcqas:kllsltba) at OCI call OCIStmtFetch. [nQSError: 17012] Bulk fetch failed. (S1000)

This is caused by a shortage of RAM on a dedicated (non shared server) environment. Depending on the Oracle version, the options for DBAs are:

  • Increase pga_aggregate_target.

  • Decrease sort_area_size and/or hash_area_size.

  • Move to multi-threaded server (a.k.a. MTS or shared servers).


H.7 ETL Issues

Table H-7 provides information about problems and solutions related to ETL in Oracle BI Applications.

Table H-7 ETL Issues

Symptom/Error Message Probable Cause/Solution

ETL failure with error: unable to create unique indexes over the W_UAEMP_TMP and W_UAPOS_TMP tables.

Duplicate records exist in the WS_PER_RESP table, probably caused by Responsibility changes in the Siebel CRM Administration application.

For example, in Siebel CRM Administration View "Responsibilities", you remove a Responsibility for a particular User, and later re-associate that Responsibility to that User.