This 15-minute tutorial shows how to deploy and undeploy a Java EE application to an Oracle Java Cloud Service Instance by using the Fusion Middleware Control Console, as well as how to access the application after it is deployed.

Last Updated

April 2019

January, Release 18.4.6

Note that Oracle develops cloud services in an agile manner and makes rapid changes to meet our users' needs. This tutorial may not reflect all of the changes since the last update to this service. For the latest information, see:

• About Creating an Oracle Java Cloud Service Instance
• What's New for Oracle Java Cloud Service

Background

The Fusion Middleware Control Console is a powerful tool that gives you many options for deploying a Java EE application. You can access the Fusion Middleware Control Console from the Oracle Java Cloud Service console, and deploy an application you have developed on your local machine to one or more managed servers in the Oracle Java Cloud Service instance. The sample application, benefits, provided in this tutorial, is a simple example of an application. In this tutorial, we do not use many of the options and advanced features you might use when you deploy your own, possibly more complex, application.

What Do You Need?

A web browser is required for working with Oracle Cloud services. These are the minimum requirements:

• Microsoft Internet Explorer 9 or 10
  • Set Browser Mode to IE9 or IE10
  • Set Document Mode to IE9 or IE10 standards
• Google Chrome 29 and later
• Mozilla Firefox 24 and later
• Apple Safari 6 and later

Before starting this tutorial:

• Obtain appropriate log-in credentials for working with Oracle Java Cloud Service
• Create an Oracle Java Cloud Service instance with a load balancer included. For more information, see the Creating a Custom Oracle Java Cloud Service Instance tutorial.
• Have the administrator log-in credentials for accessing consoles such as the WebLogic Administration Console and Fusion Middleware Control Console. You specified these credentials when you created your Oracle Java Cloud Service instance.
• Have a Java Web application, archived as an Application ARchive (WAR) file. For the purposes of this tutorial, you can download the sample benefits.war application. Right-click benefits.war, select Save Link As (or whatever your browser prompts for saving the target of a link), and save it on your local computer.

To deploy an application to an Oracle Java Cloud Service instance:

1. From the Oracle Java Cloud Service Console, click the icon and choose Open Fusion Middleware Control Console.

   

2. Log in to the Fusion Middleware Control Console by using the administrator's log-in credentials you specified when you created the Oracle Java Cloud Service instance.

   

   The Fusion Middleware Control Console is displayed.

   

3. Click Target Navigation.

   

4. From the Target Navigation pane, expand the domain, and then select the cluster.

   

   The Server page is displayed.

   

5. From the WebLogic Cluster menu on the Server page, choose Control, then Deployments.

   

   The Deployments page is displayed.

   

6. From the Change Center menu, select Lock and Edit.

   

7. Select Deploy from the Deployments menu to open the Deploy Java EE Application Assistant.

   

8. In the Archive or Exploded Directory section of the Select Archive page, select Archive is on the machine where this browser is running. Click Browse and select benefits.war.

   

9. You do not have a deployment plan for this example, so in the Deployment Plan section, select Create a new deployment plan when deployment configuration is done.

   

10. In the Deployment Type section, select Deploy this archive or exploded directory as an application, and then click Next.

    

11. On the Select Target page, select the managed server. In this case, we select All configured Servers in the cluster. Click Next.

    

12. In the Deployments Summary section of the Application Attributes page, for Application Name, enter benefitsif the software has not provided this name automatically.

    

13. In the Context Root of Web Modules section, make no changes.

    

    The context root is the URI for the Web module. You may specify a context root for your application if the context root is not configured in the application.xml file.

14. In the Distribution section, select Install and start application (servicing all requests).

    

15. Keep the Other Options defaults, and then click Next.
16. On the Deployment Wizard, Deployment Settings page, keep the default selections. Click Deploy.

    

    The Fusion Middleware Control Console displays processing messages.

17. When the deployment is completed, click Close.

    The Deployment Succeeded page is displayed.

    

18. From the Change Center menu, select Activate Changes.

    

19. Notice that the benefits application appears on the Deployments table.

    

You have successfully deployed the benefits application.

After the application is deployed, you can verify that the deployment was successful. Because you deployed the application on the cluster, you will verify it using the IP address of the load balancer configured for your Oracle Java Cloud Service instance.

1. On the Oracle Java Cloud Service Console, click the name of your service instance.

   

2. From the Overview page, copy the Public IP address of the load balancer.

   

3. Open a browser and enter the following address:
   https://IP_of_load_balancer:443/benefits

   

   When a load balancer is present, the default HTTPS access port is 443.

   Note: These are default settings. You can change the user facing ports to any value you like from the Load Balancer Administration Console (Oracle Traffic Director). To open Oracle Traffic Director, go to your Oracle Java Cloud Service Console, click the menu for the service instance you want to manage, and select Open Load Balancer Console.

4. Verify that you see the benefits application.

   

You can use the Fusion Middleware Control Console to undeploy an application that you had deployed previously.

1. From the Navigation Pane, expand Application Deployments, and then select benefits.

   

2. To display the Deployments page, click the Deployments tile on the application home page.

   

3. In the Change Center menu, select Lock and Edit.
4. From the Deployment menu on the Deployments page, select Undeploy.

   

5. On the Confirmation page, click Undeploy.

   

   Processing messages are displayed.

6. When the process completes, click Close.
7. From the Change Center menu, select Activate Changes.

   The benefits application no longer appears on the Deployments table.

You have successfully undeployed the benefits application.

• Administering Oracle Java Cloud Service in the Oracle Help Center
• Oracle Java Cloud Service Tutorials
• cloud.oracle.com