How to Set Up Environments to Harvest Deployed Composites into Oracle Enterprise Repository How to Harvest Deployed Composites into Oracle Enterprise Repository

3-16 Developers Guide for Oracle Application Integration Architecture Foundation Pack Run-time publishing to Oracle Service Registry is delegated to Oracle Enterprise Repository. For more information about publishing to Oracle Service Registry from Oracle Enterprise Repository, see Configuring Oracle Enterprise Repository to Exchange Metadata with the Oracle Service Registry in Oracle Fusion Middleware Configuration Guide for Oracle Enterprise Repository.

3.4.1 How to Set Up Environments to Harvest Deployed Composites into Oracle Enterprise Repository

Objective Set up environments to harvest deployed composites into Oracle Enterprise Repository. Prerequisites and Recommendations ■ The Oracle AIA Installer installation has been run and completed. ■ The composites that you want to harvest into Oracle Enterprise Repository have been deployed into the run-time SOA engine. Actors System administrator Specifically, this is the actor who installs and deploys the AIA Foundation Pack and Process Integration Packs PIPs. To set up environments to harvest deployed composites into Oracle Enterprise Repository: Run an AIA command to set up the environment: Source {AIA_ INSTANCE}binaiaenv.sh

3.4.2 How to Harvest Deployed Composites into Oracle Enterprise Repository

This section includes the following topics: ■ Section 3.4.2.1, Harvesting PIP-Delivered Deployed Composites to Oracle Enterprise Repository ■ Section 3.4.2.2, Harvesting Custom-Built Deployed Composites to Oracle Enterprise Repository Objective As a part of your Oracle AIA installation, you have deployed composites into the Oracle SOA engine, whether they are AIA-delivered or custom built. Post installation, you can choose to publish these deployed composites to the Oracle Enterprise Repository by way of a command-line script. Note: This post- installation harvest of deployed composites into Oracle Enterprise Repository is optional and is not performed by the AIA Installer. Harvesting Oracle AIA Content 3-17 Publishing your deployed composites to Oracle Enterprise Repository ensures that it accurately reflects your SOA run-time composite information, including end points and so forth. Prerequisites and Recommendations ■ Complete the steps covered in Section 3.1, How to Set Up Oracle AIA Content Harvesting. ■ Complete the steps covered in Section 3.4.1, How to Set Up Environments to Harvest Deployed Composites into Oracle Enterprise Repository. Actors System administrator Specifically, this is the actor who installs and deploys the AIA Foundation Pack and PIPs.

3.4.2.1 Harvesting PIP-Delivered Deployed Composites to Oracle Enterprise Repository

If you are harvesting deployed composites that were delivered as part of an AIA PIP, perform the following procedure to harvest them to Oracle Enterprise Repository. To harvest PIP-delivered deployed composites into Oracle Enterprise Repository: 1. Navigate to AIA_HOMEInfrastructureLifeCycleInstallPIPHarvest. 2. Run the following command: ant -f PIPCompositeHarvest.xml 3. Access Oracle Enterprise Repository to confirm that all expected composites are present. For more information, see Section 8.3, How to Access Oracle AIA Content in Oracle Enterprise Repository.

3.4.2.2 Harvesting Custom-Built Deployed Composites to Oracle Enterprise Repository

If you are harvesting custom-built deployed composites, perform the following procedure to harvest them to Oracle Enterprise Repository. For example, if you have installed Foundation Pack and implemented and deployed your own composites, you can choose to harvest these deployed composites to Oracle Enterprise Repository. To harvest custom-built deployed composites into Oracle Enterprise Repository: 1. Edit the HarvesterSettings.xml file, as shown in Example 3–8 , to provide content in bold specific to your harvesting requirements. ■ Provide Oracle Enterprise Repository information. ■ Use remoteQuery and list all deployed composite names to be harvested. ■ As part of the remoteQuery syntax, provide and encrypt SOA server information. Example 3–8 Sample HarvesterSettings.xml Used to Harvest Custom-Built Deployed Composites into Oracle Enterprise Repository: ?xml version=1.0 encoding=UTF-8? 3-18 Developers Guide for Oracle Application Integration Architecture Foundation Pack tns:harvesterSettings xmlns:tns=http:www.oracle.comoerintegration harvesterxmlns:xsi=http:www.w3.org2001XMLSchema-instancexsi: schemaLocation=http:www.oracle.comoerintegrationharvester Harvester_Settings.xsd --Description to set on created Assets in OER.-- harvesterDescriptionOracle Enterprise Repository Harvester harvesterDescription --Registration status to set on created Assets in OER. The Valid Registration states are 1 Unsubmitted 2Submitted - Pending Review 3Submitted - Under Review 4Registered -- registrationStatusRegisteredregistrationStatus --Namespace to set on created Assets in OER. If left empty, this is set based on information from SOA Suite and OSB projects when available. Thats generally the best practice, so override this with caution.-- namespace --Connection info to OER-- -uri is the OER server-- - admin is username to login OER in cleartext -- -password is encrypted -- repository urihttp:ple-jgau.us.oracle.com:7101oeruri credentials useradminuser passwordv2_1.qRhDTl1LdPo=password--run encrypt.bat to encrypt this-- credentials timeout30000timeout repository --Query: the files to harvest-- query --To specify design-time files to harvest: Uncomment the section below and specify the files you want to harvest. Or specify on the command-line via the -file parameter.-- --To specify run-time files to harvest: Uncomment this and specify the files you want to harvest. Or specify on the command-line via the -file parameter. The serverType must be one of: SOASuite, OSB, or WLS. Run encrypt.bat to encrypt the password.-- remoteQuery serverTypeSOASuiteserverType -This is the composite project deployed into the SOA server-- projectNameAIADemoQueryCustomerPartyCRMProvABCSImpl projectName -another example below, we specifically give the deployment revision number rev1.0. It is appended after the composite project name. User may find out this revision number of browsing MDS via their jDev projectNameAIADemoQueryCustomerPartyCRMProvABCSImpl_rev1.0 projectName-- -uri is the SOA server information -- -user is the username to log into the SOA server -- -password is used to log into the SOA server, it is encrypted -- urihttp:10.146.91.163:8001uri credentials userweblogicuser passwordv2_1.G+NTr3az8thaGGJBn0vwPg==password credentials Harvesting Oracle AIA Content 3-19 remoteQuery query --Predefined Policy Location: If harvesting SOA Suite projects from the command line, uncomment the section below and set it to point to your installation of JDeveloper-- introspection readercom.oracle.oer.sync.plugin.reader.file.FileReaderreader writercom.oracle.oer.sync.plugin.writer.oer.OERWriterwriter introspection tns:harvesterSettings 2. Access a command line utility and run the AIAHarvest.sh harvester script. We recommend using the -partial true option. For example: AIAHarvest.sh -partial true -mode OER -settings HarvesterSettings.xml

3.5 Introducing Oracle Enterprise Repository After AIA Installation