Informatica
®Corporation B2B Data Exchange Version 9.5.0 Release Notes
June 2012
Copyright (c) 2006-2012 Informatica Corporation. All rights reserved.
Contents
New Features. . . 1
Installation. . . 3
Upgrade Changes. . . 3
Fixed Limitations. . . 4
Known Limitations. . . 5
Informatica Global Customer Support. . . 7
This document contains important information about installation, fixed limitations, and known limitations for B2B Data Exchange. Do not upgrade to this release from a previous version without carefully reading the relevant sections on upgrading and bug fixes, since bug fixes may change the behavior of existing functionality.
New Features
B2B Data Exchange 9.5.0 offers the following new features and enhancements:
Dashboard and reports
The extended Dashboard displays personalized visual reports about information that B2B Data Exchange processes. Use the Dashboard to view summary information about B2B Data Exchange event
processing, such as the number of events for a specific partner or the accounts with the highest error rate. Most of the reports in the Dashboard are based on key performance indicators (KPIs) that B2B Data Exchange retrieves from the operational data store. You create the operational data store when you install the B2B Data Exchange Dashboard and Reports component.
The operational data store collects aggregated event information from the run-time B2B Data Exchange repository with the operational data store event loader. The event loader is a PowerCenter workflow that loads events from the run-time B2B Data Exchange repository at predefined intervals. In addition to the default KPIs, you can instruct the event loader to load event attribute values. The B2B Data Exchange developer can use Logi Info Studio to create custom Dashboard panels based on the default KPIs or the event attribute values.
If you upgrade from version 9.1.0 and install the Dashboard and Reports component, the B2B Data Exchange installer replaces the previous basic Dashboard.
Event archiving with Data Archive
You can use the B2B Data Exchange accelerator for Data Archive to archive events from the main B2B Data Exchange repository. With the B2B Data Exchange accelerator, you can use Data Archive to create archive projects with advanced parameters, such as event status or event type. You can also schedule standalone or recurring archive jobs, and browse or search for archived events and documents. If you use B2B Data Exchange 9.5.0 with Data Archive 5.3.6, you can archive events and documents to the history database for short-term archiving and view the archived events from the Archived Events page of the Operation Console.
You can still use the archive command line utility to perform basic event and document archiving.
Audit trail enhancement
You can use the enhanced audit trail to track actions that operators perform on objects in the Operation Console, APIs, or the command line utilities, such as creating or editing a partner or an account. Each audit record contains detailed information about the action and the object, such as the name of the user that performed the action and the actual values that were changed. B2B Data Exchange no longer stores audit records as events.
If you upgrade from earlier versions, you can still view and archive legacy audit trail events.
Authorization
You can use authorization to comply with the organization business or legal need to monitor and regulate actions that operators perform in the Operation Console on partners, accounts, and profiles, before B2B Data Exchange completes the action. You define authorization levels for different actions or objects. For example, you can require approval by 2 operators every time an operator deletes a partner. Operators with authorization privileges review and approve or reject the pending operator actions. B2B Data Exchange completes the action and generates an audit record after approval. The object is locked for editing while an operator action is pending.
Forms Designer Java API
You can populate lists in the Forms Designer with values from external sources. Use the classes, interfaces, and methods in the API to determine the source of the values and set default values for the list. You can configure the API to throw an exception in case an error occurs while the Forms Designer retrieves the values. When you use the Forms Designer, you see an indication for any list with values from an external source.
Storage of endpoint files in Hadoop file systems (HDFS)
You can store backup copies of files that B2B Data Exchange processes through Managed File Transfer or File Receive endpoints in HDFS. You configure the HDFS location and credentials in B2B Data Exchange system properties. When you define the endpoint, you can use the HDFS root directory to determine the location in which to save the file. For Managed File Transfer endpoints, you can store incoming files in HDFS.
You can use B2B Data Exchange with several Hadoop versions. Select the Hadoop version based on the organization needs.
Password encryption command line utility
When you install B2B Data Exchange, configuration properties and system property values that contain passwords are stored as encrypted strings. If you modify any of the passwords, you use the password encryption command line utility to encrypt the password and use the encrypted string.
Installation
Before you install or upgrade B2B Data Exchange, verify that your system meets the minimum requirements and follow the pre-installation steps. For information about installing or upgrading B2B Data Exchange, see the B2B Data Exchange Installation and Configuration Guide.
B2B Data Exchange Installation Limitations
¨ When you install B2B Data Exchange on IBM AIX 6.1 operating systems, an error message may appear with the following text: Unzip: not found. (XE-6569)
Workaround: Ignore the error message.
¨ When you install the B2B Data Exchange server plug-in for PowerCenter on IBM AIX operating systems, an error message may appear in cases where PowerCenter 9.5 is installed on the same machine without JDK. The error message includes the following text: java.policy doesn't exist. (XE-6824)
Workaround: Ignore the error message.
¨ When you install or uninstall B2B Data Exchange on IBM AIX operating systems in console mode, an error message may appear with the following text: Hostname and service name not provided or found. (XE-6870)
Workaround: Ignore the error message.
¨ When you upgrade from B2B Data Exchange 9.0.1 while another application uses the dx-tools folder, the installer does not import account attribute values to the B2B Data Exchange repository. (XE-6839) Workaround: Before you upgrade, verify that no other application uses the dx-tools folder.
B2B Data Exchange Accelerator for Data Archive Installation Prerequisites
Before you import the B2B Data Exchange accelerator to Data Archive 5.3.6, contact Informatica Global Customer Support.
Upgrade Changes
When you upgrade to B2B Data Exchange 9.5.0, consider the following functionality and behavior changes:
¨ Java Development Kit (JDK) is not installed on IBM AIX operating systems. Install and configure JDK before you install B2B Data Exchange.
¨ Java Cryptography Extension (JCE) is not installed on IBM AIX operating systems. If you use B2B Data Exchange with Managed File Transfer, install JCE before you install B2B Data Exchange.
¨ The archive command line utility does not use the dx.event.status.category.success system property and the dx.event.status.category.failed system property to determine if an event reached a final or an error status. Instead, B2B Data Exchange stores the information in the event status. The archive command line utility determines which events to archive based on whether the event reached a final state, regardless of the error state.
¨ Names and identifiers of custom attributes for partners and accounts are case-insensitive. During the upgrade process, the B2B Data Exchange installer removes all duplicate names or identifiers and the log describes the removal information. The installer does not remove attribute definitions. If you import
partners or accounts from earlier versions that contain duplicates, the import process rejects all duplicates and throws an exception.
¨ B2B Data Exchange does not create events for audit records, and does not convert audit trail events from previous versions to enhanced audit records. You can use the archive utility to archive and delete all of the legacy audit trail events before you upgrade. If you keep the legacy audit events from earlier versions, you can view the events after you upgrade in the Legacy Audit Events page. You can also archive the legacy audit events with the B2B Data Exchange Accelerator for Informatica Data Archive or the B2B Data Exchange archive utility after you upgrade.
¨ When an event reconciliation completes successfully, B2B Data Exchange generates a single entry in the Processing Information tab of the event details instead of multiple entries for each stage of the
reconciliation process.
¨ To improve performance and reduce bottlenecks, B2B Data Exchange creates a temporary file for every incoming file that it processes through Managed File Transfer endpoints in the following folder:
<DXDocumentStore>\mft. Each file name includes the prefix dx_, the name of the incoming file, and the extension .tmp. To conserve disk space, periodically delete temporary files that B2B Data Exchange created in the folder at least 24 hours earlier.
¨ You cannot configure session replication for B2B Data Exchange in a cluster environment.
¨ B2B Data Exchange uses the dx.endpoint.jms.provider.url system property to determine if the B2B Data Exchange JMS Broker service is running.
¨ After you upgrade, you cannot view the Properties tab of the DX_Generate_Temporary_File transformation. To use this option, delete and re-add the transformation.
¨ In the B2B Data Exchange repository on Microsoft SQL Server, the type of the
CORRELATION_IDENTIFIER column in the DX_CORRELATION table is NVARCHAR(255) instead of VARCHAR(255).
¨ In the B2B Data Exchange repository on Oracle and Microsoft SQL Server, the type of the CORRELATION_ID column in the DX_CORRELATION table is NUMERIC(19,0) instead of VARCHAR(255).
Fixed Limitations
Issue Description
XE-6776 You cannot create event attributes for email notifications that contain the prefix dx_*.
XE-6756 The DX_Profile_Parameter and the DX_Increment_Profile_Parameter transformations may not process read-only profile parameters correctly.
XE-6624 When B2B Data Exchange processes events through endpoints, the events do not include the related partner and account for profiles that do not include partners and accounts.
XE-6469 When B2B Data Exchange processes a large number of document files through Managed File Transfer endpoints, B2B Data Exchange may take a long time to delete the temporary rows from the B2B Data Exchange repository.
XE-6444 When you view schedules on multiple pages, the schedule list does not appear correctly.
XE-6288 The DX_Event_Details transformation may not process events with statuses longer than 20 characters correctly.
XE-6154 Editing a partner with a large number of accounts for which there is a large number of account attributes may take a long time.
Issue Description
XE-6084 You cannot run the pingJms command on the B2B Data Exchange server.
XE-6071 When you configure a PowerCenter mapping, you cannot create a source data port with a name that is shorter than 5 characters.
XE-6044 If you configure B2B Managed File Transfer to use a forward proxy by default, you cannot run batch workflows in B2B Data Exchange.
XE-5974 When you run a simple Web Service endpoint request, strict validation of the Web Service API response might fail.
XE-5881 When you install B2B Data Exchange with the HTTPS protocol, and configure Apache with HTTP, the Operation Console fails to appear.
XE-5771 When you upgrade to version 9.1.0 and select HTTPS as the sole connection setting without selecting HTTP, then you must manually update the following B2B Data Exchange URL system properties:
- dx.console.url
- dx.mft.console.url if B2B Data Exchange Managed File Transfer is installed - issue.tracking.url if issue tracking is installed
- pwc.webservices.url if PowerCenter web services hub uses HTTPS
XE-5717 From the Operation Console import/export feature, the user cannot export partners with more than 500 accounts in one file.
Known Limitations
CR Description
XE-6877 If you assign a batch workflow to a profile, the Delayed Processing tab and the scheduling options may be disabled.
Workaround: Save and re-edit the profile.
XE-6849 If you schedule a monitor or an endpoint to run once, you cannot reschedule the monitor or endpoint to run once within 2.5 hours of the previous run.
XE-6846 When you delete an object with information that the Dashboard displays in a panel and then create an object with the same name, the operational data store event loader fails.
Workaround: Do not delete objects with information that the Dashboard uses.
XE-6834 When you use B2B Data Exchange on Apache Hadoop 1.0 machines with the IBM AIX operating system, you cannot store files that B2B Data Exchange processes through File Receive or Managed File Transfer endpoints in the Hadoop file system.
Workaround: Upgrade the Apache Hadoop version to 1.0.3 or later.
XE-6695 If you create a delayed processing rule for a profile that contains event properties with incorrect or incomplete default values, B2B Data Exchange may enable the Delay All Events processing rule.
Workaround: Discard the event and define correct event attribute values for the profile.
XE-6657 If you use B2B Managed File Transfer and you move the B2B Data Exchange repository to a different machine, B2B Managed File Transfer does not replace the database connection.
Workaround: Manually delete the previous database connection in the Databases section of the Managed File Transfer administrator console.
XE-6545 When you work with B2B Data Exchange workflows, you cannot move a group of profile parameters into one of its child groups.
XE-6531 If you import a batch workflow to B2B Data Exchange before you define the workflow type, B2B Data Exchange may not recognize the batch workflow.
Workaround: Delete the workflow file and define the workflow type before you re-import the workflow.
CR Description
XE-6423 The operational data store event loader does not load events that B2B Data Exchange processed during the last hour before daylight savings time begins.
XE-6409 If a PowerCenter session fails, the operational data store event workflow may not display a failed status.
Workaround: Monitor the PowerCenter session to verify the success of the run.
XE-6403 You cannot use the DX_Aggregate transformation in a PowerCenter session with multiple partitions.
XE-6283 When you modify a Managed File Transfer endpoint, B2B Data Exchange does not generate an audit record for mailbox or host changes.
XE-6011 When you install B2B Data Exchange with Managed File Transfer and you select HTTPS as the protocol, the following messages appear in the MFT log:
Local Listener Error: HTTP/s SSL Server Certificate does not exist.
Local Listener Result: "Exception" "java.net.BindException: Port <PortNumber> - Address already in use ...
If installation was successful, the following message also appears and you can ignore the error messages:
Local Listener Detail: Started Listener ports - <List of Ports, including HTTP/s> level=2
XE-5983 When you install B2B Data Exchange with Web Services API connectivity and you select ISP authentication, B2B Data Exchange fails due to failure to connect to the PowerCenter Web Server Hub.
Workaround: Use a user name from the Native authentication group for the PowerCenter Web Services Hub and PowerCenter Domain panels of the installer.
XE-5972 When you reprocess an event created with a default source document that was dropped into an endpoint configured for Pass by Reference, extra characters are appended to the source file name in the Input Message Log.
XE-5958 When you install B2B Data Exchange with Managed File Transfer on a Linux or UNIX platform and you select HTTPS as the protocol, the Managed File Transfer process does not terminate when the installer terminates.
Workaround: Shut down the Managed File Transfer process before you start B2B Data Exchange to register the license.
XE-5951 When you install B2B Data Exchange with Managed File Transfer on a Linux or UNIX platform and you select HTTPS as the protocol, and you then start B2B Data Exchange to register the license, there are two instances of the MFT process and only one terminates when you close B2B Data Exchange.
Workaround: Install the license file, close B2B Data Exchange, and then kill the MFT processes or run mft.sh stop or shutdown.sh. XE-5947 When the server and browser are running in different time zones, the partner date attribute is sometimes saved with an incorrect date
value.
Workaround: Use a String data type instead of a date field.
XE-5909 When the developer uses the Profile Parameters custom transformation to define a workflow parameter that starts with "DX", the output port for this parameter is always null and the transformations fail.
Workaround: Do not start parameter names with "DX". This prefix is reserved for internal system use only.
XE-5895 When you click the Overview button on the Events List screen, you cannot scroll to the bottom of the screen.
Workaround: Resize the window.
XE-5822 When you install B2B Data Exchange with SQL server and use both the instance name and the port, B2B Data Exchange fails and the following error message appears in the log:
FATAL [com.informatica.b2b.dx.bootstrap.DXRuntimeControlImpl] {main} Fatal error in starting the servicesorg.springframework.beans.factory.BeanInitializationException: DX Repository not found.
Workaround: Enter a connection string without a port number or without the instance name.
Informatica Global Customer Support
You can contact a Customer Support Center by telephone or through the Online Support. Online Support requires a user name and password. You can request a user name and password at
http://mysupport.informatica.com.
Use the following telephone numbers to contact Informatica Global Customer Support:
North America / South America Europe / Middle East / Africa Asia / Australia
Toll Free
Brazil: 0800 891 0202 Mexico: 001 888 209 8853 North America: +1 877 463 2435
Toll Free
France: 0805 804632 Germany: 0800 5891281 Italy: 800 915 985 Netherlands: 0800 2300001 Portugal: 800 208 360 Spain: 900 813 166 Switzerland: 0800 463 200 United Kingdom: 0800 023 4632
Standard Rate
Belgium: +31 30 6022 797 France: +33 1 4138 9226 Germany: +49 1805 702 702 Netherlands: +31 306 022 797 United Kingdom: +44 1628 511445
Toll Free
Australia: 1 800 151 830 New Zealand: 09 9 128 901
Standard Rate India: +91 80 4112 5738
