11 Configuring Enterprise Manager to Manage Application Server Infrastructure Targets

This chapter describes how to configure Oracle Enterprise Manager Grid Control to manage Application Server Infrastructure targets for Oracle Collaboration Suite Release 1 and 2.

Note:

See the chapters in Part I of this manual for information on configuring Grid Control to manage Oracle Collaboration Suite 10g Release 1 targets.

All Oracle Collaboration Suite components rely upon the Oracle Application Server Infrastructure. Specifically, Oracle Collaboration Suite components depend upon Oracle Internet Directory and Oracle Application Server Single Sign-On, which are installed as part of an Oracle Application Server Infrastructure installation.

For more information about installing Oracle Application Server Infrastructure for Oracle Collaboration Suite Release 2, see Oracle Collaboration Suite Installation and Configuration Guide for Oracle Collaboration Suite Release 2 at:

http://www.oracle.com/technology/documentation/collab.html

This chapter contains the following sections:

• Prerequisites Before Configuring Grid Control for Oracle Application Server Infrastructure Targets

• Overview of Oracle Application Server Infrastructure Target Types

• Creating the LDAP Server Target

• Creating the Single Sign-On (SSO) Server Target

• Creating the OID Client Target

• Creating a Single Sign-On Web Application Target

• Creating the Identity Management Group Target

11.1 Prerequisites Before Configuring Grid Control for Oracle Application Server Infrastructure Targets

The configuration steps in this chapter assume that:

• You have installed and configured Oracle Application Server Infrastructure installation type as a prerequisite for installing Oracle Collaboration Suite.

• You have installed and configured Oracle Enterprise Manager 10g Grid Control.

  As part of installing and configuring Grid Control, you should have also installed the Oracle Management Agent on the Oracle Collaboration Suite host computers.

  See Also:

  "About Local and Remote Monitoring with the Management Agent" for information about specific cases where the Oracle Management Agent can be installed on a system other than an Oracle Collaboration Suite component host.

• You have detailed knowledge of the Oracle Application Server Infrastructure components configured and where the different Oracle Application Server Infrastructure servers are running.

11.2 Overview of Oracle Application Server Infrastructure Target Types

Oracle Application Server Infrastructure is installed as a set of services spread over hosts and databases. When you configure Grid Control to manage Oracle Application Server Infrastructure, you create the following targets:

• One LDAP Server target for each Oracle Internet Directory (OID) node, which includes one OID server and one OID database.

• One Oracle Application Server Single Sign-On (SSO) target for each instance of the SSO server

• One OID Client target co-located with each Oracle Collaboration Suite component

• One SSO Web Application with representative transactions

• Related Host, Database, and Listener targets

11.2.1 About the OID Client Target

The OID Client target uses a Perl script on the Agent to monitor performance and availability by simulating usage by the other Oracle Collaboration Suite components. As a result, you should have one such target for each configured component that relies upon connections to the Oracle Internet Directory. Alternatively, to avoid configuring too many OID Client targets, you can create OID Client targets for the representative Oracle Email components on your network.

11.2.2 About Discovery of the Oracle Application Server Infrastructure Targets

The LDAP Server targets and SSO targets can be discovered automatically by the Oracle Management Agent, or you can create the targets, depending on their configuration.

See Also:

"About Local and Remote Monitoring with the Management Agent"

The OID client and SSO Web application targets must be explicitly created.

11.3 Creating the LDAP Server Target

There are two ways to add an LDAP Server target to the Grid Control Console:

• Automatically Discovering the LDAP Server as Part of an Existing Oracle Application Server Installation

• Manually Adding the LDAP Server Target

11.3.1 Automatically Discovering the LDAP Server as Part of an Existing Oracle Application Server Installation

The LDAP Server (Oracle Internet Directory) is part of the Oracle Application Server Infrastructure installation.

When you add the Application Server target (or when it is automatically discovered by the Management Agent), Enterprise Manager discovers all the components of the Oracle Application Server instance, including the Oracle Internet Directory component.

As a result, if the Infrastructure installation is on the same machine as the LDAP Server target that you want to configure, the LDAP Server target automatically appears in the Grid Control Console when the Application Server target is discovered by the Management Agent.

11.3.2 Manually Adding the LDAP Server Target

To manually create an LDAP Server target:

1. Using the Grid Control Console, navigate to the Management Agent home page for the Management Agent that was installed on the Oracle Application Server Infrastructure host.

2. In the Monitored Targets section of the page, select OID LDAP Server from the Add drop-down menu.

   Enterprise Manager displays the property page for the selected target type. Provide the required information as described in Table 11-1.

3. Click OK to create the target.

   See Also:

   "Adding Targets to be Monitored and Administered by Enterprise Manager" in the Enterprise Manager online help

Table 11-1 OID LDAP Server Target Properties

Property	Description
Oracle home path	The Oracle Home of the LDAP Server. This will be used for the LDAP Server connection.
Username	The LDAP server database username for accessing LDAP server database.
Password	The password for the LDAP Server database user account.
OID Connect Descriptor	The connect descriptor used to connect to the LDAP database.
Oracle Application Server Version	The version of the application server installation (for example, 9.0.2)

11.4 Creating the Single Sign-On (SSO) Server Target

There are two ways to add an SSO Server target to the Grid Control Console:

• Automatically Discovering the SSO Server Target as Part of an Existing Oracle Application Server Installation

• Manually Adding the Single Sign-On Server Target

11.4.1 Automatically Discovering the SSO Server Target as Part of an Existing Oracle Application Server Installation

The SSO component is part of the Oracle Application Server Infrastructure installation.

When you add the Application Server target (or when it is automatically discovered by the Management Agent), Enterprise Manager discovers all the components of the Oracle Application Server instance, including the Single Sign-On component.

As a result, if the Infrastructure installation is on the same machine as the Single Sign-On target that you want to configure, the Single Sign-On target automatically appears in the Grid Control Console when the Application Server target is discovered by the Management Agent.

11.4.2 Manually Adding the Single Sign-On Server Target

To manually create an Single Sign-On target:

1. Using the Grid Control Console, navigate to the Management Agent home page for the Management Agent that was installed on the Oracle Application Server Infrastructure host.

2. In the Monitored Targets section of the page, select Single Sign-On Server from the Add drop-down menu.

   Enterprise Manager displays the property page for the selected target type. Provide the required information as described in Table 11-2.

3. Click OK to create the target.

   See Also:

   "Adding Targets to be Monitored and Administered by Enterprise Manager" in the Enterprise Manager online help

Table 11-2 Single Sign-On Server Target Properties

Property	Description
ssServerDAD	The Database Access Descriptor (DAD) name for SSO. For Oracle9i Application Server Release 2 (9.0.2), the DAD is orasso.
OID Rep Schema Name for orasso_PS schema	Enter the name that the Oracle Internet Directory uses to refer to the orasso_PS schema. By default, Oracle Internet Directory uses the name orasso_ps to refer to the schema. The orasso_PS schema is the schema that the Enterprise Manager SQL fetchlet uses to obtain Single Sign-On logon statistics from the database.
OracleHome	The Oracle Home for the Single Sign-On Server.
Protocol	HTTP or HTTPS
Machine name	The host name of HTTP server on which the SSO server is running. Usually, this is same as the SSO server machine. However, if the SSO server is using load balancing, enter the load balancing machine name.
Port number	The port where the SSO server is running.
Use proxy?	Overrides the proxies. If it is set to false, the Management Agent accesses the machines using the Proxy Host Override and Proxy Port Override.If set to true, the overrides are not used.
Proxy Host	The name of the proxy host computer (if required).
Proxy Port	The port for the proxy server (if required).
Component that will start the Single Sign-On Server	The Application Server component that starts the Oracle Application Server Single Sign-On. For example, enter the name of the Oracle HTTP Server that starts Single Sign-On. For example: infra.mgmt2.acme.com_HTTP Server

11.5 Creating the OID Client Target

OID Client targets are useful to measure responsiveness of the OID (Oracle Internet Directory) component. An OID Client target should be created on each machine where an Oracle Collaboration Suite middle tier is installed (on each machine where an Oracle Application Server for Oracle Collaboration Suite is installed).

To create the OID Client target:

1. Using the Grid Control Console, navigate to the Agent home page for the Oracle Management Agent that was installed on the OID Client host.

2. In the Monitored Targets section of the page, select OID Client from the Add drop-down menu.

   Enterprise Manager displays the property page for the OID Client target type. Provide the required information, as described in Table 11-3.

3. Click OK to create the target.

See Also:

"Adding Targets to be Monitored and Administered by Enterprise Manager" in the Enterprise Manager online help

Table 11-3 OID Client Target Properties

Property	Description
LDAP Client Oracle Home Path	The path of the Oracle home of the LDAP client machine. This will be used to invoke the ldapsearch/ldapcompare utility for the computation of the various OID Client metrics. As a result, the ldapsearch/ldapcompare utility should exist in the following directory: $<LDAP_Client_Oracle_home>/bin/ This is always the case for any OCS install.
LDAP Host	The host name of the machine where the LDAP server is running.
LDAP Port	The port where the LDAP server is running.
LDAP User	The user name of a test user account that is needed for the ldapsearch/ldapcompare command. It is possible to simply use the default user setup for Enterprise Manager monitoring: "cn=emd admin,cn=oracle internet directory".
LDAP Password	The password of a test user account that is needed for the ldapsearch/ldapcompare command. For the Enterprise Manager monitoring user, the default is welcome.
DC	The domain component, that is, the domain name of the component in a Domain Name System (DNS). For example: dc=uk,dc=acme,dc=com

11.6 Creating a Single Sign-On Web Application Target

To monitor your Single Sign-On instances, you create a Web Application target. Web Application targets can be monitored for availability and performance with Application Service Level Management transactions. You can also measure the response time of pages in your Web Applications using End-User Page Performance Monitoring.

See Also:

"About Application Performance Management" in the Enterprise Manager online help

To create a Web Application target for your SSO instance:

1. Click Submit to create the target.

2. Navigate to the Web Application home page and use the instructions in the online help to create representative transactions to measure the availability and performance of the Web Application you just created.

   See Also:

   "Creating Transactions" in the Enterprise Manager online help

   Specifically, create a transaction that accesses the following URLs:

   1. https://<collaboration_suite_host>/help/hello.html - User Action

      This URL will not work in the default Single Sign-On environment in OCS release 2. In this case, you should create a transaction by going to the Portal page, logging in, and then logging out.

   2. https://<sso_server>/pls/orasso/orasso.wwsso_app_admin.ls_login - User Action

   3. https://<sso_server>/pls/orasso/orasso.wwsso_app_admin.ls_login - User Action

   4. https://<sso_server>/oiddas/login/signon.jsp - User Action

   5. https://<sso_server>/pls/orasso_basic/ORASSO.wwsso_app_admin.ls_login - User Action

   6. https://collaboration_suite_host>/help/hello.html - Redirect

3. Configure the Web Application target so that the transaction you just created is used as the availability transaction for the target.

   See Also:

   "Defining Availability Transactions and Beacons" in the Enterprise Manager online help

4. Enable End-User Page Performance Monitoring for the Web Application using the procedures for earlier versions of the Oracle Application Server described in "Configuring End-User Response Time Monitoring Using Earlier Versions of Oracle Application Server Web Cache" in Oracle Enterprise Manager Advanced Configuration for Oracle Enterprise Manager 10g Release 1 at:

   http://www.oracle.com/technology/documentation/oem.html

   Note:

   Before you enable End-User Page Performance Monitoring to monitor your Oracle Collaboration Suite Web Application target, you must apply patch number 3040716 to the Oracle Application Server middle-tier instance. You can download this patch from OracleMetaLink:

   http://metalink.oracle.com/
   

11.7 Creating the Identity Management Group Target

After you configure the Oracle9iAS Infrastructure targets, you can create a group target so can manage these targets as a single entity. To ensure the group is created correctly, it is important to ensure that all the Oracle Application Server Infrastructure targets have been created. Also, ensure that the host targets and application server targets used by the Oracle Application Server Infrastructure targets are discovered and visible in the Grid Control Console.

To create the group target:

1. Click the Targets tab in the Grid Control.

2. Click All Targets.

3. Select Collaboration Suite Component from the Add drop-down menu and click Go.

   Enterprise Manager displays the Create Collaboration Suite Component page.

4. Enter a name for the Oracle Application Server Infrastructure group in the Name field.

   For example, enter Oracle AS Infrastructure Group.

5. Select IM from the Component Type drop-down menu.

6. Select the targets that you want to add to the group from the Available Targets list and add them to the Selected Targets list.

   Be sure to add the following targets to the Oracle Application Server Infrastructure group:

   • The hosts where the Oracle Application Server Infrastructure targets resides

   • The LDAP Server target you created in Section 11.3.

   • The SSO Server target you created in Section 11.4

   • The OID Client target you created in Section 11.5

   • The OID and SSO database target

   • The listener for the OID database

   • The SSO Server Web Application target you created in Section 11.6

7. Click OK to create the group target.

8. Add the Oracle Application Server Infrastructure group to the Oracle Collaboration Suite group you created in Section 10.3.4.