14 Configuring Enterprise Manager to Manage Oracle Voicemail & Fax Targets

This chapter describes how to configure Oracle Enterprise Manager Grid Control to monitor the Oracle Voicemail & Fax component for Oracle Collaboration Suite Release 2.

Note:

Oracle Enterprise Manager 10g Grid Control does not support the monitoring of Oracle Voicemail & Fax Release 1 (9.0.3) components.

This chapter contains the following sections:

• Preparing to Configure Enterprise Manager to Manage Oracle Voicemail & Fax

• Creating the Oracle Voicemail & Fax Targets

• Creating the Oracle Voicemail & Fax Group Target

Note:

See Chapter 7, "Configuring Voicemail & Fax" for information on configuring Grid Control to manage Voicemail & Fax components for Oracle Collaboration Suite 10g Release 1.

14.1 Preparing to Configure Enterprise Manager to Manage Oracle Voicemail & Fax

Before you configure Enterprise Manager to manage Oracle Voicemail & Fax, you must perform the tasks described in the following sections:

• Configuring Oracle Voicemail & Fax

• Installing the Management Agent to Manage Your Oracle Voicemail & Fax Targets

• Overview and Naming Conventions for the Oracle Voicemail & Fax Target Types

14.1.1 Configuring Oracle Voicemail & Fax

Before you can manage Oracle Voicemail & Fax with Enterprise Manager, you must download and apply a software patch and perform some additional Oracle Voicemail & Fax configuration tasks.

To configure Oracle Voicemail & Fax so it can be managed by Enterprise Manager:

1. Locate, download, and install the Oracle Voicemail & Fax software patch that allows you to monitor Oracle Voicemail & Fax with Grid Control:

   1. Log in the OracleMetaLink:

      http://metalink.oracle.com/
      
      

   2. Click Patches in the left navigation bar.

   3. Click Simple Search.

   4. Search for patch number 3207444 for the Microsoft Windows 32-bit platform.

   5. Follow the instructions on the page to download and install the patch.

2. Refer to the following document, which is available in the Oracle Voicemail & Fax home directory after you apply the patch:

   OVF_HOME\um\perf\Admin.doc
   
   

   This document provides additional information about configuring Oracle Voicemail & Fax so it can be managed with Enterprise Manager.

   Note:

   Patch number 3207444 will be included in future Oracle Collaboration Suite patchsets. For example, if you are running Oracle Collaboration Suite 9.0.4.2, there is no need to download and install patch number 3207444.

14.1.2 Installing the Management Agent to Manage Your Oracle Voicemail & Fax Targets

The Oracle Voicemail & Fax targets that you manage with Enterprise Manager can be monitored remotely by the Oracle Management Agent. This is especially important for the Oracle Voicemail & Fax components that are available only on the Windows platform. At the time this document was released, a Windows version of the Oracle Management Agent was not available.

Because you can monitor the Oracle Voicemail & Fax targets remotely, you can monitor all your Oracle Voicemail & Fax targets from a remote Management Agent installed on UNIX system; however, the UNIX system that hosts the Management Agent must have network access to the Oracle Voicemail & Fax Metrics Database.

See Also:

"About Local and Remote Monitoring with the Management Agent"

Only the AQMWI Application component of Oracle Voicemail & Fax must be installed on a UNIX host. As a result, you can install the Management Agent on the machine that hosts the AQMWI Application.

See also Oracle Enterprise Manager Basic Installation and Configuration for Oracle Enterprise Manager 10g Release 1 at:

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

14.1.3 Overview and Naming Conventions for the Oracle Voicemail & Fax Target Types

After you configure Oracle Voicemail & Fax by installing and configuring the software patch, and after you install the Management Agent, you can use the Oracle Enterprise Manager 10g Grid Control Console to create Oracle Voicemail & Fax targets.

After the targets are created, you can view the various metrics collected for each Oracle Voicemail & Fax target.

When you manage Oracle Voicemail & Fax with Enterprise Manager, you create the target types described in Table 14-1. The table also provides a set of recommended naming conventions to use when creating the targets. It is important that you follow the naming conventions in order to identify the host where each Oracle Voicemail & Fax component resides. The host name shown on the Oracle Voicemail & Fax target home pages identifies the Management Agent host, which is not necessarily the host where the Oracle Voicemail & Fax component resides.

See Also:

"Installing the Management Agent to Manage Your Oracle Voicemail & Fax Targets"

In general, you should create a target for every Oracle Voicemail & Fax application you want to monitor. This means that every time a new Oracle Voicemail & Fax telephony host is added to your system or a new mail store is added to your environment, you must add additional targets that represent the new components so they can be monitored using the Grid Control Console.

The instructions in this chapter also describe how to create an Oracle Voicemail & Fax group target. This group target contains all the Oracle Voicemail & Fax targets so you can view them from a single Group home page. The Oracle Voicemail & Fax group target provides links to related targets such as databases and listeners. You create the group target after you create all the other Oracle Voicemail & Fax targets.

Table 14-1 Oracle Voicemail & Fax Target Types

Target Type	Internal Name	Recommended Naming Convention
OVF AQMWI Application	ovf_aqmwi	Ovf.<hostname>.aqmwi
OVF FaxIn Application	ovf_faxin	Ovf.<hostname>.Faxin
OVF Mailstore	ovf_mailstore	Ovf.<hostname>.Mailstore
OVF MWI Service	ovf_mwiservice	Ovf.<hostname>.Mwiservice
OVF Recording Application	ovf_recording	Ovf.<hostname>.Recording
OVF Recovery Application	ovf_recovery	Ovf.<hostname>.Recovery
OVF Retrieval Application	ovf_retrieval	Ovf.<hostname>.Retrieval
OVF Routing Application	ovf_routing	Ovf.<hostname>.Routing
OVF Telephony Midtier	ovf_midtier	Ovf.<hostname>.Telephony
OVF Transer Application	ovf_transfer	Ovf.<hostname>.Transfer

14.2 Creating the Oracle Voicemail & Fax Targets

To create the Oracle Voicemail & Fax target:

1. Using the Grid Control Console, navigate to the Management Agent home page for the Management Agent you will use to monitor the Oracle Voicemail & Fax targets.

   See Also:

   "Installing the Management Agent to Manage Your Oracle Voicemail & Fax Targets"

2. Create a target for each of the Oracle Voicemail & Fax target types shown in Table 14-1:

   1. In the Monitored Targets section of the page, select one of the Oracle Voicemail & Fax targets 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 14-2 and Table 14-3.

   2. 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 14-2 Properties Common to All Oracle Voicemail & Fax Targets

Property	Description
Name	Enter a name for the target using the guidelines for Oracle Voicemail & Fax target names in Table 14-1. Note: The name of the AQMWI application is case-sensitive since it resides on a UNIX system.
Voicemail Host	Name of the host where where the Oracle Voicemail & Fax application or component is running. To identify the proper host name, you can use the getlocalhostname.bat script, which is installed as part of the Oracle Voicemail & Fax patch described in Section 14.1.1. The location of the script is documented in the OVF_HOME/um/perf/Admin.doc file, which is also installed as part of the patch. For example: ovf-nt-1 Note: The Voicemail Host property is case-sensitive for the AQMWI Application target type.
Mailstore Name	This property is specific to the AQMWI application target type. This property identifies the Oracle Email mail store service name.
Metrics DB Host	Fully qualified name of the host where the metrics database resides. You create the Oracle Voicemail & Fax Metrics database when you apply the patch and follow the instructions in the Admin.doc file described in Section 14.1.1. This should also be the same value used for the hostname in the metrics.dbloc process property stored in Oracle Internet Directory. For example: ovf-metrics.oracle.com
Metrics DB Port	Port number where TNS is listening for the Oracle Voicemail & Fax Metrics database. You create the Oracle Voicemail & Fax Metrics database when you apply the patch and follow the instructions in the Admin.doc file described in Section 14.1.1. This should also be the same value used for the port in the metrics.dbloc process property stored in OID. For example: 1521
Metrics DB SID	System Identifier (SID) of the Oracle Voicemail & Fax Metrics database. You create the Oracle Voicemail & Fax Metrics database when you apply the patch and follow the instructions in the Admin.doc file described in Section 14.1.1. This should also be the same value used for the SID in the metrics.dbloc process property stored in OID. For example: METRICS
Metrics DB User	Name of the Oracle Voicemail & Fax database user created in the Metrics db. You create the Oracle Voicemail & Fax Metrics database when you apply the patch and follow the instructions in the Admin.doc file described in Section 14.1.1. For example: ovf
Metrics DB Password	Password of the ovf user for the metrics db. This should also be the same value used for the metrics.pwd process property stored in OID. For example: welcome

Table 14-3 Properties Unique to the OVF Mailstore Target

Property	Description
OVF Mailstore GlobalName	Global database name of the Oracle Email mail store used by Oracle Voicemail & Fax. This value must match the global names assigned to each Oracle Voicemail & Fax user in Oracle Internet Directory. For example: OVF1.ACME.COM To obtain the value you should enter in this field, review the contents of the following file on the host where the telephony server is installed: %ORACLE_HOME%\um\install\mailstoreinfo.txt The OVF Mailstore Globalname is the value assigned to the SERVICE_NAME property in the mailstoreinfo.txt file. Note: Global name must be in all upper case.
DB Host	Fully qualified name of the host where the Oracle Email mail stored used by Oracle Voicemail & Fax resides. For example: OVF1.acme.com To obtain the value you should enter in this field, review the contents of the following file on the host where the telephony server is installed: %ORACLE_HOME%\um\install\mailstoreinfo.txt The DB Host is the value assigned to the HOST property in the mailstoreinfo.txt file.
DB Port	Port of the Oracle Email mail store used by Oracle Voicemail & Fax. For example: 1521 To obtain the value you should enter in this field, review the contents of the following file on the host where the telephony server is installed: %ORACLE_HOME%\um\install\mailstoreinfo.txt The DB Port is the value assigned to the Port property in the mailstoreinfo.txt file.
DB SID	System Identifier (SID) of the Oracle Email mail store used by Oracle Voicemail & Fax. For example: OVF1 To obtain the value you should enter in this field, review the contents of the following file on the host where the telephony server is installed: %ORACLE_HOME%\um\install\mailstoreinfo.txt The DB SID is the value assigned to the SID property in the mailstoreinfo.txt file. Note: You should enter this value in all uppercase letters.
DB User	Database user that owns the Oracle Email mail store used by Oracle Voicemail & Fax. This is the user account used to ping this database to check for database availability. For example: es_perf
DB Password	Password for the database user account that owns the Oracle Email mail store used by Oracle Voicemail & Fax. For example: <password for the es_perf database user>

14.3 Creating the Oracle Voicemail & Fax Group Target

After all the Oracle Voicemail & Fax targets are configured, you can create the Oracle Voicemail & Fax group target, which provides a custom user interface for managing your Oracle Collaboration Suite environment.

The Oracle Voicemail & Fax group home page contains the alerts table, followed by a table of rows of component targets and columns of key metrics. There is also a Performance tab where key metrics are charted for the Oracle Voicemail & Fax group.

To create the Oracle Voicemail & Fax 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 Voicemail & Fax group in the Name field.

   For example, enter Voicemail and Fax Group.

5. Select Voice and Fax 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 target types to the Oracle Voicemail & Fax group:

   • The host targets where the Oracle Voicemail & Fax servers reside

   • The Oracle Voicemail & Fax targets you created in Section 14.2.

   • The Oracle Voicemail & Fax Metrics database and listener.

7. Click OK to create the group target.