Skip Headers
Oracle® Beehive Installation Guide
Release 2 (2.0.1.8) for Microsoft Windows x86

Part Number E16642-07
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
PDF · Mobi · ePub

7 Oracle Collaboration Coexistence Gateway Install Help

Oracle Collaboration Coexistence Gateway is an Oracle proprietary solution that enables Oracle Beehive users to collaborate with Microsoft Exchange or IBM Lotus Domino users. Additionally, this solution enables Exchange or Lotus Domino users to make use of Oracle Beehive features without being migrated from Microsoft Exchange or Lotus Domino.

This chapter describes the Oracle Beehive Install Wizard screens that appear during the installation of Oracle Collaboration Coexistence Gateway:

Starting Oracle Collaboration Coexistence Gateway Installation

Follow these steps to install Oracle Collaboration Coexistence Gateway:

  1. Install Oracle Coexistence Connector for Microsoft Exchange Server.

  2. Alternatively, install Oracle Coexistence Connector for Lotus Domino Server if you want your Lotus Domino users to coexist with your Oracle Beehive users.

  3. Perform post-installation tasks. This includes configuring a coexistence connector for your Oracle Beehive deployment. For more information, refer to "Integrating Microsoft Exchange Server 2003 or 2007 with Oracle Beehive" in Oracle Beehive Integration Guide.

To install Oracle Coexistence Connector for Microsoft Exchange Server or Oracle Coexistence Connector for Lotus Domino 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 to enable your Oracle Beehive deployment to coexist with your Microsoft Exchange Server.

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

    • Converting outgoing messages to a format accepted by Oracle Beehive and dispatching the delivery to the Oracle Communication Service

    • Delivering meeting requests, responses, and cancellations arriving from Oracle Beehive to Microsoft Exchange users

    • Updating free/busy information

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

  • Oracle Coexistence Connector for Lotus Domino Server

    Choose this option to enable your Oracle Beehive deployment to coexist with your Lotus Domino Server. The Oracle Coexistence Connector for Lotus Domino Server is an Oracle Collaboration Coexistence Gateway service that is responsible for the following tasks:

    • Enabling Lotus Domino and Oracle Beehive users to look up each other's Free/Busy information

    • Enabling Lotus Domino and Oracle Beehive users to invite each other to meetings and view their responses in their respective calendar applications

    • Converting outgoing messages to a format accepted by Oracle Beehive and dispatching the delivery to the Oracle Communication Service

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

Oracle Coexistence Connector for Microsoft Exchange Server Sequence of Screens

The following screens appear during the installation of Oracle Coexistence Connector for Microsoft Exchange Server:

Note:

Oracle Coexistence Connector for Microsoft Exchange Server must be installed on the same domain as the Microsoft Exchange deployment and on a dedicated server that does not contain user mailboxes. Oracle recommends that a separate machine be used with pre-installed Microsoft Exchange Admin Tools.

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.

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.

Partnership Key

The partnership key is a password that is used for authentication between the Oracle Coexistence Connector and the Oracle Beehive Coexistence Service. It is used when Coexistence System (beectl create_coexistence_system) is created in Beehive Coexistence Service.

Each Coexistence System on the same Beehive Coexistence Service should be unique.

Enter any string to be used as the partnership key. The Partnership key must be at least 8 characters and contain at least one uppercase and one digit.

Confirm Partnership Key

Enter the same string that you entered in Partnership 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

Oracle Coexistence Connector for Microsoft Exchange Server requires the user name and password of a Windows user that has certain administrator privileges.

Follow these steps to create a Windows user account with these administrator privileges. (Alternatively, ensure that the Windows user that you specify in this screen has these privileges.)

  1. Using the Active Directory Users and Computers interface, create a Microsoft Exchange user in the top level Windows domain so that it can have access to all Windows domains.

  2. In the Windows Registry Editor, go to the HKCU\Software\Microsoft\Exchange\ExAdmin registry key. In this registry key, create a new DWORD property with the name ShowSecurityPage and value 1. (To run the Registry Editor, click Start, Run, then enter regedit. Click OK.)

  3. Open the Exchange System Manager. Right-click the top level organization and select Delegate Control.

  4. Add the Microsoft Exchange user that you created as an Exchange Full Administrator. Click OK.

  5. Right-click the top level organization and select Properties.

  6. Click the Security tab. Highlight the user you added. Remove the Deny Send As and Receive As privileges. Click OK.

  7. Using the Active Directory Users and Computers interface, enable Advanced Features. Right-click the top level domain and select Properties.

  8. Click the Security tab and select Advanced.

  9. Click Add and select the user you created.

  10. Click the Object tab. In the Apply Onto drop-down box, select User Objects. Select Allow for the Send As privilege.

  11. Click the Properties tab. In the Apply Onto drop-down box, select User Objects. Select Allow for the Write Public Information privilege. Click OK.

  12. For each computer on which you will install Oracle Coexistence Connector, grant the following permissions to the user account:

    1. Local Administrator Rights: Right click My Computer and select Manage. Expand Local Users and Groups, expand Groups, and double click Administrators. Add the user account to the list of users.

    2. Log on as a service: From the Control Panel, open Administrative Tools. Open Local Security Policy. Expand Local Policies, select User Rights Assignment, and double click the Log on as a service policy. Add the user account to the list of users.

Note:

It may take up to 24 hours for Microsoft Exchange Server to replicate the privileges described in these steps among all your Active Directory domain controllers in your organization.

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.

Complete the installation of Oracle Collaboration Coexistence Gateway, by perform the post-installation tasks, such as starting the Oracle Coexistence Connector for Microsoft Exchange. For more information, refer to "Integrating Microsoft Exchange Server 2003 or 2007 with Oracle Beehive" in Oracle Beehive Integration Guide.

Oracle Coexistence Connector for Lotus Domino Server Sequence of Screens

The following screens appear during the installation of Oracle Coexistence Connector for Lotus Domino Server:

Specify Home Location

Enter the full path of the location where you want to install Oracle Coexistence Connector for Lotus Domino 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 for Lotus Domino Server) 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

  • Disk space

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 Configuration wizard.

Oracle Beehive Connection Details

Specify the following details of the HTTP server of your Oracle Beehive instance:

Host

Specify the host name of your Oracle Beehive instance.

Port

Specify the HTTP or HTTPS port number of your Oracle Beehive instance.

Use HTTPS

If you specified the HTTPS port number of your Oracle Beehive instance, select this check box.

Test Connection

Click this button to verify the URL of your Oracle Beehive HTTP/HTTPS server. You may proceed with the installation if this test fails.

URL

The Install Wizard will generate the value of this field, the Oracle Beehive Coexistence service endpoint, based on the values you entered in the previous fields.

Partnership Key

The partnership 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 partnership key.

Confirm Partnership Key

Enter the same string that you entered in Partnership 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.

Domino Server and User Info

Oracle Collaboration Coexistence Gateway requires a Domino user account with administrative privileges to access Lotus Domino Server. This is a Domino user and password account, not a Microsoft Windows account. Specify the following information:

  • Domain Host HTTP Port: Specify the HTTP port of your Lotus Domino Server

  • Domain Admin User Name: Specify the user name of a Domino account with administrative privileges.

  • Admin User Password: Specify the password of the Domino account you entered in the previous field.

Domino Foreign Domain Name

Enter the name of the foreign domain that will represent Oracle Beehive on your Lotus Domino Server. All coexisting Oracle Beehive users will reside or be created in this foreign domain as foreign users.

Foreign domain name must be between 1 and 64 characters. The only valid characters are a-z, A-Z, 0-9, and the underscore.

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 Coexistence Connector for Lotus Domino Server, perform the following tasks:

  1. Take note of the following information:

    • URL for Oracle Coexistence Connector for Lotus Domino Server:

      http://$hostname:$portNum/coexConnector/CoexMLPort

    • Partnership key you specified in "Oracle Beehive Connection Details"

  2. Configure Oracle Coexistence Connector for Lotus Domino Server. Refer to "Integrating IBM Lotus Domino with Oracle Beehive" in Oracle Beehive Integration Guide.