Dire Lease Notes

7/31/2019 Dire Lease Notes

1/48

February 28, 2006

Data Integrator Release Notes

Data Integrator 11.5.1.5

for multiple platforms
http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdf


2/48

Patents Business Objects owns the following U.S. patents, which may cover products that are offered

and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and

6,289,352.

Trademarks Business Objects, the Business Objects logo, Crystal Reports, and Crystal Enterprise are

trademarks or registered trademarks of Business Objects SA or its affiliated companies in theUnited States and other countries. All other names mentioned herein may be trademarks of

their respective owners.

Third-party

contributors

Business Objects products in this release may contain redistributions of software licensed

from third-party contributors. Some of these individual components may also be available

under alternative licenses. A partial listing of third-party contributors that have requested or

permitted acknowledgments, as well as required notices, can be found at:

http://www.businessobjects.com/thirdparty

Copyright Copyright 2006 Business Objects. All rights reserved.


3/48

Introduction

Data Integrator Release Notes 1

Introduction

BusinessObjects Data Integrator XI Release 2 (XI R2) version 11.5.1.5 is a

release update for version 11.5.1.0. For an overview of new features includedin this and the 11.5.0.0 and 11.5.1.0 releases, see the Data IntegratorRelease Summary.

This document contains important information about this product releaseincluding installation notes, details regarding the latest resolved issues aswell as known issues with this release, and important information for existingcustomers.

Read this entire document before installing your Business Objects software.

Data Integrator information resources

Consult the Data Integrator Getting Started Guidefor:

An overview of Data Integrator products and architecture

Data Integrator installation and configuration information

A list of product documentation and a suggested reading path

After you install Data Integrator (with associated documentation), you canview the technical documentation from several locations. To viewdocumentation in PDF format:

Select Start > Programs > Data Integrator version> Data Integrator

Documentation and select: Release NotesOpens this document, which includes known andfixed bugs, migration considerations, and last-minute documentationcorrections

Data Integrator Release SummaryOpens the Release SummaryPDF, which describes the latest Data Integrator features

Data Integrator Technical ManualsOpens a master PDFdocument that has been compiled so you can search across theData Integrator documentation suite

Data Integrator Core TutorialOpens the Data Integrator Tutorial

PDF, which you can use for basic stand-alone training purposes Select one of the following from the Designers Help menu:

Release Notes

Release Summary

Technical Manuals

Data Integrator Release Notes
http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://direleasesummary.pdf/http://direleasesummary.pdf/http://digettingstartedguide.pdf/http://direleasesummary.pdf/http://ditechnicalmanuals.pdf/http://dicoretutorial.pdf/http://dicoretutorial.pdf/http://ditechnicalmanuals.pdf/http://direleasesummary.pdf/http://direleasesummary.pdf/http://direleasesummary.pdf/http://digettingstartedguide.pdf/http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdf


4/48

Compatibility and limitations update

2 Data Integrator Release Notes

Tutorial

Other links from the Designers Help menu include:

DIZoneOpens a browser window to the DI Zone, an online resource for

the Data Integrator user community) Knowledge BaseOpens a browser window to Business Objects

Technical Support Knowledge Exchange forum (access requiresregistration)

Select Help from the Data Integrator Administrator to open TechnicalManuals.

To obtain additional information that might have become available followingthe release of this document, or for documentation for previous releases(including Release Summaries and Release Notes), visit the BusinessObjects documentation Web site at http://support.businessobjects.com/

documentation/.

In this document

These release notes contain the following sections:


Software requirements for UNIX

Resolved issues

Known issues

Migration considerations Documentation corrections

Business Objects information resources

Copyright information


This section describes changes in compatibility between Data Integrator andother applications. It also summarizes limitations associated with this version

of Data Integrator.
http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/


5/48



Compatibility update

For complete compatibility and availability details, see the Business ObjectsSupported Platforms documentation on the Business Objects Customer

Support Web site:

http://support.businessobjects.com/supported_platforms/

Supported products

Support is now available for the following platforms and configurations:

HP-UX for Itanium 2 64-bit, version11.23

IBM DB2/UDB iSeries V5R3 via DB2 Connect. Please check theSupported Platforms documentation on the Business ObjectsCustomer Support Web site for updates on iSeries client support.

HTTPS support for Web services adapters Microsoft SQL Server 2005

Note: Changed-data capture for Microsoft SQL Server 2005 is notsupported with the 11.5.1.5 release. Support is expected to beincluded with an upcoming Hot Fix release. Please check theSupported Platforms documentation on the Business ObjectsCustomer Support Web site for updates.

MySQL 5.0 via ODBC driver version 3.51.12 for Windows only.Please check the Supported Platforms documentation on theBusiness Objects Customer Support Web site for updates on UNIX

availability.

Netezza NPS 2.5 and 3.0 via ODBC driver version 3.0.1

Red Hat Linux Advanced Server 4.0

SAP BW 3.5

SAP ECC 5.0

Siebel 7.7

Solaris 10 operating system on Solaris SPARC

Solaris AMD Opteron with Solaris 10 operating system

Sybase Adaptive Server Enterprise 15.0 (Windows supports source,target, and repository; UNIX supports source and target only) Data Integrator version 11.5.1 is compatible with versions 11.5 or 11.5

SP1 of the following BusinessObjects Data Integrator interfaces:

IBM Message Queue (MQ) Series

Java Message Service (JMS)
http://support.businessobjects.com/supported_platforms_di_xi_release2/http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://support.businessobjects.com/supported_platforms_di_xi_release2/


6/48



Salesforce.com (available in version 11.5 SP1 and above)

Impact analysis will interoperate with:

BusinessObjects versions 6.5.1, XI, and XI R2.

BusinessObjects universes 6.5.1, XI, and XI R2 Web Intelligence documents versions 6.5.1, XI, and XI R2

Desktop Intelligence documents version XI R2

Business Views XI and XI R2

Universe Builder version 11.5 is bundled with Data Integrator 11.5.1. Thisversion of Universe Builder will interoperate with Business Objectsversions 6.5.1, XI, and XI R2. Find Universe Builder documentation in theBuilding Universes from Data Integrator Metadata Sources chapter ofthe Universe Designer Guide(downloadable from the Business Objectsdocumentation download Web site. Go to http://support.businessobjects.com/documentation/. Select BusinessObjectsEnterprise as the product and Universe Designer Guide as thedocument.)

Data Mart Accelerator for Crystal Reports will interoperate withBusinessObjects version XI and XI R2.

ODBC to generic database support has been validated with the followingdatabase servers and ODBC drivers. For complete compatibility details,see the Business Objects Supported Platforms documentation on theBusiness Objects Customer Support web site on the Supported Platformspage:

http://support.businessobjects.com/supported_platforms_di_xi_release2/

Microsoft SQL Server 2000 via DataDirect Connect for ODBC 5.0 or5.1.

Note: Version 5.1 is required on Linux and version 5.0 is required forSolaris Opteron.

MySQL version 5.0 via ODBC driver version 3.51.12 on Windowsand MySQL version 4.1 via ODBC driver version 3.51.10 on UNIXand Windows

Red Brick version 6.3 via ODBC driver version IBM 6.3

SQLAnywhere version 9.0.1 via ODBC driver version AdaptiveServer Anywhere 9.0 Sybase IQ version 12.6 requires ESD 4.

Log-based changed-data capture (CDC) works with the followingdatabase versions
http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/http://support.businessobjects.com/supported_platforms_di_xi_release2/http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/http://support.businessobjects.com/supported_platforms_di_xi_release2/


7/48



Oracle version 9.2 and above compatible versions for synchronousCDC and Oracle version 10G and above compatible version forasynchronous CDC

Microsoft SQL Server 2000

Note: Support for Microsoft SQL Server 2005 is expected to beincluded with an upcoming Hot Fix release. Please check theSupported Platforms documentation on the Business ObjectsCustomer Support web site for updates.

IBM DB2 UDB for Windows version 8.2 using DB2 InformationIntegrator for Replication Edition version 8.2 (DB2 II Replication) andIBM WebSphere Message Queue version 5.3.

IBM DB2 UDB for z/OS using DB2 Information Integrator EventPublisher for DB2 UDB for z/OS and IBM WebSphere Message

Queue version 5.3.1 IBM IMS/DB using DB2 Information Integrator Classic Event Publisher

for IMS and IBM WebSphere Message Queue version 5.3.1

IBM VSAM under CICS using DB2 Information Integrator ClassicEvent Publisher for VSAM and IBM WebSphere Message Queueversion 5.3.1

Attunity for mainframe sources using Attunity Connect version 4.6.1

NCR Teradata V2R6 with TTU 8.0 and NCR Teradata ODBC 3.0.4

This support requires the following TTU patches:

On Windows platforms: cliv2.04.08.00.01.exe

tbld5000.05.00.00.01.exe

psel5000.05.00.00.01.exe

pdtc5000.05.00.00.01.exe

npaxsmod.01.03.01.00.exe



On all UNIX platforms:

cliv2.04.08.00.01.exe

tbld5000.05.00.00.01.exe

On AIX: 03.04.00.02


8/48



NCR Teradata V2R5 and V2R6 continue to be supported. Supportedversions of TTU client include:

With Teradata V2R6, the named pipes mechanism for Teradata bulkloader is now supported.

Note: Teradata does not recommend using Warehouse Builder in TTU7.0 and 7.1, and there are some issues with Data Integrator on the AIXplatform with multiple pipes.

Data Integrator Firstlogic data cleansing using: International ACE version 7.60c

DataRight IQ version 7.60c

BusinessObjects Mainframe Bulk Interface using IBM WebSphereInformation Integrator Classic Federation for z/OS version 8.2.

BusinessObjects Mainframe Live Interface using the following:

WebSphere Information Integrator Classic Event Publisher version8.2.

WebSphere MQ for z/OS version 5.3.1

Data Integrator uses Apache Axis version 1.1 for its Web Servicessupport. Axis version 1.1 provides support for WSDL version 1.1 andSOAP version 1.1 with the exception of the Axis servlet engine.

Data Integrator connectivity to Informix servers is now only supported viathe native Informix ODBC driver. The following Informix client SDKversions are required:

Windows: version 2.81.TC3 or higher compatible version

HP-UX for PA-RISC 32 bit: version 2.81.HC3X7 or higher compatibleversion

AIX or SOLARIS SPARC: version 2.81.UC3X7 or higher compatible

version Linux version 2.90.UC1 or higher compatible version

HP-UX for Itanium 64-bit version 2.90.FC1 or higher compatibleversion

Teradata server version Client version

V2R6 TTU 8.0

V2R5.1 TTU 7.1

V2R5 TTU 7.0


9/48



Unsupported products

Netezza NPS 2.5.x

Netezza ODBC driver 2.2.1.5234

Netscape Navigator Red Brick 5.6.2

Trillium Interface

Firstlogic data cleansing using:

International ACE versions 7.25c or 7.50c

DataRight IQ versions 7.10c or 7.50c

Informix repository and datastore connectivity via DataDirectTechnologies ODBC. The migration path is to use native Informixconnectivity.

Data Integrator mainframe interface using DETAIL. The migration path isthrough the IBM Connector and Attunity Connector mainframe interfaces.For migration information and guidance, contact your Business Objectssales person.

Data Integrator LiveLoad

Context-sensitive Help for Data Integrator

AIX version 5.1

Sybase IQ 12.5

Limitations update

Please visit http://support.businessobjects.com/documentation/for the latestversion of these release notes.

To access the Business Objects Supported Platforms documentation on theBusiness Objects Customer Support web site (requires registration), go to:

http://support.businessobjects.com/supported_platforms/

These limitations apply to Data Integrator version 11.5.1.5:

Firstlogic Data Cleansing on the Solaris for AMD Opteron platform is only

supported with the United Kingdom engine. Several configurations are not currently supported on the Solaris for AMD

Opteron platform. (Please check the Supported Platforms documentationon the Business Objects Customer Support web site for details andupdates on support availability.)
http://support.businessobjects.com/documentation/http://support.businessobjects.com/supported_platforms_di_xi_release2/http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://support.businessobjects.com/supported_platforms_di_xi_release2/http://support.businessobjects.com/documentation/


10/48



The following products are not currently supported on the HP-UX for PA-RISC platform. (Please check the Supported Platforms documentation onthe Business Objects Customer Support Web site for updates on supportavailability.)

BusinessObjects Mainframe Bulk Interface

BusinessObjects Mainframe Live Interface

The following products are not currently supported on the Red Hat Linuxplatform. (Please check the Supported Platforms documentation on theBusiness Objects Customer Support web site for updates on supportavailability.)

BusinessObjects Application Interface for JD Edwards One World orWorld

BusinessObjects Application Interface for Siebel

BusinessObjects Database Interface NCR Teradata BusinessObjects Technology Interface IBM MQSeries Interface


BusinessObjects Technology Interface JMS

SAP BW as a target (Note that SAP BW is supported as a source.)

The following products are not currently supported on the HP-UX Itanium(64-bit) platform. (Please check the Supported Platforms documentationon the Business Objects Customer Support web site for updates onsupport availability.)

BusinessObjects Application Interface for J.D. Edwards One Worldor World

BusinessObjects Interface for Siebel

BusinessObjects Database Interface for NCR Teradata

BusinessObjects Technology Interface for IBM MQSeries

BusinessObjects Interface for JMS


BusinessObjects Mainframe Live Interface

Data Cleansing

SAP BW as a target (Note that SAP BW is supported as a source.)

Files read by an adapter must be encoded in either UTF-8 or the defaultencoding of the default locale of the JVM running the adapter.

All Data Integrator features are available when you use an AttunityConnector datastore except:


11/48



Bulk loading

Imported functions (imports metadata for tables only)

Template tables (creating tables)

The datetime data type supports up to 2 sub-seconds only Data Integrator cannot load timestamp data into a timestamp column

in a table because Attunity truncates varchar data to 8 characters,which is not enough to correctly represent a timestamp value.

All Data Integrator features are available when you use an IBMConnector datastore except:

Datetime and timestamp data types are recognized as varchar,because IBM's DB2 II Classic Federation for z/OS product does notnatively support these types

Bulk loading

Imported functions (imports metadata for tables only)

Importing primary and foreign keys

Template tables

View Datas Column Profile feature

The Adapter SDK no longer supports Native SQL or Partial SQL.

Unsupported data type:

Unsupported data type is only implemented for SQL Server, Oracle,Teradata, ODBC, DB2, Informix and Sybase ASE, Sybase IQ, Oracle

Applications, PeopleSoft, and Siebel. Data Integrator can read, load, and invoke stored procedures

involving unknown data types for SQL Server, Oracle, Teradata,ODBC, DB2, Informix, Sybase ASE, and Sybase IQ assuming thesedatabase servers can convert from VARCHAR to the native(unknown) data type and from the native (unknown) data type toVARCHAR.

Data Integrator might have a problem loading VARCHAR to aphysical CLOB column (for example, bulk loading or auto-correctload could fail).

Note: Use the VARCHAR column in the physical schema for loading. Unsupported data type is not supported in the SQL transform.

PeopleSoft 8 support is implemented for Oracle only.


12/48



Data Integrator jobs that ran against previous versions of PeopleSoft arenot guaranteed to work with PeopleSoft 8. You must update the jobs toreflect metadata or schema differences between PeopleSoft 8 andprevious versions.

Stored procedure support is implemented for DB2, Oracle, MS SQLServer, Sybase ASE, Sybase IQ, and ODBC only.

Teradata support is implemented for Windows, Solaris SPARC, and AIX.HP-UX for PA-RISC 32 bit is not supported due to limitations inTeradatas HP-UX for PA-RISC 32 bit product. Linux, HP-UX for Itanium,and Solaris for AMD Opteron are not supported.

On Teradata, the named pipe implementation for Warehouse Builder issupported with Teradata Tools and Utilities version 8 or later compatibleversion. Teradata Tools and Utilities version 7.0 and 7.1 are notsupported with named pipes.

Bulk loading data to DB2 databases running on AS/400 or MVS systemsis not supported.

Data Integrator Administrator can be used on Microsoft Internet Explorerversion 6.0 SP1 or 6.0 SP2. Earlier browser versions may not support allof the Administrator functionality.

Data Integrators View Data feature is not supported for SAP R/3 IDocs.For SAP R/3 and PeopleSoft, the Table Profile tab and Column Profile taboptions are not supported for hierarchies.


13/48



Support for the Data Profiler is provided for sources as follows:

Supported Not supported

Attunity Connector for mainframe databases

DB2

Flat file

IBM connector for mainframe databases

Informix

Netezza

ODBC (includes MySQL)

Oracle

Oracle Applications

PeopleSoft

SAP R/3

Siebel

SQL Server

Sybase ASE

Sybase IQ

Teradata

IDOC

JDE

SAP BW

XML

Memory Datastore

COBOL copybooks


14/48



Support for the LOOKUP_EXT function is provided for sources asfollows:

DB2 Java Library limitations

The Web Administrator will not work with a DB2 repository under any ofthe following conditions:

db2java library is incompatible with DB2 client. For example, DB2Client is version 8.1 and db2java library is version 8.2, or

db2java library is not generated for JDBC 2 driver, or

the java class path variable is not properly set to the correspondingjava library, or

the DB2 JDBC shared library (e.g. libdb2jdbc.so on AIX) is notcompatible with the Java JDBC 2 driver

Under these conditions, you might see the following behavior:

The Administrator stops working or crashes after you configure theDB2 repository. Find any error and warning messages related to theDB2 repository configuration in the log file.

When testing your DB2 connection from Administration > Repository> Specify DB2 database type and clicking [Test], the following errorsappear in the Administrator log:

BODI-3016409: fail to connect to repository.

Supported Not supported

DB2

Flat file

Informix

JDE

Memory Datastore

Netezza

ODBC

Oracle

Oracle Applications

PeopleSoftSiebel

SQL Server

Sybase ASE

Sybase IQ

Teradata

IDOC

SAP BW

SAP R/3

XML


15/48



BODI-3013014: didn't load DB2 database driver.

In this release, the db2java JDBC 2 driver version of DB2 8.1 and DB28.2 are provided. On Windows, find the different version of these libraries

$LINK_DIR/ext/lib db2java.zip (by default) DB2 8.2 version

db2java_8.1.zip DB2 8.1 version

By default, the db2java.zip of version 8.2 will be used. If you run with aDB2 8.1 Client, you must:

replace with version 8.1 of db2java.zip

make sure the compatible DB2 JDBC shared library is in the sharedlibrary path

restart the web server service on Windows or restart the job service

on UNIXIf you run with other DB2 Client versions, you must obtain thecorresponding java library with the JDBC 2 driver. Please refer to IBMDB2 documentation for how to obtain the correct java library.

Informix native-driver support on UNIX requires a fix in the Informix ClientSDK for IBM bug number 167964. Please contact IBM for a patch thatincludes this bug fix.

Note: IBM is targeting inclusion of this bug fix in Client SDK version 2.90.

Data Integrator supports files greater than 2 GB only in the followingcases:

Reading and loading large data files of type delimited and positional.

Generating large files for bulk loader staging files for subsequentbulk loading by a native bulk loader utility (such as SQL Loader).

Previewing data files from the file format page in Designer when thelarge files are on a UNIX Job Server.

Reading COBOL copybook data files.

All other files generated by Data Integrator, such as log files andconfiguration files, are limited to 2 GB.

The MySQL 64-bit library for HP-UX Itanium 64-bit only supportsLazyLoading. When using MySQL on this platform, you must setLazyLoading=TRUE in $LINK_DIR/odbc.ini.


16/48




Please observe the following requirements for UNIX systems.

Install JDK version 1.4.2 or higher as described in the vendorsdocumentation.

On Sun Solaris for AMD Opteron, install the following patches:

117831-03

117837-05

117846-07

118682-01

The AIX maintenance level must be at least 5200-05. For all versions ofAIX, the following file sets must be installed:

To find these xlC file sets and their levels on your AIX system, use thecommand lslpp -l xlC*

If you are installing the Administrator on HP-UX for PA-RISC 32 bit, add

the following patches: PHSS_26577

PHSS_26638

Refer to the $LINK_DIR/log/DITC.log file for browser-related errors.

For Red Hat Linux 3, install the following patches:

glibc-2.3.2-95.30

libstdc++-3.2.3-20

compat-libstdc++-7.3-2.96.122

File set Level State Description

xlC.aix50.rte 6.0.0.13 COMMITTED C Set ++ Runtime for AIX 5.0

xlC.rte 6.0.0.0 COMMITTED C Set ++ Run-time

xlC.msg.en_US.rte 6.0.0.0 COMMITTED C Set ++ Run-timeMessages, U.S.English


17/48

Resolved issues


For Red Hat Linux 4, install the following patches:

glibc-2.3.4-2

libgcc-3.4.3-9.EL4

compat-libstdc++-296-2.96-132.7.2 compat-libstdc++-33-3.2.3-47.3

For Solaris 8:

Install 111721-04 (for both 32-bit and 64-bit SPARC)

The patch 112874-22 causes a core dump error coming from thedate function calls to the C lib. Apply the latest patch instead.

For Solaris 9, install the appropriate patch:

108434-13 (for 32-bit SPARC)

108435-13 (for 64-bit SPARC)

111722-04 (for both 32-bit and 64-bit SPARC)

For Solaris 10 on Opteron for 32-bit SPARC, install the following patches:

117831-03

117837-05

117846-07

11862-01

Resolved issues

Please refer to http://support.businessobjects.com/documentation for thelatest version of these release notes, which includes resolved issues specificto version 11.5.1.5.

34363 In Data Integrator version 11.5.1.0, for an R/3 table reader andSalesforce.com adapter reader, the global variable in a WHERE clause wasnot being pushed down. The problem has been fixed.

34361 A memory leak occurred when a subset of columns propagated in the queryand the propagated columns involved varchar data. This has been fixed.

34244 Data Integrator generated incorrect ABAP when an R/3 data flow involved ajoin and an orderby clause. This issue has been fixed.

34238 In Data Integrator version 11.5.1.0, lookup_ext did not work when theschema of the lookup table had VARCHARs with definitions greater than orequal to 32. In this case, lookup_ext either returned incorrect rows orreturned correct rows with corrupted data. This issue has been fixed.
http://support.businessobjects.com/documentationhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://support.businessobjects.com/documentation


18/48

Resolved issues


34228 Designer did not start successfully with a regional setting of Polish. Thisissue has been fixed.

34169 A regional setting of Icelandic generated a warning that caused the job tofinish with an error message. This issue has been fixed.

34043 Data Integrator supports web services by importing the services so they canbe used as function calls. In the process of importing services, DataIntegrator creates a wrapper schema and one or more schemas that definethe actual service content from a WSDL file that defines the web service.The following issues related to wrapper schema generation have been fixed:

When Data Integrator generated the wrapper schema, targetnamespace and other namespaces referred to in the imported/includedschema (the schema(s) defining the service content) were notgenerated appropriately.

When Data Integrator extracted schema(s) from the WSDL file, it did notrecursively explore the schemas being extracted to find out which otherschemas were imported/included by these schemas, which resulted insome referenced types not being found when the engine tried to importthe wrapper schema.

33998 The Recoverable option for Oracle bulk loading using the API method wasnot being saved. This problem has been fixed.

33908 When importing more than one index of the same name for DB2 table onAS/400, Data Integrator fails with a unique constraint violation. This fixaddresses the problem.

33893 When using parameters in a WHERE clause, Data Integrator may fail. This

problem has been resolved.33890 Data Integrator throws an error message when non-alphanumeric characters

appear in the user name or password when connecting to a DB2 repository.This problem no longer occurs.

33813 A data flow might fail with an access violation when loading data from anOracle table to a Sybase table. This issue has been fixed.

33721 When Data Integrator pushes down the ifthenelse function to SQL Server,the job fails when the data type of the true_branch part is different from thedata type of the false_branch. This fix addresses the problem.

33716 Data Integrator fails to process multi-byte data in Oracle CHAR column. The

fix addresses the problem.33704 Data Integrator returns inconsistent results when using reverse pivot to load

a large amount of data. This issue has been resolved.

33675 When using Netezza, a job with an outer join failed when the datastoreODBC capability support was set to Automatic. This issue has beenaddressed in Netezza version 3.0.


19/48

Resolved issues


33596 In certain cases, Data Integrator fails to handle a WHERE clause thatinvolves a variable and a string constant. The fix addresses this problem.

33514 An XML parsing error in custom adapters which occurred when updating to11.5 was addressed.

33473 When regional settings are Turkish, a run-time error occurs when starting theDesigner. This issue has been fixed.

33459 When a job encounters an error, Data Integrator does not roll back allchanges if the job target has the Include in transaction option selected.This issue has been fixed.

33440 If a COBOL file source is created, included in a data flow as a source,connected to a target and executed prior to opening the source, then theFile name is missing for Cobol File Source run-time error message displayswhen the file name and directory name are specified. With this fix, the errormessage only displays when the file name and/or directory name are blank.

33439 A memory leak in the Job Server occurs when a job is running and theDesigner is open. This issue was resolved.

33434 The COBOL file reader handling of zoned decimal fields was enhanced toaccommodate additional compilers.

33426 An issue related to supporting Icelandic regional settings in the DataIntegrator Installer and Designer was resolved.

33409 With mixed-case column names in a data flow that contained bothTable_Comparison and Key_Generation transforms, Data Integratorsometimes inserted duplicate rows into a target. This issue has been fixed.

33356 When changing the array fetch size for a target, Data Integrator displayed

the following extraneous warning message: Warning: array fetch value of5000 exceeds the system maximum of 5000. Reset the array fetch value to5000." With this change the warning message has been removed.

33348 When a SQL Server table is being updated by a third-party application, ifData Integrator tries to read from the table, it hangs until the changecommits. The new SQLServerReadUncommitted configuration parametereliminates this scenario and allows reading of uncommitted data from SQLServer. In addition, Data Integrator issues no share locks whenSQLServerReadUncommitted is activated. This parameter affects all SQLServer datastores. To set the option, from the Designer select Tools >Options > Job Server > General and enter the following:

Section: al_engine

Key: SQLServerReadUncommitted

Value:1(Note that if you use the default value of 0, Data Integrator will only readcommitted data.)


20/48

Resolved issues


33346 Data Integrator pushes down the incorrect outer join when you specify bothinner and outer joins in a job. The issue is now fixed.

33320 Deactivating a central repository via the Central Object Library resulted inthe Designer hanging, although deactivating from the Options dialog boxworked successfully. With this fix, both methods work correctly.

33304 When using Siebel with Oracle or DB2, you could not specify schema owner.The fix addresses this problem.

33172 Newer versions of Data Integrator will no longer overwrite the XSD thatdefines the input and output message files for the Web Services adapter.Manual intervention when installing Data Integrator is no longer required.

33036 JDE One World implementation now supports unicode for SQL Server datatype.

33033 The blank space located on the right side of the data seems to truncate aftertransferring data between files. For details on new behavior for ANSI

varchars, see the 11.5.1 Release Summary.32959 When importing a job into a repository without an associated datastore, the

target table options are not retained if the prior database version differs fromthe new database version. Instead, Data Integrator resets target tableoptions to default values. This problem has been fixed.

32942 Universal builder does not generate mapping information for universeobjects in this release. The current behavior displays the column descriptionwhich is the same information in the technical description field. This problemhas been fixed.

32814 On Solaris SPARC 8 and 9, al_engine could not be started because libm.so

was not loaded successfully. The required Solaris patches are: Solaris 8:111721-04 Solaris 9: 111722-04.

32761 On AIX, the machine_name column in al_machine_info is not updatedcorrectly; .so and the port number are incorrectly appended. As a result,

jobs executed against that Job Server via the Administrator failed. This issueno longer occurs.

32522 When a job uses the replace_substr() function and the search string length isless than the replace string length, the return column size was incorrectlycalculated, leading to memory corruption.

Additionally, the return column size becomes extremely large when thereplace string is NULL and the replace_substr() function passes as aparameter to itself.

These two issues have been fixed.

32494 When a job uses parallel work flows that each use either a sql() function or astored procedure, the job hangs. This problem has been fixed.


21/48

Resolved issues


32405 In certain jobs when there are multiple source database types, DataIntegrator pushes down the wrong SQL statement for the ifthenelse function.This fix addresses the problem.

32224 On SQL Server, when using square brackets [ ] in a SQL transform, a run-time error is generated complaining that the entity (schema, table, column, oralias) contained in the square brackets is undeclared. This issue has beenfixed and no error is generated.

32157 When importing a COBOL copybook, not all fields were correctly imported.This issue has been fixed.

32135 The function is_valid_real() was returning a wrong result when the inputcontained more than one decimal place. Invalid real numbers with more thanone decimal place were considered valid real numbers, and is_real_valid()returned 1. With this fix, Data Integrator treats any input with more than onedecimal place as an invalid real number, and is_valid_real() will return 0.

32131 On Solaris, the table comparison transform fails with a segmentationviolation error when comparing source data to target. This issue was fixed.

31995 When trying to access License Information from the start menu, a messageappeared stating License Manager has encountered a problem andneeds to close. We are sorry for the inconvenience. This issuehas been fixed.

31958 When using a variable for the file name in a file loader, Data Integrator failedto execute the job. This fix addresses the problem.

31556 Launching a job failed while logging an error. As a result no error waslogged. This issue was fixed.

31554 The The following template table(s) exist in object library. Please use theMake Table command to make them real tables error message wasupdated to say, The following template table(s) exist in object library. Pleaseuse the Import Table command to make them real tables.

31487 Get By Label was returning objects that are not part of the label. This issuehas been fixed.

31348 On HP-UX PA-RISC, the Data Integrator engine could not work with thefollowing DB2 and Oracle database client version combinations on the JobServer because of symbol-resolution problems within their dynamic clientlibraries:

Oracle 10G and DB2 8.2

DB2 8.1 and Oracle 9.2 or 10G

DB2 8.2 and Oracle 9.2 or 10G

This issue has been resolved.


22/48

Resolved issues


31330 When using a negative start argument, the substr function was not workingproperly when it was not pushed down to the database. The substr wascounting the start position backwards from one place after the last characterof the input string instead of from the last character of the input string. This

issue has been fixed.

31042 When using bulk loading, if a control file had been specified, Data Integratordid not check the bulk loader directory. With this change, if you provide acontrol file path, Data Integrator will access it; if not, Data Integrator willaccess the path provided in the bulk load directory.

30218 In a prior release, when loading a table from a MySQL table with Rows percommit greater than 1, not all data would transfer. This issue has beenfixed.

30171 When exporting ATL to a disk with no free space, no warning message isgiven; however, empty or partial ATL is created. This fix provides for an error

message that reads, No free space available on disk. ATL file not exported.28786 Odd workflow name during validation is fixed.

28611 When using Data Mart Accelerator for Crystal Reports to run complexreports or those that contain a very large amount of data, the batch jobcreated by the Data Mart Accelerator sometimes ran out of TCP ports andwas terminated by Data Integrator (after the default allowance for 10 minutesof inactivity).

This problem occurred when the Crystal Report Application Server (RAS)ran out of available ports. On a typical Windows installation, TCP portsabove 5000 might not be available.

For information on how to change the number of available ports, seeMicrosoft Knowledge Base Article 196271 Unable to Connect from TCPPorts Above 5000. To further reduce the load on the RAS server, you canalso rerun the Data Mart Accelerator and set the maximum number ofinstances to a lower number.

27036 The Kernel parameters and user resource limits of the Getting StartedGuide was updated to include complete kernel descriptions for UNIXplatforms.

26617 On UNIX, you could not pass parameters in a string to the exec function.This issue has been fixed.

26455 Due to refresh problems in the Designer, when editing metadata fromcolumns belonging to multiple tables, you lose all table metadata exceptmetadata from the last table. This issue has been resolved.

27967 When using Microsoft SQL Server, if the job called a sql function that has awhile loop in the sql command, Microsoft SQL Server might not execute allthe statements in the while loop. The fix addresses this problem.


23/48

Resolved issues


24379 Previously on AIX, when a job called the system_user_name() function in atransform, a lot of memory was consumed due to a bug in the AIX operatingsystem. This issue has been fixed.

22821Previously when you tried to import an XML file through the MetadataExchange CWM interface, you would see an error message if the XML filewas generated by Data Integrator. This problem has been fixed.


24/48

Known issues


Known issues

This section lists known issues in descending order by Business Objects

tracking number.

34457 To correctly configure Metadata Integrator for a BusinessObjects EnterpriseXI Release 2 CMS instance that is not on the same computer as DataIntegrator, refer to the Business Objects Support Web site and locateKnowledge Base article c2019073.

34003 FirstLogic is not supported on HP Itanium 64bit.

See http://support.businessobjects.com/documentation/for additionalinformation that may have become available following the release of thisdocument.

33510 Due to a known Informix issue, two phase commit (XA) transactions in IBMInformix Dynamic Server may cause Data Integrator to fail loading the datato IBM Informix Dynamic Server or profiling data with Informix. The typicalInformix errors are:

Could not position within a table

and

Could not do a physical-order read to fetch next row.The reference number from the IBM site is Reference#1172548.

33324 For SQL Server datastores, if the table owner name is DBO and the CMSconnection is also SQL Server with logon user name of SA, the updateUniverse will determine the new table schema to be new because DBO iscompared to SA as owner name.

Tip: Do not use SQL Server as CMS connection with SA as login name.

33028 The Data Profiler does not support SQL Server profiling repositories that useWindows Authentication.

31165 Data Integrator does not support any non-ASCII characters that use theeighth bit (such as an umlaut) in metadata (such as the owner name).
http://support.businessobjects.com/documentation/http://support.businessobjects.com/documentation/


25/48

Known issues


30925 When using Attunity CDC, import from browser and import by name behavedifferently. For example, when you type either CDC_DSNX4612:PUBLIC orCDC_DSNX4612 as the owner name, the same table will be imported into therepository.

Tip: When you import a table by name, always use the full owner name suchas CDC_DSNX4612:PUBLIC and also define the alias for this full name.

30506 Due to an issue in Attunity software, when using Attunity Connect to load intoa DB2 table on MVS that contains varchar columns larger than 255, the datainserted into those columns is always an empty string regardless of what youactually insert.

30059 A datastore in a nonsecure central repository can be deleted even if it has atable that is checked out by other users.

29826 When adding a very large project to central repository, a large memory leak

occurs.Tip: After adding large projects to central repository, restart the Designer.

29018 SQL Server bulk loader API truncates the decimal precision when multiplying2 decimals.

Tip: Use the round function before bulk loading in the column mapping.

28959 Data Integrator always works in binary collation for Table Comparisontransform. If the comparison table sort order is not binary, Data Integrator willgenerate inconsistent results between cached, row-by-row and sortedcomparison methods.

28654 Access server crashes on Windows 2003 machines when hyperthreading isactivated.

28610 When using the Data Mart Accelerator for Crystal Reports, numbers thatappear in the Link field are rounded to six digits.

28399 On UNIX when running a Data Integrator job with an Attunity datastore, thejob fails with following error: [D000] Cannot open file /usr1/attun/navroot/def/sys System error 13: The file access permissions

do not allow the specified action.; (OPEN)

This error occurs because of insufficient file permissions to some of the filesunder the Attunity installation directory. To avoid this error, change file

permissions for all files under the Attunity directory to 777. Run the followingcommand from Attunity installation directory: chmod a+rw *.

28356 When you import a table by name and this table is the target table of a tablecomparison transform, the table comparison does not refresh the databasechanges.

Tip: Open the table comparison transform to refresh the output schema.


26/48

Known issues


28319 Execution statistics are not available for all instances of a real-time job overthe life of a long-running Data Integrator batch job.

28161 The SAP function RFC_READ_TABLE does not work correctly with SAP

4.70 when reading source data if one of the table fields is a floating-pointfield.

Tip: Install the Data Integrator recommended transport file (preferred) orinstall the Z_AW_RFC_READ_TABLE function manually from the suppliedtext file.

27974 On Solaris, Informixs client driver does not support the ONSOCTCPcommunication protocol. Until Informix provides a fix, Business Objectsrecommends you use the ONTLITCP communication protocol.

By default, Data Integrator uses the ONSOCTCP communication protocol.Therefore, on Solaris, you must change the communication protocol

configuration found in the Informix SQLHOSTS and the ODBC.ini files to useeither ONTLITCP or SETLITCP communication protocols.

27485 Data Integrator does not monitor database connections given through thescripts.

27390 When using the Get by label option of the multi-user development interfacewith a non-existent label, Data Integrator returns the latest version of theobjects.

27048 Column Profiling is not supported in the View Data feature on SAP R/3cluster and pool tables.

Tip: Use the Data Profiling feature introduced in DI XI R2.

27045 Multibyte strings are not handled correctly when passed as a functionparameter.

Tip: Put multibyte string parameters in quotes.

26445 When editing metadata from columns belonging to multiple tables, allmetadata except for that in the last table is lost. This is caused by refreshproblems in the Designer.

Work Around: To ensure your metadata is saved to the repository, close themetadata window for each table before opening the next table for editing.


27/48

Known issues


26355 When comparison tables are on Microsoft SQL Server, the TableComparison transforms Sorted input option generates incorrect results.The Data Integrator engine runs in binary collation while the Microsoft SQLServer database runs in a Latin1 collation sequence. As a result, MicrosoftSQL Server generates the data in a different sort order. This issue will beaddressed in a later release.

Tip: Use the Row-by-row select or Cached comparison table option inthe Table Comparison transform.

25578 When processing large MQ messages, you must use IBM's AMI repository. Ifyou do not use the AMI repository, the PUT operation could fail.

24746 Data Integrator cannot import metadata through an adapter if it includes aDTD or XML Schema that begins with the header .

Tip: Remove the header line.

24223 When bulk loading to Oracle using the API method, Data Integrator cannotload a case-sensitive partitioned target table name due to a problem inOracle.

The following error message displays:

ORA - 02149. The specified partition does not exist.

Tip: Use the File method and select the Direct path option to handle case-sensitive partition names.

24195 For the DB2 database, when the Data Integrator engine pushes down aSELECT statement and the SELECT statement has an upper/lower function

for a graphic/vargraphic data type, then the describe column (ODBClibrary call) returns a char data type instead of a graphic data type. This isan ODBC bug.

Tip: Set the datastores code page to utf8 (or a similar superset codepage).

24013 When you specify length(lpad(' ',41) for the varchar data type, itreturns different lengths when it is pushed down to an Oracle database if thebind column is NCHAR or NVARCHAR2. The issue is with the Oracle OCIclient.

Tip: Do not use Data Integrators Auto-correct load option (on the targettable editor) for an Oracle table when you want to specify length(lpad('',41) for the varchar data type.


28/48

Known issues


23941 For Oracle, the load trigger for an NCHAR or NVARCHAR data type fails if thecode page in the database does not support these characters in thepushdown SQL. Consequently, Oracle fails to execute the SQL properly. Forexample, the following situations are known to cause problems:

The database code page is english, we8ISO88591

The code page of the NCHAR column in the database is ucs2 The submitted SQL has Japanese characters

Tip: Do not use Data Integrators Auto-correct load option (on the targettable editor) when processing NCHAR or NVARCHAR data types.

23938 If the code page used by the Oracle client is set to certain values (it works for

utf8 and fails for we8winms1252), and the bind column size is greater than1312, and Data Integrator uses the same Oracle connection more than twiceduring internal processing, then Oracle will throw the following error:

ORA-01460: unimplemented or unreasonable conversionrequested

23852 For MS SQL Server, if a concatenation operator is used in a storedprocedure and if the code page for the database is ucs2, then the ODBClibrary fails to concatenate the data properly. The issue is with the MicrosoftODBC driver.

Tip: Do not allow Data Integrator to push down a concatenation expressionto the database. One way to do this is to construct job so that data loads intoa flat file and the concatenation operation occurs in another query. Thus,Data Integrator cannot push down the SELECT statement because the

target does not have the operation it needs.

23811 For Oracle, nchar or nvarchar data types do not work for databaseprocedures and database functions when one of the parameters has annchar or nvarchar column and the datastore code page set in Data Integratordoes not understand nchar or nvarchar encoding. In these cases, the DataIntegrator engine handles nchar or nvarchars as if they were varchar datatypes.

23687 After you restart an adapter instance, the service that uses it fails to processthe next message it receives.

Tip: When you restart an adapter instance, also restart its associated

services.


29/48

Known issues


23005 When reading XML schema data, you may encounter the following errormessage:

Type of attribute 'lang' must be validly derived from type

of attribute in base...Tip: Change your schema to avoid use=prohibited for any attribute orelement whose type is derived from xsd:language.

22690 If you have a data flow that includes mapping a varchar column to a datetimecolumn in a query transform, the job will give an access violation error if anyof the date values are invalid.

21659 The Adapter SDK has some syntax limitations for DTDs that can be importedfor use as an adapter source or target:

Conditional syntax cannot be included in the DTD file. Sample syntaxthat fails:

[

"ebHeader.dtd">%eb:MessageHeader;]]>

Tip: The following syntax is supported and produces the same result:

%eb:MessageHeader;

XML version information cannot be included in the DTD file. Samplesyntax that fails:

""

Tip: Eliminate the line from the file.

Note: These limitations only apply to DTD files read by an adapter, notthose read by the Designer. It is important to note that the only file theadapter reads is the one configured in the adapter operation. Adapters donot read embedded DTD files.


30/48

Migration considerations



Data Integrator version 11.5.1.5 will only support automated upgrade from

ActaWorks and Data Integrator versions 5.2.0 and above to version 11.5. Forcustomers running versions prior to ActaWorks 5.2.0 the recommendedmigration path is to first upgrade to Data Integrator version 6.5.1.

If you are upgrading to 11.5.1.5, to take advantage of the new Netezza bulk-loading functionality, you must upgrade your repository.

If you are upgrading from Data Integrator versions 11.0.0 or older to DataIntegrator 11.5.1.5, you must upgrade your repository. If upgrading from11.5.0 to 11.5.1.5, you must upgrade your repository to take advantage of thenew:

Data Quality Dashboards feature

Preserving database case feature

Salesforce.com Adapter Interface (delivered with version 11.5 SP1Adapter Interfaces)

20647 View optimized SQL in the Designer does not capture the latest changes tothe data flow. Instead, SQL for the previously-saved version of the objectdisplays.

Tip: To view Optimized SQL for the latest changes, save the object first.19893 The mail_to function does not work on Windows 2000 after downloading a

security patch for Microsoft Outlook.

Tip: To send e-mail out from Data Integrator after installing a security patch,follow the instructions from the following web site:

http://support.microsoft.com/default.aspx?scid=kb;en-

us;Q263297&id=263297&SD=MSKB#OB

The instructions on the web site show how to suppress prompting whensending e-mail from a particular computer. First a security policy file iscreated on the Exchange Server. Second, the registry key is added to a

client machine that tries to send e-mail programmatically. This client machineis the machine on which you are running the Data Integrator Job Server.When a client machine tries to send an e-mail, the Outlook client first checksthe registry key. If this key is set, Outlook looks at the security policy file onthe exchange server. In the security policy file, turn off prompting and theData Integrator mail_to function will work.
http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdf


31/48



The following sections describe changes in the behavior of Data Integratorfrom previous releases. In most cases, the new version avoids changes thatwould cause existing applications to modify their results. However, undersome circumstances a change has been deemed worthwhile or unavoidable.

This section includes:

Brief installation instructions

Netezza bulk loading

Conversion between different data types

Varchar behavior

Central Repository

Changes to code page names

Crystal Enterprise adapters

Data cleansing Changes to Designer licensing

Web Services support

Sybase ASE version 12.5 bulk loader library on UNIX

Informix native client support

Statistics repository tables

Brief installation instructions

Complete installation instructions are in the Data Integrator Getting StartedGuide(for the stand-alone version, open the DIGettingStartedGuide.pdf in theDoc\Books folder on the installation CD).

To install without a previous version of Data Integrator:

Follow the instructions in the Data Integrator Getting Started Guideto create adatabase location for a Data Integrator repository, run the installationprogram, and register the repository in the Data Integrator Administrator.

To install with an existing version of Data Integrator:

1. Using your existing Data Integrator or ActaWorks version, export the

existing repository to a file as a backup.2. Create a new repository and import the ATL file created in step 1.

3. To use configuration settings from the previous version of Data Integratoror ActaWorks, create the new installation directory structure and copy thefollowing files from your Data Integrator or ActaWorks installation into it.The default Windows installation structure is:


32/48



drive\Program Files\Business Objects\Data Integratorversion

4. Uninstall your previous version of Data Integrator or ActaWorks.

Business Objects recommends uninstalling, particularly when you areupgrading from ActaWorks to Data Integrator.

5. Install Data Integrator in the default location given by the install program.

If you set up an installation path in step 3, use that path.

6. During the installation, upgrade the existing repository to 11.5.0.

7. If you used the configuration settings from the previous version, validatethat the existing Job Server and Access Server configuration appearswhen you reach the server configuration section of the installer.

8. After the installation is complete, open the Administrator at the browserlocation

http://:28080

9. Re-register (add) the repository.

Netezza bulk loading

If you are upgrading to 11.5.1.5, to take advantage of the new Netezza bulk-loading functionality, follow these procedures.

To enable Netezza bulk loading

1. Upgrade your repository to version 11.5.1.5.

2. In the Designer, for each ODBC datastore that uses a Netezza datasource:

a. Right-click the datastore and click Edit to open the datastore editor.

b. Click OK.

This procedure verifies the connection to the database. If you receive aconnection error:

a. Open the ODBC Administrator.

b. Select the data source name.

c. Click Configure.

To use Copy

Administrator settings \conf directory

Repository, Job Server, andDesigner settings

\bin\dsconfig.txt


33/48



d. Click Test Connection.

e. Correct any connection errors.

f. Right-click the datastore and click Edit to open the datastore editor.

g. Click OK.

3. In the Designer, for each Netezza job:

a. Open the job so it appears in the workspace.

b. Click the Save All button.

This procedure causes Data Integrator to set the default options in thejobs.

If you only upgrade the repository and do not perform the other steps, thenthe Bulk Loader Options tab for Netezza targets and the new options in thedatastore editor wont be visible. However, Data Integrator still automatically

employs bulk loading unless one or more of the following options have valuesset on the Netezza target table editor Options tab:

Ignore columns with value Ignore columns with null Any Error handling options Any Transaction control options

Conversion between different data types

For release, there is a change in behavior for data conversion between

different data types. Previously, if there was an error during data conversion(for example converting a varchar string to integer and the varchar stringcontains non-digits), the result was random. Now, the return value will beNULL for any unsuccessful conversion.

Similarly, previously Data Integrator returned random data for the result ofvarchar to datetime conversion when the varchar string contains an illegaldate format. Now, the return value will be NULL.

Varchar behavior

Data Integrator 11.5.0 (and above) conforms to the ANSI SQL-92 varcharbehavior. When you upgrade Data Integrator and save your previousconfigurations, the default is to use the previous varchar behavior. However,Business Objects recommends that you use the ANSI varchar behaviorbecause the previous varchar behavior will not be supported in a future DataIntegrator version.


34/48



To change from the previous varchar behavior to the ANSI varcharbehavior

1. In the Data Integrator Designer, click Tools > Options > Job Server >General

2. Enter al_engine for Section, ANSI_VARCHAR_BEHAVIOR for Key, andTRUE for Value.

3. Click OK.

4. If you want your jobs and work flows from a previous version of DataIntegrator to use the ANSI varchar behavior, you must make changes inthe following areas:

NULLs and empty strings in scripts and script functions

Trailing blanks in sources and functions

NULLs, empty strings, and trailing blanks in transforms

For details about the changes in these areas and a comparison of theprior behavior and the varchar ANSI behavior, please contact BusinessObjects Technical Support at Business Objects Customer Support athttp://support.businessobjects.com/.

Central Repository

Business Objects recommends the following guidelines to upgrade yourcentral repository from one Data Integrator release to another.

Maintain a separate central repository for each Data Integrator version topreserve object history.

An upgrade of the central repository might override the versions of anyobject whose internal representation (ATL) has changed in the newrelease.

To preserve the current ATL of objects and their history

1. Create a new central repository on the current Data Integratorrelease and export the latest version of all objects and theirdependents from the existing central repository to the new centralrepository.

2. Install the new Data Integrator release and upgrade the new centralrepository to the new Data Integrator release.

3. Keep the existing central repository to maintain the history of theobjects in the current release.

4. Use the new central repository for objects that you create in the newrelease.
http://support.businessobjects.com/http://support.businessobjects.com/


35/48



Upgrade the central repository and local repositories at the same time, ifpossible.

A central repository might not work with a local repository that is on a

different Data Integrator release. You might not be able to perform multi-user operations between a central repository and a local repository thatare on different Data Integrator versions. Therefore, upgrade the centralrepository and local repositories to the same Data Integrator version atthe same time.

If it is not convenient to upgrade the central and local repositories at thesame time, check in all objects before you upgrade the central repository.

Check in all objects (or undo the check-outs if objects have not beenmodified after check-out), especially those objects that were checked outto the local repositories that will not be upgraded at the same time. Afteryou upgrade the central repository the new Data Integrator version, youwill not be able to check in any objects from the local repository of anolder Data Integrator version.

Changes to code page names

Starting with Version 11.0, Data Integrator displays some code pages withdifferent names. For example, code page MS1252 displays as CP1252.Additionally, two code pages are no longer supported. These changes arevisible only in the list locales screens (in installer, datastore and file-formats).The Data Integrator engine does not have any upgrade issues and

understands the old code page name.

Old code page name New Name (Data Integrator

version 11.0 and later)

iso885910 Not supported

MS949 CP949

MS950 CP950

MS1250 CP1250

MS1251 CP1251

MS1253 CP1253MS1254 CP1254

MS1255 CP1255

MS1257 CP1257

MS874 CP874


36/48



Crystal Enterprise adapters

After installing a new version of Business Objects, you might receive a classnot found error when trying to start Crystal Enterprise adapter. You mustupdate the Crystal Enterprise adapter configuration by updating theBusinessObjects directory name in the classpath for both the CrystalEnterprise adapter and the DMAC command file.

To update classpaths

1. Locate the new jar files. The default locations are:

BusinessObjects XI: C:\Program Files\Common Files\ BusinessObjects\3.0\java\lib

BusinessObjects XI R2: C:\Program Files\ BusinessObjects\common\3.5\java\lib

2. For the Crystal Enterprise Adapter:

a. To ensure any new adapter instances have the correct classpath,modify LINK_DIR\adapters\install\CrystalAdaper.xml with the new jarfile location. Modify the element by globallychanging the path to the new jar files for Crystal Enterprise 10 (seethe default location noted in the previous step) to that of theBusinessObjects XI path.

b. Save the file. Any future adapter instances created will now have thecorrect jar file path.

c. Change any configured adapter instances by deleting the configuredadapter instance and creating a new one using the same adapterinstance name, which keeps all adapter usage valid.

3. For the DMAC command file launched by the DMAC wizard:a. Edit LINK_DIR\ext\dmac\wizard.com.

b. Change the entry set CE_JARS_DIR= to point to the new path. Forexample, if you installed BusinessObjects XI, the line should read:

set CE_JARS_DIR=C:\Program Files\CommonFiles\Business Objects\3.0\java\lib

MS1258 CP1258

MS1361 Not Supported

USASCII US-ASCII

Old code page name New Name (Data Integrator

version 11.0 and later)


37/48



Data cleansing

The new Data Integrator installation will overwrite all template job filesshipped with Data Integrator with the upgraded job files compatible with

Firstlogic 7.60. If the user had manually modified the template job files andwants to preserve the changes, Business Objects recommends that a copy ismade of the job file, or that the job file is renamed, prior to installing DataIntegrator version 11.5.

After installing Data Integrator version 11.5 and the Firstlogic 7.6 suite, youshould do the following:

From the Data Integrator CD, copy pwdiqjob.upd from the followingdirectory:

Windows: \Utilities

UNIX: /unix/PLATFORM

to the dtr_iq directory. Click Yes to overwrite existing file.

For all your job templates, run Firstlogic's edjob utility to upgrade yourFirstlogic job files from the previous version to 7.60. Find the edjob utilityunder the installation of Firstlogic. Run the utility to upgrade all jobs of thesame extension by specifying *.extensionin the utility. Extension namesare .diq, .iac, and .mpg. For instructions on how to use the edjob utility,refer to Firstlogic documentation.

Note: If the jobs have already been updated to 7.60c (using the .upd filesent with the master install with edjob), you will receive the following error

when trying to open a 7.60 job:Error: The Report Defaults block, occurrence 1, has an

incorrect number of lines and the job cannot beloaded.

These jobs will need to be manually edited to change the version string inthe General block from the previous version to 7.60c. Then edjob can bererun with the correct .upd file.

For all job templates created under the address enhancementapplication, manually edit the job templates using an editor such asNotepad, and comment out the Create Output File block by adding the'*' character at the beginning of the line. For example:

*BEGIN Create Output File


38/48



Changes to Designer licensing

Data Integrator Designer versions 6.5 and above do not support floatinglicenses. If you are currently using floating Designer licenses, obtain a new

license key before upgrading. Send your request [email protected] with Data Integrator License Keys as thesubject line. The new key will be added to your existing License AuthorizationCode.

For more information, contact Business Objects Technical Support at http://support.businessobjects.com.

Web Services support

When using Data Integrator with Web Services, the following limitations exist:

SAP R/3 IDoc message sources in real-time jobs are not supported The Data Integrator Web Services server uses the first Job Server in the

list of those available for a batch job. The first Job Server might be aserver group.

If you are using Web Services and upgrading to versions 6.5.0.1 orabove, Web Services server (call-in) functionality that you created withprevious versions of Data Integrator is not supported. Perform thefollowing changes to manually upgrade the Web Services server:

Regenerate a WSDL file

Prior to release 6.5.0.1, every batch job and real-time serviceconfigured in Data Integrator was published in the WSDL file. Inrelease 6.5.0.1 and above, Data Integrator only publishes batch jobsand real-time services that you select. Clients that call DataIntegrator using Web Services will fail until you authorize the jobsand services being invoked.

Change SOAP calls to match those in the 6.5.0.1 and aboveversions.

A session ID is not included in SOAP messages unless you enablesecurity for the Web Services server. Prior to release 6.5.0.1, thesessionID message part was published in every SOAP message.

To fix this problem, change SOAP calls to match those in the 6.5.0.1or above version of the WSDL file.

If security is off, remove the sessionID line from the SOAP inputmessage.
http://support.businessobjects.com/http://support.businessobjects.com/http://support.businessobjects.com/http://support.businessobjects.com/


39/48



If security is on, copy the sessionID from the SOAP body to theSOAP header as a session ID now appears in the SOAP headerinstead of the body.

Note: When you install 6.5.0.1 or above, the installer automaticallyupgrades the Web Services Adapter and your existing Web Servicesclients will function properly.

Sybase ASE version 12.5 bulk loader library on UNIX

With Sybase ASE version 12.5, the installed Sybase ASE client on UNIXplatforms does not include the Sybase bulk loader dynamic shared library thatData Integrator requires. Please refer to the README in either the CDROMLocation/unix/PLATFORM/AWSybase directory or the $LINK_DIR/AWSybasedirectory for instructions about how to:

Confirm that the library is available in the Sybase client installation

Build the library

Informix native client support

If you created an Informix repository and datastores with a previous DataIntegrator release using DataDirect Technologies Connect ODBC driver, theyare not compatible with Data Integrator 6.5.1 and above. You must recreateyour repository, datastores, and jobs if you want to use the Informix native

driver.

Statistics repository tables

The repository tables AL_FLOW_STAT and AL_JOB_STAT are no longerpopulated for job, work flow, or data flow statistics. These two tables no longerexist in the newly created Data Integrator version 11.0.1 and aboverepositories. They could still exist in the repositories that are upgraded toversion 11.0.1 and above.

Beginning with Data Integrator version 11.0.1, all job, work flow, and data flowstatistics are stored in the AL_HISTORY, AL_HISTORY_INFO, and

AL_STATISTICS tables. In particular, the job statistics, previously stored inAL_JOB_STAT, are now stored in the AL_HISTORY and AL_HISTORY_INFOtables. The work flow and data flow statistics, previously stored inAL_FLOW_STAT are now stored in the AL_STATISTICS table. Use themetadata reporting tool to retrieve all job, work flow and data flow statistics.


40/48

Documentation corrections



Please note the following last-minute corrections to the Data Integrator

11.5.1.5 and later documents. These changes will be incorporated into afuture release of the manual set.

Note: Business Objects uses the associated numbers for bug-trackingpurposes.

Administrators Guide

34055

Data Integrator now supports HTTPS for Web services adapters. Add thefollowing overview to the Administrators Guide.

To enable HTTPS support for Web services

1. Generate keystores for the server and client computers.

2. Configure the TOMCAT web server by opening the server_di.xml file inthe %LINK_DIR%\ext\webserver\conf directory, uncommenting theConnector element, and adding the following attributes:

keystoreFile="%your server keystore file path here"keystorePass="%the password you entered in the keystore%"

3. When you create the Web services adapter datastore in Designer, enterthe Keystore Path.

Metadata Reports Users Guide

34403

Add the following note to chapter 3, Impact and Lineage Analysis Reports,Navigation section:

Note: To repopulate the CMS navigation tree with any objects that mighthave changed (added, deleted, renamed, etc.) in the CMS repository afteryou display an impact and lineage report, log out and log back in to metadatareports to display the changes.
http://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdfhttp://../ReleaseNotes/11.5.1.5ReleaseNotes/master.pdf


41/48



Salesforce.com Adapter Interface Guide

33860

When you create a new Custom table in Salesforce.com and attempt to fetchCDC data from that table from the Data Integrator Designer, if the CDC tabledoes not specify a starting date, Data Integrator will throw an error stating:

Error reading from : .

Therefore, the Using the CDC table source default start date section of theSalesforce.com Adapter Interface Guide should state the following:

When you do not specify a value for the start date:

Data Integrator uses the beginning of the Salesforce.com retentionperiod as the start date if a check-point is not available (during initial

execution).

Data Integrator uses the check-point as the start date if a check-point isavailable and occurs within the Salesforce.com retention period. If thecheck-point occurs before the retention period, Data Integrator uses thebeginning of retention period as the start date.

Data Integrator may throw an error message. Business Objectsrecommends that you specify a default start date for your CDC tables.

DMAC User's Guide

28611

Add the following note in the section Running the batch job:

Note: When using Data Mart Accelerator for Crystal Reports to run complexreports or those that contain a very large amount of data, the batch jobcreated by the Data Mart Accelerator might run out of TCP ports and theadapter could hang and ultimately be terminated by Data Integrator (after thedefault allowance for 10 minutes of inactivity). This problem occurs when theCrystal Report Application Server (RAS) runs out of available ports. On atypical Windows installation, TCP ports above 5000 might not be available.For information on how to change the number of available ports, see

Microsoft Knowledge Base Article 196271 Unable to Connect from TCPPorts Above 5000. To further reduce the load on the RAS server, you canalso rerun the Data Mart Accelerator and set the maximum number ofinstances to a lower number.


42/48




Business Objects offers a full documentation set covering its products and

their deployment. Additional support and services are also available to helpmaximize the return on your business intelligence investment. The followingsections detail where to get Business Objects documentation and how to usethe resources at Business Objects to meet your needs for technical support,education, and consulting.

Documentation

You can access electronic documentation at any time from the productinterface, the web, or from your product CD.

Documentation on the web

The full electronic documentation set is available to customers on the webfrom the Customer Support web site at: http://support.businessobjects.com/documentation/.

Documentation on the product CD

Look in the Doc directory of your product CD or installation directory forguides in Adobe Acrobat PDF format.

Send us your feedback

Do you have a suggestion on how we can improve our documentation? Isthere something you particularly like or have found useful? Drop us a line,and we will do our best to ensure that your suggestion is included in the nextrelease of our documentation:[email protected].

Note: If your issue concerns a Business Objects product and not thedocumentation, please contact our Customer Support experts at http://support.businessobjects.com.

Customer support, consulting, and training

A global network of Business Objects technology experts provides customersupport, education, and consulting to ensure maximum business intelligencebenefit to your business.
http://support.businessobjects.com/documentationhttp://support.businessobjects.com/documentationmailto:%[email protected]://support.businessobjects.com/http://support.businessobjects.com/http://support.businessobjects.com/http://support.businessobjects.com/mailto:%[email protected]://support.businessobjects.com/documentationhttp://support.businessobjects.com/documentation


43/48



Data Integrator (DI) Zone

DI Zone provides technical information such as white papers, tips and tricks,and listings of training opportunities and other events. This site is available to

all Data Integrator users.http://www.businessobjects.com/products/dev_zone/di/default.asp

Customer support centers

Business Objects offers customer support plans to best suit the size andrequirements of your deployment. We operate customer support centers inthe following countries:

USA

Australia

Canada

United Kingdom

Japan

Online Customer Support

The Business Objects Customer Support web site contains information aboutCustomer Support programs and services. It also has links to a wide range oftechnical information including Knowledge Base articles, downloads, andsupport forums.

http://support.businessobjects.com/

Consultation

Business Objects consultants can accompany you from the initial analysisstage to the delivery of your deployment project. Expertise is available inrelational and multidimensional databases, connectivities, database designtools, customized embedding technology, and more.

For more information, contact your local sales office, or contact us at:

http://www.businessobjects.com/services/consulting/

Training

From traditional classroom learning to targeted e-learning seminars, we canoffer a training package to suit your learning needs and preferred learningstyle. Find more information on the Business Objects Education web site:

http://www.businessobjects.com/services/training
http://www.businessobjects.com/products/dev_zone/di/default.asphttp://support.businessobjects.com/http://www.businessobjects.com/services/consulting.htmhttp://www.businessobjects.com/services/education.htmhttp://www.businessobjects.com/services/education.htmhttp://www.businessobjects.com/services/education.htmhttp://www.businessobjects.com/services/consulting.htmhttp://www.businessobjects.com/services/consulting.htmhttp://support.businessobjects.com/http://www.businessobjects.com/products/dev_zone/di/default.asp


44/48



Useful addresses at a glance


SNMP copyright information

Portions Copyright 1989, 1991, 1992 by Carnegie Mellon University

Portions Derivative Work - 1996, 1998-2000

Portions Copyright 1996, 1998-2000 The Regents of the University ofCalifornia

All Rights Reserved

Address Content

Business Objects productinformation

http://www.businessobjects.com

Information about the full range ofBusiness Objects products.

Product documentation

http://support.businessobjects.com/documentation

Business Objects productdocumentation, including theBusiness Objects ProductDocument Map.

Business Objects Documentationmailbox

[email protected]

Send us feedback or questionsabout documentation.

Online Customer Support

http://support.businessobjects.com

Information on Customer Supportprograms, as well as links totechnical articles, downloads, andonline forums.

Business Objects ConsultingServices

http://www.businessobjects.com/services/consulting/

Information on how BusinessObjects can help maximize yourbusiness intelligence investment.

Business Objects EducationServices

http://www.businessobjects.com/services/training

Information on Business Objectstraining options and modules.
http://www.businessobjects.com/http://support.businessobjects.com/documentationhttp://support.businessobjects.com/documentationmailto:[email protected]://support.businessobjects.com/http://businessobjects.com/services/consulting/http://businessobjects.com/services/consulting/http://www.businessobjects.com/services/traininghttp://www.businessobjects.com/services/traininghttp://www.businessobjects.com/services/traininghttp://www.businessobjects.com/services/traininghttp://businessobjects.com/services/consulting/http://businessobjects.com/services/consulting/http://support.businessobjects.com/mailto:[email protected]://support.businessobjects.com/documentationhttp://support.businessobjects.com/documentationhttp://www.businessobjects.com/


45/48



Permission to use, copy, modify and distribute this software and itsdocumentation for any purpose and without fee is hereby granted, providedthat the above copyright notice appears in all copies and that both thatcopyright notice and this permission notice appear in supporting

documentation, and that the name of CMU and The Regents of the Universityof California not be used in advertising or publicity pertaining to distribution ofthe software without specific written permission.

CMU AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIADISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY ANDFITNESS. IN NO EVENT SHALL CMU OR THE REGENTS OF THEUNIVERSITY OF CALIFORNIA BE LIABLE FOR ANY SPECIAL, INDIRECTOR CONSEQUENTIAL DAMAGES OR ANY DAMAGES

WHATSOEVER RESULTING FROM THE LOSS OF USE, DATA OR

PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OROTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTIONWITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Portions Copyright (c) 2001, Networks Associates Technology, Inc

All rights reserved.

Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this listof conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

Neither the name of the NAI Labs nor the names of its contributors may beused to endorse or promote products derived from this software withoutspecific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ANDCONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANT ABILITY AND FITNESS FOR APARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THECOPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANYDIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OFUSE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,


46/48



STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

Portions of this code are copyright (c) 2001, Cambridge Broadband Ltd.

All rights reserved.

Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this listof conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, thislist of conditions and the following disclaimer in the documentation and/orother materials provided with the distribution.

The name of Cambridge Broadband Ltd. may not be used to endorse orpromote products derived from this software without specific prior writtenpermission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AS IS''AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANT ABILITY ANDFITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NOEVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIALDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS

INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUTOF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.

Specifications subject to change without notice. Not responsible for errors oradmission

Documents

Dire Lease Notes