Skip Headers
Oracle® Enterprise Manager Configuration for Oracle Collaboration Suite
10g Release 2 (10.2)

Part Number B16224-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

1 Introduction to Managing Oracle Collaboration Suite 10g Release 1

Part I of this manual provides an overview of the benefits of using Oracle Enterprise Manager Grid Control 10g Release 2 (10.2) to monitor Oracle Collaboration Suite 10g Release 1 (10.1) components. It also includes information about how to set up Grid Control 10g Release 2 (10.2) to monitor Oracle Collaboration Suite 10g Release 1 (10.2) targets.

Grid Control 10g Release 2 supports the following Oracle Collaboration Suite 10g Release 1 components:

This chapter contains the following sections:


Note:

For information on setting up Grid Control 10g Release 2 (10.2) to monitor Oracle Collaboration Suite Release 2 (9.0.4) components, see the chapters in Part II, "Configuring Collaboration Suite Release 2 Targets" of this manual.

1.1 Installing Oracle Enterprise Manager Grid Control 10g Release 2

Before you begin configuring Grid Control 10g Release 2 (10.2) to manage your Oracle Collaboration Suite 10g Release 1 components, you must install and configure Grid Control 10.2 on at least one host computer on your network.

Oracle recommends that you install the Grid Control components on their own host or hosts. For example, if the Oracle Collaboration Suite middle tier is installed on host1.us.oracle.com, then install and configure the Oracle Management Service and Oracle Management Repository on host2.us.oracle.com.

Install the Grid Control 10.2 Oracle Management Agent on every host that includes components that you want to manage with Grid Control.

See Oracle Enterprise Manager Basic Installation and Configuration for Oracle Enterprise Manager Grid Control 10.2 at:

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

1.2 Benefits of Managing Oracle Collaboration Suite with Grid Control

When you set up Grid Control 10g Release 2 (10.2) to monitor Oracle Collaboration Suite 10g Release 1 targets, Grid Control provides the following benefits:

1.3 Configuring Collaboration Suite Services and Systems

This section describes how to configure Oracle Collaboration Suite services and systems. The steps described in this section are:


Note:

The Oracle Management Agent for Grid Control 10g Release 2 (10.2) should be installed and running on the hosts that include the Oracle Collaboration Suite components that you want to manage.

1.3.1 Enabling the Collaboration Suites Tab

The Collaboration Suites tab is a subtab on the Grid Control Targets tab. After you enable the Collaboration Suites tab, you can create a Collaboration Suite service for each of your Collaboration Suite instances. Then you can manage all the instances from the Collaboration Suites tab.

To enable the Collaboration Suites tab, follow these steps:

  1. In Grid Control, click Preferences at the top of a page.

  2. On the Preferences page, click Target Subtabs.

  3. On the Target Subtabs page, move Collaboration Suites to the Selected Target Subtabs box. The entry at the top of the Selected Target Subtabs box will appear on the far left of the Targets tab. The entry at the bottom will appear on the far right of the Targets tab.

  4. In the Selected Subtabs box, move Collaboration Suites until it is in the position where you want the Collaboration Suites subtab to appear on the Targets tab, relative to the other subtabs.

  5. Click the Targets tab. The Collaboration Suites tab appears in the specified position, relative to the other subtabs.

1.3.2 Creating an Identity Management Service

Each Collaboration Suite service that you create must be associated with an Identity Management service. Therefore, before you create your first Collaboration Suite service, an Identity Management service must exist or you must create one.

The tasks described in this section are:

1.3.2.1 Specifying Access Rights for the LDAP User

When you are creating an Identity Management service (or an LDAP service test) in Grid Control, you are prompted to specify a value for the LDAP User Name property in the Internet Directory Test Properties section of the Create Identity Management Service General page.

If the user name specified for the LDAP User Name property has the access rights for the Collaboration Suite components and target types specified in Table 1-1, then when that user creates an Oracle Collaboration Suite component service (such as a Calendar service or other component service), the appropriate information required to create the component service will be automatically discovered from Oracle Internet Directory and displayed on the pages used to create the component service. If the user does not have the access rights documented in the table, then the user will need to specify the correct information on the pages used to create the component service.

When you are specifying an LDAP user during the creation of an LDAP service test, you should consider whether that user will also be creating an Oracle Collaboration Suite component service at some point in the future and whether it would be beneficial for that user to have the access rights in Table 1-1.

Table 1-1 Access Rights for the LDAP User

Oracle Collaboration Suite Component Access Rights for the LDAP User

Calendar

(Calendar web client)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Calendar, cn=VirtualServices and its subtree.

Read access on the attributes:

orclservicesubtype, orclservicetype, labeleduri;webserviceurl in the subtree of the above object.

Collaboration Suite Search/Ultra Search

(oracle_ultrasearch targets)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Ultrasearch, cn=VirtualServices and its subtree.

Read access on the attribute orclassocdb in the subtree of the above object.

Browse access on the object that is the value of the attribute above - orclassocdb.

Read access on the attribute seealso of the object found in the step above.

Browse access on the object that is the value of the attribute above - seealso.

Read access on the attribute orclsystemname of the object found in the step above.

Collaboration Suite Search/Ultra Search

(oracle_ocsclient targets)

Browse access on the object:

cn=OracleContext, cn=Products, cn=OCSClient, cn=AppEntity, orclApplicationCommonName=OCSClientSingleton, cn=Associated Mid-tiers

Read access on the attribute uniquemember of the above object.

Browse access on the object that is the value of the attribute above - uniquemember.

Read access on the attribute orclapplicationcommonname of the object found in the step above.

Collaboration Suite Search/Ultra Search

(all Administration web application services and Search web application services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=OCSClient, cn=VirtualServices, cn=IntegratedClient

Read access on the attribute labeleduri;baseurl of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=OCSClient, cn=VirtualServices, cn=Search

Read access on the attribute labeleduri;webbaseurl of the above object.

Collaboration Suite Search/Ultra Search

(the Web Crawler and Administration database)

Browse acccess on the object:

cn=OracleContext, cn=Services, cn=Ultrasearch, cn=VirtualServices and its subtree.

Read access on the attribute orclassocdb in the subtree of the above object.

Browse access on the object that is the value of the attribute above - orclassocdb.

Read access on the attribute seealso of the object found in the step above.

Browse access on the object that is the value of the attribute above - seealso.

Read access on the attributes orclsid, orclnetdescstring of the object found in the step above.

Content Services

(oracle_files targets)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Files, cn=VirtualServices and its subtree.

Read access on the attributes cn, displayname for every object in the subtree of the above object.

Content Services

(Send App and Read App service)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Files, cn=VirtualServices and its subtree.

Read access on the attribute labeleduri;applicationuri for every object in the subtree of the above object.

Content Services

(associated Databases)

Browse access on the object:

cn=OracleContext, cn=Products, cn=IFS, cn=Database Instances and its subtree.

Read access on the attribute seealso for every object in the subtree of the above object.

Browse access on the object that is the value of the attribute above - seealso

Read access on the attributes - orclsid, orclnetdescstring of the object found in the step above.

Discussions

(oracle_discussions targets)

Browse access on the object:

cn=OracleContext, cn=Services, cn=ThreadedDiscussions, cn=VirtualServices and its subtree.

Read access on the attribute orclassociasinstance for every object inthe subtree of the above object.

Discussions

(Collaboration Suite Database targets)

Browse access on the object:

cn=OracleContext, cn=Services, cn=ThreadedDiscussions, cn=VirtualServices and its subtree.

Read access on the attribute orclraparameter for every object in the subtree of the above object.

Browse access on the object (and its subtree) based on the domain of the value of the attribute orclraparameter in the steps above and which starts under the object cn=OracleContext, cn=Products, cn=EMailServerContainer, cn=um_system

Read access on the attributes:

orclmailstore for every object - cn=Users of objects in the subtree of the object found in the step above.

Browse access on the object that is the value of the attribute above - orclmailstore

Read access on the attributes - orclsid, orclnetdescstring of the object found in the step above.

Discussions

(News Feed and Web application services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=ThreadedDiscussions, cn=VirtualServices and its subtree.

Read access on the attribute labeledurl;rss for every object in the subtree of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=ThreadedDiscussions, cn=VirtualServices and its subtree.

Read access on the attribute labeledurl;webui for every object in the subtree of the above object.

Discussions

(Databases associated with Discussions instances)

Browse access on the object:

cn=OracleContext, cn=Services, cn=ThreadedDiscussions, cn=VirtualServices and its subtree.

Read access on the object orclraparameter for every object in the subtree of the above object.

Browse access on the object (and its subtree) based on the domain of the value of the attribute - orclraparameter in the steps above and which starts under the object cn=OracleContext, cn=Products, cn=EmailServerContainer, cn=um_system

Read access on the attributes:

orclmailstore for every object - cn=Users of objects in the subtree of the object found in the step above.

Browse access on the object that is the value of the attribute above - orclmailstore

Read access on the attributes - x121address, orclmailstoreport, orclmailstoresid of the object found in the step above.

Identity Management

Not applicable.

Mail

(imap, smtp_in, pop, nntp_in, housekeeper, slist, vscrub, and mailstore targets)

Browse access on the object:

cn=OracleContext, cn=Computers and its subtree.

Read access on the attributes - cn for every object, cn=mailProcessConfig of object - cn=EmailServer in the subtree of the above object.

Mail

(imap, smtp, pop, nntp, Web Read, and Web Send services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Email, cn=VirtualServices, cn=imap

Read access on the attribute labeleduri of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=Email, cn=VirtualServices, cn=smtp

Read access on the attribute labeleduri of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=Email, cn=VirtualServices, cn=pop

Read access on the attribute labeleduri of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=Email, cn=VirtualServices, cn=nntp

Read access on the attribute labeleduri of the above object.

Browse access on the object:

cn=OracleContext, cn=Services, cn=Email, cn=VirtualServices, cn=WebMail

Read access on the attribute labeleduri;webbaseurl of the above object.

Mail

(databases associated with Mail services)

Browse access on the object:

cn=OracleContext, cn=Products, cn=EmailServerContainer, cn=um_system, cn=Mailstores and its subtree.

Read access on the attributes:

x121address, orclmailstoreport, orclmailstoreside for every object in the subtree of the above object.

Mobile Collaboration

(oracle_mcs targets)

Browse access on the object:

cn=OracleContext, cn=Products, cn=Wireless and its subtree.

Read access on the attributes:

uniquemember for every object - cn=AssociatedMid-tiers of objects in the subtree of the above object.

Browse access on the objects that is the value of the attribute above - uniquemember

Read access on the attribute - orclapplicationcommonname of the objects found in the step above.

Mobile Collaboration

(all Web application services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=Wireless, cn=VirtualServices, cn=WIRELESS1

Read access on the attribute labeleduri;mobilesetupurl of the above object.

Real-Time Collaboration

(all Web Presence and Web Conference services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=RTC, cn=VirtualServices, cn=RTC

Read access on the attribute labeleduri;enduserurl of the above object.

Voicemail & Fax

(Voicemail & Fax system)

Browse access on the object:

cn=OracleContext, cn=Products, cn=UMContainer, cn=GlobalProperties

Read access on the attribute orclumovftargetname of the above object.

Voicemail & Fax

(Mail Store)

Browse access on the object:

cn=OracleContext, cn=Products, cn=UMContainer, cn=MailStoreContainer and its subtree.

Read access on the attribute orclumemailmailstoredn for every object in the subtree of the above object.

Browse access on the objects based value of the attribute - orclumemailmailstoredn in the step above.

Read access on the attributes - x121address, orclmailstoreport, orclmailstoresid for every object found in the step above.

Web Access Client

(oracle_intgclient targets)

Browse access on the object:

cn=OracleContext, cn=Products, cn=OCSClient, cn=AppEntity, orclApplicationCommonName=IntegratedClient, cn=Associated Mid-tiers

Read access on the attribute uniquemember of the above object.

Browse access on the attribute orclapplicationcommonname of the object found in the step above.

Web Access Client

(all Web application services)

Browse access on the object:

cn=OracleContext, cn=Services, cn=OCSClient, cn=VirtualServices, cn=IntegratedClient

Read access on the attribute labeleduri;baseurl in the subtree of the above object.

Web Access Client

(Databases associated with Web Access Client instances)

Browse access on the object:

cn=OracleContext, cn=Products, cn=OCSClient, cn=DataStore and its subtree.

Read access on the attribute seealso for every object in the subtree of the above object.

Browse access on the objects that is the value of the attribute above - seealso

Read access on the attributes - orclsid, orclnetdescstring of the objects found in the step above.

Workspaces

(oracle_workspaces targets)

Browse access on the object:

cn=OracleContext, cn=Products, cn=CollaborativeWorkspaces, cn=Midtier Instances and its subtree.

Read access on the attribute orclapplicationcommonname for every object in the subtree of the above object.

Workspaces

(Web application service)

Browse access on the object:

cn=OracleContext, cn=Services, cn=CollaborativeWorkspaces, cn=VirtualServices

Read access on the attribute labeleduri;webbaseurl of the above object.

Workspaces

(Databases associated with Workspaces)

Browse access on the object:

cn=OracleContext, cn=Products, cn=CollaborativeWorkspaces, cn=Database Instances and its subtree.

Read access on the attribute - seealso for every object in the subtree of the avove object.

Browse access on the object that is the value of the attribute above - seealso

Read access on the attributes - orclsid, orclnetdescstring of the object found in the step above.


1.3.2.2 Steps for Creating an Identity Management Service

To create an Identity Management service, follow these steps:

  1. On the Targets tab in Grid Control, click Services.

  2. On the Services page, choose Identity Management Service in the Add box and click Go.

  3. On the Create Identity Management Service General page, you:

    • Specify the time zone that you want Grid Control to use when displaying monitoring data for the Identity Management service.

    • Identity the targets related to the Identity Management service that you are creating.

    • Specify the beacons that you would like to monitor the Identity Management service, and specify a key beacon.

    • Specify values for the Internet Directory and Single Sign-On test properties. The beacons use these properties to run the performance and availability tests for the Identity Management service.


      Note:

      You will be asked to specify a value for the LDAP User Name property for the Internet Directory test. If the user name specified for the LDAP User Name property has the access rights specified in Table 1-1, "Access Rights for the LDAP User", then when that user creates an Oracle Collaboration Suite component service (such as Calendar), the appropriate information required to create the component service will be automatically discovered from Oracle Internet Directory and displayed on the pages used to create the component service.

      If the user name specified for the LDAP User Name does not have the access rights specified in Table 1-1, then that user will need to specify the correct information on the pages used to create the component service.


    • Specify the databases that are critical for the Identity Management service. The databases you specify will be used in root cause analysis for the Identity Management service.

    • Specify the application servers that are critical for the Identity Management service. The application servers you specify will be used in root cause analysis for the Identity Management service.

    Click Help on the Create Identity Management Service General page to learn more about the information to provide on the page.

  4. On the Create Identity Management Service Beacons page, the beacons you specified on the General page for monitoring the Internet Directory and Single Sign-On service are displayed. You have the option of making changes to these beacons on this page.

  5. On the Create Identity Management Service Database Association page, the databases you specified on the General page are displayed. You have the option of making changes to these databases on this page.

  6. On the Create Identity Management Service Names page, you can view and modify the names of the service and system components that will be created for the Identity Management service. These names cannot be modified after the Identity Management Service is created.

  7. Click Finish after you have specified the correct values on the Create Identity Management Service pages for the Identity Management service you are creating.

  8. Grid Control displays the Identity Management service and subcomponent services on the Services tab. Grid Control also creates the Identity Management system, which appears on the Systems tab.

1.3.3 Creating a Collaboration Suite Service and System

Before you create a Collaboration Suite service, you need to create one or more test users. You can create one test user for all the component services you plan to create, or you can create a separate test user for each of the individual component services.

You can create a Collaboration Suite service for each of your Collaboration Suite instances, then view and manage all the instances from the Collaboration Suites tab. The hierarchy of services and systems that represent each Collaboration Suite instance is displayed on the Collaboration Suites tab, along with critical performance, usage, and availability data for each instance.

During the process of creating a Collaboration Suite service in Grid Control, you also create component service targets and system targets associated with the Collaboration Suite service.

The rest of this section provides information you need to be aware of before you create Collaboration Suite services and component services.

The steps described in this section are:

1.3.3.1 Access Rights for Collaboration Suite Services and Component Services

To create, edit, and delete Oracle Collaboration Suite services, component services, subcomponent services, and aggregate services, you must have the specific Oracle Enterprise Manager access rights documented in Table 1-2.

Table 1-2 Access Rights for Managing Collaboration Suite Services

Operation Access Rights Needed

Create an Oracle Collaboration Suite service

None

Edit an Oracle Collaboration Suite service

For basic operations on the Configure Collaboration Suite Service page:

  • Operator on the Oracle Collaboration Suite service

  • Operator on the Oracle Collaboration Suite system

  • View on the Identity Management service associated with the Oracle Collaboration Suite service (in the Associated Identity Management Service list, you can view only those Identity Management services to which you have been granted the View access right)

To associate a different Identity Management service with the Oracle Collaboration Suite service on the Configure Collaboration Suite Service page:

  • Operator on the Oracle Collaboration Suite service

  • Operator on all the underlying component services and subcomponent services

Delete an Oracle Collaboration Suite service

This operation requires:

  • Full on the Oracle Collaboration Suite service

  • Full on the Oracle Collaboration Suite system

  • All the access rights in the Delete a component service (such as the Mail service) row for every component under the Oracle Collaboration Suite service

Create a new component service (such as the Mail service)

This operation requires:

  • Operator on the Oracle Collaboration Suite service

  • Operator on the Oracle Collaboration Suite system

Edit an Identity Management Service or Identity Management User Access Service

This operation requires:

  • Operator on the Collaboration Suite Service that the Identity Management Service is associated with

  • Operator on all the underlying component services and subcomponent services for the Collaboration Suite service

Edit a component service (such as the Mail service)

To edit component services, you need these access rights*:

  • Operator on the component service

  • Operator on the component system

* To edit a Web Access Client service, you must have both the access rights above and the access rights listed in the Edit a subcomponent service or aggregate service (such as the Mail User Access Service) row of this table.

Delete a component service (such as the Mail service)

This operation requires:

  • Full on the component service

  • Full on the component system

  • Full on all the underlying subcomponent services and leaf level services

  • Full on the underlying redundancy groups

  • Operator on the beacons for the component service

Create a subcomponent service or aggregate service (such as the Mail User Access Service)

This operation requires:

  • Operator on the component service

  • Operator on the component system

Edit a subcomponent service or aggregate service (such as the Mail User Access Service)

This operation requires:

  • Operator on the subcomponent service

  • Operator on the component system

  • Full on the leaf level services

  • Full on the redundancy groups

  • Operator on the beacons

  • View on Management Agent monitored targets (including component-specific targets, HTTP Server, Web Cache, OC4J, Database, and RAC Database)

  • View on all cross-component targets (services or redundancy groups). For example, for the Mobile Collaboration Service, you should also have the View access right for dependent IMAP service, SMTP service, Internet Directory service, and Calendar Server redundancy group.

Delete a subcomponent service or aggregate service (such as the Mail User Access Service)

This operation requires:

  • Full on the subcomponent service

  • Full on the component system

  • Full on the leaf level services

  • Full on the redundancy groups

  • Operator on the beacons associated with the subcomponent service


1.3.3.2 Steps for Creating a Collaboration Suite Service

To create an Oracle Collaboration Suite service, follow these steps:

  1. On the Targets tab in Grid Control, click Collaboration Suites.

  2. On the Collaboration Suites tab, click Add. See "Enabling the Collaboration Suites Tab" if the Collaboration Suites tab does not exist.

  3. On the Add Collaboration Suite Service page, you:

    • Specify a service name for the service and a system name for the system associated with the service. You also specify the time zone that you want Grid Control to use when displaying monitoring data for the Collaboration Suite service.

    • Specify the Identity Management service that is associated with this Collaboration Suite service. See "Creating an Identity Management Service" if no Identity Management services exist.

    • In the Components table, click Add for a component service to create the component service as part of the Collaboration Suite service.

    • Specify whether the dashboard for the Collaboration Suite service you are creating will be available to any user who knows the dashboard URL.

  4. When you choose a component service to add in the Components table on the Add Collaboration Suite Service page, the General page (and associated pages) used to create that component service are displayed. To create the service, click Continue after specifying the correct information on the pages used to define the component service. Click Help on any page for more information about that page.

  5. After you create a component service, Grid Control displays the Add Collaboration Suite Service page again. You can either continue to create component services one at a time by repeating the previous step, or you can finish creating the Collaboration Suite service after you create a component service.

  6. Click OK to create the Collaboration Suite service.

  7. Grid Control displays the Collaboration Suite service on the Collaboration Suites tab.

Note that the systems and redundancy groups associated with a Collaboration Suite component are created when the component service is created.


Note:

When you create component and subcomponent services for an Oracle Collaboration Suite service, make sure that you do not include any blank characters at the end of the names that you specify for the component and subcomponent services. Grid Control cannot create the services if there are blank spaces at the end of the names.

1.3.3.3 Installing Oracle Collaboration Suite Metric and Policy Helpsets

In Grid Control 10.2.0.1, more than 90 metric helpsets for Oracle Collaboration Suite target types as well as the Oracle Calendar policies helpset were not installed by default.

In Grid Control 10.2.0.2, this problem has been rectified. If you are using Grid Control 10.2.0.1, Oracle strongly recommends that you patch it to 10.2.0.2. You can download the patch from the Oracle MetaLink Web site:

http://metalink.oracle.com

If you want to continue using 10.2.0.1, you would have to use the following procedure to run a script to include all these helpsets in the Grid Control online help system:

  1. Make sure that the ORACLE_HOME variable is set to the directory where the Oracle Management Service for Grid Control is installed.

  2. Change your default directory to the bin subdirectory of the Oracle home for the Oracle Management Service. Then, stop the Oracle Management Service. For example:

    $ cd $ORACLE_HOME/bin
    $ ./emctl stop oms
    
    
  3. Run the ocs_helpset.pl script, which is in the sysman/bin subdirectory of the Oracle home for the Oracle Management Service. This script copies the Oracle Collaboration Suite helpsets to the correct directories, so that these helpsets will be included in the Grid Control online help after the Oracle Management Service is restarted:

    $ cd $ORACLE_HOME/sysman/bin
    $ $ORACLE_HOME/perl/bin/perl ocs_helpset.pl
    
    
  4. Restart the Oracle Management Service. For example:

    $ cd $ORACLE_HOME/bin
    $ ./emctl start oms
    
    
  5. After the Oracle Management Service is started, when the first help topic is requested in Grid Control 10.2.0.1, it takes longer for that topic to be displayed than when only the default helpsets are included in the online help system. This extra time is due to the additional helpsets that are being loaded. The topic should display in less than 2 minutes. Then, for all subsequent help requests, topics display in 2 seconds or less.

Note that after the Oracle Collaboration Suite metric and policy helpsets are included in the online help system, each time the Oracle Management Service is started, it will take a similar length of time (usually under two minutes) for the first help topic to display. Then, for all subsequent help requests, topics display in 2 seconds or less. In 10.2.0.2, although all helpsets are included by default, this performance problem does not occur.

1.3.3.4 Steps to Perform Before Creating a Mail Service

Before you create a Mail service, create a Collaboration Suite Database target for each mail store created for Oracle Mail. Create these targets on each mail store that you want to monitor.

To create a Collaboration Suite Database target:

  1. In Grid Control, navigate to the Agent home page for the Oracle Management Agent that was installed on the mail store 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 mail store host.

  2. In the Monitored Targets section of the Agent home page, select Collaboration Suite Database from the Add drop-down menu, then click Go.

    Grid Control displays the property page for the Collaboration Suite Database target type. Provide the required information, as described in Table 1-3.

  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.

Table 1-3 Collaboration Suite Database Target Properties

Property Description

DB Host

The host name of the machine that has the database with the ES_MAIL schema and data

DB Port

The port of the database with the ES_MAIL schema and data

DB SID

The SID of the database with the ES_MAIL schema and data

Collaboration Suite Database Connect Descriptor

The connect information for the mail store for this server. If the mail store is running in RAC mode, a RAC connect descriptor can be supplied.

The default value is usually in the following format:

(DESCRIPTION=(FAILOVER=ON)(LOAD_BALANCE=ON) (ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=<host-name>)(PORT=<port>)))(CONNECT_DATA=(SERVICE_NAME=<service-name>)))

Edit the descriptor when the mail store is changed or connect information changes.

Collaboration Suite Database User

The database user name on the database with the ES_MAIL schema and data

Collaboration Suite Database Password

The password of the database user on the database with the ES_MAIL schema and data

Oracle Home

The Oracle Home in which this component is installed.


1.3.3.5 Steps to Perform Before Creating an Ultra Search Service

Before you create an Ultra Search service, create an Ultra Search target for each Oracle Ultra Search instance.

To create an Oracle Ultra Search target:

  1. In Grid Control, navigate to the home page for the Management Agent that was installed on the Oracle Ultra Search Repository Database 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 Ultra Search Repository Database host.

  2. In the Monitored Targets section of the page, select Ultra Search from the Add drop-down menu, then click Go.

    Grid Control displays the property page for the selected target type.

  3. Provide the required information, as described in Table 1-4.

  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 1-4 Oracle Ultra Search Target Properties

Property Description

Name

Enter a unique name for the Oracle Ultra Search target. If you have multiple Oracle Ultra Search targets in your environment, consider including the host name in the target name.

Database Host

The host for Oracle Ultra Search repository database. This is usually an Oracle Application Server Infrastructure database.

For example: iashost2.acme.com

Database Listener Port

The port for Oracle Ultra Search repository database.

For example: 1521

Oracle SID

The System Identifier (SID) for the Oracle Ultra Search repository database.

For example: iasdb

Schema Username

User name for the owner of the Oracle Ultra Search schema. By default, the user name is WKSYS.

Schema Password

Password for the WKSYS user account.


1.3.3.6 Steps to Perform Before Creating a Mobile Collaboration Service

When the Mobile Collaboration service is created, Web applications associated with the service are also created. To ensure that these Web applications work properly, perform these steps before creating the Mobile Collaboration service:

  1. On the Collaboration Suite Welcome page, click Oracle Mobile Preferences and specify the credentials the test uses to query the Mobile Collaboration middle tier.

  2. On the Collaboration Suite Mobile Preferences page, create a test user mobile access account using the Mobile Access Account ID, Mobile Access PIN, and Confirm your Mobile Access PIN fields.

  3. Click OK.

  4. In the Administrator's Tools section of the Collaboration Suite Welcome page, click provisioning console.

  5. On the Welcome to Self-Service Console page, click Login and log into the test user account. Click on My Profile.

  6. On the View My Profile page, click Edit My Profile.

  7. In Additional Personal Details section of the Edit My Profile page, make sure that the value selected in the Language field is English (United States).

  8. Click Submit and OK.

  9. Go to the following URL (replace <host> and <port> with the name of the host and the port where the Collaboration Suite middle tier is installed):

    http://<host>:<port>/ptg/rm

  10. On the Login page, specify the test user mobile access account credentials using the Mobile Access Account ID and Mobile Access PIN that were created earlier. Click Submit.

  11. Click Preferences.

  12. On the User Preferences page, make sure that Show Images is set to Yes, then click Save and Logout.

1.3.3.7 Specifying the Oracle HTTP Server Port for the Mobile Collaboration Push Mail Service

When the Mobile Collaboration service is being created, the value specified for the Port field in the Push Mail Test Properties section of the Create Mobile Collaboration Service All Test Properties page should be the port for the Oracle HTTP Server for the Mobile Collaboration middle tier.

If the port for the Oracle HTTP Server for the Mobile Collaboration middle tier is not specified during creation of the Mobile Collaboration Service, you can specify the correct Oracle HTTP Server port after the Mobile Collaboration Service is created by following these steps:

  1. In Grid Control, navigate to the Collaboration Suites tab.

  2. On the Collaboration Suites Services page, select the Oracle Collaboration Suite service that contains the Mobile Collaboration service, then click Configure.

  3. In the Components section on the Configure Collaboration Suite Service page, click Configure for the Mobile Collaboration service.

  4. On the Configure Mobile Collaboration Service page, click Configure for the Mobile Collaboration Push Mail Service.

  5. In the Port field on the Configure Mobile Collaboration Push Mail Service All Test Properties page, specify the port for the Oracle HTTP Server for the Mobile Collaboration middle tier.

  6. Click Continue and Finish to update the port number.

1.3.3.8 Steps to Perform Before Creating a Voicemail & Fax Service

Before you can create a Voicemail & Fax component service in Grid Control, you need to create Voicemail & Fax system targets for Oracle Collaboration Suite 10g Release 1 (10.1) for Windows.

Before you install Oracle Voicemail & Fax for Oracle Collaboration Suite 10g Release 1 (10.1) for Windows, be sure that the latest Oracle Management Agent for Windows is installed and properly configured on the Windows machine.

For complete information about installing Oracle Voicemail & Fax for Oracle Collaboration Suite 10g Release 1, see Oracle Collaboration Suite Oracle Voicemail & Fax and Oracle Web Conferencing Conversion Servers Installation and Upgrade Guide for Microsoft Windows for Oracle Collaboration Suite 10g Release 1 at:

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

After installing Oracle Voicemail & Fax for Oracle Collaboration Suite 10g Release 1 (10.1) for Windows, use Grid Control to centrally administer your Voicemail & Fax installation.

Before you start using Oracle Voicemail & Fax, use Grid Control to set up your sites and groups and configure the PBX-Application Cluster.

For more information about getting started with Grid Control and configuring Oracle Voicemail & Fax for Oracle Collaboration Suite 10g Release 1, see Oracle Voicemail & Fax Administrator's Guide for Oracle Collaboration Suite 10g Release 1 at:

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

After following the instructions in Oracle Voicemail & Fax Administrator's Guide, you can create a Voicemail & Fax component service in Grid Control by following the steps in Steps for Creating a Collaboration Suite Service.

1.3.3.9 Disabling Auto Versioning for Content Services

To prevent the Content Services Send Web Application service from creating a new test file each time it runs and pushing the previous test file to the Trash folder, you should set the Content Services versioning model to disabled before you create the Content Services service.

To set the Content Services versioning model to disabled, follow these steps:

  1. Log into Content Services as the Content Services test user you created for the Content Services service test.

  2. In the right hand pane in Content Services, right-click the folder for the test user.

  3. Choose Properties and then on the Versioning tab enable Modify Settings and set Versioning Model to Disable Versioning.

1.3.3.10 Specifying the Full Path Name to a Content Services Service Sample File

Before you create the Content Services service in Grid Control, you need to create a Content Services sample file.

During the creation of the Content Services service, the full pathname to the Content Services sample file should be specified in the Server-Side Filename field in the Basic Test Properties section on the Configure Content Services General page.

If the full pathname to the sample file is not specified in the Server-Side Filename field when the Content Services service is created, the full pathname to the sample file can be added after the Content Services service is created by following these steps:

  1. In Grid Control, navigate to the Collaboration Suites tab.

  2. On the Collaboration Suites Services page, select the Oracle Collaboration Suite service that contains the Content Services service, then click Configure.

  3. In the Components section on the Configure Collaboration Suite Service page, click Configure for the Content Services service.

  4. On the Configure Content Services Service page, click Configure for the Content Services User Access Service.

  5. In the Basic Test Properties section on the Configure Content Services User Access Service General page, specify the full pathname to the sample file in the Server-Side Filename field.