5 Deploying SOA Composite Applications

5.1 Deploying Applications

You can deploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control with the Deploy SOA Composite wizard. Use the Deploy SOA Composite wizard to deploy any of the following:

• A new SOA composite application for the first time.

• A new revision (for example, 2.0) alongside an older revision (for example, 1.0) without having an impact on the latter. The revision deployed last becomes the new default revision of that composite (unless you specify otherwise at a later step during deployment).

• A SOA bundle (ZIP file) containing multiple SOA composite application revisions (for example, revisions 2.0, 3.0, and 4.0) of a SOA composite application that has different revisions currently deployed (for example, 1.0). This option enables you to deploy revisions 1.0, 2.0, 3.0, and 4.0 at the same time. The bundle can also contain revisions of different composites. There is no restriction that all revisions must be of the same composite application. There should not be any cross references between the composites in the same bundle. For example, composite A revision 1.0 should not reference Composite B revision 1.0.

Deployment extracts and activates the composite application in the SOA Infrastructure. After an application is deployed, you can perform administration tasks, such as creating instances, configuring properties, monitoring performance, managing instances, and managing policies and faults.

To deploy applications:

1. Access the Deploy SOA Composite wizard through one of the following options:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...	From the SOA Infrastructure Home Page...	From the SOA Composite Menu...
   Select SOA Deployment > Deploy.	Right-click soa-infra. Select SOA Deployment > Deploy.	Click the Deployed Composites tab. Above the Composite table, click Deploy.	Select SOA Deployment > Deploy Another Composite.

   
   

   Note:

   You can also access the Deploy SOA Composite wizard by selecting Deploy to This Partition from the Deployment dropdown list of the Manage Partitions page or home page of a specific partition, from the SOA Partition menu at the top of the home page of a specific partition, or by right-clicking a specific partition in the navigator.

   The Select Archive page appears.

   
   Description of the illustration sca_deploy.gif
   
   

2. In the Archive or Exploded Directory section, specify the archive of the SOA composite application to deploy. The archive contains the project files of the composite to be deployed (for example, HelloWorld_rev1.0.jar for a single archive or OrderBooking_rev1.0.zip for multiple archives). This information is required.

3. In the Configuration Plan section, optionally specify the configuration plan to include with the archive. The configuration plan enables you to define the URL and property values to use in different environments. During process deployment, the configuration plan is used to search the SOA project for values that must be replaced to adapt the project to the next target environment.

4. Click Next.

   The Select Target page appears.

   This page lists the Oracle SOA Suite managed server or cluster to which to deploy the SOA composite application archive.

5. Select the partition into which to deploy this SOA composite application. Partitions enable you to logically group SOA composite applications into separate sections. Note that even if there is only one partition available, you must explicitly select it. Once deployed, a composite cannot be transferred to a different partition.

   If you want to deploy to a partition that does not exist, exit the wizard and create the partition before deploying the composite. You create partitions in the Manage Partition page, accessible from the SOA Infrastructure menu.

   If the server contains no partitions, you cannot deploy composite applications to that server. Also, if the server is not in a running state, you cannot deploy this archive. By default, a partition named default is automatically included with Oracle SOA Suite. You can delete the default partition.

   Note:

   Human workflow artifacts such as task mapped attributes (previously known as flex field mappings) and rules (such as vacation rules) are defined based on the namespace of the task definition. Therefore, the following issues are true when the same SOA composite application with a human workflow task is deployed into multiple partitions:

   • For the same task definition type, mapped attributes defined in one partition are visible in another partition.

   • Rules defined on a task definition in one partition can apply to the same definition in another partition.

   If you invoke the Deploy SOA Composite wizard by selecting Deploy to This Partition from the Deployment dropdown list on the Manage Partitions page or home page of a specific partition, the partition to which to deploy is selected. Therefore, the Select Target page is skipped.

6. Click Next.

   The Confirmation page appears.

7. Review your selections.

8. Select whether to deploy the SOA composite application as the default revision. The default revision is instantiated when a new request comes in.

9. Click Deploy.

   Processing messages are displayed.

   At this point, the deployment operation cannot be canceled. Deployment continues even if the browser page is closed.

10. When deployment has completed, the home page of the newly deployed composite revision is displayed automatically. A confirmation message at the top of the page tells you that the composite has been successfully deployed. In the case of a bundle deployment, the Deployed Composites page of the SOA Infrastructure is displayed.

For information about creating configuration plans and deploying applications from Oracle JDeveloper, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.

<hwTaskFlows
 xmlns="http://xmlns.oracle.com/bpel/workflow/hwTaskFlowProperties">
   <ApplicationName>worklist</ApplicationName>
   <LookupType>LOCAL</LookupType>
   <TaskFlowDeploy>false</TaskFlowDeploy>
   <PartitionName>partition2</PartitionName> 

5.2 Redeploying Applications

You can redeploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control with the Redeploy SOA Composite wizard. Using the Redeploy SOA Composite wizard has the following consequences:

• A new version of a revision of a currently deployed SOA composite application is redeployed on the same deployment target (for example, old version 1.0 is redeployed as new version 1.0).

• If the older, currently deployed version of this revision has running instances, the state of those instances is changed to stale. The instance state is available in the instance listing, and you can access audit and flow trace details.

To redeploy applications:

1. Access this page through one of the following options:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...	From the SOA Infrastructure Home Page...	From the SOA Composite Menu...
   Select SOA Deployment >Redeploy. The Select Composite page appears. In the SOA Composite Deployments section, select the SOA composite application revision you want to redeploy, and click Next.	Right-click soa-infra. Select SOA Deployment > Redeploy. The Select Composite page appears. In the SOA Composite Deployments section, select the SOA composite application revision you want to redeploy, and click Next.	Click the Deployed Composites tab. In the Composite table, select a specific SOA composite application. Only one application can be redeployed at a time. Above the Composite table, click Redeploy.	Select SOA Deployment > Redeploy.

   
   

   Note:

   You can also access the Redeploy SOA Composite wizard by right-clicking a partition and selecting SOA Deployment > Redeploy.

   The Select Archive page appears.

2. In the Archive or Exploded Directory section, select the location of the SOA composite application revision you want to redeploy.

3. In the Configuration Plan section, optionally specify the configuration plan to include with the archive.

4. Click Next.

   The Confirmation page appears.

5. Select whether to redeploy the SOA composite application as the default revision.

6. Click Redeploy.

   Processing messages are displayed.

   At this point, the deployment operation cannot be canceled. Deployment continues even if the browser page is closed.

7. When redeployment has completed, click Close.

   When redeployment has completed, the home page of the newly redeployed composite revision is displayed. A confirmation message at the top of the page tells you that the composite has been successfully redeployed.

5.3 Undeploying Applications

You can undeploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control with the Undeploy SOA Composite wizard. Using the Undeploy SOA Composite wizard has the following consequences:

• You can no longer configure and monitor this revision of the application.

• You can no longer process instances of this revision of the application.

• The state of currently running instances is changed to stale and no new messages sent to this composite are processed.

• The instance state of the undeployed composite application is set to stale. The instance state is available in the instance listing, and you can access audit trail details. However, the flow trace is not available. If you click the Flow tab, a message is displayed indicating that the flow trace view is not available for undeployed composites.

• If you undeploy the default revision of the application (for example, 2.0), the next available revision of the application becomes the default (for example, 1.0).

To undeploy applications:

1. Access this page through one of the following options:

   From the SOA Infrastructure Menu...	From the SOA Folder in the Navigator...	From the SOA Infrastructure Home Page...	From the SOA Composite Menu...
   Select SOA Deployment >Undeploy. The Select Composite page appears. In the SOA Composite Deployments section, select a specific SOA composite application to undeploy, and click Next.	Right-click soa-infra. Select SOA Deployment > Undeploy. The Select Composite page appears. In the SOA Composite Deployments section, select a specific SOA composite application to undeploy, and click Next.	Click the Deployed Composites tab. In the Composite table, select a specific SOA composite application. Only one application can be undeployed at a time. Above the Composite table, click Undeploy.	Select SOA Deployment > Undeploy.

   
   

   Note:

   You can also access the Undeploy SOA Composite wizard through these additional partition options:

   • Right-clicking a partition and selecting SOA Deployment > Undeploy From This Partition

   • Selecting Deployment > Undeploy All From This Partition on the partition home page

   • Selecting Deployment > Undeploy All From This Partition for the selected partition from the Manage Partitions page

   The Confirmation page appears.

2. If you are satisfied, click Undeploy. Note that you are warned if you are about to undeploy the last remaining revision of a deployed composite application.

   Processing messages are displayed.

   At this point, the undeploy operation cannot be canceled. Undeployment continues even if the browser page is closed.

3. When undeployment has completed, the SOA Infrastructure Deployed Composites page is displayed automatically. A confirmation message at the top of the page tells you that the composite has been successfully undeployed.