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.

   Note:

   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.

   Caution:

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

   • AuthStoreType

   • JssoSessionTimeout

   • LoginAttempts

   • LockoutTime

   • OssoConfigFile

   • SsoLogoutUrl

   • SsoType

   • UseJazn

   • UseSecureCookie

   • WnaEnabled

   • WnaKeytab

   • WnaPrincipal

   • WsSecurityExpiry

   • WsSecuritySamlEnabled

   • WsSecuritySigKeyAlias

   • WsSecuritySigKeyPwd

Enabling and Disabling Services and Service Instances

You can set a service or service instance to be disabled. A disabled service or service instance will not start when Oracle Beehive is started. To start such a service, you must first enable it, and then start the service (or restart Oracle Beehive).

Many services are essential to the normal operation of Oracle Beehive, and therefore should not be disabled. To avoid system errors or a service outage, you should only disable a service if advised to do so by Oracle documentation or an Oracle service representative.

To enable or disable a service or service instance:

1. Click the name a service in the Services list. From the service pane, you can select a service instance from the Go to drop down list at the top of the pane.

   Or, from the Topology module, navigate to a service or service instance, select it in the list, and from the View menu, click Configuration.

2. In the service pane, click the Configuration tab.

3. Click Edit. A new window opens, showing the service configuration parameters.

4. In the new window, click the Advanced link to show the advanced options.

5. Select Enabled or Disabled from the Status drop down list.

6. Click Apply to apply the change to the proposed configuration and leave the window open, or click Save & Close to apply the change and close the window.

7. You must activate your proposed configuration to apply your change. SeeActive Configuration for details.

Comparing Service Configuration Versions

From any Service view, you can compare current and prior configurations and proposed configurations, to see which service properties may have been changed. To compare configurations:

1. Click on any service. To compare a service instance configuration, use the Go to drop down list to navigate to the service instance.

2. On the Configuration tab, click Compare. The Compare Configuration Versions window opens.

3. Using the drop down boxes, select a Baseline Version and an Other Version to compare to it. Click Compare. In the lower pane, any differences between the two configuration versions are shown.

4. When you are done reviewing the changes, close the Compare Configuration Versions window.

Services

See Also:

For descriptions of the service properties, please consult "Oracle Beehive Property Reference" in the Oracle Beehive Administrator's Reference Guide.

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

• Access Control

• Alarm

• Audit

• Authentication

• BeeCentral

• Beehive Conferencing

• CalDAV

• Client Management

• Coexistence

• Conference

• Device Management

• Discussions

• Email

• Event

• Fax Message

• FTP

• Identity Provider

• Instant Message (IM)

• Management

• Mobile Data Sync (OMA)

• Mobile Device Management (Mobile DM)

• Mobile Instant Message (MIM)

• Mobile Mail

• Mobile Push

• Notification Delivery

• Platform

• Policy

• Presence

• Records Management

• Resource Directory

• Remote Content

• Search

• SES Endpoint

• SMPP Delivery

• Subscription

• Syndication

• Team Collaboration

• Time Management

• Time Zone

• Transcoding

• User Directory

• Voice Message

• WebDAV

• Wiki

• Workspace

• XMPP

• Zimbra Connector

• Zimbra User Interface (UI)

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.

Alarm

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 pre-configured times.

Audit

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, and policies.

Authentication

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

Caution:

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.

BeeCentral

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

Beehive Conferencing

The Beehive Conferencing Service provides connectivity for Oracle Beehive Conferencing online meetings. You can designate locations for the Windows and Apple Macintosh client software, if you do not want to use the default locations (accessible from the Oracle Beehive Central client download page).

CalDAV

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

Coexistence

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

Conference

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.

Discussions

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

Email

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

See Also:

For extensive documentation about how to manage and configure e-mail using Oracle Beekeeper, see Chapter 8, "Managing Oracle Beehive E-mail," in the Oracle Beehive Administrator's Guide

Event

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.

FTP

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

Identity Provider

The Identity Provider Service provides certificate authority features for Oracle Beehive, enabling the system to manage digital certificates and other related security credentials.

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

Management

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 Data Sync (OMA)

The Mobile Data Sync Service provides for automatic synchronization of e-mail, calendar, task, and address book data on mobile devices.

Mobile Device Management (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.

Mobile Instant Message (MIM)

The Mobile Instant Message service manages delivery of instant messages to and from mobile devices.

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

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.

Platform

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.

Policy

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

Presence

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.

Note:

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.

Remote Content

The Remote Content Service provides connectivity to remote repositories using Oracle Universal Content Repository (UCM).

Search

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

SES Endpoint

The SES Endpoint Service provides connectivity to Oracle Secure Enterprise Search.

SMPP Delivery

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

Subscription

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

Syndication

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

Team Collaboration

The Team Collaboration Service provides much of the functionality for the Oracle Beehive Workspaces client.

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.

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.

Transcoding

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.

WebDAV

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

Wiki

The Wiki Service provides the Oracle Beehive Wiki functionality in the Oracle Beehive Workspaces client.

Workspace

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.

XMPP

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, 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.

Zimbra User Interface (UI)

The Zimbra User Interface Service provides some of the custom functionality available through Oracle Beehive Webmail.