Adobe LiveCycle ES Business Activity Monitoring

Update 1 (8.2)

Edition 1.0

Copyright 2008 Adobe Systems Incorporated. All rights reserved.

This file contains important information that was not available when the product documentation was written. Review this information before running this version of Adobe^(R) LiveCycle^(R) ES (8.2) Business Activity Monitoring 4.3.

Contents

System Requirements

New Features

Known Issues

General Documentation Issues

System Requirements

For information about the supported operating systems, application servers, databases, and drivers, refer to the supportmatrix.xls spreadsheet file on the distribution CD-ROM .
Back to Contents

New Features

External portlets

You can add portlets that are external to Business Activity Monitor (BAM) Dashboard to the dashboard by specifying a URL that points to an external object.
Back to Contents

Webservices event host and port are user interface settings

You can now specify a host and port for Webservice events by using the system settings in the Administration console of the Application Workbench.
Back to Contents

PostgresSQL supported

Business Activity Monitoring now supports PostgreSQL.
Back to Contents

Direct access to dashboard objects

Direct access to dashboard objects is now available through the JSP, getDashboardObject.jsp. Direct access to this JSP is accomplished using a POST of the JSP to http://localhost:port/jsp. For information about this feature, see the Installation and Configuration guide.
Back to Contents

Keystores for encrypted passwords

User passwords are encrypted using public key encryption. The private and public keys are stored in keystores specified by the Administrator using the Encryption Configuration section in the system settings of the Business Activity Monitor (BAM) Workbench Administration Console. The Administrator’s password is also encrypted and stored in a separate keystore. Existing users are transparently migrated to the keystore the first time they log into Business Activity Monitoring 8.
If you plan on migrating keystores,see "Cautions when Migration Keystores" in the Known Issues section.
Back to Contents

Associated reports and external reportlets can use arguments

A new feature has been added to associated reports, an external reportlet. You can now specify arguments and argument values in addition to parameters for URLs when creating associated reports or external reportlets.
Back to Contents

Single Sign-On

Single sign-on allows Business Activity Monitoring to access Cognos C8 objects, and Cognos C8 to access Business Activity Monitoring dashboard objects with a single username and password without having to relog into either C8 or Business Activity Monitoring. For more information about this feature, see the Installation and Configuration guide.
Back to Contents

Known Issues

Drillback limitations

• Cannot have spaces or special characters in table and column names in views that are used for drillback with view persistence.
• Column names for views must be in all caps as a best practice when using drillback; otherwise, drillback to detail might not work.
• A drillback with a filter on a dimension column of type TIMESTAMP does not work if the dimension context is stored in an Oracle^(R) database.
• If the user who creates the cube has filtered access to the fact view, the cube is not enabled for drillback.
• Drillback to detail is only supported on cubes that are build on a stateless view.

Back to Contents

Folders cannot be deleted

A folders that a user creates in the dashboard navigation tree cannot be deleted and can be seen by all other users. Folders that do not contain any objects are not displayed in the tree. A future release will allow users to delete folders.
Back to Contents

Default settings for recovery logger are disabled

The recover settings for the recovery logger are disabled by default. You must specify the recovery log directory to enable the recovery logger. For information about how to set the recovery logger, see the Installation and Configuration guide.
Back to Contents

Preexisting watchpoints are private

Watchpoints created prior to version 4.2 are private, and the public watchpoint checkbox is disabled in the Watchpoint Manager. To change the availability of the watchpoint, you must delete the watchpoint and recreate it as a public watchpoint.
Back to Contents

Must use AS clause for alias name in a JDBC query

In a SELECT statement, you cannot omit the AS clause for the alias name in a JDBC query. For example, SELECT x+y AS z will work as expected, but SELECT x+y z causes an error.
Back to Contents

The geoDatasource for Geography charts fails on Oracle

When configuring the geoDatasource to enable Geography charts, the abbreviation map will fail to load if the geoDatasource points to an Oracle database. It is recommended that either PostgreSQL or MySQL be used for geoDatasource.
Back to Contents

Internet Explorer 6.x exits when accessing drop-down lists

This is caused by a patch to Internet Explorer 6.x. Removing the patch corrects this problem. To remove the patch, do the following:

1. Go to Control Panel > Add/Remove Software.
2. Select Show Updates.
3. Remove the Security Update for Windows XP (KB918899) update.

Note: Internet Explorer 7.0 functions properly with all of its patches.
Back to Contents

Cautions when migrating keystores

Keystore information used to validate a user's password is stored in Business Activity Monitoring metadata with each user. The path to the keystore is one of these properties. If it is necessary to change the keystore, it is essential to create a NEW keystore file with a new name. The previous keystore should remain available at the same, prior location (as saved within the metadata) to authenticate preexisting users. Once authenticated, their passwords will automatically be migrated to the new keystore. Once the passwords of all users have been migrated, you can remove the old keystore.

Because the path to the keystore is stored in metadata, it may not be possible to migrate passwords from a Microsoft^(R) Windows^(R) server to a Linux^(R) server. Windows paths resemble "c:\keystore\keystore.jks", which cannot be used as a path and filename on a Linux or Unix^(R) server; therefore, the Linux or Unix sever will not be able to find the old keystore. Passwords can be changed by logging in as the system user and editing each user by changing their password. Linux to Windows migration may be possible by creating a similar path on Windows. For example, /usr/bam/user.jks would become c:\usr\bam\user.jks.
Back to Contents

Certain events must be enabled in a specific order

After importing metadata, events must be disabled then enabled to get previously published workflow data. The events you must disable and enable are as follows:

1. Disable ActivityInstanceStartedEvent and ActivityInstanceCompletedEvent along with their dependencies.
2. Enable ActivityInstanceStartedEvent and ActivityInstanceCompletedEvent along with their dependencies.
3. Disable ProcessInstanceStartedEvent and ProcessInstanceCompletedEvent along with their dependencies.
4. Enable ProcessInstanceStartedEvent and ProcessInstanceCompletedEvent along with their dependencies.
5. Disable, and then enable all remaining events, except for AdobeEvent.

Back to Contents

General Documentation Issues

XML flattening

The description in the Business Activity Monitoring Server Reference of how XML documents are handled has been improved. An explanation of how XML documents are flattened into tables has been added.
Back to Contents

Query windows

The documentation for query windows has been corrected and updated.
Back to Contents

LDAP Referral system setting is undocumented

A drop-down menu for LDAP Referral has been added to LDAP Synchronization configuration under the System Settings of the Workbench Administration Console. This drop-down menu lets you indicate to service providers how to handle referrals. Set the referral to one of the following:

• Follow — Referrals are followed.
• Ignore — Referral entries are ignored and returned as plain entries. This is the default.
• Throw — Each referral encountered results in an exception.

Back to Contents

Multiple Role Base DNs for LDAP Role Mapping is undocumented

The LDAP Role Mapping configuration window under the System Settings of the Workbench Administration Console now allows you to enter more than one Role Base DN for LDAP Synchronization.

Caution: Do not enter a blank line between rows.
Back to Contents

Multiple User Base DNs LDAP User Mapping is undocumented

The LDAP User Mapping configuration window under the System Settings of the Workbench Administration Console now allows you to enter more than one User Base DN for LDAP Synchronization.

Caution: Do not enter a blank line between rows.
Back to Contents

Release Notes -- Adobe LiveCycle ES (8.2) Business Activity Monitoring 4.3 -- 07/03/2008 3:38 PM