6 Configuring Calendar

6.1 Preparing to Configure Grid Control to Manage Oracle Calendar Targets

Calendar is installed as a set of services distributed over hosts and databases.

For more information, see Oracle Calendar Administrator's Guide for Oracle Collaboration Suite Release 2 at:

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

As a result, you should create the following targets using Grid Control:

• One Calendar Server target for each Oracle Calendar server

• One Calendar Applications target for each Oracle Calendar application system

• One Oracle Calendar Web Applications target that contains all the targets that support your Oracle Calendar installation.

  The Web Application target consolidates your Oracle Calendar targets for easier monitoring and provides you with the ability to use the Application Service Level Management features of Grid Control.

• One Oracle Calendar group target for each Oracle Calendar server.

6.2 Creating the Oracle Calendar Server Target

After installing the Oracle Calendar server, the following information needs to be identified:

• The name of the host where the Oracle Calendar server was installed

• The listening port assigned to the Oracle Calendar engine (uniengd)

  The engine listening port is assigned during the Oracle Calendar installation and can be found under the [ENG] section of the following file:

  $ORACLE_HOME/ocal/misc/unison.ini
  
  

• The password for the Oracle Calendar instance administrator (SYSOP) for the Oracle Calendar server

• Oracle Home for the middle tier that hosts the Oracle Calendar application system

To create the Oracle Calendar server target:

1. Verify that the scripts required to configure Oracle Calendar for Grid Control are located in the following directory:

   $ORACLE_HOME/ocal/oem/scripts
   
   

   These scripts are installed with Oracle Collaboration Suite Release 2. The scripts should include:

   ocal_ps.pl
   ocal_dbsize.pl
   
   

2. Using Grid Control, navigate to the home page for the Oracle Management Agent that was installed on the Oracle Calendar server host. Use these steps to navigate to the appropriate Agent home page:

   1. Click Setup at the top of any Grid Control page.

   2. Click Agents in the Overview of Setup page subtab.

   3. In the Agents table on the Agents page, click the link for the Management Agent for the Oracle Calendar server host.

3. In the Monitored Targets section of the page, select Calendar Server from the Add box, then click Go.

   Grid Control displays the property page for the selected target type. Provide the required information, as described in Table 6-1.

4. Click OK to create the target.

   
   

   See Also: "Adding Targets to be Monitored and Administered by Enterprise Manager" in the Grid Control online help

   
   

   Table 6-1 Oracle Calendar Server Target Properties

   Property	Description
   Calendar Server host:port	The Oracle Calendar server host and engine (unieng) listening port. The port number is configured during installation and can be found under the [ENG] section in the following file: $ORACLE_HOME/ocal/misc/unison.ini
   Sysop Password	The password of the Oracle Calendar instance administrator (Oracle Calendar SYSOP account) that was used to install the Calendar Server. Note that the password for the SYSOP account is set to the ias_admin password by default. To modify the SYSOP password after installation, run the following command: $ORACLE_HOME/ocal/bin/unipasswd Note that changing the iAS Admin password does not automatically change the SYSOP password. The SYSOP password may be different for each Calendar Server.
   OracleHome	The Oracle Home for the middle tier that hosts the Oracle Calendar server.

   
   

6.3 Creating the Oracle Calendar Applications Target

After installing the Oracle Calendar application system, gather the following information, which will be required during the Calendar Applications target configuration:

• The name of the HTTP Server host for the Oracle Calendar application system

• The default listening port for the HTTP Server.

  This is usually the same as the port for the Portal instance configured on the middle tier.

• The Oracle Home for the middle tier that hosts the Oracle Calendar application system

To create the Calendar Applications target:

1. Using Grid Control, navigate to the home page for the Oracle Management Agent that was installed on the Oracle Calendar application system host. Use these steps to navigate to the appropriate Agent home page:

   1. Click Setup at the top of any Grid Control page.

   2. Click Agents in the Overview of Setup page subtab.

   3. In the Agents table on the Agents page, click the link for the Management Agent for the Oracle Calendar application system host.

2. In the Monitored Targets section of the page, select Calendar Applications from the Add box, then click Go.

   Grid Control displays the property page for the selected target type. Provide the required information, as described in Table 6-2.

3. Click OK to create the target.

   
   

   See Also: "Adding Targets to be Monitored and Administered by Enterprise Manager" in the Grid Control online help

   
   

6.4 Creating the Oracle Calendar Web Application Target

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

Before you configure the Calendar Web Application target, Oracle recommends that you create a test account so you can test the target immediately after it is created.

To create a Web Application target for monitoring your Calendar components:

1. Create a TEST Calendar account that you can later use to test the Web Application target.

2. Using Grid Control, navigate to the Agent home page for the Oracle Management Agent that was installed on the Calendar host. Use these steps to navigate to the appropriate Agent home page:

   1. Click Setup at the top of any Grid Control page.

   2. Click Agents in the Overview of Setup page subtab.

   3. In the Agents table on the Agents page, click the link for the Management Agent for the Calendar host.

3. In the Monitored Targets section of the page, select Web Application from the Add box, then click Go.

   Grid Control displays the Create Web Application wizard, which guides you through the process of creating the Web Application.

   When the wizard asks you for the Homepage URL, enter the Calendar URL. For example:

   http://calhost1.acme.com:7777/ocas-bin/ocas.fcgi?sub=web&web=calendar
   
   

   Click Help for information about other fields in the Web Application target wizard.

4. Click OK to create the target.

5. Use the instructions in the online help to create some representative transactions to measure the availability and performance of the Web Application you just created.

   For example, create a transaction from the TEST account that logs in and schedules a new appointment or views an existing appointment.

   
   

   See Also: "Creating Transactions" in the Grid Control online help

   
   

6. Enable End-User Performance Monitoring for the Web Application using the procedures described in "Configuring Application Performance Management" in Oracle Enterprise Manager Advanced Configuration for Oracle Enterprise Manager Grid Control 10g Release 2 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/

   
   

6.5 Creating the Oracle Calendar Group Target

After you configure the Oracle Calendar targets, you can create the Oracle Calendar group target. To ensure the group is created correctly, it is important to ensure that every possible calendar target has been created. Also, ensure that the host targets and application server targets used by Oracle Calendar are discovered and visible in Grid Control.

To create the group target:

1. Click the Targets tab in Grid Control.

2. Click All Targets.

3. Select Collaboration Suite Component from the Add box, then click Go.

   Grid Control displays the Create Collaboration Suite Component page.

4. Select Calendar from the Component Type box.

5. Enter a name for the Calendar group in the Name field.

   For example, enter Calendar Group.

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 Calendar group:

   • The host where the Calendar Server resides

   • The Calendar Server target you created in Section 6.2.

   • The Calendar Applications target you created in Section 6.3

   • The Web Application target you created in Section 6.4

7. Click OK to create the group target.