Data Integrator 9.0.2 on HP-UX - Readme - General Release

Welcome to Integration Architect release 9.0.2. This document contains the most up-to-date information for running this product on HP-UX systems and may supersede that in the product documentation. It covers the following topics:

System Requirements

Installation Utility

Preinstallation Checklist

To Install from a CD

To Install from a Downloaded Archive

To Apply the License File

Postinstallation Steps

Reverting to Previous Unix Permissions

Known Issues and Resolutions

Important Notes

Useful Links

Technical Support

System Requirements

The following hardware and software is needed for a minimum and preferred installation:

1 GB of free memory (RAM)

At least 200 MB of available free hard disk space, depending upon the installation options selected.

HP-UX/PA-RISC version 11i or 11i v2

Note The above are recommended system requirements for satisfactory operation. For maximum performance, make sure that physical memory meets the requirements of the local system and all applications.

Installation Utility

The installation creates a Groupid called pvsw, under which djengine runs. The pvsw Groupid permissions are 644. Transformations and resulting files run by a user are owned by the user who created them.

Preinstallation Checklist

Install Java Development Kit. For supported versions, see the general release notes.

To verify your JDK version, use the following command:

java -version

See the following web site to download the Java SDK:

http://www.hp.com/products1/unix/java/

Make sure the Standard C++ run time libraries for -AA support (.depot) are installed. For information, see www.hp.com.

Have a root user ID and password.

Uninstall any previous version of the Integration Engine by running the following command as root:

swremove IntegrationEngineversion

Note When running the swremove command, leave off the final digit of the version number.

Obtain a license file

The license file to use for your solution is provided by your Pervasive sales representative. This license .slc file determines which integration products can be used. If you need to update features for your existing installation, contact your sales representative.

Upgrade the libjvm and libfontmanager libraries. If you do not upgrade the SDK and libraries, an error is returned when you attempt to run Integration Engine.

To upgrade the libraries

After you have installed the Java SDK, verify that it is at the beginning of the path:

export PATH=/opt/javaversion/bin:$PATH

For version, use your Java SDK version number.

Change SHLIB_PATH to include the following:

/opt/javaversion/jre/lib/PA_RISCversion/hotspot:/opt/javaversion/jre/lib/PA_RISCversion

To Install from a CD

Log on to the machine as a root user.

Mount the CD.

Create a temporary directory. This example uses mytmp.

mkdir /mytmp

Copy the archive to the directory.

cp dje900-hpux-version.tar.gz /mytmp

Change to the directory.

cd /mytmp

Uncompress the archive.

gunzip dje900-hpux-version.tar.gz

Untar the archive.

tar xvf dje900-hpux-version.tar

Run the installation:

dje900-hpux-version.sh

Read the license agreement and type Yes to accept. The software installs.

Installation Tips

If you have difficulty installing using the above steps, try the following options. In all examples, for /dev/cddevice, use your CD device name.

HP-UX does not support the Rock Ridge CD format used to make the installation CD. To view files in lower case with long file names, mount the CD with the following command:

mount /dev/cddevice /cdrom

If you have problems viewing the CD contents, mount the CD with the following arguments:

mount -F cdfs -o ro /dev/cddevice /cdrom

If the CD still does not have the proper file names, try to install the Portable File System (PFS) file set available from HP. Once the PFS package daemon is installed, do the following as root user:

Edit /etc/pfs_fstab and add the following entry if it does not already exist:

/dev/cddevice /cdrom pfs-rrip xlat=unix 0 0

Run the following as the root user:

pfs_mountd & pfsd & pfs_mount /cdrom

What to Do Next

To Install from a Downloaded Archive

Log on to the machine as a root user.

Create a temporary directory. This example uses mytmp.

mkdir /mytmp

Copy the archive to the directory:

cp dje900-hpux-version.tar.gz /mytmp

Change to the directory:

cd /mytmp

Uncompress the archive:

gunzip dje900-hpux-version.tar.gz

Untar the archive:

tar xvf dje900-hpux-version.tar

Run the installation:

dje900-hpux-version.sh

Read the license agreement and type Yes to accept. The software installs.

What to Do Next

To Apply the License File

Use these steps to apply the default license file. If you do not have one, see “Obtain a license file.”

After you have installed Integration Engine, copy the file cosmos.slc to the following location:

/opt/PervasiveSoftware/IntegrationEngineversion/license

Change the file access permissions as follows:

chmod 644 /opt/PervasiveSoftware/IntegrationEngineversion/license/cosmos.slc

Next, you may want to verify the installation. See “Postinstallation Steps.”

Note For information on how to use License Manager to access future license files, see “Managing License Files on Unix” in the Getting Started Guide.

Postinstallation Steps

To ensure that Integration Engine is set up correctly, follow these steps after installation:

Set the environment variables for all Integration Engine users as follows:

export PATH=$PATH:/opt/PervasiveSoftware/IntegrationEngineversion

Insure that all Integration Engine users are sourcing the /etc/SHLIB_PATH file in their environments:

export SHLIB_PATH="$(cat /etc/SHLIB_PATH):$SHLIB_PATH"

Check for installed versions. You can determine the Integration Engine versions installed on your machine with the following command:

swlist -v -l product IntegrationEngine

Reverting to Previous Unix Permissions

If the security settings applied during installation are not appropriate for your environment, you can revert to your previous permissions by executing the following commands as root:

Known Issues and Resolutions

This section lists known issues for HP-UX as of the release date. If you encounter an issue not found here, contact Pervasive Support.

Solution: Install Java, and then perform the integration platform installation again. For more information, see the topic “Installing Java Before the Integration Platform” in the Getting Started Guide.

Issue: You do not have administrative privileges for the machine. A root user ID and password are required to install the product.

Solution: Contact your support organization and request that your privileges be modified to Administrative for the affected machine.

Issue: While performing a maintenance installation, your subscription is determined to be expired.

Solution: Contact your support organization to obtain an updated license. After implementing the new license, attempt to install again. For information on how to use License Manager to access your new license file, see “Managing License Files on Unix” in the Getting Started Guide.

Issue: You have trouble running Integration Engine and encounter a loading of shared libraries error.

Solution: Put the Integration Engine installation directory at the beginning of your PATH environment variable. In rare cases, customers have reported problems with an existing incompatible version of one of the third-party components that we use, such as ACE, ICU, or Xerces C. Place Integration Engine at the front of the search paths to insure the component version in the Integration Engine install directory is loaded first at run time.

Important Notes

C++ Run Time Patches

If you receive one of the following errors when running Integration Engine, you may not have the latest patches installed:

Oracle8 Connectors

We have included two versions of the Oracle 8 connector to support two versions of Oracle8. The djoci8.8.0.5.so connector will work with all

Oracle 8.0.x client installations and the djoci8.8.1.5.so connector will work with all Oracle 8.1.x client installations. The user will have to either copy or make a symbolic link from the versioned shared library to the djoci8.so shared library in the Integration Engine installation directory.

To enable Oracle 8.0.x support type the following command in the Integration Engine installation directory:

To enable Oracle 8.1.x support, type the following command in the Integration Engine installation directory:

ODBC Drivers

We include support for both the Data Direct Technologies ODBC driver manager and the IODBC driver manager.

By default the ODBC 3.x connector named djodbc3.so is built for the Data Direct Technologies ODBC driver manager. The IODBC version of the ODBC 3.x connector can be used in situations where the default ODBC 3.x connector does not work with ODBC drivers from other vendors. The IODBC enabled shared library is named djodbc3.iodbc.so and the Data Direct Technologies shared library is named djodbc3.datad.so.

To change the default supported ODBC driver manager, either copy or make a symbolic link from the versioned shared library to the djodbc3.so shared library in the Integration Engine installation directory. To enable IODBC driver manager support, type the following command in the Integration Engine installation directory:

To reenable Data Direct driver manager support, type the following command in the Integration Engine installation directory:

Useful Links

View a comprehensive list of Pervasive products.

Search the product knowledge base.

Search and participate in forums on application development.

Download technical papers.

Download product updates.

Read and search documentation online.

Read about support programs.

Technical Support

If you encounter problems not covered in this document, see the file contact.htm with the product documentation under /help/pdf.

Disclaimer

PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUMENTATION PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN "AS IS" BASIS AND SOLELY IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING LICENSE AGREEMENT.

PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE SOFTWARE OR THE CONTENT OF THE DOCUMENTATION; PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE SOFTWARE INC. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMPLE, WITH RESPECT TO MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE OR ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG OTHERS.

Data Integrator 9.0.2 on HP-UX - Readme
General Release - April 2008

Contents

System Requirements

Installation Utility

Preinstallation Checklist

To upgrade the libraries

To Install from a CD

Installation Tips

What to Do Next

To Install from a Downloaded Archive

What to Do Next

To Apply the License File

Postinstallation Steps

Reverting to Previous Unix Permissions

Known Issues and Resolutions

Important Notes

C++ Run Time Patches

Oracle8 Connectors

ODBC Drivers

Useful Links

Technical Support

Disclaimer

Data Integrator 9.0.2 on HP-UX - Readme General Release - April 2008

Contents

System Requirements

Installation Utility

Preinstallation Checklist

To upgrade the libraries

To Install from a CD

Installation Tips

What to Do Next

To Install from a Downloaded Archive

What to Do Next

To Apply the License File

Postinstallation Steps

Reverting to Previous Unix Permissions

Known Issues and Resolutions

Important Notes

C++ Run Time Patches

Oracle8 Connectors

ODBC Drivers

Useful Links

Technical Support

Disclaimer

Data Integrator 9.0.2 on HP-UX - Readme
General Release - April 2008