SOA 11g - Deployment of SOA Applications

Deploying SOA Applications

You can deploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control Console 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 impacting the latter. The revision deployed last becomes the new default revision of that composite (unless you specify otherwise at a later step during deployment).

Deployment extracts and activates the composite application in the SOA Infrastructure. Once 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...

1. Select SOA Deployment >Deploy.

From the SOA Folder in the Navigator...

2. Right-click soa-infra.
3. Select SOA Deployment >Deploy.

From the SOA Infrastructure Home Page...

1. Click the Deployed Composites tab.
2. Above the Composite table, click Deploy.

From the SOA Composite Menu...

3. 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.

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.

Notes:

• A SOA composite application with the same name can be deployed to separate partitions. Each is deployed as a distinct, separate composite from the other.
• You cannot deploy the same SOA composite application with a human workflow task into multiple partitions. For example, if the composite named VacationRequest includes VacationRequestTask.task, you cannot deploy this composite into a partition named production and a partition named development. Deploy this composite to only one 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 already selected. Therefore, the Select Target page is skipped.

2. Click Next.

The Confirmation page appears.

3. Review your selections.
4. Select whether to deploy the SOA composite application as the default revision. The default revision is instantiated when a new request comes in.
5. Click Deploy.

Processing messages are displayed.

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

6. When deployment has completed, the home page of the newly deployed composite revision automatically displays. 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.

Redeploying SOA Applications

You can redeploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control Console 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.

Notes:

• If you want to maintain multiple revisions of a deployed application (for example, revisions 1.0 and 2.0), do not use this wizard. Instead, use the Deploy SOA Composite wizard.
• Redeploying multiple SOA composite applications at once is not supported.

To redeploy applications:

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

From the SOA Infrastructure Menu...

a.       Select SOA Deployment>Redeploy.  The Select Composite page appears.

b.      In the SOA Composite Deployments section, select the SOA composite application revision you want to redeploy, and click Next.

From the SOA Folder in the Navigator...

1. Right-click soa-infra.
2. Select SOA Deployment > Redeploy.  The Select Composite page appears.

c.       In the SOA Composite Deployments section, select the SOA composite application revision you want to redeploy, and click Next.

From the SOA Infrastructure Home Page...

1. Click the Deployed Composites tab.
2. In the Composite table, select a specific SOA composite application. Only one application can be redeployed at a time.
3. Above the Composite table, click Redeploy.

From the SOA Composite Menu...

4. 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 cancelled. Deployment continues even if the browser window 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.

Undeploying SOA Applications

You can undeploy SOA composite applications from Oracle Enterprise Manager Fusion Middleware Control Console 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).

Note:

If you want to undeploy and then redeploy an existing revision of this application, do not use this wizard. Instead, use the Redeploy SOA Composite wizard. The Redeploy SOA Composite wizard enables you to redeploy an existing revision of a SOA composite application and remove (overwrite) the older, currently deployed version of the revision.

To undeploy applications:

Note:

You can undeploy multiple SOA composite applications together if they are located in the same partition.

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

From the SOA Infrastructure Menu...

1. Select SOA Deployment>Undeploy. The Select Composite page appears.
2. In the SOA Composite Deployments section, select a specific SOA composite application to undeploy, and click Next.

From the SOA Folder in the Navigator...

1. Right-click soa-infra.
2. Select SOA Deployment >Undeploy. The Select Composite page appears.
3. In the SOA Composite Deployments section, select a specific SOA composite application to undeploy, and click Next.

From the SOA Infrastructure Home Page...

1. Click the Deployed Compositestab.
2. In the Composite table, select a specific SOA composite application. Only one application can be undeployed at a time.
3. Above the Composite table, clickUndeploy.

From the SOA Composite Menu...

4. 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 cancelled. Undeployment continues even if the browser window is closed.

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