4 Installing and Deploying using Manual Steps

This chapter provides an overview of manual deployment of AIA artifacts and discusses how to deploy AIA artifacts manually without using the installer.

This chapter includes the following sections:

• Section 4.1, "Manual Deployment of AIA Artifacts Overview"

• Section 4.2, "Deploying Foundation Pack Using Scripts"

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.7) 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.7) 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 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 enables 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, 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 the same manner as AIA recommends.

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

4.2 Deploying Foundation Pack Using Scripts

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 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=${MW_HOME}/modules/org.apache.ant_<version number>. For example, 1.7.1.

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

11. Set CLASSPATH=.:${WL_HOME}/server/lib/weblogic.jar: ${AIA_HOME}/lib/aia.jar: ${AIA_HOME}/lib/aia-utils.jar: ${MW_HOME}/modules/net.sf.antcontrib_1.1.0.0_1-0b2/lib/ant-contrib.jar: ${MW_HOME}/oracle_common/modules/oracle.mds_11.1.1/mdsrt.jar: ${MW_HOME}/oracle_common/modules/oracle.osdt_11.1.1/osdt_xmlsec.jar: ${MW_HOME}/oracle_common/modules/oracle.jps_11.1.1/jps-e.jar: ${MW_HOME}/oracle_common/modules/oracle.jps_11.1.1/jps-common.jar: ${MW_HOME}/oracle_common/modules/oracle.jps_11.1.1/jps-internal.jar: ${MW_HOME}/oracle_common/modules/oracle.jps_11.1.1/jps-unsupported-api.jar: ${MW_HOME}/oracle_common/modules/oracle.pki_11.1.1/oraclepki.jar: ${MW_HOME}/oracle_common/modules/oracle.idm_11.1.1/identitystore.jar: ${MW_HOME}/oracle_common/modules/oracle.xdk_11.1.0/xmlparserv2.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>

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.