Integration Architect 8.14.0 on HP-UX - Readme
Release - March 2007

Contents

Welcome to Integration Architect release 8.14.0. 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

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

Installation Utility

HP-UX uses the standard swinstall installation utility to install Integration Engine. 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

Review the following checklist before installing Integration Engine:

To upgrade the libraries

  1. After you have installed the Java SDK, verify that it is in the front of the path. Substitute your Java SDK version number for <version>:

    2. export PATH=/opt/java<version>/bin:$PATH

  2. Change SHLIB_PATH to include the following:

    3. /opt/java<version>/jre/lib/PA_RISC<version>/hotspot:/opt/java<version>/jre/lib/PA_RISC<version>

To Install from a CD

  1. Log on to the HP-UX machine using your root user name and password.
  2. Mount the CD and run the HP-UX swinstall utility. Type your own CD device name in place of /dev/cddevice. As a root user, run the following command:

    3. swinstall -s /cdrom/IntegrationEngine-<version>.depot IntegrationEngine<version>

Additional Notes

If you have difficulty installing using the instructions above, see the following troubleshooting notes:

  1. 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 and type your own CD device name in place of /dev/cddevice:

    2. mount /dev/cddevice /cdrom

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

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

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

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

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

  4. Run the following as the root user:

    5. pfs_mountd & pfsd & pfs_mount /cdrom

    Note  The archive file name on the installation CD will contain the actual version value to type in place of <version>.

What to Do Next

After installing, you must apply the license file. See To Apply the License File.

To Install from a Downloaded Archive

  1. Log on to the HP-UX machine using your root user name and password.
  2. Create a temporary directory (called mytmp in the example, or any other name you wish):

    3. mkdir /mytmp

  3. Copy the archive into the mytmp directory :

    4. cp dje800-hpux-<version>-<date>.tar.gz /mytmp

    Note  The archive file name on the installation CD will contain the actual version value to type in place of <version>.

  4. Change directories to the temporary directory:

    5. cd /mytmp

  5. Uncompress and untar the archive:

    6. gunzip dje800-hpux-<version>.tar.gz

    tar xvf dje800-hpux-<version>.tar

  6. Run the HP-UX swinstall utility:

    7. swinstall -s /mytmp/IntegrationEngine-<version>.depot IntegrationEngine<version>

What to Do Next

After installing, you must install the license file. See To Apply the License File.

To Apply the License File

The following are instructions for applying a license file. If you do not have a license file, see Obtain a license file.

  1. After you have installed Integration Engine, copy your license dj800.slc file to the following location:

    2. cd /opt/PervasiveSoftware/IntegrationEngine<version>/license

  2. Change the file access permissions as follows:

    3. chmod 644 /opt/PervasiveSoftware/IntegrationEngine<version>/license/dj800.slc

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

Postinstallation Steps

To ensure that Integration Engine is set up correctly, perform the following postinstallation steps:

  1. Check for the existence of installed versions. You can determine the Integration Engine versions installed on your HP-UX box with the following command:

    2. swlist -v -l product IntegrationEngine<version>

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

    3. export PATH=$PATH:/opt/PervasiveSoftware/IntegrationEngine<version>

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

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

  4. If you need to uninstall Integration Engine, run the following command as root:

    5. swremove -v IntegrationEngine<version>

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:

chmod 755 /opt/PervasiveSoftware/IntegrationEngine8140/djengine

chmod 777 /opt/PervasiveSoftware/IntegrationEngine8140/Plug-Ins

chmod 777 /opt/PervasiveSoftware/IntegrationEngine8140/lookup

chmod 777 /opt/PervasiveSoftware/IntegrationEngine8140/eaa

chmod 777 /opt/PervasiveSoftware/IntegrationEngine8140/jars

chmod 777 /opt/PervasiveSoftware/IntegrationEngine8140/license

The Unix security feature for the integration platform is now disabled.

Known Issues and Resolutions

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

Issue: A Java Virtual Machine (JVM) is not detected on the machine.

Solution: Install JVM version 1.4.2_11 or higher or Java 5, 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: The Java version currently installed on the machine is not one of the following: 1.4.2_11 or higher or Java 5

Solution: Install JVM version 1.4.2_11 or higher or Java 5. 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 is 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 have the subscription renewed and obtain an updated licence. After implementing the new license, attempt to install again.

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:

$ djengine /opt/lib/dld.sl: Can't find path for shared library:

libCsup_v2.2 /opt/lib/dld.sl: No such file or directory Abort(coredump)

To fix this issue, install the latest C++ run-time patches.

Oracle8 Connectors

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

Oracle 8.0.x client installations and the dj800oci8.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 dj800oci8.so shared library in the Integration Engine installation directory.

By default we install the 8.1.x version of the Oracle8 connector. To enable Oracle 8.0.x support type the following command in the Integration Engine installation directory:

cp dj800oci8.8.0.5.so dj800oci8.so

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

cp dj800oci8.8.1.5.so dj800oci8.so

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 dj800odbc3.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 other vendor's ODBC drivers. The IODBC enabled shared library is named dj800odbc3.iodbc.so and the Data Direct Technologies shared library is named dj800odbc3.datad.so. To change the default supported ODBC driver manager, either copy or make a symbolic link from the versioned shared library to the dj800odbc3.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:

cp dj800odbc3.iodbc.so dj800odbc3.so

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

cp dj800odbc3.datad.so dj800odbc3.so

Useful Links

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.

© Copyright 2007 Pervasive Software Inc.

All Rights Reserved

Pervasive Software Inc.
http://www.pervasive.com
12365 Riata Trace Pkwy, Bldg B
Austin, TX 78727 USA
Voice: (512) 231-6000
Fax: (512) 231-6010
Online Pervasive Contacts

*** END OF README ***