Skip Headers
Oracle® Beehive Installation Guide
Release 1 (1.4) for Microsoft Windows (32-Bit)

Part Number E13792-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

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

12 Oracle Collaboration Coexistence Gateway Install Help

Oracle Collaboration Coexistence Gateway is an Oracle proprietary solution that allows Oracle Beehive users to collaborate with Microsoft Exchange users. Additionally, this solution allows Microsoft Exchange users to make use of the full set of Oracle Beehive features without being migrated from Microsoft Exchange.

The following sections describe the Oracle Beehive Install Wizard screens that appear during the installation of Oracle Collaboration Coexistence Gateway:

Starting Oracle Collaboration Coexistence Gateway

Follow these steps to install Oracle Collaboration Coexistence Gateway:

  1. Install the Oracle Coexistence Connector for Microsoft Exchange Server.

  2. Install the Oracle Change Notification Service for Microsoft Exchange Server.

  3. Perform post-installation tasks. This includes configuring a coexistence connector in the Oracle Beehive deployment. For more information, refer to "Configuring a Coexistence Connector on Oracle Beehive" in the module "Configuring and Managing Oracle Collaboration Coexistence Gateway" in Oracle Beehive Administrator's Guide.

To install either the Oracle Coexistence Connector for Microsoft Exchange Server or the Oracle Change Notification Service for Microsoft Exchange Server, run the Oracle Beehive Install Wizard (you do not need any command line arguments). For more information about the Oracle Beehive Install Wizard, refer to "Starting Oracle Beehive Install Wizard" in "What You Should Know Before Installing Oracle Beehive".

Note:

If you configured Oracle Beehive to use HTTPS, follow the directions described in the section "Configuring Oracle Connector for Exchange to Use HTTPS" in the module "Configuring and Managing Oracle Collaboration Coexistence Gateway" in Oracle Beehive Administrator's Guide.

Oracle Collaboration Coexistence Gateway Options

Choose from one of the following install options:

Oracle Coexistence Connector for Microsoft Exchange Server

Choose this option if you have not installed either of the two options.

The Oracle Coexistence Connector is an Oracle Collaboration Coexistence Gateway service that is responsible for the following tasks:

If you pick this option, you will proceed to "Oracle Coexistence Connector Sequence of Screens".

Oracle Change Notification Service for Microsoft Exchange Server

Choose this option if you have already installed the Oracle Coexistence Connector.

The Oracle Change Notification Service is an Oracle Collaboration Coexistence Gateway service that is responsible for the following tasks:

The Oracle Change Notification Service requires an installation of the Oracle Coexistence Connector.

If you pick this option, you will proceed to "Oracle Change Notification Service Sequence of Screens".

Note:

You must install the Oracle Change Notification Service on every Microsoft Exchange server that contains user mailboxes that will coexist with Oracle Beehive.

Oracle Coexistence Connector Sequence of Screens

The following screens appear during the installation of the Oracle Coexistence Connector:

Notes:

Oracle Coexistence Connector for Microsoft Exchange Server must be installed on the same domain as the Microsoft Exchange deployment. Oracle recommends that a separate machine be used. If a separate machine is used, the Microsoft Exchange Admin Tools must be pre-installed.

Oracle also recommends that you install the Oracle Coexistence Connector on a dedicated Microsoft Exchange server that does not contain user mailboxes.

Specify Home Location

Enter the full path of the location where you want to install the Oracle Coexistence Connector for Microsoft Exchange Server. Do not leave the Location field blank.

Prerequisite Checks

This screen displays the prerequisite checks that the Oracle Beehive Install Wizard runs. It verifies that the host (where you are installing Oracle Coexistence Connector) meets all minimum requirements for installation and configuration.

Some of the checks that the Oracle Beehive Install Wizard performs include:

  • Operating system requirements

  • Service pack requirements

  • Physical memory requirements

Note:

If any check is flagged as Manual check, then you must manually run and verify it.

After verifying a Manual check, select the check box next to it. All check boxes must be selected before you can proceed to the next screen.

Tip:

For details on why a check failed, select the check box against it and see the details in the description box at the bottom of the screen.

Select Installation Type

Specify the type of installation you want to perform. You can choose from:

Install and Configure

Select this option if you want to install and automatically start the configuration of the product.

If you select this option, the Oracle Coexistence Connector is functional with minimal configuration after the installation is completed.

Install Only

Select this option to only install the Oracle Coexistence Connector This will only copy files to your system. Until you configure the Oracle Coexistence Connector, you will not be able to perform any tasks with it.

To configure the product after installation, you must run the Config Wizard.

Option to Configure Oracle Change Notification Service

If the Oracle Install Wizard detects that the Microsoft Exchange server you selected resides on the local host, you may configure the Oracle Change Notification Service as part of the installation of the Oracle Coexistence Connector.

Select Yes if you want to configure the Oracle Change Notification Service. Otherwise, select No.

Oracle Beehive Coexistence Service

The Oracle Beehive Coexistence Service is automatically enabled when Oracle Beehive is installed and is required by Oracle Collaboration Coexistence Gateway. The Oracle Beehive Coexistence Service relays data between the Oracle Coexistence Connector and Oracle Beehive.

Specify the following details for your Oracle Beehive installation. The installer will automatically determine the URL for the Oracle Beehive Coexistence Service that is installed with Oracle Beehive:

Oracle Beehive Host

Enter the host name, real or virtual, used to access your Oracle Beehive installation.

Oracle Beehive Port

Enter the HTTP port used to access your Oracle Beehive installation.

The Oracle Beehive Coexistence endpoint (specified by URL) will be generated based on the values of Oracle Beehive Host and Oracle Beehive Port.

Site Key

The site key is a password that will be used for authentication between the Oracle Coexistence Connector and the Oracle Beehive Coexistence Service.

Enter any string to be used as the site key.

Confirm Site Key

Enter the same string that you entered in Site Key.

oc4jadmin Password

Specify and confirm the password for the oc4jadmin user.

Password Restrictions

The password of the oc4jadmin user must have the following characteristics:

  • Be between 8 and 30 characters long.

  • Only contain alpha-numeric characters (a-z, A-Z, and 0-9) or the underscore (_); the password cannot contain any other punctuation mark character.

  • Contain at least one uppercase and one lowercase alphabetic character.

  • Contain at least one numeric character.

  • Begin with an alphabetic character; the password cannot begin with a number or the underscore (_).

Note:

When entering your password, check that the state of your Caps Lock key is what you want it to be. Passwords are case-sensitive.

Password Recommendations

  • Passwords should not be simple or obvious words, such as welcome, account, database, or user.

  • Passwords should not be the same as the user name.

  • Passwords should not be Oracle reserved words such as ACCESS, AUTHORIZATION, UID, or VARCHAR,

Windows User Account

Enter the user name and password of a Windows user that has administrator privileges for your Microsoft Exchange server.

Note:

If you have configured your Exchange organization with multiple routing groups, you must create a new Windows user for each routing group. Each of these users must have the following characteristics:
  • The user's mailbox resides on an Exchange server that belongs to the same routing group from where you are running the Install Wizard

  • All the rights and privileges specified in this section

The Windows user you specify must have the following rights and privileges:

  • Membership to the Domain Admins group: Verify this with the Active Directory Users and Computers interface by viewing the properties of the selected user account.

  • Exchange account/mailbox: Verify this with the Active Directory Users and Computers interface.

  • "Exchange Full Administrator" rights:

    1. Open the Exchange System Manager.

    2. Right-click your organization's name and select Delegate Control....

    3. Click Next and then click Add.

    4. Select the user to grant rights to and select the Exchange Full Administrator role.

  • "Send As" and "Receive As" rights set at the Exchange Server level: Verify this by viewing the Security properties of the appropriate Exchange server under the "Servers" section of the Exchange System Manager Console. Follow these steps to add these rights:

    1. Open the Exchange System Manager.

    2. Select Servers\YOURSERVER\First Storage Group.

    3. Select the Mailbox Store (YOURSERVER) and view its properties.

    4. Select the Security tab. Select the user you want to grant rights. Click Advanced.

    5. Select Allow for the rights ReceiveAs and SendAs.

  • "Log on as a service" right: Follow these steps to add this right:

    1. Run secpol.msc to access Local Security Settings.

    2. In the tree view, select Security Settings\Local Policies\User Rights Assignment.

    3. Right-click the policy Log on as a service and select Properties. Click Add User or Group to add the right to a user. If the computer you are running secpol.msc is a node in a cluster, check that this user right is assigned to the cluster service account on all nodes in the cluster.

    If Add User or Group is disabled, a group policy may be prohibiting setting this right at a user level. You must set this right at the Domain Policy or Domain Controller Policy level (whichever takes precedence):

    1. Run rsop.msc to access Resultant Set of Policy.

    2. Right-click the policy Log on as a service and select Properties. Select the Precedence tab to find the highest policy enforcing this setting.

    3. Follow note Q327545, "How to Troubleshoot Service Startup Permissions in Windows Server 2003," at http://support.microsoft.com/kb/327545/en-us from the Microsoft Knowledge Base or the steps in "Add the Log on as a service right to an account" at http://technet2.microsoft.com/WindowsServer/en/library/be1ebd3f-3490-4fb6-9558-16b6b49b89ba1033.mspx from Microsoft TechNet. Add the user Administrator as an exception to the highest policy in place, granting Administrator the "Log on as a service" right.

    Notes:

    You may need to restart the server to make the settings effective.

    Run rsop.msc to confirm you have successfully set the exception for "Log on as a service."

  • "Logon as" right

User Name

Enter the fully qualified name of the user with administrator privileges to the Microsoft Exchange server. The syntax for the user name is DOMAIN\username or username@FQDN.

For example, if the network domain name of the computer that has Microsoft Exchange Server installed is MYSERVER and the name of the user that has administrator privileges is admin, the username would be MYSERVER\admin.

Password

Enter the password of the user you entered in the User Name field.

Summary

The Installation Summary screen presents a summary of the options you have selected so far.

Installation Progress

Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.

Configuration Assistants

This screen displays the configuration assistants that the Oracle Beehive Install Wizard runs to configure the product type that you selected on the Select Product Type screen.

If any configuration is flagged as Failed, then you must manually run the assistant to configure it. You do so by selecting the check box against it and clicking Retry.

End of Installation

Click Finish to complete the installation process and close the Oracle Beehive Install Wizard.

To complete the installation of Oracle Collaboration Coexistence Gateway, perform the following tasks:

  1. Install the Oracle Change Notification Service for Microsoft Exchange.

  2. Perform post-installation tasks, including starting the Oracle Coexistence Connector for Microsoft Exchange and the Oracle Change Notification Service for Microsoft Exchange. For more information, refer to "Post-Installation Tasks" in the module "Oracle Collaboration Coexistence Solution" in Oracle Beehive Administrator's Guide.

Oracle Change Notification Service Sequence of Screens

The following screens appear during the installation of the Oracle Change Notification Service:

Specify Home Location

Enter the full path of the location where you want to install the Oracle Change Notification Service for Microsoft Exchange Server. Do not leave the Location field blank.

Prerequisite Checks

This screen displays the prerequisite checks that the Oracle Beehive Install Wizard runs. It verifies that the host (where you are installing the Oracle Change Notification Service) meets all minimum requirements for installation and configuration.

Some of the checks that the Oracle Beehive Install Wizard performs include:

  • Operating system requirements

  • Service pack requirements

  • Physical memory requirements

Note:

If any check is flagged as Manual check, then you must manually run and verify it.

After verifying a Manual check, select the check box next to it. All check boxes must be selected before you can proceed to the next screen.

Tip:

For details on why a check failed, select the check box against it and see the details in the description box at the bottom of the screen.

Select Installation Type

Specify the type of installation you want to perform. You can choose from:

Install and Configure

Select this option if you want to install and automatically start the configuration of the product.

If you select this option, the Oracle Change Notification Service is functional with minimal configuration after the installation is completed.

Install Only

Select this option to only install the Oracle Change Notification Service This will only copy files to your system. Until you configure the Oracle Change Notification Service, you will not be able to perform any tasks with it.

To configure the product after installation, you must run the Configuration wizard.

Select Oracle Coexistence Connector

If you selected the Install and Configure from the previous screen, this screen is shown.

Select the Oracle Coexistence Connector to be used for this installation of Oracle Change Notification Service.

Windows User Account

Enter the user name and password of a Windows user that has administrator privileges for your Microsoft Exchange server.

Note:

If you have configured your Exchange organization with multiple routing groups, you must create a new Windows user for each routing group. Each of these users must have the following characteristics:
  • The user's mailbox resides on an Exchange server that belongs to the same routing group from where you are running the Install Wizard

  • All the rights and privileges specified in this section

The Windows user you specify must have the following rights and privileges:

  • Membership to the Domain Admins group: Verify this with the Active Directory Users and Computers interface by viewing the properties of the selected user account.

  • Exchange account/mailbox: Verify this with the Active Directory Users and Computers interface.

  • "Exchange Full Administrator" rights:

    1. Open the Exchange System Manager.

    2. Right-click your organization's name and select Delegate Control....

    3. Click Next and then click Add.

    4. Select the user to grant rights to and select the Exchange Full Administrator role.

  • "Send As" and "Receive As" rights set at the Exchange Server level: Verify this by viewing the Security properties of the appropriate Exchange server under the "Servers" section of the Exchange System Manager Console. Follow these steps to add these rights:

    1. Open the Exchange System Manager.

    2. Select Servers\YOURSERVER\First Storage Group.

    3. Select the Mailbox Store (YOURSERVER) and view its properties.

    4. Select the Security tab. Select the user you want to grant rights. Click Advanced.

    5. Select Allow for the rights ReceiveAs and SendAs.

  • "Log on as a service" right: Follow these steps to add this right:

    1. Run secpol.msc to access Local Security Settings.

    2. In the tree view, select Security Settings\Local Policies\User Rights Assignment.

    3. Right-click the policy Log on as a service and select Properties. Click Add User or Group to add the right to a user. If the computer you are running secpol.msc is a node in a cluster, check that this user right is assigned to the cluster service account on all nodes in the cluster.

    If Add User or Group is disabled, a group policy may be prohibiting setting this right at a user level. You must set this right at the Domain Policy or Domain Controller Policy level (whichever takes precedence):

    1. Run rsop.msc to access Resultant Set of Policy.

    2. Right-click the policy Log on as a service and select Properties. Select the Precedence tab to find the highest policy enforcing this setting.

    3. Follow note Q327545, "How to Troubleshoot Service Startup Permissions in Windows Server 2003," at http://support.microsoft.com/kb/327545/en-us from the Microsoft Knowledge Base or the steps in "Add the Log on as a service right to an account" at http://technet2.microsoft.com/WindowsServer/en/library/be1ebd3f-3490-4fb6-9558-16b6b49b89ba1033.mspx from Microsoft TechNet. Add the user Administrator as an exception to the highest policy in place, granting Administrator the "Log on as a service" right.

    Notes:

    You may need to restart the server to make the settings effective.

    Run rsop.msc to confirm you have successfully set the exception for "Log on as a service."

  • "Logon as" right

User Name

Enter the fully qualified name of the user with administrator privileges to the Microsoft Exchange server. The syntax for the user name is DOMAIN\username or username@FQDN.

For example, if the network domain name of the computer that has Microsoft Exchange Server installed is MYSERVER and the name of the user that has administrator privileges is admin, the username would be MYSERVER\admin.

Password

Enter the password of the user you entered in the User Name field.

Summary

The Installation Summary screen presents a summary of the options you have selected so far.

Progress

Use this screen to monitor the progress of your installation. Click Show Details to see the details in the description box that appears.

Configuration Assistants

This screen displays the configuration assistants that the Oracle Beehive Install Wizard runs to configure the product type that you selected on the Select Product Type screen.

If any configuration is flagged as Failed, then you must manually run the assistant to configure it. You do so by selecting the check box against it and clicking Retry.

End of Installation

Click Finish to complete the installation process and close the Oracle Beehive Install Wizard.

To complete the installation of Oracle Collaboration Coexistence Gateway, you must perform post-installation tasks, including starting Oracle Coexistence Connector for Microsoft Exchange and Oracle Change Notification Service for Microsoft Exchange. For more information, refer to "Post-Installation Tasks" in the module "Oracle Collaboration Coexistence Solution" in Oracle Beehive Administrator's Guide.