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

Previous
Previous
 
Next
Next
 

3 Basic Installation

The software is provided as a distribution package, which includes all files and directories needed for successfully running the application.

3.1 Installation Steps

  1. Copy the installation package onto the dedicated server, which should be used for running the Integration Platform. The used server needs to be able to connect to the Agile EDM Java Daemon via ECI and to ERP system via RFC.

  2. Uncompress the package into the install directory of the Integration Platform, e.g. into the directory c:\agile\eip on MS-Windows (this will be referred to as <eai.home> in the rest of the document).

Following directory structure will be created under <eai.home>:

  • archive: Directory for archived queue entries

  • bin: Contains the startup scripts for the applications

  • conf: Contains the configuration and mapping files

  • data: Contains the XDOs (data packages) when persistence is activated

  • db_util: Contains database utilities

  • docs: Contains the documentation/manuals

  • install: Contains all additional installation files, which are required for external applications, e.g. Agile EDM

  • libs: Contains all library files (except JRE files)

  • log: Contains all log/trace files, depending on setting in configuration file

  • tmp: Contains all temporary files, which are neither log files nor XDO data files

3.2 Installing Oracle Database Client

If not done yet, you need to install an Oracle Database Client.

Refer to the Agile EDM Server Installation Guide on Windows and UNIX in the chapter ”Installing Oracle Database Client” for installation instructions.


Note:

To run EIP, the Environment Variable ORACLE_HOME must be set to the root directory of the Oracle Client installation (see Software location path in GUI Installation)

3.3 Database Creation

Before using the Enterprise Integration Platform, the needed database tables must be created.


Note:

Although it might be possible to create the EIP's database objects with the same user as other applications (e.g. Agile EDM), we strongly recommend using a separate user (a schema in Oracle). Please read carefully the chapter Tools in the "EIP Administration Guide for Agile e6.2.0.0" for further information.


Note:

It is recommended to create the new database user with own database files (tablespace in Oracle). The advantages of separate database files are independent from other tables and users (e.g. from Agile EDM), and easier to backup and replicate. Because the tables are constantly growing in size, and if they are not cleaned up on a regular basis, the initial size of the database file should be considered big enough. The definitions for Agile e6 may be used as a guideline for specifying the initial database size and extends. Since this is only a recommendation, you may feel free to use the same database files as an existing Agile e6 installation or even the same database user, especially if you do not expect too much data load.

In order to create the database tables, please call the SQL script cre_eip_db.sql in the directory db_util. The script can be used to create and drop the EIP database. It removes EIP tables, indexes and stored procedures, and creates them again. This script has to be executed in the database as configured in file eai_ini.xml.

Example to execute the script with the SQL Plus tool:

@cre_eip_db.sql edb edb_idx edb_lob

The default parameter are:

  • edb: data tablespace

  • edb_idx: index tablespace

  • edb_lob: lob tablespace

Three Oracle PL/SQL procedures needed by EIP will also be installed during execution of the script:.

  • EIP_CLEANUP_ALL

  • EIP_CLEANUP_BPM_QUEUE

  • EIP_CLEANUP_EIP_QUEUE

The log file cre_eip_db.log will be created.

3.4 EIP Wallet

EIP wallet will be generated by cryptographer tool or encrypt tool.

The directory 'wallet' needs to be created manually in the directory <eai.home>, and will contain the EIP wallet. If the directory is not available, an error message will be displayed.


Note:

Please make sure that only EIP users have access to the directory wallet.

By first run of cryptographer tool or encrypt tool the wallet will be generated in directory <eai.home>/wallet/private/eip.

The cryptographer tools check the wallet at every run, and generate a new wallet if it does not exist in directory <eai.home>/wallet/private/eip.