Skip Headers
Oracle® Beehive Administrator's Guide
Release 1 (1.4)

Part Number E13797-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

14 Configuring and Managing Oracle Collaboration Coexistence Gateway

This module explains the concepts and terminology of Oracle Collaboration Coexistence Gateway. Installation instructions and administration tasks are also explained. The following topics are covered in this module:

Introduction to Oracle Collaboration Coexistence Gateway

The Oracle solution for coexistence between Oracle Beehive and Microsoft Exchange requires an understanding of fundamental terminology and concepts before installation and deployment. This section serves as a general introduction to Oracle Collaboration Coexistence Gateway, including terminology and concepts, while providing a broad overview of the technology and architecture that facilitates coexistence.

Oracle Collaboration Coexistence Gateway is an Oracle proprietary solution that allows Oracle Beehive users to collaborate with Microsoft Exchange users. Additionally, the solution allows Microsoft Exchange users to make use of the full set of Oracle Beehive features without being migrated from Microsoft Exchange. Oracle Collaboration Coexistence Gateway can be broken down to these services:

The first three services run on the computer or computers where Oracle Connector for Exchange and Oracle Change Notification Service for Exchange were installed. The last service is on Oracle Beehive.

These services update and propagate data between the two coexisting systems. Depending on the deployment, the information being updated and propagated may include events, contacts, tasks, and e-mails.

You can centrally manage Oracle Beehive Coexistence from the beectl command line, and from Oracle Beekeeper, including managing components of Coexistence that are installed on remote servers.

This section includes the following topics:

Terminology

Read the following list of terminology to better understand the terms that will be used throughout this module:

Active Directory Mail Enabled User

Users who exists in the Windows domain and can send and receive e-mail.

Active Directory Contact

A Microsoft Active Directory contact is a user who does not have a Microsoft Exchange mailbox, and who resides on a different system. For example, an Active Directory contact could be an Oracle Beehive user.

Active Directory Exchange User

A Microsoft Active Directory Exchange user is a mail enabled user who exists in the Windows domain and has an Exchange mailbox. Among other objects, the Exchange mailbox can contain e-mail, calendar, and task items.

Coexisting Third-Party User

Users residing on a third-party system, such as Microsoft Exchange; however, they have the ability to collaborate and view free/busy information of Oracle Beehive users. Oracle Beehive users are able to collaborate with coexisting third-party users and view their free/busy information. These users can also do the following:

  • Collaborate with other users on the same system

  • View Oracle Beehive users' free/busy information

  • Collaborate with Oracle Beehive users as though they were users native to Microsoft Exchange

Non-Coexisting Third-Party User

Users residing solely on an existing third-party system. These users are not aware of the existence of Oracle Beehive. No coexistence solution has been provided to this group of users. Although these users may exist in the Oracle Beehive Global Address List, an Oracle Beehive user cannot view the free/busy information or cross-schedule these users. All communication between Oracle Beehive users and these types of users on third-party systems is accomplished using e-mail. These users can do the following:

  • Collaborate with other users on the same system

  • View Oracle Beehive users' free/busy information

  • Collaborate with Oracle Beehive users by e-mail

Oracle Beehive Coexistence Service

The Oracle Beehive Coexistence Service is deployed in an OC4J container (BEEAPP) that is part of every Oracle Beehive deployment. The service is automatically enabled when Oracle Beehive is installed and is required to implement the Oracle Collaboration Coexistence Gateway. The Oracle Beehive Coexistence Service relays data between the Oracle Connector for Exchange and Oracle Beehive.

Oracle Beehive Users

Users with Oracle Beehive as their data repository for all content types. These users can do the following:

  • Use all available Oracle Beehive services

  • Collaborate with other Oracle Beehive users

  • Collaborate with coexisting third-party users as though they were Oracle Beehive users

  • Collaborate with Team Collaboration-Enabled Users as though they were Oracle Beehive users

Oracle Change Notification Service for Exchange

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

  • Detecting changes to Team Collaboration-Enabled Users' personal data: including e-mail, contacts, and calendar events

  • Detecting changes to free busy information for coexisting third-party users

  • Dispatching changes to Oracle Connector for Exchange

Oracle Communication Service

The Oracle Communication Service plays a vital role in information exchange between Oracle Beehive and Microsoft Exchange. The Oracle Communication Service is responsible for the transmission of all message types between the two systems. It distinguishes between different message types, including e-mails, events, and contacts, to facilitate the transmission of information between Oracle Beehive and Microsoft Exchange.

Oracle Connector for Exchange

The Oracle Connector for Exchange 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, cancellations, task requests, responses, and updates arriving from Oracle Beehive to Microsoft Exchange users

  • Updating free/busy information

Public Free/Busy Folder

The public free/busy folder is a shared folder that resides on the Microsoft Exchange server. Its purpose is to store availability information for all Active Directory individuals, including Active Directory users and contacts. The availability information that is stored in the folder is populated by Microsoft Exchange clients, such as Microsoft Outlook.

Team Collaboration-Enabled User

Team Collaboration-Enabled Users remain on the existing third-party solution and use Oracle Beehive for added features and content types. The legacy data for these users may be exposed and manipulated using Oracle Beehive clients. These users can do the following:

  • Use all available Oracle Beehive features

  • Collaborate with Oracle Beehive users as though they are users of the same system

  • Perform any of the above actions from within Oracle Beehive clients or third-party clients, where the functionality is available

  • Use Oracle Beehive clients to access the additional capabilities available in Oracle Beehive

  • Use Oracle Beehive clients to manage select personal third-party data

  • Continue collaborating with native users on the third-party system

Concepts

This section defines Oracle Collaboration Coexistence Gateway concepts that will be used throughout this module.

Note:

An understanding of the "Terminology" section is required to fully understand the concepts outlined in this section.

Team Collaboration Enablement

This method of coexistence allows Oracle Beehive to be deployed into an environment where existing applications for e-mail, contact, and scheduling already exist. Team collaboration enablement allows a user of a third-party system to use Oracle Beehive features and access data stored and managed in the third-party systems until such time that the transition to Oracle Beehive is complete.

Cross-Scheduling

This method of coexistence allows Oracle Beehive users and third-party system users to collaborate with each other transparently. This consists of event scheduling and task assignment, including free/busy lookup and post-invitation event updates. In this method of coexistence, users in either system are unaware of the existence of the other system, and can collaborate transparently.

Architectural Overview

This section includes a diagram of the architectural overview specific to Oracle Collaboration Coexistence Gateway.

Figure 14-1 depicts key components of Oracle Collaboration Coexistence Gateway in conjunction with Microsoft Exchange, including services, third-party software, and information flow:

Figure 14-1 Oracle Collaboration Coexistence Gateway Architecture

Oracle Collaboration Coexistence Gateway architecture
Description of "Figure 14-1 Oracle Collaboration Coexistence Gateway Architecture"

Installation and Post-Installation Configuration

This section includes important information and cross-references that are necessary to install and configure the Oracle Collaboration Coexistence Gateway solution. This section contains the following topics:

Installation

The Oracle Beehive Installation Guide for Microsoft Windows contains all of the information that you will need related to preparing for and installing the components of the Oracle Collaboration Coexistence Gateway solution:

Note:

After installing the components of the Oracle Collaboration Coexistence Gateway solution, a Remote Coexistence System must be configured in the Oracle Beehive deployment.

Follow the steps outlined in the "Configuring a Coexistence System on Oracle Beehive" section to complete the installation.

Follow the steps outlined in the "Post-Installation Configuration" section to complete the configuration.

Post-Installation Configuration

After installing Oracle Beehive, Oracle Connector for Exchange, and Oracle Change Notification Service for Exchange; and "Configuring a Coexistence System on Oracle Beehive", additional post-installation configuration must be completed before the Oracle Collaboration Coexistence Gateway is fully functional.

Complete all of the tasks in this list to get the Oracle Collaboration Coexistence Gateway up and running:

  1. Adjust quota restrictions on Microsoft Exchange. For additional information about this task, refer to "Adjusting Quota Restrictions for the Oracle Connector for Exchange Mailbox".

  2. If your Microsoft Exchange deployment does not allow users to receive e-mails from external addresses, the Microsoft Exchange administrator must reconfigure Microsoft Exchange to allow incoming external e-mails.

  3. Configure a relay server on Oracle Beehive. For additional information about this task, refer to "Setting Up E-mail Relay Routing" in Chapter 8, "Managing Oracle Beehive E-mail".

  4. Configure your local domain on Oracle Beehive by running the following beectl command:

    ./beectl append_value --component _EmailService --name LocalEmailPatterns --value "*@<yourdomain>"
    

    Where <yourdomain> represents your local domain.

    Note:

    For the configuration changes to take effect, you must run the activate_configuration beectl command.
  5. Set the CoexUserLocal E-mail Service property to FALSE using the following beectl command:

    ./beectl modify_property --component _EmailService --name CoexUserLocal --value FALSE
    

    Note:

    For the configuration changes to take effect, you must run the activate_configuration beectl command.
  6. If your Microsoft Exchange and Oracle Beehive deployments have local users with the same e-mail domain, set the AcceptInvalidLocalUsers E-mail Service property to TRUE using the following beectl command:

    ./beectl modify_property --component _EmailService:TransportProperties --name AcceptInvalidLocalUsers --value TRUE
    

Post-Installation Tasks

This section is a compilation of information related to post-installation administration tasks that may or may not be required after installing Oracle Connector for Exchange and Oracle Change Notification Service for Exchange. Read each preamble carefully, because not all deployment scenarios will require the post-installation tasks described in this section. For a list or required post-installation tasks, refer to "Post-Installation Configuration".

This section includes the following topics:

Adjusting Quota Restrictions for the Oracle Connector for Exchange Mailbox

During the installation of Oracle Connector for Exchange, a mailbox is created for the service. This mailbox will be given the following name: Oracle-coexConnExch <host>. This folder should not be subject to default mail quota policies imposed on regular user folders.

For Oracle Connector for Exchange to function as it was intended, the Microsoft Exchange administrator must remove all mailbox quota policies that may be enforced on this folder before attempting a coexistence deployment.

Installing the Oracle Change Notification Service for Exchange on the Same Host as Microsoft Exchange

While installing Oracle Connector for Exchange on the same computer as Microsoft Exchange, a prompt appears giving you the "Option to Configure Oracle Change Notification Service". If you select No to this option and complete the installation, you will not be able to install Oracle Change Notification Service for Exchange on that computer using the Oracle Universal Installer.

If after choosing not to install Oracle Change Notification Service for Exchange on the same computer as Microsoft Exchange and Oracle Connector for Exchange, you then want to install Oracle Change Notification Service for Exchange on that same computer, follow these instructions:

  1. On the computer hosting the Oracle Connector for Exchange and Microsoft Exchange, navigate to the C:\oracle\product\<version>\exconnector_1\beehive\collabcoex_connector.

    Where <version> represents the folder with the version number of Oracle Connector for Exchange.

  2. Run the following command:

    coexctl.exe install_eventsink --install_directory C:\oracle\product\<version>\exconnector_1\beehive\collabcoex_connector --admin_account <WindowsUserAccount> --admin_password <psw>
    

    Where:

    If the installation was successful, the following message will be returned:

    EventSink registered successfully.
    
  3. Start the Oracle Change Notification Service for Exchange. For instructions on starting the Oracle Change Notification Service for Exchange, refer to "Starting Oracle Change Notification Service for Exchange".

Note:

If this method is used to install Oracle Change Notification Service for Exchange, the Oracle Universal Installer cannot be used to uninstall it. To uninstall Oracle Change Notification Service for Exchange using the command-line tool, run the following command:
coexctl.exe uninstall_eventsink

Administering Oracle Collaboration Coexistence Gateway

This section explains how to perform various administrative tasks related to Oracle Collaboration Coexistence Gateway, and includes the following topics:

Oracle Beehive Coexistence Service Administrative Tasks

This section describes how to perform various administrative tasks related to the Oracle Beehive Coexistence Service. The instructions in this section assume that the beectl shell is being used.

See Also:

For more information about the beectl commands used in this section, see "Oracle Beehive Command-Line Utility" in Module 2 of the Oracle Beehive Administrator's Reference Guide.

This section includes the following topics:

Configuring a Coexistence System on Oracle Beehive

This section includes information about adding a coexistence system using the add_coexistence_system command.

The add_coexistence_system command takes either a --url, or both a --host_name and --port. You must use the --url option if you need to customize the URI portion of the URL. Otherwise, you can use either method of specifying the host.

Optionally, the --use_https parameter can be used along with the --host_name and --port paramaters to specify that the HTTPS protocol will be used.

The following examples show how to format input using each method:

beectl add_coexistence_system --host_name example.com --port 80 --sitekey

This command generates a URL of http://example.com:80/coexConnector/CoexMLPort

beectl add_coexistence_system --host_name example.com --port 80 --use_https --sitekey

This command generates a URL of https://example.com:80/coexConnector/CoexMLPort

beectl add_coexistence_system --url http://example.com --sitekey

This command generates a URL of http://example.com:80/coexConnector/CoexMLPort

beectl add_coexistence_system --url https://example.com/uri --sitekey

This command generates a URL of https://example.com:80/uri

Follow these steps to add a coexistence system to your Oracle Beehive deployment:

  1. Determine the fully qualified domain name and port of your Oracle Connector for Exchange installation.

  2. Navigate to the ORACLE_HOME/beehive/bin directory on the system hosting the Oracle Beehive deployment.

  3. Run the following command:

    beectl> add_coexistence_system {--url  http://<OracleConnectorForExchangeHost>:<port>/coexConnector/CoexMLPort | --host_name <coexistence_system_name> --port <port_number> --use_https } --sitekey [<obfuscated_sitekey> --obfuscated] [--timezone_alias_namespace <timezone_alias_namespace>]
    

    Notes:

    The argument passed to the --sitekey option is the password defined during the installation of the Oracle Connector for Exchange. For more information about the Site Key value, see "Oracle Collaboration Coexistence Gateway Install Help" in Module 6 of the Oracle Beehive Installation Guide for Microsoft Windows.

    The argument passed to the --url option is displayed in the summary screen of the Oracle Connector for Exchange installation.

    Where:

    • <OracleConnectorForExchangeHost> represents the fully qualified domain name of the system hosting Oracle Connector for Exchange

    • <port> represents the HTTP port of your Oracle Connector for Exchange installation

    • <coexistence_system_name> represents the name that you want to give to the Remote Coexistence System

    • <obfuscated_sitekey> represents the password defined during the installation of the Oracle Connector for Exchange, which you have obfuscated using the beectl obfuscate command

    • <timezone_alias_namespace> is a string that corresponds to a timezone namespace in Oracle Beehive and is used to map timezones from Exchange to Oracle Beehive and vice versa. By default this is set to MSFT. Unless advised to do so by Oracle support, do not change this value.

Listing Oracle Beehive Remote Coexistence Systems

Oracle Beehive administrators may require details about the Oracle Beehive Remote Coexistence Systems configured on their deployment. This section includes information about listing all configured Remote Coexistence Systems using the list_coexistence_systems command.

Run the following command to list the configured Remote Coexistence Systems on your Oracle Beehive deployment:

beectl> list_coexistence_systems

The command will return output similar to the following example:

----------------------------------------------------------------------------------
Coexistence remote collaboration system details.
----------------------------------------------------------------------------------
Name                    : Exchange
URL                     : http://10.156.42.99:7777/coexConnector/CoexMLPort
Timezone alias namespace: MSFT
----------------------------------------------------------------------------------

For additional details, use the --show_more option:

beectl> list_coexistence_systems --show more
 
----------------------------------------------------------------------------------
Coexistence remote collaboration system details.
----------------------------------------------------------------------------------
Id                      : 121A:2A16:cors:56F748517E90371EE040578CF71854800000000186A6
Name                    : Exchange
URL                     : http://10.156.42.99:7777/coexConnector/CoexMLPort
Timezone alias namespace: MSFT
----------------------------------------------------------------------------------
----------------------------------------------------------------------------------
Configuration properties status.
----------------------------------------------------------------------------------
Modified On             : 9/19/08 10:17 AM
Last synchronization    : 9/19/08 10:17 AM
Propagation state       : IN-SYNC 

In addition to the information provided by the list_coexistence_systems command, you can use the beectl list_coexistence_connectors command to show information about individual coexistence connectors within a Remote Coexistence System:

beectl> list_coexistence_connectors
 
----------------------------------------------------------------------------------
List of coexistence connectors for remote collaboration systems.
----------------------------------------------------------------------------------
Connector Name          : Oracle-coexConnExch (tmcoex1)
Routing List            : RGC426AE:*;1;OCS:*;1;
Relay Address Type      : RGC426AE
----------------------------------------------------------------------------------

Modifying Oracle Beehive Remote Coexistence Systems

Oracle Beehive administrators may need to modify certain properties of an Oracle Beehive Remote Coexistence System. This section includes information about modifying a Remote Coexistence System using the modify_coexistence_system command. Depending on what properties require modification, different options are required.

In the following example, the Remote Coexistence System listed in the "Listing Oracle Beehive Remote Coexistence Systems" section, named TMCOEX2, is being assigned a new URL:

beectl> modify_coexistence_system --select_by_name TMCOEX2 --url http://new.example.com

You can also update the Remote Coexistence System's sitekey attribute.

See Also:

For more information about the modify_coexistence_system command, including available options and syntax, see "modify_coexistence_system" in Module 2 of the Oracle Beehive Administrator's Reference Guide.

Provisioning Users for Coexistence

Before users can take advantage of the Oracle Collaboration Coexistence Gateway, Oracle Beehive administrators must provision users for coexistence with a Remote Coexistence System. This section includes information about provisioning users for coexistence with a Remote Coexistence System using the modify_coexistence_profile command.

Prerequisites

Before provisioning users for coexistence with a Remote Coexistence System using the modify_coexistence_profile command the following conditions must be met:

Example 14-1 Provisioning a User for Coexistence

In this example, user2 is being provisioned for coexistence with Remote Coexistence System TMCOEX2.

Using the BEEHIVE argument for the --accessible_system option indicates an Oracle Beehive user who will be coexisting:

beectl> modify_coexistence_profile --select_by_authuser user1 --accessible_system BEEHIVE

Coexistence profile has been created and processing is initiated.

Using the BEEHIVE argument for the --accessible_system option, and then repeating the option with the EXCHANGE argument indicates that the user is a Team Collaboration-Enabled User (the user can access both Oracle Beehive and Microsoft Exchange):

beectl> modify_coexistence_profile --select_by_authuser user1 --accessible_system BEEHIVE --accessible_system EXCHANGE

Using the EXCHANGE argument only for the --accessible_system option indicates that the user is a Coexisting Third Party User (the user can access Microsoft Exchange only):

beectl> modify_coexistence_profile --select_by_authuser user1 --accessible_system BEEHIVE --accessible_system EXCHANGE

See Also:

For more information about the modify_coexistence_profile command, including available options and syntax, see "modify_coexistence_profile" in Module 2 of the Oracle Beehive Administrator's Reference Guide.

Post-Provisioning Notes

After running the modify_coexistence_profile command, the registration process will begin. To view whether the registration process has completed refer to "Viewing the Registration State of Coexisting Users".

Manually Importing User Data

To avoid or delay the registration process of coexistence users (which normally occurs automatically), you can run the beectl modify_coexistence_profile command with the --no_data_import option. You can then use the beectl import_coexistence_data command to manually trigger user data import.

You might wish to do this for any of the following reasons:

  • You want to customize date ranges and data types for a subset of users

  • You want to trigger the import at a later time, and not immediately when users are registered for coexistence

  • If the automated data import failed or partially succeeded, you can reattempt the import manually

  • You want to extend the date ranges to get more data in the past

To register a coexistance user without importing that user's data into Oracle Beehive, use the --no_data_import option, such as in the following example:

beectl> modify_coexistence_profile --select_by_authuser <user_login_id> --accessible_system BEEHIVE --no_data_import

To manually import coexistance user data into Oracle Beehive, use the beectl import_coexistence_data command:

beectl> import_coexistence_data [--user] [--select_by_name] [--select_by_address] [--select_by_authuser] [--data_type] [--timerange_start] [--relative_timerange_start] [--timerange_end] [--relative_timerange_end]

Use the --data_type option to specify one or more particular types of user data to import. Valid types are MEETING, TASK , CONTACT or MESSAGE.

Use the --timerange_start and --timerange_end options to specify an absolute range of time for which all data should be imported. You can use a timestamp, for example 2007-10-01T12:00:00Z. You can also use the keywords NOW (to specify a timerange beginning or ending with the current time) or INFINITY (to specify that there should be no limit).

Use the --relative_timerange_start and --relative_timerange_end options to specify a relative range of time (in days) for which all data should be imported. Specify an integer for each option. A negative integer represents a number of days prior to today, while a positive integer represents a number of days in the future (from today).

See Also:

For more information about the import_coexistence_data command, including available options and syntax, see "import_coexistence_data" in Module 2 of the Oracle Beehive Administrator's Reference Guide.

Viewing the Registration State of Coexisting Users

After a user has been provisioned for coexistence using the steps outlined in "Provisioning Users for Coexistence", Oracle Beehive will attempt to register the user. The user must be registered for coexistence before being able to coexist. Although this will occur automatically, it may take some time.

To view the registration state of coexisting users use the list_coexistence_profiles command:

beectl> list_coexistence_profiles

Output similar to the following will be returned:

--------------+---------------------+-----------+-------------------------------
User Name     | Accessible systems  | State     | Import state
--------------+---------------------+-----------+-------------------------------
user1         | BEEHIVE             | COMPLETED | NONE
--------------+---------------------+-----------+-------------------------------
user2         | BEEHIVE,EXCHANGE    | COMPLETED | CREATED
--------------+---------------------+-----------+-------------------------------
user3         | EXCHANGE            | COMPLETED | COMPLETED
--------------+---------------------+-----------+-------------------------------

Five possible values will appear in the State column:

  • CREATED indicates that the registration request has been created.

  • IN-PROGRESS indicates that the registration request has been sent to the Oracle Beehive Remote Coexistence System, but the Oracle Beehive Coexistence service is waiting for a response.

  • COMPLETED indicates that the registration request acknowledgement has been received from the Oracle Beehive Remote Coexistence System and the provisioning, and registration process has completed.

  • DELETED indicates that the user was once provisioned for coexistenence, but is no longer.

  • REJECTED indicates that the specified system(s) were not possible for a given user. For example, if you specify EXCHANGE as one of the systems for a user that does not exist in the Microsoft Exchange server, the registration process will fail and the profile will be set to REJECTED.

The value in the State column must be COMPLETED before a user has been fully provisioned for coexistence.

To view the additional information about the registration state of coexisting users, use the list_coexistence_profiles command with the --show_more option:

beectl> list_coexistence_profiles --show_more

The following columns will be displayed:

  • User Name

  • Accessible systems

  • State

  • Last Modification

  • Import State

  • Last import

To view complete information about coexisting users, use the list_coexistence_profiles command with the --show_all option:

beectl> list_coexistence_profiles --show_all

Output similar to the following will be displayed for each user:

===================================================================
User:user2
Accessible system: BEEHIVE,EXCHANGE
Profile process state: COMPLETED
Profile modifiedon: 8/5/08 7:34:07 AM
 
Data Type: CONTACT
GUID: guid-F14819DF1B5F4DA683E1C9393DFF106E000000000003
State: CREATED
Latest process time: NOT-PROCESSED
Received entity: 0
Expected entity: 0
Time range start: -INFINITY
Time range end: INFINITY
 
Data Type: MESSAGE
GUID: guid-F14819DF1B5F4DA683E1C9393DFF106E000000000002
State: CREATED
Latest process time: NOT-PROCESSED
Received entity: 0
Expected entity: 0
Time range start: 7/6/08 2:28:08 PM UTC
Time range end: INFINITY
 
Data Type: TASK
GUID: guid-F14819DF1B5F4DA683E1C9393DFF106E000000000001
State: CREATED
Latest process time: NOT-PROCESSED
Received entity: 0
Expected entity: 0
Time range start: 7/6/08 2:28:08 PM UTC
Time range end: INFINITY
 
Data Type: MEETING
GUID: guid-F14819DF1B5F4DA683E1C9393DFF106E000000000000
State: CREATED
Latest process time: NOT-PROCESSED
Received entity: 0
Expected entity: 0
Time range start: 7/6/08 2:28:06 PM UTC
Time range end: INFINITY
===================================================================

Deprovisioning Users from an Oracle Beehive Remote Coexistence System

If a users has been been provisioned for coexistence, and coexistence is no longer needed thereafter, the user can be deprovisioned. This section includes information about provisioning users for coexistence with a Remote Coexistence System using the delete_coexistence_profile command.

Example 14-2 Deprovisioning a User for Coexistence

In this example, user2 is being deprovisioned for coexistence from Remote Coexistence System TMCOEX2:

beectl> delete_coexistence_profile --select_by_name user2

Coexistence profile has been deleted and processing is started.

See Also:

For more information about the delete_coexistence_profile command, including available options and syntax, see "delete_coexistence_profile" in Module 2 of the Oracle Beehive Administrator's Reference Guide.

Post-Deprovisioning Notes

After running the delete_coexistence_profile command, the deprovisioning process will begin. To view the state of the coexistence profile refer to "Viewing the Registration State of Coexisting Users".

Oracle Connector for Exchange Administrative Tasks

This section explains how to stop and start Oracle Connector for Exchange. The following topics are covered in this section:

When installed in the default location, the command line tool to stop and start Oracle Connector for Exchange is located in the C:\oracle\product\<version>\exconnector_1\beehive\collabcoex_connector folder. This section assumes that you have navigated to the above mentioned directory from the Windows command line prompt.

Best Practices for Stopping and Starting Oracle Connector for Exchange

Oracle Connector for Exchange works in tandem with the BEECONNECTOR OC4J instance. Both are installed on the computer where Oracle Connector for Exchange was deployed.

Due to the interdependency between Oracle Connector for Exchange and the BEECONNECTOR OC4J instance, Oracle recommends stopping and starting the service and instance in a specific order.

Stopping When stopping the Oracle Connector for Exchange, Oracle recommends following these steps:

  1. Stop the BEECONNECTOR OC4J instance. For details about stopping the BEECONNECTOR OC4J instance, see "Stopping the BEECONNECTOR OC4J Instance".

  2. Stop Oracle Connector for Exchange. For details about stopping Oracle Connector for Exchange, see "StoppingOracle Connector for Exchange".

Starting When starting the Oracle Connector for Exchange, Oracle recommends following these steps:

  1. Start Oracle Connector for Exchange. For details about starting Oracle Connector for Exchange, see "StartingOracle Connector for Exchange".

  2. Start the BEECONNECTOR OC4J instance. For details about starting the BEECONNECTOR OC4J instance, see "Starting the BEECONNECTOR OC4J Instance".

Stopping Oracle Connector for Exchange

Before stopping the Oracle Connector for Exchange, the BEECONNECTOR OC4J instance must be stopped. For details about stopping the BEECONNECTOR OC4J instance, see "Stopping the BEECONNECTOR OC4J Instance".

To stop Oracle Connector for Exchange, run the following command:

coexctl.exe stop_connector

Note:

Oracle Connector for Exchange can also be stopped in the Windows Services panel, by selecting and stopping "Oracle Coexistence Connector for Exchange" and "Oracle Coexistence Administration Service".

Starting Oracle Connector for Exchange

To start Oracle Connector for Exchange, run the following command:

coexctl.exe start_connector

Note:

Oracle Connector for Exchange can also be started in the Windows Services panel, by selecting and starting "Oracle Coexistence Connector for Exchange" and "Oracle Coexistence Administration Service".

Stopping the BEECONNECTOR OC4J Instance

The BEECONNECTOR OC4J instance works in tandem with the Oracle Connector for Exchange. It is installed on the same computer as Oracle Connector for Exchange, and can be stopped using the following instructions:

  1. Click the Start button on the Windows computer hosting Oracle Connector for Exchange

  2. Select Programs

  3. Select Oracle - coex

  4. Click on Stop SOA suite

Starting the BEECONNECTOR OC4J Instance

The BEECONNECTOR OC4J instance works in tandem with the Oracle Connector for Exchange. The BEECONNECTOR OC4J instance is installed on the same computer as Oracle Connector for Exchange, and can be started using the following instructions:

Note:

The Oracle Connector for Exchange should be started before starting the BEECONNECTOR OC4J instance. For details about starting Oracle Connector for Exchange, see "StartingOracle Connector for Exchange".
  1. Click the Start button on the Windows computer hosting Oracle Connector for Exchange

  2. Select Programs

  3. Select Oracle - coex

  4. Click on Start SOA suite

Configuring Oracle Connector for Exchange to use HTTPS

If Oracle Beehive was configured to use HTTPS, the Oracle Connector for Exchange must be configured to use the Oracle Beehive HTTPS URL.

Follow these steps to configure Oracle Connector for Exchange to use the Oracle Beehive HTTPS URL:

  1. Stop the BEECONNECTOR OC4J Instance. For information about stopping the BEECONNECTOR OC4J Instance, refer to Stopping the BEECONNECTOR OC4J Instance.

  2. Using the command prompt on the computer hosting Oracle Connector for Exchange, navigate to the C:\oracle\product\<version>\exconnector_1\beehive\collabcoex_connector directory.

    Where <version> represents the installed version of Oracle Connector for Exchange.

  3. Run the following command:

    coexctl.exe set_property --file C:\oracle\product\<version>\beehive\collabcoex_connector\conf\OGWEConfiguration.xml --section communicationservice --property endpoint --value "https://<OracleBeehiveHost>:<OracleBeehivePort>/coexService/CoexMLPort"
    

    Where:

    • <OracleBeehiveHost> represents your Oracle Beehive hostname

    • <OracleBeehivePort> represents the HTTPS listening port of your Oracle Beehive installation

  4. Start the BEECONNECTOR OC4J Instance. For information about starting the BEECONNECTOR OC4J Instance, refer to Starting the BEECONNECTOR OC4J Instance.

Oracle Change Notification Service for Exchange Administrative Tasks

This section explains how to stop and start the Oracle Change Notification Service for Exchange from the command line.

When installed in the default location, the command line tool to stop and start the Oracle Change Notification Service for Exchange is located in the c:\oracle\product\<version>\exconnector_1\beehive\collabcoex_connector folder. This section assumes that you have navigated to the above mentioned directory from the Windows command line prompt.

Stopping Oracle Change Notification Service for Exchange

To stop the Oracle Change Notification Service for Exchange, run the following command:

coexctl.exe stop_eventsink

Note:

Oracle Change Notification Service for Exchange can also be stopped in the Windows Services panel, by selecting and stopping "Oracle Change Notification Service for Exchange".

Starting Oracle Change Notification Service for Exchange

To start the Oracle Change Notification Service for Exchange, run the following command:

coexctl.exe start_eventsink

Note:

Oracle Change Notification Service for Exchange can also be started in the Windows Services panel, by selecting and starting "Oracle Change Notification Service for Exchange".