Saturday, June 23, 2012

AIA 11g PIPS Deployment using AIA Installer Driver: Harvesting AIA composites Part 2: Harvesting Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository

  • When you choose to harvest into the Project Lifecycle Workbench, annotations in composite XML files are published to Project Lifecycle Workbench. These annotations published to Project Lifecycle Workbench are instrumental in facilitating downstream automation, such as bill of material (BOM) generation and deployment plan generation. Annotations and harvesting are required to enable this downstream automation.
  • If downstream automation is not a requirement for you, you may or may not annotate and harvest. When you reach a point in the lifecycle flow at which the result of annotations and harvesting are used, such as BOM and deployment plan generation, you can manually complete the BOM via the Project Lifecycle Workbench UI or manually write your own ANT script to generate a deployment plan.
  • When you choose to harvest into Oracle Enterprise Repository, annotations on Application Business Connector Service (ABCS) WSDL files, Enterprise Business Service (EBS) WSDL files, Enterprise Business Object (EBO) XSD files, and Enterprise Business Message (EBM) XSD files are published to Oracle Enterprise Repository. Harvesting to Oracle Enterprise Repository is optional.

Setting Up for Design-Time Harvesting Using a Non-AIA-Foundation Pack Environment

1.) Download AIAHarvester.zip. The AIAHarvester.zip can be found in $AIA_HOME/Infrastructure/LifeCycle directory. AIAHarvester.zip contains all components necessary to perform a harvest against Project Lifecycle Workbench and Oracle Enterprise Repository. AIAHarvester.zip contains all components necessary to perform a harvest against Project Lifecycle Workbench and Oracle Enterprise Repository.
2.) Unzip AIAHarvester.zip in any location. You must maintain the unzipped structure.

3.) Update the values shown in bold in the ./AIAInstallProperties.xml file.Foundation Pack uses Java Database Connectivity (JDBC) to determine the Project Lifecycle Workbench database. Ensure that the <jdbc-url>jdbc:oracle:thin:@localhost:1521:XE</jdbc-url> value points to the Project Lifecycle Workbench database where you want AIAHarvester results to be stored.

Example 3-1 AIAInstallProperties.xml File Adjustments
<?xml version = '1.0' encoding = 'UTF-8'?>
<properties>
    <aiainstance>
        <aiaHome>AIA_HOME</aiaHome>
        <name>AIA_INSTANCE_NAME</name>
        <javahome>JAVA_HOME</javahome>
        <remote_install>true</remote_install>
        <domain_root>SERVER_DOMAIN_ROOT</domain_root>
        <mwHome>MW_HOME</mwHome>
        <soaHome>SOA_HOME</soaHome>
        <aiainstalltype>standard</aiainstalltype>
        <isencrypted>true</isencrypted>
    </aiainstance>
    <aialifecycle>
        <jdbc-url>jdbc:oracle:thin:@localhost:1521:XE</jdbc-url>
        <username>weblogic</username>
        <password>[C@8b567c</password>
        <createschema>true</createschema>
        <sysusername>sys</sysusername>
        <syspassword>[C@15b0e2c</syspassword>
        <role>SYSDBA</role>
        <defaulttablespace>SYSTEM</defaulttablespace>
        <temptablespace>TEMP</temptablespace>
        <isRac>false</isRac>
        <racCount>1</racCount>
        <racInstances>rac0</racInstances>
        <rac>
            <serviceName>RAC_DATABASE_SERVICENAME</serviceName>
            <rac0>
                <instanceName>RAC_INSTANCE_NAME</instanceName>
                <host>INSTANCE_HOST</host>
                <port>INSTANCE_PORT</port>
            </rac0>
        </rac>
    </aialifecycle>
...


4.) Encode the password for the Project Lifecycle Workbench database by running AIALifeCycleEncode.sh: ./AIALifeCycleEncode.sh -user <username>

  • When prompted, enter the password. 

5.) Encode the password for the application server by running AIALifeCycleEncode.sh: ./AIALifeCycleEncode.sh -user <username> -type jndi

Replace <username> with the WebLogic username value. When prompted, enter the password.

6.) Generate the HarvesterSettings.xml file. 
(1    Generate your own HarvesterSettings.xml. e.g., HarvesterSettings_ModuleName.xml, which specifies all composites you want to harvest: The template for HarvestingSetting.xml can be found in the directory where the AIAHarvester.zip was uncompressed. This will be in the folder C:\AIAHarvester\Harvester A sample HarvesterSettings.xml is attached below.



<?xml version="1.0" encoding="UTF-8"?>
<tns:harvesterSettings xmlns:tns="http://www.oracle.com/oer/integration/harvester" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.oracle.com/oer/integration/harvester Harvester_Settings.xsd ">
 
  <harvesterDescription>Oracle Enterprise Repository Harvester</harvesterDescription>     
  <registrationStatus>Registered</registrationStatus>
  
  <!--Query: the files to harvest-->
  <query>
    <fileQuery>      <files>C:\SourceCode\ModuleName\ProjectName\composite.xml</files>
      <fileType>.xml</fileType>
    </fileQuery>
  </query>
  <introspection>
    <reader>com.oracle.oer.sync.plugin.reader.file.FileReader</reader>
    <writer>com.oracle.oer.sync.plugin.writer.oer.OERWriter</writer>
  </introspection>
</tns:harvesterSettings>
A
7.)
(HHarvest Design-Time Composites into Project Lifecycle Workbench only Using HarvesterSettings.xml

AIAHarvest -partial true -mode AIA -settings ./Harvester/HarvesterSettings_moduleName.xml

########

0 comments: