1_adf deployment guide how-to install & configure weblogic server to run adf 11g applications in...

7/24/13 How-To: ADF Deployment Guide

www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html 1/64

ADF Deployment Guide: How-To Install & ConfigureWebLogic Server to Run ADF 11g Applications in Production

An Oracle JDeveloper How-To Document

Written by Dana Singleterry, Oracle Corporation

March, 2011

Introduction

This How-To Document details a step-by-step process for creating a deployment environment for Application Development Framework

(ADF) applications. Included are steps to follow in creating a managed server, applying the Java Runtime Files (JRF) for the ADF, creation of

the Web Tier (HTTP Server and WebCache) and then tuning elements for your ADF application that will provide for better performance.

Note that this How-To assumes a Windows Server so unless otherwise stated, starting and stopping of WebLogic takes place from the

Windows Start Menu although this can also occur from the command prompt and invoking the startWebLogic.cmd. The details here canalso be used on a Linux Server with some minor variations.

In addition, while most of the images in this How-To illustrate WebLogic Server 10.3.3, Application Development Runtime (ADR) 11.1.1.3.0,

JDeveloper 11.1.1.3.0, etc... where appropriate the most recent version and differences in the process will be outlined. The Appendix alsoprovides a step by step approach for both Application Development Runtime (ADR) 11g (11.1.1.4.0) and 11g (11.1.1.3.0).

Note: The Optional sections in the Table of Contents below are separate files so if printing the document for reference, be sure to print the

Optional sections as well.

Requirements

Download and Install WebLogic Server

Download and Install Application Development Runtime (ADR)

Create a WebLogic Domain With a Managed Server

Apply Java Runtime Files (JRF) to the Managed ServerOptional: Download and Install Web Tier Utilities

Optional: Configure Web Tier Utilities

JDeveloper 11g: Utilized for development, configuration, & deployment of sample applicationOptional: Download and Review ADF Application (web.xml and adf-config.xml configuration for Caching/Compression)

Create a connection to the Managed Server

Configure a JDBC Data Source

Deploy ADF Application to the Managed Server

Optional: Configure HTTP Server and Set Additional Performance Parameters Within WebCache

Test ADF Application and Analyze Logs for Performance EnhancementsAppendix

Outlined process and downloads for Application Development Runtime (ADR) 11.1.1.4.0

Outlined process and downloads for Application Development Runtime (ADR) 11.1.1.3.0

Documentation

Requirements

WebLogic Server

Application Development Runtime

Oracle Web Tier

Oracle JDeveloper

Java JDK 6

Oracle Database XE

Sample ApplicationSchema


http://blogs.oracle.com/dana

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#1





http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wtu.html

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/cwtu.html


http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/appconfig.html

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#8b

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#8c

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#8d

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/fcwtu.html



http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#11a

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#11b

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#11c

http://www.oracle.com/technetwork/middleware/fusion-middleware/downloads/index.html

http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html


http://www.oracle.com/technetwork/developer-tools/jdev/downloads/index.html

http://www.oracle.com/technetwork/java/javase/downloads/index.html

http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/downloads/HousesDemo.zip

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/downloads/mls.dmp




In this section the download and install of Oracle WebLogic Server will be described. Go to the Fusion Middleware 11g Download Page.

Note: If creating a Managed Server for a ADR 11.1.1.4.0 installation, then select 11gR1 product specific download pages (shown above) |find WebLogic Server download under the Middleware section and download "Oracle WebLogic Server 11gR1 (10.3.4) + Coherence -

Package Installer".

Referring to the main For Deployment page above, select See All | Accept the License Agreement and select WebLogic Server 10.3.3 All

Available Platforms.

Download the second option "Oracle WebLogic Server 11gR1 (10.3.3) + Coherence - Package Installer".

Run the Installer by double-clicking on the downloaded package wls1033_win32.exe. Select Next to continue.

Create a new Middleware Home directory and name it as desired. Select Next to continue.




It is recommended, but not required, that you register for security updates. Enter your Oracle Support Account credentials. Select Next tocontinue.

Select Custom installation. Select Next to continue.



This is the defaul list of products and components for the installation. For the purposes of this How-To, not all are necessary. Select Next tocontinue.



Deselect the following products and components.

Server ExamplesEvaluation Database

Oracle Coherence

Select Next to continue.



Both JDKs may be installed by default such that when creating a WebLogic domain, it may be configured in a development mode with the

recommended Sun JDK or in a production mode with the recommended JRockit JDK. Select Next to continue.

Go with the default product installation directories or change as desired. Select Next to continue.



Install the Node Manager Service for remote management and monitoring as needed. This can also be started manually if preferred. SelectNext to continue.

Choose Shortcut location as desired. Select Next to continue.



Installation Summary. Select Next to continue.

The installer runs.



Completed installation. No need to run Quickstart at this point as the WebLogic domain will be created in a later step. Select Done whencomplete.



Download and Install Application Development Runtime(ADR)

The Application Development Runtime (ADR) is used to extend a Java EE server (WebLogic or WebSphere) with the ADF Runtime libraries.This prepares the server to accept the deployment of ADF based applications and hence the running of said applications.

In this section the download and install of the ADR 11g will be described. Go to the Oracle ADF Download Page. The first step wil be todownload and install ADF 11.1.1.2.0 follwed by upgrading the install to ADF 11.1.1.3.0.

Note: If creating a Managed Server for ADR 11.1.1.4.0 installtion, then download "ADR 11.1.1.4.0". This is an independent installation thatdoes not get installed over earlier versions.

Accept the License Agreement and download ADR 11.1.1.2.0. This is an independent installation that does not get installed over earlierversions.

After downloading ADR (11.1.1.2.0) , download the ADR (11.1.1.3.0) which is a patch set that will need to be installed on top of 11.1.1.2.0and can be done immediately thereafter.

Install the ADR (11.1.1.2.0). Unzip the ADR (11.1.1.2.0) installation using the archive tool of choice.

After unzipping the archive, run the setup utility, setup.exe.

The setup utility will start and the reader will be prompted to specify their JRE/JDK location. JDK 6 is required for this installation and is

assumed to already be installed.

Follow the wizard instructions. Select Next to continue on the Welcome Screen.




A series of Prerequisite Checks will take place to ensure requirements are met. Once verified, select NEXT to continue.



Specify the installation location, this is the WebLogic installation home utilized earlier when installing WebLogic Server, for the ADR and select

Next to continue.



Review the Installation Summary and Save the Response File for reference. If necessary, the reader can select Back to make revisions or

select the topic to change to jump to that location. Once ready, select Install to continue.

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/resources/adr11112_response_file.txt



After selecting Install in the previous step, installation will begin and a Progress bar will provide the status of the installation. Select Next to

complete the installation.

A Installation Complete summary screen will be provided and the reader will have the option to Save the Installation Details for reference.

Select Finish to exit.

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/resources/adr11112_install_results_file.txt



Install the ADR (11.1.1.3.0) on top of ADR 11.1.1.2.0. Unzip the ADR (11.1.1.3.0) installation using the archive tool of choice.

After unzipping the archive, run the setup utility, setup.exe.

The setup utility will start and the reader will be prompted to specify your JRE/JDK location. JDK 6 is required for this installation. As before,

JDK 6 is assumed to be installed.



Follow the wizard instructions. Select the Next buton on the Welcome Screen.

Specify the installation location (i.e. this is the same Oracle Middleware Home as specified for the ADR 11.1.1.2.0 install completed

previously) for the ADR and the select Next to continue.



Review the Installation Summary and Save the Response File for reference. If necessary, the reader can select Back to make revisions or

select the topic to change to jump to that location. Once ready, select Install to continue.

After selecting Install in the previous step, installation will begin and a Progress bar will provide the status of the installation.

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/resources/adr11113_response_file.txt



An Installation Complete summary screen will be provided and the reader will have the option to Save the Installation Summary for reference.

Select Finish to exit.

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/resources/adr11113_install_results_file.txt



Create a WebLogic Domain with a Managed Server

After installing the ADR 11.1.1.2.0 and 11.1.1.3.0 respectively , or 11.1.1.4.0 for the most recent version, the reader will have an option in

their Start Menu to Configure the Application Server. Select this option.

Once the "Oracle Fusion Middleware Configuration Wizard" launches, select "Create a new WebLogic domain" followed by selecting Next to

continue.



In this step select "Generate a domain configured automatically to support the following products:" and select the following options:

Oracle Enterprise Manager - 11.1.1.0 [oracle_common]

Oracle JRF - 11.1.1.0 [oracle_common]




Specify a Domain name such as adf_domain and the Domain Location should be the location of the WebLogic Server Middleware Homeinstall performed earlier. Specifically, this will default to the correct location based on the prior steps of this How-To. Select Next to continue.

Provide the Administrator User Name and Password. NOTE: These credentials will be used later for the Administrator console and Enterprise

Manager, etc. so keep them secure.



This How-To demonstrates one possible production configuration so in "Configure Server Start Mode and JDK", be sure to select"Production Mode" and the JRockit SDK from the "Available JDKs" window. Select Next to continue.



On the "Select Optional Configuration" screen, select "Administration Server" and "Managed Servers, Clusters and Machines". Select Next tocontinue.



On the "Configure the Administration Server" screen, the options are left at their defaults. Know that they can be changed as required. Select

Next to continue.



On the "Configure Managed Servers" screen, select the Add option and enter the credentials as outlined below. Know that these are

suggestions and the reader can change these as desired. Select Next to continue.

This How-To does not demonstrate Clustering so select Next to continue.



On the the "Configure Machines" screen, select Add to create a machine with the details provided here. Know that the reader can change

these as required. Select Next to continue.



On the "Assign Servers to Machines" screen, select a machine in the right pane, only ADFMachine in this case, and then select the ADFServer

in the left pane and shuttle it to the right. This assisgns the ADFServer to the ADFMachine for purposes of management. Select Next to

continue.



The next few screens shows a Configuration Summary WebLogic Domain and Managed Server that is being Created. In the drop down,

select "Deployment" to inspect its attributes in the Details pane.

In the drop down, select "Application" to inspect its attributes in the Details pane.



In the drop down, select "Summary" to inspect its attributes in the Details pane.



In the drop down, select "Machine" to inspect its attributes in the Details pane. Select Create to create the domain and the managed server.



The adf_domain is created along with the manged server. The Admin Server will be started in future step so deselect the "Start Admin Server"

option and select Done to complete the configuration.



Verify the Windows Service NodeManger is running.

The new domain is created and the summary provided. At this point, the Administration Server can be started. This can also be started via

the command line for Windows or Linux (i.e...\Oracle\WlsStandalone\user_projects\domains\adf_domain\bin\startWeblogic.cmd).

Start the Admin Server for the adf_domain.

A terminal window will open and prompt the reader for the WebLogic Server username and password. This is the uid/pwd that was used

when creating the adf_domain earlier.

Once the WebLogic Server is running, log into the WebLogic Server Administration Console (http://localhost:7001/console) to assess the

server status and to perform further configuration as required. This is the uid/pwd that was provided when creating the adf_domain earlier.



As can be seen in this view, the AdminServer is running but the ADFServer is not. This can be automated as needed. In this case, the reader

will have to start the ADFServer manually.



Select the Control tab followed by checking the box for the ADFServer and then select Start.



Select Yes on the Server Life Cycle Assistant screen to start the ADFServer.



The Summary of Servers screen will indicate that the ADF Server state is RUNNING once the start task is complete.

Select the Deployments to review application and modules that have been installed to the adf_domain.



Apply Java Runtime Files (JRF) Template to the ManagedServer

Now that the ADFServer has been started, the reader will need to apply the JRF Template to the Managed Server in order to deploy and run

their ADF applications on the server. In an earlier step, the ADR libraries (required libraries to run an ADF application on WebLogic orWebSphere) were installed and the Managed Server was created. When the JRF Template is applied to the Managed Server, the ADR

libraries ared added to that server in order to run ADF based applications. This can also be done via command line invocation or through

Oracle Enterprise Manager as demonstrated here.

Launch a web browser and enter the url for Enterprise Manager: http://localhost:7001/em. If a different port for the AdminServer has been

used, then simply replace it with the one supplied here. This also applies to the host name. Use the same credentials (uid/pwd) here that was

used during creation of the adf_domain earlier. These credentials are also the same as used to login to the Administration Server.



Once the reader has successfully authenticated into Oracle Enterprise Manager, expand the nodes for the domain and select the ADFServer

created earlier. Notice an option "Apply JRF Template". Select the option "Apply JRF Template".



Upon success, a Confirmation response will be provided indicating the JRF Template has been successfully applied to the ADFServer. Also

review a summary of the server state along with default Application Deployments.



At the bottom of the Oracle Enterprise Manager Summary Screen, the reader can also review a list of default Servlets and JSPs available

within the server.

JDeveloper 11g: Utilized for Development, Configuration, &Deployment of Sample Application

This section describes the use of JDeveloper to optimize an ADF Application for deployment. The reader will also configure a WebLogic

Server datasource, create a connection to the WebLogic Server and deploy the sample application to the Managed Server. This How-To

leverages JDeveloper 11g 11.1.1.3.0, however, the most current version of Oracle JDeveloper 11g, which is 11.1.1.4.0, can also be used

without any significant differences. If not already done, download and install Oracle JDeveloper 11g from the download page. Go to archivesat the bottom of the download page to get JDeveloper 11g (11.1.1.3.0) . See Appendix below for process and required software when using

ADR 11g 11.1.1.4.0. After downloading JDeveloper, start the installer and follow the instructions within the Wizard. For specific JDeveloper

installation instructions, the reader can refer to the Installation Guide for Oracle JDeveloper.

Create a connection within JDeveloper to the Managed Server

One way to deploy your applications is through the use of JDeveloper by creating a connection to the Server of choice and deploying directly.

Another method would be to create an Enterprise Archive and then deploy that archive through the WebLogic Server Administration Console.

In this How-To, deployment will take place directly from within JDeveloper. Regardless of using JDeveloper 11g 11.1.1.3.0 or 11.1.1.4.0,

the process is the same.

In the View Menu of JDeveloper select Application Server Navigator.

Right select on Application Server and select "New Application Server..." from context.

http://www.oracle.com/technetwork/developer-tools/jdev/downloads/index.html

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html#11a

http://download.oracle.com/docs/cd/E17904_01/install.1111/e13666/toc.htm



Select to Create a connection to a Standalone Server. Select Next to continue.

Provide an appropriate name for the Connection. For Connection Type select WebLogic 10.3. Select Next to continue.



Provide the credentials (uid/pwd) that were created during the configuration of the Managed Server earlier in this How-To. Select Next to

continue.



Provide the Weblogic Hostname, Port, and domain that are required for this configuration. Select Next to continue.

Test the Connection. If all tests are successful, select Next to continue.



Select Finish to complete the creation of tthe connection to the Managed Server.



Drill into the Application Server connection to review the details.

Configure a JDBC Data Source

It is considered best practice to take advantage of the data-source capabilities of the application server being utilized. In this case that is

WebLogic Server. In order to do this with an ADF application, it is easy to edit the ADF Business Components (BCs) application module

configuration and modify the connection so that it is based on a JDBC Data Source instead of a direct JDBC connection.

Right select on the Application Module for project leveraging Business Components for persistence.

Change the connection type to JDBC datasource for both the AppModuleLocal and AppModuleShared by selecting the Edit Icon and

making the appropriate changes to each configuration respectively.



For Connection Type, select JDBC DataSource.

Go with the Data Source Name that is provided and then follow the same process and change the datasource for the AppModuleShared

Business Component Configuration Name for consistency.



Note: After this modification, if not already completed, create the mls user in the database and load the database schema provided. As used

here the user mls is created and the mls dmp file is loaded by running imp at the command line within Windows. Go with the defaults that are

provided via the Oracle database import utility. A similar process should be completed for other Operating Systems.

Go to the WebLogic Server Adminstration Console (http://localhost:7001/console) and define a datasource. Use the credentials (uid/pwd)

that were supplied during the creation of the Managed Server. In this case, the jndi name must be jdbc/mlsDS.

Go to the Domain Selection Section | JDBC | Data Sources on the main page of the Administration Console.



Select Lock & Edit to lock the server for configuration purposes.



Select New to create a new datasource and supply the following parameters. Select Next to continue.



Choose the Database Driver of choice as required. In this How-To, *Oracle's Driver (Thin) for Instance connections is used. Select Next to

continue.

The defaults for Support of Global Transaction and One-Phase Commit are used in this part of datasource creation. Configure as required.




Provide the database connection credentials specific to the application. In this How-To, use the credentials provided here. Be sure to use the

database uid/pwd that was used when loading the mls schema. Select Next to continue.



Select Test Configuration to ensure that the datasource credentials provided are valid. The message "Connection test succeeded" is the valid

response. Select Next to continue.



Select the Target Server for this new JDBC Data Source. In this case that is the ADFServer. Select Finish to complete the creation of the

JDBC Data Source and to assign that datasource to a Server Target.



The Summary of the JDBC Data Sources is provided.

Be sure to select Activate Changes for the new JDBC Data Source that was created.



Deploy ADF Application to the Managed Server

Prior to deploying the sample ADF application it's necessary to take a look at the deployment profile. Right select on the ViewController in the

application navigator and select Project Properties.



Select Deployment and the Deployment Profile Provided followed by Edit to review the deployment profile.



Provide a uniques Java EE Web Copntext Root name. In this case and in the sample application, housesdemo is used. Select OK followed by

OK again to save the configuration.

Right select on the HousesDemo workspace and select Deploy from context followed by the HousesDemo application.



Select Deploy to Application Server. Select Next to continue.

Select the Application Server connection that was created earlier. Select Next to continue.



Select Deploy to selected instances in the domain and select the ADFServer to deploy to. Select Next to continue.



Review the Deployment Summary and when satisfied, select Finish to begin the deployment.



The Message log will provide the details of the compilation.

The Deployment log will provide indication of a successful deployment.

Back in the Application Server Navigator, expand Deployments to see that the HousesDemo is actually deployed to the server.

Log into the Administration Console (http://localhost:7001/console), expand Environments, select Servers followed by ADF Server, then

select Deployments to see that HousesDemo application is deployed to the ADFServer instance and is Active.



Test ADF Application and Analyze Logs for PerformanceEnhancements

To test the application, if the optional installation and configuration for Web Tier was performed, go to

http://localhost:7777/housesdemo/faces/houses.jspx where port 7777 referes to the HTTP server. If the optional installation and

configuration of Web Tier was not performed then go to http://localhost:7002/housesdemo/faces/houses.jspx where port 7002 refers to

the port that was set for the Managed Server ADFServer. Work with the demo application as much as desired but do a simple test as

provided here. Using the browser of choice, access the main page. Then, open the HTTP server access.log either through Oracle Enterprise

Manager or via the file system (...\Oracle\WlsStandalone\Oracle_WT1\instances\instance_adf\diagnostics\logs\OHS\ohs_adf).

.



.

At first glance of the Oracle HTTP Server access.log, the reader will notice 8 jpg hits. The complete file (access.log) for these two sessions

can be viewed at once for an easy comparison. These images were cached on first access.

Looking at the second part of the log, notice a new session id, where a second browser instance was created and the same page accessed.

This time, since the .jpg images were cached, there is no get for them. This is but one performance improvement that is apparent.

Appendix

The details within provide a short summary that outlines the basic steps for configuring a Managed Server utilizing ADR 11.1.1.4.0 as well as

http://www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/resources/access_log



The details within provide a short summary that outlines the basic steps for configuring a Managed Server utilizing ADR 11.1.1.4.0 as well as

ADR 11.1.1.3.0. Within each table links are provided for the appropriate download as well as supporting documentation. Additionaldocumentaition is provided in the final table for further reading regarding the various utilities used in the How-To document.

Outlined process and downloads for ADR 11.1.1.4.0

The following table provide an outline of the steps required to configure a Manged Server for ADR 11.1.1.4.0.

Download and Install WebLogic

Server 10.3.4

Download and Install ADR

11.1.1.4.0

Create a WebLogic Domain

With a Managed Server

Apply JRF Template to the

Managed Server

Download and Install Web Tier

Utilities 11.1.1.4.0

Configure HTTP Server and Set

Performance Parameters Within

WebCache

Outlined process and downloads for ADR 11.1.1.3.0

The following table provides an outline of the steps required to configure a Manged Server for ADR 11.1.1.3.0.

Download and Install WebLogic

Server 10.3.3


11.1.1.2.0


11.1.1.3.0

Create a WebLogic Domain

With a Managed Server

Apply JRF Template to the

Managed Server


Utilities 11.1.1.2.0


Utilities 11.1.1.3.0 Patchset

Configure HTTP Server and Set

Performance Parameters Within

WebCache

Documentation

The following table provides links to documentation used in the How-To.

Oracle WebLogic Server

Oracle ADR

Oracle Web Tier Utilities

Oracle JDeveloper

http://www.oracle.com/technetwork/middleware/weblogic/downloads/wls-main-097127.html


http://www.oracle.com/technetwork/java/webtier/downloads/index.html

http://www.oracle.com/technetwork/middleware/downloads/fmw-11-download-092893.html





http://www.oracle.com/technetwork/middleware/weblogic/documentation/index.html

http://www.oracle.com/technetwork/developer-tools/adf/documentation/index.html

http://www.oracle.com/technetwork/java/webtier/documentation/index.html

http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.html

1_adf deployment guide how-to install & configure weblogic server to run adf 11g applications in...

Documents