15 Documentation Notes

This module contains the following type of information regarding Oracle Beehive documentation:

• Changes in Oracle Beehive Documentation

• Known Issues with Administration Documentation Issues

• Known Issues with End-User Documentation

Changes in Oracle Beehive Documentation

The first edition of the documentation library for Oracle Beehive Release 1 (1.2 and 1.3) was published on April 30, 2008. This section lists the major changes that have been made in each edition of the documentation library since then. All changes are cumulative.

• Changes in Oracle Beehive Documentation: August 11, 2008

• Changes in Oracle Beehive Documentation: May 27, 2008

Changes in Oracle Beehive Documentation: August 11, 2008

The following table lists the changes made in the August 11, 2008 edition of the Oracle Beehive documentation library.

Table 15-1 Changes in Oracle Beehive Documentation: August 11, 2008

Book	Change
Oracle Beehive Administrator's Guide	Added section "Listing Users" in "Managing and Provisioning User Accounts" module Added section "Listing Groups" in "Managing Groups" Added section "Using Expressions in Workspace Templates" in "Managing Oracle Beehive Workspaces" module Updated beectl commands and user account attributes throughout
Oracle Beehive Administrator's Reference Guide	Added the following commands: add_attendant; add_voice_enterprise; add_voice_facility; delete_coexistence_profile; delete_voice_enterprise; delete_voice_facility; download_ldap_group_data; modify_directory_profile; modify_hostname; validate_virus_scan_engine_connectivity Replaced the following commands: list_coexistence_users (replaced by list_coexistence_profile); modify_coexistence_users (replaced by modify_coexistence_profile) Removed the following commands: shutdown; test_virus_scan_engine_connectivity; upload_translation Revised details for the following commands: add_custom_user; add_dmz_home_instance; download_language_pack; add_resource; add_user; add_virus_scan_engine; clone_site; delete_external_contact; export_errorcodes; export_filesystem_logs; list_groups; list_users; modify_coexistence_connector; modify_external_contact; modify_resources; modify_user; restart; start; status; stop
Oracle Beehive Concepts	Added section "Delegation" in "Overview of Oracle Beehive" module Added section "Difference Between a Service and a Service Instance" in "Oracle Beehive Services" module Added section "Oracle Beehive Administration Console" in "Oracle Beehive Management and Administration Concepts" module Added section "Oracle Beehive Integration for Zimbra" in "Oracle Beehive End-User Clients" module
Oracle Beehive Deployment Guide	Added section "Oracle Beehive Administration Console" in "Tools for Deploying Oracle Beehive" module Added section "Oracle Beehive Integration for Zimbra" in "Deploying Oracle Beehive with Supported Clients and Devices" module
Oracle Beehive Installation Guide (All Operating Systems)	Added module "Oracle Beehive Administration Console Installation Help" Added module "Upgrading Oracle Beehive" Added module "Running Oracle Beehive Provisioning Application" Added sections for installating and configuring Oracle Beehive Integration for Zimbra
Oracle Beehive End-User Information	Added information for RIM BlackBerry devices in "Configuring Mobile Devices" module Added module "Configuring Preferences"
Oracle Beehive Administration Console Online Help	New book

Changes in Oracle Beehive Documentation: May 27, 2008

The following table lists the changes made in the May 27, 2008 edition of the Oracle Beehive documentation library.

Table 15-2 Changes in Oracle Beehive Documentation: May 27, 2008

Book	Change
Oracle Beehive Administrator's Guide	Added module "Managing Oracle Beehive Time Management"
Oracle Beehive Installation Guide (All Operating Systems)	Added module "Configuring External Oracle BPEL Process Manager with Oracle Beehive"
Oracle Beehive Application Developer's Guide	Removed sample code (including custom workflows and Web Services samples); updated samples are now available at the Oracle Beehive website Added the section "Searching for Artifacts with Web Services" in the module "Oracle Beehive Web Services"

Known Issues with Administration Documentation Issues

This section contains information on known issues with the documentation for Oracle Beehive administration, and includes the following topics:

• Format for Entering Values that Begin with Hyphens(-) Does Not Work

• Incorrect Values Provided for status Parameter of modify_user Command

• Incorrect Format Provided for address Parameter of modify_user and add_external_user Commands

Format for Entering Values that Begin with Hyphens(-) Does Not Work

Bug 6601536. The format recommended by the Oracle Beehive Administrator's Reference Guide for changing command-line values that begin with hyphens (-) does not work. Specifically, the guide recommends the <option-name>=<option value> format. To avoid this issue, use one of the other formats that the guide recommends.

Incorrect Values Provided for status Parameter of modify_user Command

Note:

This issue is resolved in Release 1 (1.3) and later.

Bugs 6882302 and 6882440. The beectl command-line help and the Oracle Beehive Administrator's Reference Guide provide incorrect values for the status parameter of the modify_user command. The correct values supported by this parameter are disabled, enabled, and locked.

Incorrect Format Provided for address Parameter of modify_user and add_external_user Commands

Note:

This issue is resolved in Release 1 (1.3) and later.

Bug 6882311. The beectl command-line help provides an incorrect format for the personal setting of the address parameter. The correct format should include the underscore character (_) between personal and its index number. This parameter is supported by the modify_user and add_external_user commands.

Known Issues with End-User Documentation

This section contains information on issues with the documentation for Oracle Beehive end users, and includes the following topics:

• Incorrect Configuration Information for CalDAV Client

• Incorrect Version Numbers Provided for Certified Mozilla Lighting and Sunbird Clients

• Port Number Entries Missing in Example URLs Provided in "Configuring Mobile Devices" Module

Incorrect Configuration Information for CalDAV Client

In the sections entitled "Mozilla Lighting 0.7" and "Mozilla Sunbird 0.7", Oracle Beehive End-User Information Release 1 (1.3) incorrectly instructs users to configure the Location field using their user IDs in the following structure:

http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-ID>/calendars/MyCalendar

Instead, users should use their e-mail addresses in the following structure:

http://<Server-Name>:<Port-Number>/caldav/<Enterprise-ID>/home/<User-Email-Address>/calendars/MyCalendar

Incorrect Version Numbers Provided for Certified Mozilla Lighting and Sunbird Clients

Oracle Beehive End-User Information, Release 1 (1.3) incorrectly states that Mozilla Lighting 0.7 and Mozilla Sunbird 0.7 are certified for Oracle Beehive Release 1 (1.3). The correct version number for the certified versions of these clients is 0.8.

Port Number Entries Missing in Example URLs Provided in "Configuring Mobile Devices" Module

The example URLs provided in the "Configuring Mobile Devices" module (from Oracle Beehive End-User Information, Release 1 (1.3)) incorrectly omit entries for port numbers.

For example, the documentation instructs certain users to configure their mobile devices using the following URL structure:

http://<Server-Name>/mobiledm/

In this example, these users should instead include the port number for their Oracle Beehive deployments, as follows:

http://<Server-Name>:<Port-Number>/mobiledm/