1. Using Visualizer for Oracle Stream Analytics
  2. Application Lifecycle

5 Application Lifecycle

This chapter describes how you can use Oracle Stream Analytics Visualizer to deploy, suspend, update, and uninstall Oracle Stream Analytics applications.

This chapter includes the following sections:

For more information, see:

5.1 Deploy 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 Stream Analytics 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 Stream Analytics Visualizer does not wait for the completion of the second operation. As soon as the application has successfully started, the Oracle Stream Analytics 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 Stream Analytics Visualizer.

When you deploy an application, the Oracle Stream Analytics server starts a new configuration history for it. See Configuration History Management.

Note:

You may only deploy to a group if the target Oracle Stream Analytics server is part of a multiserver domain (that is, if clustering is enabled). You may not deploy to a group if the target Oracle Stream Analytics server is part of a standalone-server domain (that is, if clustering is disabled).

This section describes:

5.1.1 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 multiserver domain, see Deploy an Application in a Multiserver Domain.

Note:

Uploading an application JAR file via Oracle Stream Analytics Visualizer running in the Firefox browser over HTTPS is not supported. For uploading over HTTPS, use Internet Explorer.

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 follows
    Description of "Figure 5-1 The Install Application Screen: Standalone-Server Domain"
  7. If you want the application JAR file removed from the Oracle Stream Analytics 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 follows
    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 Deploy an Application in a Multiserver Domain

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

For more information, see Multiserver Domains.

Note:

Uploading an application JAR file via Oracle Stream Analytics Visualizer running in the Firefox browser over HTTPS is not supported. For uploading over HTTPS, use Internet Explorer.

Deploy an Application in a Multiserver 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: Multiserver Domain

    Description of Figure 5-3 follows
    Description of "Figure 5-3 The Install Application Screen: Multiserver 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: Multiserver Domain

    Description of Figure 5-4 follows
    Description of "Figure 5-4 The Review Deployment Information Screen: Multiserver Domain"
  9. Click OK.

    Oracle Stream Analytics 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 follows
    Description of "Figure 5-5 HelloWorld Application Deployed to All the Servers in Group testgroup"

5.2 Suspend or Resume an Application

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

Note:

Suspend and resume apply to installed applications only.

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 Update 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 Stream Analytics server erases the application's existing configuration history and starts a new configuration history for it. See Configuration History Management.

Note:

Uploading an application JAR file via Oracle Stream Analytics Visualizer running in the Firefox browser over HTTPS is not supported. For uploading over HTTPS, use Internet Explorer.

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 Uninstall 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 Stream Analytics server erases the application's existing configuration history. See Configuration History Management.

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.