Skip Headers
Oracle® Application Integration Architecture Agile Product Lifecycle Management for Oracle EBS: Design to Release Install Guide
Release 3.4
E54321-01
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

2 Before Installing Agile PLM for Oracle EBS: Design to Release

This chapter describes how to configure prerequisites and download the Agile Product Lifecycle Management for Oracle E-Business Suite: Design to Release pre-built integration installer.

2.1 Configuring Installation Prerequisites

Before installing the pre-built integration, you must make sure the SOA Core Extension (SCE) is configured properly.

To configure the SCE:

  1. Update the AIAInstallProperties.xml file, located in <DOMAIN_LOCATION/soa/aia/bin as described in the following table:

    Table 2-1 AIAInstallProperties.xml file

    Field Value

    sharedlocation

    Used in clustering environment. No need to update CLUSTER_SHARED_LOCATION to your shared folder location. Installer will complete field.

    isencrypted

    Keep "false" value here. After post-install configuration, it will be updated to true.

    version

    SOA version

    adminhostname

    Hostname of Admin Server

    adminport

    Port of Admin Server

    domainname

    Domain Name of the SOA domain

    username

    User Name to log in to WebLogic Console and Enterprise Manager

    password

    Password for the user name. Keep "ADMIN_PASSWORD" value here. Post-install configuration script will ask for the password and write the encrypted password here.

    servertype

    In a clustered environment, enter Cluster. Otherwise enter Server.

    soaserver

    In a clustered environment, enter Cluster Name. Otherwise, enter Managed Server name.

    soaserverhostname

    In a clustered environment, enter HTTP Proxy Host Name. Otherwise, enter Managed Server Host name.

    soaserverport

    In a clustered environment, enter HTTP Proxy Port. Otherwise, enter Managed Server port.

    jndiurl

    The URL should be in the format: t3://<managed server hostname>:<managed server port>. In a clustered environment, add all managed servers delimited with ","; for example, t3://<managed server 1 hostname>:<managed server1 port>,<manabed server2 hostname>:<managed server2 port>


    Example 2-1 An example of a clustered environment

    <?xml version="1.0" encoding="UTF-8"?>
    <properties>
        <aiaDomain>
            <sharedlocation>CLUSTER_SHARED_LOCATION</sharedlocation>
            <isencrypted>false</isencrypted>
        </aiaDomain>
        <fp>
            <version>12.1.3.0.0</version>
            <server>
                <adminhostname>slc07rmp.us.oracle.com</adminhostname>
                <adminport>7037</adminport>
                <domainname>soa_domain</domainname>
                <username>weblogic</username>
                                                    <password>ADMIN_PASSWORD</password> <!--Do not edit this property.-->
                <servertype>Cluster</servertype>
                <soaserver>soa_cluster</soaserver>
                <soaserverhostname>slc07rmp.us.oracle.com</soaserverhostname>
                <soaserverport>7777</soaserverport>
                <jndiurl>t3://slc07rmp.us.oracle.com:8037,slc07rmq.us.oracle.com:8037</jndiurl>
            </server>
        </fp>
    </properties>        
    

    Note:

    shared Location is a remote network position/container that can be set for NFS, Drive Mapping or another technology. Shared Location is needed for PIP 3.4 clustering and should be configured before installation to assure successful installation and deployment. In each SOA machine, the path to the shared location must be the same, and also must be Readable and Writeable.

  2. Run the following commands:

    On Linux:

    • source <DOMAIN_LOCATION>/soa/aia/bin/aiaenv.sh

    • ant -f $SOA_HOME/aiafp/Install/config/FPPostInstall.xml

    On Windows:

    • <DOMAIN_LOCATION>\soa\aia\bin\aiaenv.bat

    • ant -f %SOA_HOME%\aiafp\Install\config\FPPostInstall.xml

2.2 Downloading and Starting the Agile PLM for Oracle E-Business Suite: Design to Release Installer

To install the Agile Product Lifecycle Management for Oracle E-Business Suite: Design to Release pre-built integration:

  1. Navigate to the Oracle Software Deliver Cloud. [https://edelivery.oracle.com]

  2. Select the Product Pack: Oracle Application Integration Architecture

  3. Select your platform.

  4. Click Go.

  5. Click the Oracle Agile PLM for Oracle E-Business Suite: Design to Release Pre-built Integrations Release 3.4 Media Pack link for your platform.

  6. Download the Oracle Agile PLM for Oracle E-Business Suite: Design to Release Pre-built Integrations Release 3.4 file.

  7. Unzip the downloaded file.

  8. Navigate to the Agile2EbizPIP3.4 directory.

  9. Run the following installation file for your platform:

    • Linux: setup_lin.bin

    • Windows: setup_win.exe

    The Agile PLM PIP Installer launches the Welcome screen.

  10. Click Next.

  11. Enter the Name and Path where the SOA Core Extension (SCE) is installed.


  12. Note:

    If the AIA Home Path is not correct, the installation will not proceed.

  13. Click Next.

  14. Complete the remaining screens as described in the following sections:

  15. If the information displayed on the Pre-Installation Summary page is correct, click Install.

2.3 Agile PLM PIP Installer Screens

The following sections describe the fields on the Agile PLM PIP installer screens.

2.3.1 SOA Admin Server Details Screen

Use this screen to enter details about your SOA Admin Server. This screen contains the fields listed in Table 2-2.

Table 2-2 SOA Admin Server Details Screen Fields

Field Description

Admin Hostname

The value is the name/domain of the WebLogic admin server. To find this value contact your WebLogic administrator.

The Admin Hostname is _________________________________.

Admin Port

This value is the port number of the WebLogic admin server. To find this value contact your WebLogic administrator.

The Admin Port is ___________________________________.

Admin User

This value is the WebLogic admin user name. To find this value contact your WebLogic administrator.

The Admin User is __________________________________

Admin Password

This value is the WebLogic admin password. To find this value contact your WebLogic administrator.

The password is _____________________________________


2.3.2 SOA Server Details Screen

Use this screen to enter information about your managed or cluster SOA server.This screen contains the fields listed in Table 2-3.

Table 2-3 SOA Server Details Screen Fields (Standalone)

Field Description

SOA Domain Name

This is WebLogic server domain corresponding to the Admin Server. Example: domain1

The SOA Domain Name is _______________________________

SOA Installation Directory

This value is the path where the SOA Domain is located.

Managed Server Name

This value is the name of the Managed Server for the domain.

Managed Server Port

This value is the port number of the managed server.


If installing in a cluster environment:

Table 2-4 SOA Server Details Screen Fields (Cluster)

Field Description

SOA Domain Name

This is WebLogic server domain corresponding to the Admin Server. Example: domain1

The SOA Domain Name is _______________________________

SOA Installation Directory

This value is the path where the SOA Domain is located.

Cluster Name

This value is the name of the cluster.

Cluster Proxy Hostname

This value is the Hostname of the proxy server managing the cluster.

Proxy Port

This value is the proxy port of the cluster


2.3.3 SOA Server Cluster Details

This screen only appears if you are installing in a cluster environment. The field and description are as follows:

Path to SOA Cluster Shared Directory—Enter the path to the location of the SOA Cluster Shared Directory.

2.3.4 EBS Server Connect Details Screen

Use this screen to enter details related to connect to your Oracle E-Business Suite server instance. The screen contains the fields listed in Table 2-5.

Table 2-5 EBS Server Connect Details Screen fields

Field Description

EBS Hostname

Specifies the system name of the Oracle E-Business Suite application. Example: example1.corp.oracle.com.

E-Business Suite Host Name is _____________________

EBS Port

This value is the Oracle E-Business Suite application port. To find this value, contact your administrator. Example: 8024.

E-Business Suite Port is ___________________________

EBS User Name

To find this value, contact your administrator.

E-Business Suite User Name is _____________________

EBS Password

To find this value, contact your administrator.

E-Business Suite Password is _______________________


2.3.5 EBS Server Details Screen

Use this screen to enter details related to your Oracle E-Business Suite server instance. The screen contains the fields listed in Table 2-6.

Table 2-6 EBS Server Details Screen fields

Field Description

Workflow Business Event System Name

This is the Workflow Business Event System Name of E-Business Suite Server.

For example: SID.server2.xyz.com. To find this value, contact your administrator.

Workflow Business Event System Name is _________________.

EBS Version

This is a drop down list of Oracle E-Business Suite Application versions.

EBS Protocol for Web Services

This is a drop down list with options http or https for the protocols used to invoke webservices on E-Business Suite. To find this value, contact your administrator.


2.3.6 EBS Database Details Screen

Use this screen to enter details related to your Oracle E-Business Suite database instance.The screen contains the fields listed in Table 2-7.

Table 2-7 EBS Database Details Screen fields

Field Description

EBS Database Hostname

Specifies the system name. To find this value, contact the database administrator. Example: server1.oracle.com.

E-Business Suite Database Host is ___________________

EBS Database Port

To find this value, contact the database administrator. Example: 1521.

E-Business Suite Database Port is ___________________

EBS Database SID (System ID)

To find this value, contact the database administrator. Example: orcl.

E-Business Suite Database SID is _________________________

EBS Database Username

To find this value, contact the database administrator. Example: apps.

E-Business Suite Database Username is ______________

EBS Database Password

To find this value, contact the database administrator.

E-Business Suite Database Password is ______________

EBS Database Schema

To find this value, contact the database administrator. Example: apps.

Database Schema is ______________________________

All the database credentials are used for creating the connection pool URL (universal resource locator) and data source URLs.


2.3.7 Agile PLM Server Connect Details Screen

Use this screen to enter details related to your Agile PLM instance. The screen contains the fields listed in Table 2-8.

Table 2-8 Agile PLM Server Connect Details Screen fields

Field Description

Agile PLM Hostname

Specifies the system name. Example: example1.corp.oracle.com.

Agile PLM Host is ________________________________

Agile PLM Port

This is the http or https port if you are using Agile PLM 9.3.4 with Web Service Security enabled. This value depends on the web server port and operating system of your Agile PLM instance. To find this value, contact your Agile PLM administrator. Example: 80.

Agile PLM Port is ________________________________

Agile PLM Virtual Path

This value is the same virtual path entered during the Agile PLM installation. Example: Agile.

Agile PLM Virtual Path is _________________________

Agile PLM Integration User Name

This is the Agile PLM admin access user name. Example: admin.

Agile PLM Integration Username is ________________

Agile PLM Integration User Password

To find this value, contact your Agile PLM administrator.

Agile PLM Integration User Password is ____________


2.3.8 Agile PLM Server Details Screen

Use this screen to enter details related to your Agile PLM server. The screen contains the fields listed in Table 2-9.

Table 2-9 Agile PLM Server Details Screen fields

Field Description

Agile PLM Version

Select the Agile PLM version from the dropdown list.

Web Services Security Enabled

If you are using Agile PLM 9.3.4 and have enabled Web Services Security, then select the checkbox.


2.3.9 PIP Database Connect Details Screen

Use this screen to enter details related to your Pre-built Integration database instance.The screen contains the fields listed in Table 2-10.

Table 2-10 PIP Database Connect Details Screen fields

Field Description

PIP Schema Database Hostname

Specifies the system name. To find this value, contact the database administrator. Example: server1.oracle.com.

PIP Schema Database Host is ___________________

PIP Schema Database Port

To find this value, contact the database administrator. Example: 1521.

PIP Schema Database Port is ___________________

PIP Schema Database SID (System ID)

To find this value, contact the database administrator. Example: orcl.

PIP Schema Database SID is _________________________

Sys User Name

Enter the name of the SYS database user. Default value is sys.

Sys User Password

Enter the password for the SYS database user. To find this value, contact the database administrator.


2.3.10 PIP Schema Details Screen

Use this screen to enter details related to your new schema to be created for the pre-built integration queue tables. The screen contains the fields listed in Table 2-11

Table 2-11 PIP Schema Details Screen fields

Field Description

PIP Schema Name

Enter the name of the new schema to be created for the PIP queue tables. Default Value is plmpip.

PIP Schema password

Create a password for the schema.

Confirm PIP Schema password

Confirm the new password that you created.


2.3.11 PIP Item Initial Load Data Location Details Screen

Use this screen to enter details related to the Oracle EBS to Agile PLM Initial Load instance. The screen contains the fields listed in Table 2-12.

Table 2-12 PIP Item Initial Load Data Locations

Field Description

Location to store XML files with item data from EBS

This is the location where AIA stores the XML files that contain Initial Load Item data from Oracle E-Business Suite.

Location to read Item XML files to load into Agile PLM

This is the location from where AIA picks up the Initial Load Item data XML files for loading into Agile PLM. This location option enables you to review and improve the data before loading into Agile.

Location to store the failed Item data XML files

This is the location of the Item Data XML files that failed to load into Agile.

Location to store the successful Item data XML files

This is the location of the Item Data XML files that were successfully loaded into Agile.