Before You Begin
This tutorial explains how to use Oracle JDeveloper to deploy an application to Oracle Java Cloud Service.
May 2019, Release 19.2.2
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:
Time to Complete
Approximately 45 minutes
Oracle JDeveloper is a free integrated development environment that simplifies the development of Java-based SOA and Java EE applications. Oracle JDeveloper offers complete end-to-end development to Oracle Fusion Middleware and Oracle Fusion Applications with support for the full development life cycle.
This tutorial explains how Oracle JDeveloper on a
local machine can be used to deploy an
application to a remote Oracle Java Cloud Service
What Do You Need
This tutorial assumes you have a Windows 7 PC.
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, you should have:
- Created an Oracle Java Cloud Service instance that has load balancer enabled. For more information, see the Creating and Managing an Oracle Java Cloud Service—Coherence Instance tutorial. (You can create a service instance without enabling Oracle Coherence for the instance, as you don't need to have a Coherence data tier to follow the instructions in this tutorial.)
- Installed Oracle JDeveloper 12c Studio Version (12.1.3) on your local machine.
- A sample application WAR file to deploy to the
Oracle Java Cloud Service instance. The example in
this tutorial uses
benefits.war, which is available in the default workspace in Oracle JDeveloper.
Service Instance Details
You need the user name and password you specified for the WebLogic administrator when you created the service instance, the Administration Server Domain name, and the cluster name. The examples shown in this tutorial use the following service instance details:
- Oracle Java Cloud Service instance: MyServiceInstance
- Administration Server Domain: MyServic_domain
- Cluster: MyServic_cluster
Note: You might have different service instance details for performing this tutorial.
Establishing a Connection to an Oracle Java Cloud Service Instance through Oracle JDeveloper
Before you start deploying an application to your Oracle Java Cloud Service instance using Oracle JDeveloper, you must establish a connection with the remote server from JDeveloper.
Log in to the JDeveloper 12c Studio Console with the Studio Developer role.
From the menu, choose Window > Application Servers.
In the left pane, right-click Application Servers and then click New Application Server.
The Create Application Server Connection dialog is displayed. Proceed as follows:
On the Usage page, select Standalone Server and click Next.
On the Name and Type page, enter the Connection Name as
ServerInstance1. From the Connection Type drop-down list, select WebLogic 12.x. Click Next.
On the Authentication page, enter the user name and password for the WebLogic administrator (for example,
weblogic/examplepassword) and click Next.
Note: The WebLogic administrator user name and password must be the credentials you specified when you created the Oracle Java Cloud Service instance.
On the Configuration page, enter the WebLogic Hostname as the IP address of your remote cloud server. and Port as
The SSL port should be set to
7002. Select the Always Use SSL checkbox.
In the WebLogic Domain field, enter the Administration Domain Server name for your service instance (for exampleClick Next.
- On the Test page, click Test Connection. After you see that all the tests are successful, click Next.
- On the Finish page, click Finish after you complete creating the connection.
- In the left pane under Application Servers, notice that ServerInstance1 is displayed.
Note: If any of the tests failed, make sure your connection session to the remote instance is not expired. If it has expired, reestablish the connection session and try again.
You have established a connection to the remote WebLogic Server host running on an Oracle Java Cloud Service instance.
Preparing the WAR file to be Deployed
In this section, you will learn how to prepare the WAR file that you want to deploy to your Oracle Java Cloud Service instance.
- In Oracle JDeveloper, open the DefaultWorkspace that was created when JDeveloper was installed.
- From the menu, choose File > Open.
Browse to the location where DefaultWorkspace is. In Windows, it is located in the default directory
C:\Users\<User_Name>\AppData\Roaming\JDeveloper. Open the
In the left pane, verify that DefaultWorkspace is opened.
From the File menu, choose Import.
In the Import dialog, scroll down a bit and select WAR File, then click OK.
The Create Project from WAR File, Location page, is displayed. For this tutorial, accept the default project name (Project1) and directory. Click Next .
On the WAR Location page, click Browse to locate the application WAR file. For this tutorial, navigate to the location of
benefits.warand click Open.
Click Next. On the Summary page, click Finish.
Verify that a Web Application Project,
Project1is created under Projects in the left pane.
You have prepared the WAR file for deploying to Oracle Java Cloud Service.
Deploying the Application to the Oracle Java Cloud Service Instance
In this section, you will learn how to deploy the prepared WAR File to your Oracle Java Cloud Service instance.
In the Projects pane in Oracle JDeveloper, right-click Project1 and select Deploy > benefits.
The Deploy benefits, Deployment Action page, is displayed. Select Deploy to Application Server and click Next.
On the Select Server page, select the application server you want the WAR file to be deployed to. For this tutorial, select ServerInstance1 and click Next.
On the WebLogic Options page, select Deploy to selected instances in the domain. Select the cluster name in your Oracle Java Cloud Service instance (for example,
MyServic_cluster). Verify that Deploy as a standalone Application is selected. Click Next.
On the Summary page, verify the values and click Finish.
In the Log pane, verify that
Deploying benefitsis in progress. Verify also that you see the messages
Application Deployed Successfullyand
Note: While Oracle JDeveloper supports deploying to server clusters, you cannot use JDeveloper to deploy to individual managed servers that are members of a cluster.
Verifying the Application Deployment
After the application is deployed, you will learn how to verify if the deployment has been successful. Since you have deployed the application on the cluster, you will verify it using the IP address of the load balancer that was configured for your Oracle Java Cloud Service instance.
Sign in to the My Services application by clicking the link in your Welcome email. Or, you can go to http://cloud.oracle.com, click Sign In, and select the Public Cloud Services value for your region from the My Services Data Center dropdown list. Either way you must provide an identity domain, user name, and password to sign in.
When logged in, you will see the My Services Dashboard or a cloud service console.
If necessary, from the navigation menu at the top of the page, choose Oracle Java Cloud Service.
The Oracle Java Cloud Service Console is displayed.
On your Oracle Java Cloud Service Console, click the name of the service instance to which the application was deployed.
The service instance Overview page is displayed, showing details about the instance.
On the Overview page, copy the IP address of the load balancer configured for your service instance.
Enter the URL,
https://IP_load_balancer:443/benefitsin a web browser.
Verify that you see the benefits application.
Note: 443 is the default HTTPS user access port.
You have successfully deployed the application using Oracle JDeveloper.
Undeploying the Application
In Oracle JDeveloper, navigate to the Application Servers pane.
Under the application server connection you created (for example, ServerInstance1), expand Deployments.
Find the application that you want to undeploy (for example, benefits). Right-click the application and select Undeploy. When prompted, click Yes to confirm you want to undeploy.
In the Log pane, verify you see the message:
Application Undeployed Successfully. You have undeployed the application.
Note: If you see the message
The task cannot be processed further until the current edit session is activated. When this occurs, task processing will continue.
The user can exit the deployer tool without affecting the task, log in to the WebLogic Server Administration Console using the URL
http://localhost:9001/console. When prompted, supply the user name and password you specified for the WebLogic administrator when you created the service instance. See that you click Activate Changes.