1 - ADF Deployment Guide How-To Install & Configure WebLogic Server To Run ADF 11g Applications in Production

7/24/13
How-To: ADF Deployment Guide
ADF Deployment Guide: How-To Install & Configure WebLogic 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 can also 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 also provides 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 Server Optional: Download and Install Web Tier Utilities Optional: Configure Web Tier Utilities JDeveloper 11g: Utilized for development, configuration, & deployment of sample application Optional: 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 Enhancements Appendix 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 Application Schema
www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html
Download and Install WebLogic Server
1/64
7/24/13
Download and Install WebLogic Server

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.
2/64
7/24/13
It is recommended, but not required, that you register for security updates. Enter your Oracle Support Account credentials. Select Next to continue.
Select Custom installation. Select Next to continue.
3/64
7/24/13
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 to continue.
4/64
7/24/13
Deselect the following products and components. Server Examples Evaluation Database Oracle Coherence Select Next to continue.
5/64
7/24/13
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.
6/64
7/24/13
Install the Node Manager Service for remote management and monitoring as needed. This can also be started manually if preferred. Select Next to continue.
Choose Shortcut location as desired. Select Next to continue.
7/64
7/24/13
Installation Summary. Select Next to continue.
The installer runs.
8/64
7/24/13
Completed installation. No need to run Quickstart at this point as the WebLogic domain will be created in a later step. Select Done when complete.
9/64
7/24/13
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 to download 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 that does 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 earlier versions. 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.0 and 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.
10/64
7/24/13
A series of Prerequisite Checks will take place to ensure requirements are met. Once verified, select NEXT to continue.
11/64
7/24/13
Specify the installation location, this is the WebLogic installation home utilized earlier when installing WebLogic Server, for the ADR and select Next to continue.
12/64
7/24/13
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.
13/64
7/24/13
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.
14/64
7/24/13
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.
15/64
7/24/13
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.
16/64
7/24/13
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.
17/64
7/24/13
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.
18/64
7/24/13
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.
19/64
7/24/13
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] Select Next to continue.
20/64
7/24/13
Specify a Domain name such as adf_domain and the Domain Location should be the location of the WebLogic Server Middleware Home install 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.
21/64
7/24/13
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.
22/64
7/24/13
On the "Select Optional Configuration" screen, select "Administration Server" and "Managed Servers, Clusters and Machines". Select Next to continue.
23/64
7/24/13
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.
24/64
7/24/13
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.
25/64
7/24/13
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.
26/64
7/24/13
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.
27/64
7/24/13
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.
28/64
7/24/13
In the drop down, select "Summary" to inspect its attributes in the Details pane.
29/64
7/24/13
In the drop down, select "Machine" to inspect its attributes in the Details pane. Select Create to create the domain and the managed server.
30/64
7/24/13
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.
31/64
7/24/13
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.
32/64
7/24/13
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.
33/64
7/24/13
Select the Control tab followed by checking the box for the ADFServer and then select Start.
34/64
7/24/13
Select Yes on the Server Life Cycle Assistant screen to start the ADFServer.
35/64
7/24/13
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.
36/64
7/24/13
Apply Java Runtime Files (JRF) Template to the Managed Server

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 or WebSphere) 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.
37/64
7/24/13
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".
38/64
7/24/13
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.
39/64
7/24/13
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 archives at 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.
40/64
7/24/13
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.
41/64
7/24/13
Provide the credentials (uid/pwd) that were created during the configuration of the Managed Server earlier in this How-To. Select Next to continue.
42/64
7/24/13
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.
43/64
7/24/13
Select Finish to complete the creation of tthe connection to the Managed Server.
44/64
7/24/13
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.
45/64
7/24/13
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.
www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html 46/64
7/24/13
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.
47/64
7/24/13
Select Lock & Edit to lock the server for configuration purposes.
48/64
7/24/13
Select New to create a new datasource and supply the following parameters. Select Next to continue.
49/64
7/24/13
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. Select Next to continue.
50/64
7/24/13
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.
51/64
7/24/13
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.
52/64
7/24/13
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.
53/64
7/24/13
The Summary of the JDBC Data Sources is provided.
Be sure to select Activate Changes for the new JDBC Data Source that was created.
54/64
7/24/13
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.
55/64
7/24/13
Select Deployment and the Deployment Profile Provided followed by Edit to review the deployment profile.
56/64
7/24/13
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.
57/64
7/24/13
Select Deploy to Application Server. Select Next to continue.
Select the Application Server connection that was created earlier. Select Next to continue.
58/64
7/24/13
Select Deploy to selected instances in the domain and select the ADFServer to deploy to. Select Next to continue.
59/64
7/24/13
Review the Deployment Summary and when satisfied, select Finish to begin the deployment.
60/64
7/24/13
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.
61/64
7/24/13
Test ADF Application and Analyze Logs for Performance Enhancements

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).
62/64
7/24/13
. 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
www.oracle.com/webfolder/technetwork/jdeveloper/howto/11114/managedserver/wlsadfms.html 63/64
7/24/13
How-To: ADF Deployment Guide 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. Additional documentaition 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 Download and Install ADR 11.1.1.2.0 Download and Install ADR 11.1.1.3.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.2.0 Download and Install Web Tier 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
64/64

1 - ADF Deployment Guide How-To Install & Configure WebLogic Server To Run ADF 11g Applications in Production

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

1 - ADF Deployment Guide How-To Install & Configure WebLogic Server To Run ADF 11g Applications in Production

Transféré par

Droits d'auteur :

Formats disponibles

7/24/13

How-To: ADF Deployment Guide

Download and Install WebLogic Server

Download and Install WebLogic Server

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Select Custom installation. Select Next to continue.

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Choose Shortcut location as desired. Select Next to continue.

How-To: ADF Deployment Guide

Installation Summary. Select Next to continue.

The installer runs.

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Download and Install Application Development Runtime (ADR)

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

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

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

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Create a WebLogic Domain with a Managed Server

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

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

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Verify the Windows Service NodeManger is running.

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Apply Java Runtime Files (JRF) Template to the Managed Server

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Create a connection within JDeveloper to the Managed Server

How-To: ADF Deployment Guide

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

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

How-To: ADF Deployment Guide

Drill into the Application Server connection to review the details.

Configure a JDBC Data Source