Adding and Configuring a Web Application

OBE Home > Grid Control > Installation > Web Application

Adding and Configuring a Web Application

Purpose

This lesson shows you how to add and configure a Web Application so that it can be monitored using Enterprise Manager 10g Grid Control.

Topics

This module will discuss the following topics:

	Overview
	Prerequisites
	Creating a New Web Application
	Adding a Beacon
	Associating the Beacon with your Web Application
	Defining Availability
	Configuring Web Application OC4J
	Configuring Web Application Web Caches
	Adding a Watch List
	Creating a Transaction

Viewing Screenshots

Place the cursor on this icon to display all screenshots. You can also place the cursor on each icon to see only the screenshot associated with it.

Overview

Back to List

Web applications consist of multiple components, such as:

	A backend database that provides the data for your application
	Various middle-tier components that provide performance improvements, such as Oracle Web Cache
	Application server components that you use to develop and deploy your custom applications, such as Oracle Containers for J2EE (OC4J), or Oracle HTTP Server
	The hardware used to control load balancing and switching on the network

Oracle Enterprise Manager provides all the tools you need to manage each of these component types. Creating a Web Application target allows you to combine the individual components of a Web application into a single managed target. You measure the availability and response time of the target using Application Performance Management.

Prerequisites

Back to List

Before starting this module, you should have:

1.	Reviewed and fulfilled the requirements in the PreInstallation Considerations section of the Oracle Enterprise Manager Grid Control Installation and Basic Configuration 10g Release 1 (10.1) Documentation.
2.	Complete the Installing Enterprise Manager 10g Grid Control Using a New Database lesson.
3.	Complete the Installing the Oracle Database 10g lesson.
4.	Complete the first three lessons in Installing the Application Server 10g.
5.	Complete the Deploying the Enterprise Manager 10g Linux Management Agent lesson on each host machine.
6.	Complete the Postinstallation Configuration lesson.
7.	Complete the Managing Admnistrators Preferences lesson.
8.	Complete the Deploying the FAQ OC4J Application lesson.

Creating a New Web Application

Back to Topic List

Before you deploy the FAQ application, you will need to create the database user. Perform the following steps:

1.	Open your browser and enter the following URL: http://<gridhost>:<webcache port>/em Login as your sysman and click Login.
2.	Click the Targets tab.
3.	Select the Web Applications subtab.
4.	Click Add to add your Web Application.
5.	Enter FAQ Application in the Name field and http://<midtierhostname.domain.com>:<http server listener port>/FAQApp/ as the URL and click Next.
6.	Select the Type Database and click Go. Then select orcl.oracle.com and click Move.
7.	Select the Type OC4J and click Go. Then select midtier.<hostname.domain.com>_home and click Move.
8.	Select the Type Listener and click Go. Then select LISTENER_<hostname.domain.com> and click Move.
9.	Select the Type Host and click Go. Then click Move All.
10.	Select the Type Web Cache and select midtier.<hostname.domain.com>_Web Cache and click Move. Then click Next.
11.	You want to select the monitoring agent which is located on the host where your Grid Control Instance is located. Make sure your grid control host is selected and click Next.
12.	Review your choices and click Finish.
13.	Your Web Application has been created. Now you can create a new beacon for this Web Application. Click on the Management System tab.

Adding a Beacon

Back to Topic List

The Beacon functionality is built into the agent. In order to enable this functionality on the agent, you must go to the agent homepage and discover it as an agent target. In a "production" environment, administrators would enable Beacon functionality on agents that geographically represent user communities. Perform the following steps:

1.	Select the Agents subtab.
2.	Select the Agent where your FAQ Application is deployed.
3.	Under Monitored Targets, select Beacon from the Add pulldown list and click Go.
4.	Enter San Francisco (or the location where the machine is) for the Name and click OK.
5.	Your Beacon has been added. Click OK.

Associating the Beacon with your Web Application

Back to Topic List

Now that an additional Beacon has been enabled, you must associate it with a Web Application. Note: A Beacon can be associated with multiple web applications. Perform the following steps:

1.	Select the Targets tab.
2.	Select the Web Applications subtab.
3.	Select the FAQ Application from the list.
4.	Click the Administration subtab.
5.	Select Manage Beacons.
6.	Click Add/Remove Beacons.
7.	Select San Francisco and click Move.
8.	Select OK twice.
9.	Select the Web Application: FAQ Application breadcrumb.

Defining Availability

Back to Topic List

You must define availability for the Web Application. By default, the homepage URL for the application is this determinant. The local Beacon checks to see if the URL is available. Typically, you will probably want to add additional beacons to verify availability from the other Beacon locations. Perform the following steps:

Select Define Availability.

Select San Francisco and click Apply.

Configuring Web Application OC4Js

Back to Topic List

In order to capture interactive trace and middle tier page performance data, you must configure the Web Application's OC4J(s). Perform the following steps:

1.	Select Configure Web Application OC4Js.
2.	Click the Collecting checkbox, enter 5 for the Interval and click Enable Logging.
3.	Enter ias_admin/<password> and click OK.
4.	Click the Enable JDBC/SQL Performance Details, Enable Interactive Trace and Enable Historial Trace checkboxes and click Apply.
5.	Your request is being processed.
6.	Once your changes have been saved, click Yes to restart the OC4J server.
7.	Your instance is being restarted.
8.	Once your instance has been restarted, click OK. Then close the window to return to your Enterprise Manager Grid Control window.
9.	Click Apply to Configure your Web Application OC4Js.
10.	Click Apply again to proceed.
11.	Select the Web Application: FAQ Application breadcrumb.

Configuring Web Application Web Caches

Back to Topic List

To capture end-user response time data, an administrator must configure the Web Application's Web Cache(s). Perform the following steps:

1.	Select Configure Web Application Web Caches.
2.	Click the Collecting checkbox, enter 5 for the Interval and click Enable Logging.
3.	Click Log on to Web Cache Manager.
4.	Enter ias_admin/<password> and click OK.
5.	Scroll down in the left frame.
6.	Under Logging and Diagnostics, select End-User Performance Monitoring.
7.	Under Cache-Specific End-User Performance Monitoring, select your web cache and click Enable.
8.	Under Logging and Diagnostics, select Access Logs.
9 .	Select the access_log filename and click Edit Selected.
10.	Select WCLF as the Format Style and click Submit.
11.	Click Apply Changes.
12.	Under Cache Operations, click Restart.
13.	Once Web Cache has restarted, click OK. Then you can close the Web Cache Manager window.
14.	From Enterprise Manager Grid Control, click Apply.
15.	Click Apply to proceed.
16.	Select the Web Application: FAQ Application breadcrumb.

Adding a Watch List

Back to Topic List

When you configure End-User Response Time Monitoring, Enterprise Manager collects response metrics for every URL accessed by the application end-users. You can use the Watchlist to highlight the response time of specific pages that are particularly important to you. These are the pages you want to monitor to see how quickly they respond when a user visits your site. For example, you might want to collect data on the login page and the home page because these are the pages that provide users with their initial impressions of your site. After you define a watchlist, you can view details about the performance of the URLs you specified in the watchlist. Perform the following steps:

1.	Select Manage Watch List.
2.	Click Add.
3.	Enter Home Page for the Name and /FAQApp/ for the URL and click Submit.
4.	Click Add again.
5.	Enter FAQ Save for the Name and /FAQApp/FAQSave.do for the URL and click Submit.
6.	Your watch list has been created. Select the Web Application: FAQ Application breadcrumb.

Creating a Transaction

Back to Topic List

In order to create additional transactions, you must use the transaction recorder to walk through the desired transaction. After the transaction is created, you will activate monitoring. This will push out the transaction to all of the Web Application's associated Beacons. Perform the following steps:

1.	Select Manage Transactions.
2.	Click Create.
3.	Enter addFAQ for Name and add a description. Then click Next.
4.	You will record the transaction. Click Start.
5.	Another window will open. Enter the URL http://<midtierhost>:<http server listener port>/FAQApp. At the login screen enter faq/faq and click OK.
6.	The FAQApp homepage appears. Click Create a New FAQ.
7.	Add a FAQ question.
8.	Switch back to the Manage Transaction window and click Stop.
9.	To view the transaction, click Verify. The recording results will be played.
10.	Click Next.
11.	You see the list of requests made in the transaction. Click Next.
12.	For Settings, change the following and click Next. Slowest Page Response: Warning Threshold: 2 Slowest Page Response: Critical Threshold to 4 Realm: faqrealm Username: faq Password: faq
13.	Click Finish.
14.	You want to start the transaction. Click Start.
15.	Your transaction has been started for all the beacons that you have defined and made available. Click OK.
16.	To play a transaction, select the transaction and click Play.
17.	The transaction will play. Select the Web Application: FAQ Application breadcrumb.

OBE Home > Grid Control > Installation > Web Application