Welcome to Data Integrator 9.0.3. This document contains the most up-to-date information for running this product on AIX systems and may supersede that in the product documentation. It covers the following topics:
The following hardware and software is needed for a minimum and preferred installation:
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.
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.
Review the following checklist before installing Integration Engine:
java -version
See the following web site to download the JDK:
http://www-128.ibm.com/developerworks/java/jdk/aix/service.html
installp -u IntegrationEngineversion
Note When running the installp command, leave off the final digit of the version number.
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.
slibclean command unloads object files that have load and use counts of 0, those that are no longer used in the shared library region, and those that are no longer required in the shared library and kernel text regions. Before and after you install Integration Engine on AIX, run /usr/sbin/slibclean as root.
mount -r -v cdrfs /dev/cddevice /cdrom
For /dev/cddevice, use your CD device name.
mkdir /mytmp
cp dje900-aix-version.tar.gz /mytmp
For version, use the values from the .tar.gz file name.
cd /mytmp
gunzip dje900-aix-version.tar.gz
tar xvf dje900-aix-version.tar
dje900-aix-version.sh
After installing, apply the license. See “To Apply the License File.”
mkdir /mytmp
cp dje900-aix-version.tar.gz /mytmp
For version, use the values from the .tar.gz file name.
cd /mytmp
gunzip dje900-aix-version.tar.gz
tar xvf dje900-aix-version.tar
dje900-aix-version.sh
After installing, apply the license. See “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”.
/usr/PervasiveSoftware/IntegrationEngineversion/license
chmod 644 /usr/PervasiveSoftware/IntegrationEngineversion/license/cosmos.slc
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.
To ensure that Integration Engine is set up correctly, follow these steps after installation:
export PATH=$PATH:/usr/PervasiveSoftware/IntegrationEngineversion
djengine -V
slibclean command unloads object files that have load and use counts of 0, those that are no longer used in the shared library region, and those that are no longer required in the shared library and kernel text regions. Before and after you install Integration Engine on AIX, run /usr/sbin/slibclean as root.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 /usr/PervasiveSoftware/IntegrationEngineversion/djengine
chmod 777 /usr/PervasiveSoftware/IntegrationEngineversion/Plug-Ins
chmod 777 /usr/PervasiveSoftware/IntegrationEngineversion/lookup
chmod 777 /usr/PervasiveSoftware/IntegrationEngineversion/eaa
chmod 777 /usr/PervasiveSoftware/IntegrationEngineversion/jars
chmod 777 /usr/PervasiveSoftware/IntegrationEngineversion/license
The Unix security feature for the integration platform is now disabled.
This section lists known issues for AIX 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 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.
If you are using a multithreaded license of Integration Engine on a multiprocessor machine, to acheive better performance, export the following environment variables from the shell before starting Integration Engine. Run with the malloc multiheap support enabled and one kernel thread to one runnable pthread.
export MALLOCMULTIHEAP=1
export AIXTHREAD_SCOPE=S
export AIXTHREAD_MNRATIO=1:1
The default stack size used by threads on AIX is 96 KB. To avoid potential system errors when running the multithreaded Integration Engine, export the following environment variable. In this example, the thread stack size is set to 768 KB. You can increase the size further if needed.
export AIXTHREAD_STK=786432
Two versions of the Oracle8 connector are included with Integration Engine to support two versions of Oracle8. The djoci8.8.0.5.so connector works with all Oracle 8.0.x client installations. The djoci8.8.1.5.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, do one of the following commands in the Integration Engine installation directory:
cp djoci8.8.0.5.so djoci8.so
ln -s djoci8.8.0.5.so djoci8.so
To enable Oracle 8.1.x support, type one of the following commands in the Integration Engine installation directory:
cp djoci8.8.1.5.so djoci8.so
ln -s djoci8.8.1.5.so djoci8.so
Support for both the Data Direct Technologies ODBC driver manager and the IODBC driver manager is included in the installation.
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. 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 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, type one of the following commands in the Integration Engine installation directory:
cp djodbc3.datad.so djodbc3.so
ln -s djodbc3.datad.so djodbc3.so
The following information only applies if you are using HTTPS or the Salesforce.com connector. The OpenSSL library that ships with Integration Engine seeds a random number generator by using /dev/urandom or /dev/random. If you receive an error similar to the one below when running Integration Engine, you must install an OS patch for /dev/urandom, since many versions of Unix do not install this by default. For more information, contact your vendor.
"Version: HTTPS establish connection: error:random number generator:
SSLEAY_RAND_BYTES:PRNG not seeded"
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 2008 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 ***