Welcome to Data Integrator release 9.2.3. This document contains the most up-to-date information for running this product on Solaris systems and may supersede that in other documentation. It covers the following topics:
This document may be updated after the product release. Download the latest version from Product Updates on the Pervasive web site.
For a list of minimum system requirements for Solaris, see Minimum System Requirements on Unix in the Getting Started Guide.
For a list of Unix systems, versions, and platforms that are supported in version 9.2.3 of Integration Engine, see Environments Supported in the Getting Started Guide.
To begin your installation on Solaris, see Checklist Before Installing on Solaris.
The following items address frequently asked questions about installation:
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 your machine.
Issue: While performing a maintenance installation, your subscription is found 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 encounter a loading of shared libraries error after attempting to run Integration Engine.
Solution: Put the Integration Engine installation directory at the beginning of your path environment variable. In rare cases, customers have reported problems with having an existing incompatible version of one of the third-party components that are used, such as ACE, ICU, or Xerces C. Place Integration Engine at the beginning of search paths to insure the component version in the Integration Engine install directory is loaded first at run time.
Different 9.x versions of Integration Engine can be installed on the same machine. After you install the engines side-by-side, you must indicate which engine to run. To do this, use the following procedure to load the libraries of the desired engine first in the system shared library search path.
You can use the same license file for both installations.
Note Different connectivity options are available, depending on whether you are running a 32-bit or 64-bit version of the engine. See Connectivity Reference for details.
Two versions of the Oracle8 connector are included to support two versions of Oracle8. The djoci188.8.131.52.so connector works with all Oracle 8.0.x client installations; the djoci184.108.40.206.so connector works with all Oracle 8.1.x client installations. You must either copy or make a symbolic link from the versioned shared library to the djoci8.so shared library in the Integration Engine installation directory.
By default, the 8.1.x version of the Oracle8 connector is installed. To enable Oracle 8.0.x support, run one of the following commands in the Integration Engine installation directory:
cp djoci220.127.116.11.so djoci8.so
ln -s djoci18.104.22.168.so djoci8.so
To enable Oracle 8.1.x support, run one of the following commands in the Integration Engine installation directory:
cp djoci22.214.171.124.so djoci8.so
ln -s djoci126.96.36.199.so djoci8.so
The installation 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, you must 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, run one of the following commands in the Integration Engine installation directory:
cp djodbc3.iodbc.so djodbc3.so
ln -s djodbc3.iodbc.so djodbc3.so
To reenable Data Direct driver manager support, run one of the following commands in the Integration Engine installation directory:
cp djodbc3.datad.so djodbc3.so
ln -s djodbc3.datad.so djodbc3.so
In some rare cases, if you are using a multithreaded license of Integration Engine on a multiprocessor machine and receive a random TOC error followed by a core dump, try using an alternate Solaris threads library by running the following command:
/usr/bin/crle -u -l /opt/PervasiveSoftware/IntegrationServerSDKversion
Sample error messages:
### Cannot allocate space for TOC object entry for container "ActionParameter1"
### ID seed value missing in TOC object 1 in container "Structure2"
### Total container size value missing in TOC object 1 in container "AppField14"
For more information, see the Solaris "libthread" man page.
Integration Engine does not currently support Solaris 10 containers.
This section lists known issues for Solaris as of the release date. If you encounter an issue not found here, contact Pervasive Support.
Issue: The Solaris JVM uses its 32-bit version by default. If your Java application tries to interface with the Pervasive 64-bit engine, errors are returned.
Solution: Set the -d64 JVM flag for your Java application. See the following example:
java -d64 -cp /opt/PervasiveSoftware/IntegrationEngine92x/djcosmos_core.jar:/opt/PervasiveSoftware/IntegrationEngine92x/djec.jar MyJavaApp
If you encounter problems not covered in this document, see the file contact.htm with the product documentation under /help/pdf.
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 2009 Pervasive Software Inc.
All Rights Reserved.
Pervasive Software Inc.
12365 Riata Trace Pkwy, Bldg B
Austin, TX 78727 USA
Voice: (512) 231-6000
Fax: (512) 231-6010
Online Pervasive Contacts
*** END OF README ***