Go to primary content
Oracle Agile Engineering Data Management Enterprise Integration Platform Installation and Upgrade Guide
Release e6.2.1.0
E69182-03
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

1 Installation Requirements

1.1 Platform Support Matrix

In general, the Integration Platform runs on any platform which provides a Java Runtime Environment 8. Nevertheless, there are some restrictions based on certain connectors which are listed below:

The Agile EDM Connector supports all platforms supported by Agile e6.2.1.0.

The Administration Client is part of the Integration Platform. Since it is a Java application and only needs a Java Runtime Environment, no platform restrictions apply. The Administration Client does also allow remote administration of the Integration Platform. In that case, you need to have a network connection between the workstation where you run the Administration Client and the Integration Platform Server.

1.2 Enterprise Integration Platform

Since the Enterprise Integration Platform is a Java application, a Java Runtime Environment is required. This is not part of the installation package and therefore needs to be installed beforehand.


Note:

As the Enterprise Integration Platform includes a Web Server that is able to handle JSPs, a Java Compiler must be installed. Either you install a Java Development Environment (JDK) where this is included, or you install a Java Runtime Environment and copy the file tools.jar from the JDK's lib directory to the JRE's lib directory.


Note:

Enterprise Integration Platform supports 64-bit mode.

Please remember to install the Java Runtime Environment on all platforms where you want to run the Enterprise Integration Platform or parts of it. If you installed it on a UNIX system for example, and you want to use the GUI tools on a Windows system from this installation location via a shared network drive, you have to install a Java Runtime Environment on your Windows machine as well.

This version of the Integration Platform runs on Java 8 64-bit (latest patch level recommended). You may download this from the website of the respective operating system provider:

AIX: http://www.ibm.com/developerworks/java/jdk/aix/service.html
Windows, Solaris, Oracle Linux/Intel: http://www.oracle.com/technetwork/java/javase/overview/index.html
HP-UX: http://www.hp.com/go/java


Note:

After the installation of the Java Runtime Environment for 64-bit, please set the environment variable JAVA_HOME to point to its installation directory.

1.2.1 Third-Party Libraries

As certain third-party libraries are not shipped with the Enterprise Integration Platform anymore, please download from the following location:

Library Purpose Download Location Installation Instructions
rhino-1.7.7.2.jar JavaScript support for XSL transformations www.mozilla.org/rhino/ Browse to Downloads and then to the Rhino downloads archive. The preferred version to download is 1.7.7.2.

Copy the file rhino-1.7.7.2.jar from the ZIP file to the libs directory.


Customers who want to use Web Service Connector (ws) as well as synchronous Web Service connector (ws-sync) have to copy the WebLogic library.

com.oracle.webservices.wls.jaxws-wlswss-client.jar

from the WebLogic location:

ORACLE_HOME/wlserver/modules/clients/

We recommend to create a separate directory in <eai.home>/libs such as <eai.home>/libs/jaxws-wlswss-client and copy the WebLogic lib to this new directory. Following Java classpath has to be adapted in run.conf file. We recommend to place new lib path at the end of EAI_HOME classpath, e.g.

wrapper.java.classpath.9=%EAI_HOME%/libs/jaxws-wlswss-client/*.jar

The remaining class path elements must be renumbered accordingly.

For further information about this library, please refer: https://docs.oracle.com/middleware/12212/wls/WSGET/jax-ws-client.htm#WSGET3648

1.2.2 Agile EDM

The minimum Agile EDM version to be used together with the Integration Platform is Agile EDM e6.2.1.0.

1.3 Hardware Requirements

The following hardware requirements need to be met.

1.3.1 Minimum Network Connectivity and Bandwidth


Note:

100 MB/s LAN connections based on TCP/IP between the Integration Platform, Agile EDM Server and ERP Server.


Note:

At a minimum, a TCP/IP loopback device is required

1.3.2 Minimum Memory Requirements

The following recommendations are incremental to the amount of RAM required for other applications and the operating system.

  • Minimum of 128 MB for the Integration Platform.

  • Minimum of 30 MB for the Administration Client

1.3.3 Minimum Disk Space

The basic server installation requires 120 MB which also includes administration client installation.

Depending on the location of the queue database, temp directory for DEBUG files and checked-out physical files and log directory, more space may be required during runtime.

1.4 Software Requirements

Ensure that the following software requirements are configured and running properly.

1.4.1 Java Runtime Environment

This version of the Integration Platform runs on Java 8 for 64-bit (latest patch level recommended). You may download this from the website of the respective operating system provider:

Please check if the JAVA_HOME environment variable is set correctly. You must get the version of the current installation of the Java Runtime Environment, when calling on the Integration Platform Server the program:

java -version

1.4.2 Agile EDM Server and Java Daemon

The minimum Agile EDM version to be used together with the Integration Platform is Agile e6.2.1.0. Older versions of Eigner or Agile EDM products are not supported.

Since the Agile EDM Connector is using the Java-ECI for connecting to Agile EDM, ensure that the Agile EDM Java Daemon is configured and running properly.

1.4.3 Installation

The distribution is provided as a zipped tar file because the UNIX execution file rights are not preserved by WinZIP.

We recommend using WinZIP on Windows Platforms for expanding the delivered file.

On UNIX platforms you need the respective tar and unzip tools (recommended gtar and unzip).

1.4.4 Configuration

The configuration of the Integration Platform is done in XML files and XML stylesheet files. Although you can use any text editor to modify those files, we recommend using special XML/XSL Editing tools.

These tools are not part of the standard distribution of the Enterprise Integration Platform.