4 Installing and Deploying using Manual Steps

This chapter discusses how to deploy AIA artifacts manually without using the Installer.

This chapter includes the following sections:

Note:

Ensure that you access the latest Oracle Fusion Middleware Installation and Upgrade Guide for Oracle Application Integration Architecture Foundation Pack 11g Release 1 (11.1.1.4.0) on Oracle Technology Network at http://www.oracle.com/technetwork/index.html.

Ensure that you review the release notes for Oracle Application Integration Architecture Foundation Pack 11g Release 1 (11.1.1.4.0) available on Oracle Technology Network at http://www.oracle.com/technetwork/middleware/docs/aiasoarelnotes-196861.html.

4.1 Manual Deployment of AIA Artifacts Overview

Manual deployment of AIA delivered products is not a common scenario unless there is a need to do automation. You can do a manual installation after you do Copy AIA Files using AIA Foundation Pack Installer and execute the Installation driver. This is explained in this chapter.

You can also deploy fully or partially build AIA content.

For information on how to deploy custom built services, refer to "Generating Deployment Plans and Deploying Artifacts" in Oracle Fusion Middleware Developer's Guide for Oracle Application Integration Architecture Foundation Pack.

Installing fully or partially custom-built AIA content is a more common scenario. This mode of installation allows you to select the specific AIA components (SOA Composites, JMS queues, and so on) you want to install and deploy. This content could be fully custom-built content for a specific business integration scenario or a combination of custom built content and Oracle AIA delivered content.

AIA makes available all tools and utilities required to build your custom installation. These are the same tools used by Oracle to deliver pre-built integrations (PIPs), Foundation Pack and the AIA Demo. These tools allow you to focus on the "what-to-deploy" and not the "how-to-deploy", thereby allowing custom content to be deployed easily and in exactly the same manner as AIA recommends.

AIA Project Lifecycle Workbench allows you to manage your project. Using this application you can define your custom content, browse existing content, and create and maintain an AIA project. Once a project is defined you can select all elements or a subset of elements to auto generate a deployment plan. The deployment tool will deploy this plan to the specified servers.

4.2 Deploying Foundation Pack Using Scripts

You need to perform the following steps to complete manual deployment of Foundation Pack.

4.2.1 Fulfill Prerequisites for Script Based Deployment

To fulfill the prerequisites for script based deployment of Foundation Pack you need to configure the following environment variables:

  1. Set MW_HOME (where you have installed FMW 11g).

  2. Set SOA_HOME to the directory where you have installed SOA 11g. For example c:\MW_HOME\AS11gR1SOA.

  3. Set AIA_HOME to the directory where you have copied AIA software. For example d:\AIA_HOME.

  4. Set JAVA_HOME to directory where you have installed Java.

  5. Set ANT_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=512m".

  6. Set ORACLE_HOME=$SOA_HOME.

  7. Set WEBLOGIC_HOME=$MW_HOME/wlserver_10.3.

  8. Set HARVESTER_HOME=$AIA_HOME/Infrastructure/LifeCycle/AIAHarvester.

  9. Set ANT_HOME=$AIA_HOME/ant.

  10. Set PATH=.:$JAVA_HOME/bin:$ANT_HOME/bin:$PATH.

  11. Set CLASSPATH=.:$WEBLOGIC_HOME/server/lib/weblogic.jar:$AIA_HOME/lib/aia.jar:$MW_HOME/modules/net.sf.antcontrib_1.0.0.0_1-0b2/lib/ant-contrib.jar:$CLASSPATH.

4.2.2 Create AIA Instance

To create AIA instance:

  1. Copy AIAHome/Infrastructure/Install/templates/AIAInstallProperties.xml.tmpl to AIAHome/config/AIAInstallProperties.xml.

  2. Update AIAInstallProperties.xml to reflect to target server details.

  3. Navigate to AIAHome/Infrastructure/Install/AID.

  4. Run the following command to create an AIA Instance:

    ant -f AIACreateInstance.xml -DPropertiesFile=<location of the AIAInstallProperties.xml file>

  5. Encrypt the passwords in the AIAInstallProperties.xml file.

    The AIAInstallProperties.xml contains plain text passwords. AIA recommends that you encrypt these passwords. AIA provides a utility to encrypt these passwords by creating a key store that AIA will use for further actions.

  6. To encrypt passwords, navigate to AIAHome/util folder and execute the following command:

    ant -f createStore.xml generate -DPropertiesFile=<location of AIAInstallProperties.xml>

4.2.3 Run Installation Scripts

To run the installation script:

  1. Navigate to AIA_HOME/aia_instances/<instance_name>/bin.

  2. Run the command

    . aiaenv.sh (for Unix based)
    aiaenv.bat (for windows)
    
  3. Navigate to AIA_HOME/Infrastructure/Install/AID.

  4. Run the following command to initiate installation:

    ant -f  AIAInstallDriver.xml
    -DPropertiesFile=$AIA_HOME/aia_instances/<Instance 
    Name>/config/AIAInstallProperties.xml
    -logfile $AIA_HOME/aia_instances/<Instance Name>/logs/FPInstall.log
    -DDeploymentPlan=$AIA_HOME/aia_instances/<Instance 
    Name>/config/FPInstallDP.xml
    
  5. Verify the installation using steps in the Verifying the Installation chapter.