How to Set Up Environments to Enable Design-Time Harvesting

Harvesting Oracle AIA Content 3-3 If composites are not annotated correctly, accuracy of downstream data, BOM generation, and deployment plan generation may suffer. For more information about AIA annotation specifications, see Chapter 9, Annotating Composites. We recommend that you harvest your composite into both Project Lifecycle Workspace and Oracle Enterprise Repository. However, if an Oracle Enterprise Repository instance is not available for your implementation, you may choose not to harvest to Oracle Enterprise Repository. We also recommend that you harvest composites upon completion of the composite implementation when the composite is in a stable and tested condition.

3.2.2 How to Set Up Environments to Enable Design-Time Harvesting

This section includes the following topics: ■ Section 3.2.2.1, Setting Up for Design-Time Harvesting Using a Non-Foundation Pack Environment ■ Section 3.2.2.2, Setting Up for Design-Time Harvesting Using a Foundation Pack Environment Objective Set up environments so that design-time harvesting can be done via command line. Perform this setup in preparation for harvesting design-time composites into the Project Lifecycle Workspace and Oracle Enterprise Repository. Prerequisites and Recommendations Oracle Meta Data Services MDS repository must be set up and populated with the prerequisite and dependent artifacts for the composites to be harvested, such as Enterprise Object Library and Application Object Library artifacts. For more information about setting up and populating MDS, see Chapter 20, Building AIA Integration Flows. To avoid a weblogic.common.resourcepool.ResourceLimitException error when running AIAHarvester, ensure that SOA-MDS is configured according to a recommended set of minimum basic configurations. For information about the minimum basic configurations, see Section 28.2.3, Configuring Performance Related Database Initialization Parameters. Actor Individual developers

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

To set up environments to enable design-time command line-based harvesting using a non-Foundation Pack environment: 1. Download AIAHarvester.zip. AIAHarvester.zip contains all components necessary to perform a harvest against Project Lifecycle Workbench and Oracle Enterprise Repository. 3-4 Developers Guide for Oracle Application Integration Architecture Foundation Pack AIAHarvester.zip no longer includes adf-config.xml. This file is no longer needed by AIAHarvester. If your installation was upgraded from a previous release, you may still have this file but no further action is required. 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, as shown in Example 3–1 . Foundation Pack uses Java Database Connectivity JDBC to determine the Project Lifecycle Workbench database. Ensure that the jdbc-urljdbc:oracle:thin:localhost:1521:XEjdbc-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 aiaHomeAIA_HOMEaiaHome nameAIA_INSTANCE_NAMEname javahomeJAVA_HOMEjavahome remote_installtrueremote_install domain_rootSERVER_DOMAIN_ROOTdomain_root mwHomeMW_HOMEmwHome soaHomeSOA_HOMEsoaHome aiainstalltypestandardaiainstalltype isencryptedtrueisencrypted aiainstance aialifecycle jdbc-urljdbc:oracle:thin:localhost:1521:XEjdbc-url usernameFPINST_AIALIFECYCLEusername password[C8b567cpassword createschematruecreateschema sysusernamesyssysusername syspassword[C15b0e2csyspassword roleSYSDBArole defaulttablespaceSYSTEMdefaulttablespace temptablespaceTEMPtemptablespace isRacfalseisRac racCount1racCount racInstancesrac0racInstances rac serviceNameRAC_DATABASE_SERVICENAMEserviceName rac0 instanceNameRAC_INSTANCE_NAMEinstanceName hostINSTANCE_HOSThost portINSTANCE_PORTport rac0 rac aialifecycle ... Note: The following steps assume that tasks are being performed within the AIAHarvester directory. Harvesting Oracle AIA Content 3-5 4. Ensure the accuracy of information in the .META-INFadf-config.xml file. Under normal circumstances, you should not have to update it. Specifically, ensure that the file includes the jdbcmdsMDS_ LocalTxDataSource value that appears in bold in Example 3–2 . Example 3–2 adf-config.xml File ?xml version=1.0 encoding=UTF-8 ? adf-config xmlns=http:xmlns.oracle.comadfconfig xmlns:adf=http:xmlns. oracle.comadfconfigproperties xmlns:sec=http:xmlns.oracle.comadf securityconfig adf:adf-properties-child xmlns=http:xmlns.oracle.comadfconfig properties adf-property name=adfAppUID value=OER.oracle.apps.aia.oer adf:adf-properties-child adf-mds-config xmlns=http:xmlns.oracle.comadfmdsconfig mds-config xmlns=http:xmlns.oracle.commdsconfig persistence-config metadata-namespaces namespace path=soab2b metadata-store-usage= soa-infra-store namespace path=deployed-composites metadata-store-usage= soa-infra-store namespace path=soashared metadata-store-usage= soa-infra-store namespace path=apps metadata-store-usage= soa-infra-store metadata-namespaces metadata-store-usages metadata-store-usage id=soa-infra-store deploy-target= true metadata-store class-name=oracle.mds.persistence. stores.db.DBMetadataStore property value=soa-infra name=partition-name property value=jdbcmdsMDS_LocalTxDataSource name= jndi-datasource metadata-store metadata-store-usage metadata-store-usages auto-purge seconds-to-live=300 persistence-config mds-config adf-mds-config adf-config 5. Encode the password for the Project Lifecycle Workbench database by running AIALifeCycleEncode.sh: .AIALifeCycleEncode.sh -user username When prompted, enter the password. 6. 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. 7. Decide upon the type of harvesting that you want to perform: 3-6 Developers Guide for Oracle Application Integration Architecture Foundation Pack ■ Oracle Enterprise Repository and Project Lifecycle Workbench database harvesting ■ Project Lifecycle Workbench database harvesting only 8. Generate the HarvesterSettings.xml file. If you prefer to harvest using command-line options instead of the HarvesterSettings.xml file, you do not have to perform this step and can proceed to Section 3.2.3.3, How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository Using Command Line Options. ■ Adjust the harvesterSettings_prep.xml file based on the choice that you made in the previous step. ■ Run an encryption script on the harvesterSettings_prep.xml to produce the final HarvesterSettings.xml file, which you will use as the input file to the harvester script that will harvest your composites: .Harvesterencrypt.sh source_file target_file. For example: .Harvesterencrypt.sh harvesterSettings_ prep.xml HarvesterSettings.xml harvesterSettings_prep.xml and HarvesterSettings.xml file names are used for illustrative purposes only. The source and target file names can be set to any file name.

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

To set up environments to enable design-time command line-based harvesting using a Foundation Pack environment: 1. Run source AIA_INSTANCEbinaiaenv.sh. 2. Prepare HarvesterSettings.xml, which contains the file system directory path to the newly completed composite.xml. 3. If you will be harvesting to Oracle Enterprise Repository, run the following encryption script to produce the final HarvesterSettings.xml file, which you will use as the input file to the harvester script that will harvest your composites: AIA_ HOMEInfrastructureLifeCycleAIAHarvesterHarvesterencrypt. sh source target 3.2.3 How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository This section discusses: Note: The encrypted database access information is stored in AIA_ INSTANCEInfrastructureLifeCycleAIAHarvesterconfig.configu rationProperties. If you subsequently change the database user name, for example, you may re-encrypt the database access information by running AIA_ HOMEInfrastructureLifeCycleAIAHarvesterAIALifeCy cleEncode.sh. Harvesting Oracle AIA Content 3-7 ■ Section 3.2.3.1, How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository Using HarvesterSettings.xml. ■ Section 3.2.3.2, How to Harvest Design-Time Composites into Project Lifecycle Workbench Only Using HarvesterSettings.xml. ■ Section 3.2.3.3, How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository Using Command Line Options. Objective Harvest design-time composites into Project Lifecycle Workspace and Oracle Enterprise Repository. You can choose to perform the harvest using the harvester script and the HarvesterSettings.xml file or by using command-line options. 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.2.2, How to Set Up Environments to Enable Design-Time Harvesting. ■ Ensure that the composite to be harvested is fully annotated according to AIA specifications. This is the ideal scenario. These annotations include those in ABCS WSDL files and composite XML files. AIA EBO and EBM XSD files are delivered with annotations. Annotations are not required, however downstream automation features will not work as designed if they are not annotated properly. For more information about AIA annotation specifications, see Chapter 9, Annotating Composites. Actor Individual developers 3.2.3.1 How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository Using HarvesterSettings.xml To harvest design-time composites into Project Lifecycle Workspace and Oracle Enterprise Repository using HarvesterSettings.xml: 1. Ensure that your HarvesterSettings.xml file is accurately configured. Sample file content is provided in Example 3–3 . In particular, note that the content shown: ■ Provides Oracle Enterprise Repository server information and credentials. ■ Uses fileQuery. ■ Specifies the file system path to the composite.xml for a given composite project. Example 3–3 Sample HarvesterSettings.xml to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository ?xml version=1.0 encoding=UTF-8? tns:harvesterSettings xmlns:tns=http:www.oracle.comoerintegration harvester xmlns:xsi=http:www.w3.org2001XMLSchema-instance xsi:schemaLocation=http:www.oracle.comoerintegrationharvester 3-8 Developers Guide for Oracle Application Integration Architecture Foundation Pack 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.-- fileQuery filesslotems3470oracleAIAHOME_1022samplesAIASamplesBaseSample SamplesCreateCustomerPartyPortalProvABCSImplcomposite.xmlfiles fileType.xmlfileType fileQuery 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 most of the time. Harvesting Oracle AIA Content 3-9 For example, for harvesting using a non-Foundation Pack environment, run AIAHarvest.sh -partial true -settings HarvesterSettings.xml For example, for harvesting using a Foundation Pack environment, run AIA_ HOMEInfrastructureLifeCycleAIAHarvesterAIAHarvest.sh -partial true -settings file path to destHarvesterSettings.xml 3.2.3.2 How to Harvest Design-Time Composites into Project Lifecycle Workbench Only Using HarvesterSettings.xml To harvest design-time composites into Project Lifecycle Workspace using HarvesterSettings.xml: 1. Ensure that your HarvesterSettings.xml file is accurately configured. Sample file content is provided in Example 3–4 . In particular, note that the sample file content: a. Uses fileQuery. b. Uses -mode AIA as a command-line parameter. c. Does not include Oracle Enterprise Repository server information. Example 3–4 Sample HarvesterSettings.xml Used to Harvest Design-Time Composites into Project Lifecycle Workbench Only ?xml version=1.0 encoding=UTF-8? tns:harvesterSettings xmlns:tns=http:www.oracle.comoerintegration harvester xmlns:xsi=http:www.w3.org2001XMLSchema-instance xsi:schemaLocation=http:www.oracle.comoerintegrationharvester Harvester_Settings.xsd --Description to set on created Assets in OER.-- harvesterDescriptionOracle Enterprise Repository HarvesterharvesterDescription --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 -- comment out the OER server section since we dont perform OER harvesting 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 fileQuery 3-10 Developers Guide for Oracle Application Integration Architecture Foundation Pack files slotems3470oracleAIAHOME_1022samplesAIASamples BaseSampleSamplesCreateCustomerPartyPortalProvABCSImplcomposite.xml files fileType.xmlfileType fileQuery query 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 execute the harvester script: AIAHarvest.sh -mode AIA. For example, for harvesting using a non-Foundation Pack environment: AIAHarvest.sh -partial true -mode AIA -settings HarvesterSettings.xml For example, for harvesting using a Foundation Pack environment: AIA_ HOMEInfrastructureLifeCycleAIAHarvesterAIAHarvest.sh -partial true -settings file path to harvesterSettings.xml -mode AIA 3.2.3.3 How to Harvest Design-Time Composites into Project Lifecycle Workspace and Oracle Enterprise Repository Using Command Line Options To harvest design-time composites into Project Lifecycle Workspace and Oracle Enterprise Repository using command line options: 1. Compose your AIAHarvest.sh script command statement using the available command line options covered in Table 3–1 . Table 3–1 Harvester Command-Line Options Harvester Command-Line Options Description -settings file name Configuration settings XML file name -url URL Oracle Enterprise Repository URL -user OER user name Oracle Enterprise Repository user name -password OER password Oracle Enterprise Repository password -partial true | false Provides support for partial introspection. To continue harvesting even if encountering errors, enter true. The default value is false. In other words, if this option is set to true, processing will continue even if an importedincluded file cannot be accessed. USE WITH CARE. -artifact_store store Name of Oracle Enterprise Repository Artifact Store to look in. If specified, the -file argument will be resolved relative to the artifact store URL -file filename or URL File or directory to be harvested. This can be a file name or URL to the file. Harvesting Oracle AIA Content 3-11 2. Access a command line utility and issue your harvester command. For example: AIAHarvest -settings file name

3.3 Harvesting Interfaces to Oracle Enterprise Repository in Bulk