Business objects EDATAQUALITY SUITE 7.60C RELEASE 4 User Manual

eDataQuality Suite

Release Notes

Version 7.60c September 2005
What’s new in this version? ................. 2
Your eDataQuality shipment................. 3
Installing eDataQuality for the first time 4
Upgrading to version 7.60c (all revisions)
of eDataQuality.................................. 5
Installing eDataQuality software........... 6
Updating your server configuration ....... 7
Updating your client application ........... 8
Contact information
Phone U.S. and Canada: 888-788-9004
Fax 608-788-2870 Web http://www.firstlogic.com/customer E-mail customer@firstlogic.com Mail 100 Harborview Plaza
Technical support is available weekdays 8 a.m. to 6 p.m. Central time.
Firstlogic Proprietary and Confidential
© 2005 Firstlogic, Inc. All rights reserved. This publication and accompanying software are protected by U.S. copyright law and international treaties. No part of this publication or accompanying software may be copied, transferred, or distributed to any person without the express written permission of Firstlogic, Inc.
elsewhere: +1-608-788-9000
La Crosse WI 54601

What’s new in this version?

eDataQuality 7.60c includes the following feature enhancements.
Updated engines eDataQuality 7.60c includes the following versions of updated core engines:
International ACE 7.60c
ACE 7.60c
CACE 7.60c
TrueName 2.61c
Upgraded PERL Version
The Perl client for eDataQuality 7.60c is compiled using the Perl version 5.6. This provides compatibility to the Perl object in eDataQuality with Perl 5.6 and higher.
Perl version 5.6 is not backward compatible.
If you use a PERL client, you must follow these special installation instructions.
To install PERL 1. After you install the PERL client, open a command.
2. Change the current directory to the location of your PERL installation (install_location\edqclient\perl).
3. Run perl edqinstall.pl
Updated environment variable for HP UX
After completing your PERL client installation, you must also update one of your environment variables. This step only applies to UNIX platforms.
1. Add the path to the Perl client to the appropriate environment variable as shown below. By default, this path is install_location/edqclient/perl.
If you use HP UX, you must update the shared library path environment variable, as listed below:
Platform Environment variable
HP SHLIB_PATH
LD_PRELOAD
Note:
You must assign /user/lib/libcl.2 and /user/lib/libpthread.1to
LD_PRELOAD
2
eDataQuality 7.60c Release Notes

Your eDataQuality shipment

What's in your package
Access the latest documentation
Order printed documents
Your Firstlogic shipment includes the following pieces:
eDataQuality Server installation CD
eDataQuality Client installation CD
Address directories CD(s) appropriate for your purchase
You can access Firstlogic documentation in several places:
On your computer. Release notes, manuals, and other documents for each
Firstlogic product that you’ve installed are available in the Documentation folder. Choose Start > Programs > Firstlogic Applications > Documentation.
On the Firstlogic Customer Portal. Go to www.firstlogic.com/customer,
and then click the Documentation link to access all the latest Firstlogic documentation. You can view the PDFs online, save them to your computer, or order professionally printed documents that will be delivered to you. To order printed documents, see the following instructions.
You can order professionally printed documents and have them delivered to you for a small charge. Your documents will be sent to you as soon as the next business day.
1. Go to www.firstlogic.com/customer, click the Documentation link, and then
click the Printed Technical Documentation link.
If this is your first time accessing the Mimeo site, you’ll be prompted to open an account before you can log in. Follow the instructions on screen to open an account.
2. Log in to Mimeo.
3. To access Firstlogic documents, in the Folders area on the left side of the
Mimeo web site, choose DocCenter Shared Folders > Firstlogic Inc.
DocCenter > Firstlogic’s Printable Materials > Technical Documentation.
4. Choose the documents that you want printed.
5. Follow the instructions on screen to place your order.
Your eDataQuality shipment
3

Installing eDataQuality for the first time

If you are a first-time user of eDataQuality, follow the steps below to install your eDataQuality application.
Step 1: Install your eDataQuality server software
Step 2: Install your eDataQuality client software
Step 3: Set up your eDataQuality server
Step 4: Set up your eDataQuality clients
You must install the eDataQuality server software to the appropriate server computer of your choice. Use the eDataQuality Server CD that you received with your shipment.
The specific instructions vary slightly, depending on your operating system. See “Installing eDataQuality software” on page 6 for specific instructions.
You must install the eDataQuality client software to any computers that will be used to write the eDataQuality client application. Use the eDataQuality Client CD that you received with your shipment.
The specific instructions vary slightly, depending on your operating system. See “Installing eDataQuality software” on page 6 for specific instructions.
After all of your software is installed, you can begin setting up your server. This step in itself is a multi-step process. For details on server setup, see "Setting up the eDataQuality server"in the eDataQuality Suite User’s Guide.
After all of your software is installed and your server is set up, you can set up your eDataQuality client application. This step in itself is a multi-step process. For details on client setup, see "Setting up the eDataQuality clients"in the eDataQuality Suite User’s Guide.
4
eDataQuality 7.60c Release Notes

Upgrading to version 7.60c (all revisions) of eDataQuality

If you are a current user of eDataQuality, you must take the following steps to upgrade your application to version 7.60c.
Step 1: Update the eDataQuality server software
Step 2: Update the eDataQuality client software
Use the eDataQuality Server CD that you received with your shipment to update your server software to the latest version. You need not uninstall the earlier version first. The new installer will automatically back up some of your important files, such as edqconfig.xml and your packages files.
The specific instructions vary slightly, depending on your operating system. See “Installing eDataQuality software” on page 6 for specific instructions.
You must install the eDataQuality client software on any computers that will be used to write the eDataQuality client application. Use the eDataQuality Client CD that you received with your shipment.
The specific instructions vary slightly, depending on your operating system. See “Installing eDataQuality software” on page 6 for specific instructions.
Upgrading to version 7.60c (all revisions) of eDataQuality
5

Installing eDataQuality software

Follow the appropriate instructions below for your operating system.
Installing eDataQuality on UNIX
The eDataQuality installation on UNIX uses a step-by-step command-prompt installer.
1. Insert the appropriate eDataQuality CD into the CD-ROM drive (either the Client or Server CD, as necessary).
2. Mount the CD-ROM drive.
3. At the UNIX command line, change directories to your CD-ROM drive.
4. Enter the command install_console.
5. Follow the on-screen instructions to complete the installation.
Installing eDataQuality on Windows
®
The eDataQuality installation on Windows uses a familiar installation wizard.
1. Insert the appropriate eDataQuality CD into the CD-ROM drive (either the Client or Server CD, as necessary).
2. The installation program should start automatically. If it doesn’t, choose Start > Run from the task bar. At the Run prompt, type x:\setup (where x is the CD-ROM drive) and then click OK.
3. Follow the on-screen installation instructions to complete the installation.
Environment variables If you use the JNI-Java, Pure Java, or Perl clients, some of your environment
variables require updates to work properly. On Windows, the installer attempts to automatically update the necessary paths at the beginning of the variable.
Copying the address directories
If you use UNIX, you must manually set these variables. See "Additional client setup steps"in the "Setting up the eDataQuality clients"section of your eDataQuality User’s Guide for details on setting up these variables.
After installing your software, be sure to copy the proper address directories to your system. For details, see "Installing the directories"in the "Setting up the eDataQuality server"section of your eDataQuality User’s Guide for details.
6
eDataQuality 7.60c Release Notes

Updating your server configuration

You must update your server configuration when upgrading to version 7.60c.
Automatically updating your configuration
Manually updating your configuration
If you use the eDataQuality configuration tool, you can automatically update your existing configuration. For details on the eDataQuality configuration tool, see "eDataQuality configuration tool"in the "Setting up the eDataQuality server"section your eDataQuality Suite User’s Guide. That section of the user’s guide includes details about how to set up your configuration tool, including how to set up environment variables.
To automatically update your server configuration:
1. Open the eDataQuality configuration tool.
2. In the configuration tool, open your existing server configuration file.
When you install 7.60c, your existing configuration edqconfig.xml file is backed up and moved to install_location/edqsrv/bin/back_ups.
When you open your existing file, the configuration tool will automatically make the necessary changes to upgrade your configuration.
3. Save the updated configuration file to install_location/edqsrv/bin.
If you choose not to use the eDataQuality configuration tool, you can instead manually update your configuration. To do this, you can either simply reconfigure the newly installed edqconfig.xml, or follow these steps:
1. Open your existing edqconfig.xml from install_location/edqsrv/bin/
back_ups in a text-editing application or XML-editing application.
2. Change the values, as necessary.
3. Save the updated configuration file to install_location/edqsrv/bin.
Updating your server configuration
7

Updating your client application

Additional setup for C++ clients
If you use a C++ client, be sure to include the appropriate compiler defines in your makefiles (all C++ clients are shared objects). These instructions have changed slightly from earlier versions of eDataQuality. Specific instructions vary by platform, and are listed below:
For Windows 1. Add the fledataobj.lib to the project
2. Configure the project settings for:
CODE GENERATION: multi threaded DLL
PREPROCESSOR > Additional include directories:
edqclient\cpp\include
PREPROCESSOR > Preprocessor definitions:
FL_WIN32
GENERAL - Object/library modules: wsock32.lib
For UNIX Sample makefiles are included in the installation for review. These samples are
included in install_location/client/samples/cpp. Be sure that the appropriate compiler defines are included in your makefiles. The following table shows the required defines per platform:
Platform Required compiler defines
AIX PS_UNIX_AIX433
PS_UNIX_AIX6000
Solaris PS_UNIX_SOL
HP PS_UNIX_HP
PS_UNIX_HP9000
Linux PS_UNIX_LINUX
Recompile your client After installing the updated 7.60c client software, be sure to recompile your client
application so that it makes use of the updated libraries.
8
eDataQuality 7.60c Release Notes
Loading...