Skip Headers
Oracle® Beekeeper Online Help
Release 1 (1.5)

Part Number E14838-01
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

4 Managing Services

This module provides an overview of the different services that administrators can manage using Oracle Beekeeper.

Accessing Services

To access a service, click it in the Services pane on the bottom-left side of the window. To view the current configuration of the service, click the Configuration tab. To view metrics for a service, click the Metrics tab. To view logs for a service, click the Logs tab.

Modifying Services

When you modify a service, you save a change or a series of changes as a proposed configuration. To apply your changes, you must validate and activate your proposed configuration. For more information, see Proposed Configuration and Active Configuration.

To modify a service:

  1. Select the service in the Services pane on the bottom-left side of the window.

  2. Click the Configuration tab.

  3. Click Edit.

    A window opens showing all of the configurable parameters and their current values

  4. Modify the values for any of the parameters.

  5. Click Save & Close to store your proposed changes.


    The main window for each service only displays the active configuration for the service. Therefore, when you modify a service, your changes will not appear in the main window until you validate and activate your proposed configuration.
  6. If you made changes to a parameter of the Authentication Service included in the following list, you must run beectl modify_local_configuration_files after saving your changes. Until you do so, the changes will not be active in the system.


    The beectl modify_local_configuration_files command may restart various affected components of Oracle Beehive.
    • AuthStoreType

    • LoginAttempts

    • LockoutTime

    • OssoConfigFile

    • SsoLogoutUrl

    • SsoType

    • UseJazn

    • UseSecureCookie

    • WnaEnabled

    • WnaKeytab

    • WnaPrincipal

    • WsSecurityExpiry

    • WsSecuritySamlEnabled

    • WsSecuritySigKeyAlias

    • WsSecuritySigKeyPwd


This section describes the services you can manage through Oracle Beekeeper:

For detailed information on each Oracle Beehive service, including descriptions of key parameters, please consult "Managing Services" in the Oracle Beehive Administrator's Guide.

Access Control

The Access Control Service manages how users are permitted to access (view, use, and manipulate) entities in Oracle Beehive, such as files, workspaces, client services, and shared resources.


The Alarm Service handles all time management-related alerts for the system, and enables users to configure and receive alerts such as reminders prior to meeting start times. The Alarm Service is also responsible for signaling the activation of other services at preconfigured times.


The Audit Service is the service interface to the Oracle Beehive Audit Framework, which supports and manages all aspects of auditing for system and business events, policies, and workflows.


The Authentication Services manage all aspects of user authentication for Oracle Beehive, including single sign-on (SSO), user repository authentication, authentication policies, and encryption.


After making changes to certain security-related parameters, and applying your changes, you must also run the beectl modify_local_configuration_files command on the command-line. Until you do so, your changes will not be active. See "Modifying Services" for a complete list of affected parameters.


The BeeCentral Service manages Oracle Beehive Central; the Web page provided for Oracle Beehive users, primarily for downloading clients and updates.


The CalDAV Service manages all time management-related features and settings that the system leverages using the Calendaring Extensions to WebDAV (CalDAV) protocol, including:

  • Session cache settings, such as the maximum number of entries allowed in the authentication token table and the length of time (in seconds) an authentication token is valid

  • Directory cache settings, such as the maximum number of entries allowed in the directory cache and the length of time (in seconds) an entry is valid

  • Collection-related settings, such as whether or not browsing on collections is enabled and the default media type for collections if none is specified in client requests

Client Management

The Client Management Service allows you to manage client software settings related to client connections, notification thresholds, and debugging.

Using the Client Management Service, you can:

  • Set session timeout values

  • Enable trace logs and debug mode

  • Set the node address on which to listen for incoming client requests

  • Set the maximum number of pending notifications the Client Management Service will hold for supported clients

  • Suspend the threshold for the client notifications queue


The Coexistence Service enables organizations to integrate Microsoft Exchange Server 2003 with Oracle Beehive for maximum interoperability.


The Conference Artifact Service enables Web conferencing capabilities including video, voice, text, instant messaging, and desktop sharing.

Device Management

The Device Management Service enables you to manage supported client software such as Oracle Beehive Integration for Outlook, installed on end-user computers, and mobile devices.


The Discussions Service enables organizations to host threaded, online discussion forums in which users can browse message boards, and post and respond to messages.

Using the Discussions Service, you can:

  • Set policy- and security-based filters including anti-spam capabilities

  • Use predefined roles (moderator, reader, contributor, editor)

  • Control permissions for users and groups

  • Allow programmatic access through Web Services


The Email Service supports all aspects of e-mail creation, delivery, and management for Oracle Beehive.


The Events Service manages business events and related configuration settings, including:

  • Handling requests from the Subscription Service regarding subscriptions on business events

  • Setting the log level for business events processing

  • Specifying the number of times the system should retry failed actions that result from business events

Fax Message

The Fax Message Service enables forwarding of fax messages from the Cisco Call Manager to Oracle Beehive users, as e-mail attachments.


The FTP Service supports and manages all content management-related features and settings that the system leverages through FTP and FTP over TLS, including:

  • Support for FTP clients such as CuteFTP, WS_FTP, and SmartFTP

  • Whether or not the specified FTP server is enabled for Oracle Beehive

  • The port number at which the FTP Service will listen for requests

  • The maximum number of ports the FTP Service can use for passive listening

  • The buffer size between streams during content uploads

  • The length of time (in seconds) the service will allow a user session to remain inactive before timing out

Instant Message (IM)

The Instant Message Service provides core instant messaging features, including:

  • Message encryption

  • Rosters (buddy lists) based on Oracle Beehive address books and People lists

  • Presence support (provided by the Presence Service) with customizable status settings

  • Offline capabilities such as sending an instant message through e-mail

  • Server-side message transcripts


The Management Service supports all aspects of system administration for Oracle Beehive.

Using the Management Service, you can:

  • Configure system and infrastructure on the fly (host names, ports, connections, memory, and so on) and management (start, stop, refresh, and restart)

  • Monitor performance and usage in real time

  • Trace parameter configuration (including the ability to attach probes to transactions)

  • Identify and examine errors in transactions

  • Link trace errors to log records

  • Manage logs

  • Manage log files including rotation and disposition functions (parameter and qualifier definitions)

  • Manage your log file repository (size management, truncation schedules)

  • Integrate your Oracle Beehive system with Oracle Enterprise Manager Grid Control

  • Remote monitoring through integration with existing Oracle and third-party system management tools and standardized protocols

Mobile DM

The Mobile Device Management Service manages the communications and configuration settings for the Mobile Device Management Server, which enables connections between the Device Management Service and supported device-resident Mobile Device Management clients.

Notification Delivery

The Notification Delivery Service is responsible for the delivery of event notifications. Message delivery can be accomplished through e-mail, instant messages, and Simple Message Service (SMS). The service also allows users to schedule when such notifications should be delivered or temporarily block them altogether.

Mobile Mail

The Mobile Mail Service provides a complete Push IMAP (P-IMAP) v0.6 implementation for real-time delivery of e-mail to users' mobile devices. The service also manages the features and settings related to push mail, including:

  • The maximum number of concurrent users the Mobile Mail Service will allow

  • The maximum number of e-mail messages the Mobile Mail Service will allow in each user's mobile device inbox

  • The number of invalid login attempts the Mobile Mail Service will allow each mobile user to make before closing a connection

  • Whether or not connections to the specified IMAP server are enabled

Mobile Push

The Mobile Push Service is responsible for delivering notifications to Push clients running on end users' mobile devices. It is, in essence, an event dispatcher for those devices. For example, Mobile Push Service alerts can indicate changes in users' inboxes, calendars, task lists, and address books. Alerts can also prompt users to take action on corresponding device management events.

Additionally, the Mobile Push Service manages the following features and settings:

  • The Internet-accessible address, port number range, and type of listener for the Mobile Push Server

    • Supported types include HTTP, TCP, and the Oracle Beehive Transport Infrastructure (BTI)

  • The length of time (in minutes) of inactivity the service will allow before terminating an unauthenticated session

  • The maximum number of concurrent connections the Mobile Push Service will allow

  • The number of invalid login attempts the Mobile Push Service will allow before closing a connection


The Notification Service handles all aspects of creating notifications for Oracle Beehive.


The Platform Service enables organizations to leverage the Oracle Beehive platform and its APIs, and support integration and coexistence with third-party components, Web services, and custom solutions.


The Policy Service enables organizations to centrally apply, manage, and store business logic for Oracle Beehive events. A policy is a set of server-side rules that defines what actions the system must take when one or more events occur. Policies can apply to any Oracle Beehive entity, including users, artifacts, services, and workspaces. The Policy Service leverages the Oracle Beehive Event Framework, and also provides the following key features:

  • Policy and policy schema extensibility

  • Inheritance model that supports enterprise-level policies with exceptions and extensions for specified groups, levels, and entities

  • Policy templates that enable you to define the extensible characteristics of policies and the business rules that they contain


The Presence Service supports and manages all aspects of user and resource presence for Oracle Beehive. Presence is the ability to detect and identify the status of a user or resource, and then display that status to other users and resources in one or more clients or applications.

Records Management

The Records Management Service supports all aspects of records management of documents and e-mail for Oracle Beehive through integration with Oracle Universal Records Management (URM). Oracle URM enables you to manage records and retention policies, disposition processes, and litigation holds or freezes in a central repository, or Universal Records Management (URM) server. You can then apply policies, dispositions, and holds to content stored in other systems, such as Oracle Beehive. Although the records associated with e-mail and documents are managed by Oracle URM, the artifacts themselves are stored and maintained in the Oracle Beehive content repository.


Oracle URM is a separate product not included with Oracle Beehive. For more information about using Records Management with Oracle Beehive, see "Managing Records Management" in Chapter 6, "Managing Oracle Beehive Workspaces" of the Oracle Beehive Administrator's Guide.

Resource Directory

The Resource Directory Service provides a common definition for all Oracle Beehive resources and a centralized location to access and manage resource entries. The Resource Directory Service manages all aspects of the resources provided in Oracle Beehive directories, enabling users to view and schedule resources through supported time management features. This includes related settings such as the total number of resources returned in search results.


The Search Service supports and manages all aspects of user-initiated, text-based searches for Oracle Beehive.

SMPP Delivery

The SMPP Delivery Service provides Short Message Peer-to-Peer (SMPP) connectivity to other Oracle Beehive services, particularly mobility services.


The Subscription Service handles all aspects of subscription logic for Oracle Beehive subscriptions.


The Syndication Service provides Really Simple Syndication (RSS) feed subscription capability to Oracle Beehive users.

Time Management

The Time Management Service provides the coordination services for the core aspects of Oracle Beehive calendars, scheduling, task management, and reminders. This includes support for multiple calendars and task lists in workspaces, automatic updates of group-based invitations and task assignments resulting from group definition changes, and the integration of BPEL-based tasks and processes.

Time Zone

The Time Zone Service supports and manages all aspects of synchronizing user schedules and calendar entries across global time zones. The Time Zone Service unifies the coordination of all time zone-related components and activities in Oracle Beehive.


The Transcoding Service supports and manages all the data and audio conversions for Oracle Beehive voice and Web conferences.

User Directory

The User Directory Service manages all aspects of user directory management for Oracle Beehive and supports a variety of implementations including local storage of users and groups as well as integrations with existing Oracle and third-party user directories.

Other key user directory management features provided by the User Directory Service include:

  • Support for National Language Support (NLS) user aliases

  • Customizable user attribute fields

  • Attribute mapping with existing user directories

  • User creation through pre-defined templates

  • Import capabilities of directory data based on Extensible Markup Language (XML) files

  • Bulk user management functions such as creating, modifying, and deleting users

The User Directory Service supports integration with the following user directory servers:

  • Oracle Internet Directory

  • IBM Tivoli

  • Microsoft Active Directory

  • Sun Java System Directory Server

Voice Message

The Voice Message Service supports all aspects of voicemail and fax management for Oracle Beehive. The Voice Message Service can be leveraged by the E-mail Service, enabling delivery of voicemail messages and faxes as e-mail. The Voice Message Service also supports multiple locations, including private branch exchanges (PBXs), and multiple languages, enabling enterprises to support a variety of network and user needs all within a single Oracle Beehive instance. Supported options include integration of existing telephony infrastructures with Oracle Beehive.


The WebDAV Service supports and manages all content management-related features and settings that the system leverages over the Web-based Distributed Authoring and Versioning (WebDAV) protocol, including:

  • Support for WebDAV clients

  • Whether or not the specified WebDAV server is enabled for Oracle Beehive

  • The default authentication scheme for WebDAV clients

  • Length of time (in minutes) before browser-based and WebDAV-based client cookies expire

  • The minimum value (in minutes) allowed for content locks

  • Length of time (in minutes) before the system refreshes each active user's preferences

  • The buffer size between streams during content uploads and downloads

  • Shortcuts for content


The Wiki Service provides the Oracle Beehive Wiki workspace functionality.


The Workflow Service supports and manages for Oracle Beehive all workflow settings and other aspects that are related to integrations with Business Process Execution Language (BPEL) components. Out of the box, Oracle Beehive contains an internal Oracle BPEL Process Manager instance and provides two default workflows for content management, which allow either serial or parallel approval-based capabilities for content. Integration with external Oracle BPEL Process Manager instances and workflows is also supported.


The Workspace Service supports all the features and functionality provided by Oracle Beehive personal and team workspaces. In addition to collaborating with other workspace members and managing their artifacts, the Workspace Service enables users to manage their own workspace environments. The Workspace Service provides XML-based templates that enable self-service workspace creation, including the configuration of workspace properties such as workspace name, description, and URLs, among others. The Workspace Service enables you to manage workspaces from the enterprise level by configuring settings such as soft and hard quotas for workspaces and groups.


The XMPP Service supports and manages all the features and settings that the system exposes through the Extensible Messaging and Presence Protocol (XMPP) v 0.9 and 1.0., including:

  • Support for XMPP clients such as Pidgin (formerly Gaim), iChat, Oracle Messenger, and Trillion Pro

  • Multiple authentication methods

  • The list of all supported messaging agents

  • The port number at which all XMPP servers will communicate

  • The port number at which the system will encrypt messages over Secure Sockets Layer (SSL)

  • The default language for messages

Zimbra Connector

The Zimbra Connector Service communicates between the Oracle Beehive server and any deployed instances of Oracle Beehive Integration for Zimbra.