5 Managing Application Lifecycle

This section contains the typical application tasks you can perform with Oracle CEP Visualizer to manage application lifecycle, including:

• Section 5.1, "Deploying an Application"

• Section 5.2, "Suspending or Resuming an Application"

• Section 5.3, "Updating an Application"

• Section 5.4, "Uninstalling an Application"

For more information, see:

• Section 3.2, "Application Lifecycle Management"

• Chapter 10, "Managing Deployments"

5.1 Deploying an Application

Deploying an application refers to uploading to the server the JAR file that contains the application and then installing it, which makes it available to clients.

Oracle CEP internally deploys an application as a two step processes. The first step involves starting the application bundle inside the OSGi container. The second step involves starting and initializing the application. Because the second step is asynchronous in nature, Oracle CEP Visualizer does not wait for the completion of the second operation. As soon as the application has successfully started, the Oracle CEP Visualizer navigation tree is updated automatically with the new deployment and a successful message will be sent to the dashboard. However, if the application fails to start, you must check for errors on the server side because no messages/updates will occur on the Oracle CEP Visualizer.

When you deploy an application, the Oracle CEP server starts a new configuration history for it. See Section 3.4, "Configuration History Management".

Note:

You may only deploy to a group if the target Oracle CEP server is part of a multi-server domain (that is, if clustering is enabled). You may not deploy to a group if the target Oracle CEP server is part of a standalone-server domain (that is, if clustering is disabled). For more information, see "Overview of Oracle CEP Multi-Server Domain Administration" in the Oracle Complex Event Processing Administrator's Guide.

This section describes:

• Section 5.1.1, "How to Deploy an Application in a Standalone-Server Domain"

• Section 5.1.2, "How to Deploy an Application in a Multi-Server Domain"

5.1.1 How to Deploy an Application in a Standalone-Server Domain

This section describes how to deploy an application to a standalone-server domain. For information on deploying an application in a multi-server domain, see Section 5.1.2, "How to Deploy an Application in a Multi-Server Domain".

To deploy an application in a standalone-server domain:

1. In the left pane, navigate to and select the Deployment node.

   The Deployed Applications table is displayed in the Deployment screen on the right pane.

2. Click the Install button.

   The Install Application screen is displayed.

3. Click the Upload tab.

4. Click the ... button to open a file browsing window.

5. Browse to the local directory that contains the JAR file of the application you want to install and click Open.

6. Click Upload.

   In the Install Application tab, the JAR file appears in the table of uploaded files, as shown in Figure 5-1.

   Figure 5-1 The Install Application Screen: Standalone-Server Domain

   
   Description of "Figure 5-1 The Install Application Screen: Standalone-Server Domain"
   
   

7. If you want the application JAR file removed from the Oracle CEP server after deploying, check the Remove file after deploy check box.

   In this case, you must upload the application JAR file again if you want to redeploy this application.

8. Select your application in the table and click Deploy.

   The Review Deployment Information screen is displayed, as shown in Figure 5-2.

   Figure 5-2 The Review Deployment Information Screen: Standalone-Server Domain

   
   Description of "Figure 5-2 The Review Deployment Information Screen: Standalone-Server Domain"
   
   

9. Click OK.

   Your application is deployed and ready for use.

5.1.2 How to Deploy an Application in a Multi-Server Domain

This section describes how to deploy an application to a multi-server domain. For information on deploying an application in a standalone-server domain, see Section 5.1.1, "How to Deploy an Application in a Standalone-Server Domain".

For more information, see Chapter 18, "Managing Multi-Server Domains".

To deploy an application in a multi-server domain:

1. In the left pane, navigate to and select the Deployment node.

   The Deployed Applications table is displayed in the Deployment screen on the right pane.

2. Click the Install button.

   The Install Application screen is displayed.

3. Click the Upload tab.

4. Click the ... button to open a file browsing window.

5. Browse to the local directory that contains the JAR file of the application you want to install and click Open.

6. Click Upload.

   In the Install Application tab, the JAR file appears in the table of uploaded files, as shown in Figure 5-3.

   Figure 5-3 The Install Application Screen: Multi-Server Domain

   
   Description of "Figure 5-3 The Install Application Screen: Multi-Server Domain"
   
   

7. Configure the Select Target Group to Deploy field.

   The group name appears in the Target Group to Deploy field.

   To unselect this selection, click the Clear Group button.

8. Select your application in the table and click Deploy.

   The Review Deployment Information screen is displayed, as shown in Figure 5-4.

   Figure 5-4 The Review Deployment Information Screen: Multi-Server Domain

   
   Description of "Figure 5-4 The Review Deployment Information Screen: Multi-Server Domain"
   
   

9. Click OK.

   Oracle CEP Visualizer deploys your application to all servers in the selected target group as Figure 5-5 shows.

   Figure 5-5 HelloWorld Application Deployed to All the Servers in Group testgroup

   
   Description of "Figure 5-5 HelloWorld Application Deployed to All the Servers in Group testgroup"
   
   

5.2 Suspending or Resuming an Application

You can temporarily suspend an application from running and resume the operation using the Suspend and Resume operations in the Deployment screen.

5.2.1 How to Suspend or Resume an Application

You can suspend or resume an application using the Oracle CEP Visualizer.

To suspend or resume an application:

1. In the left pane, navigate to Deployment node. The Deployed Applications table is displayed in the Deployment screen on the right pane.

2. Select the application you want to suspend or resume by checking the box to the left of its name.

3. Click Suspend to suspend the application or Resume to resume a suspended application.

5.3 Updating an Application

You can update your currently existing application with your latest application using the Update operation in the Deployment screen.

When you update an application, the Oracle CEP server erases the application's existing configuration history and starts a new configuration history for it. See Section 3.4, "Configuration History Management".

5.3.1 How to Update an Application

You can update an application using the Oracle CEP Visualizer.

To update an application:

1. In the left pane, navigate to Deployment node. The Deployed Applications table is displayed in the Deployment screen on the right pane.

2. Select the application you want to update by checking the box to the left of its name.

3. Click Update. The Update application screen is displayed.

4. Click the Upload tab.

5. Click on the "..." button to invoke a file browsing window, browse to the directory that contains the JAR file of application, and click Open.

6. Click Upload. In the Update Application tab, the JAR file appears in the table of uploaded files.

7. Select your application in the table and click OK.

   The existing application is updated with the latest application.

5.4 Uninstalling an Application

When you uninstall an application, you completely remove it from the server so that you can no longer access it.

When you uninstall an application, the Oracle CEP server erases the application's existing configuration history. See Section 3.4, "Configuration History Management".

5.4.1 How to Uninstall an Application

You can uninstall an application using the Oracle CEP Visualizer.

To uninstall an application:

1. In the left pane, navigate to Deployment node. The Deployed Applications table is displayed in the Deployment screen on the right pane.

2. Select the application you want to uninstall by checking the box to the left of its name.

3. Click Uninstall.

   You have undeployed the application successfully.