Sun Java System Connector for Microsoft Outlook 6 2004Q2 Release Notes

Sun Java™ System Connector
for Microsoft Outlook Release Notes

Version 6 2004Q2

Part Number 817-6618-10

Last updated: June 18, 2004

These release notes contain important information available at the time of release of Version 6 2004Q2 of Sun Java System Connector for Microsoft Outlook (also referred to as Connector for Microsoft Outlook). New features and enhancements, known limitations and problems, technical notes, and other information are addressed here. Read this document before you begin using Sun Java System Connector for Microsoft Outlook 6 2004Q2.

The most up-to-date version of these release notes can be found at /docs/cd/E19263-01/817-6618. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.

Please see the section What’s New in This Release for information on features that are new to this release.

These release notes contain the following sections:

Third-party URLs are referenced in this document and provide additional, related information.


Note

Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.



Release Notes Revision History

Table 1  Revision History 

Date

Description of Changes

April 2004

Initial release of these release notes

June 2004

Added the following sections: "What’s New in This Release," "Bugs Fixed in This Release," and "Localization Issues."


About Sun Java System Connector
for Microsoft Outlook, Version 6 2004Q2

Sun Java System Connector for Microsoft Outlook enables Outlook to be used as a desktop client with Sun Java Enterprise System.

Connector for Microsoft Outlook is an Outlook plug-in that must be installed on the end-user’s desktop. Connector for Microsoft Outlook queries the Sun Java System Messaging Server for folder hierarchies and email messages. It converts the information into Messaging API (MAPI) properties that Outlook can display. Similarly, it uses WCAP to query the Sun Java System Calendar Server for events and tasks which are then converted into MAPI properties. With this model, Sun Java System Connector for Microsoft Outlook builds an end-user Outlook view from two separate information sources: mail from Messaging Server and calendar information from Calendar Server.


Note

Please note, the package that is Sun Java System Connector for Microsoft Outlook does not include any migration tools. You need those tools if you have users that are currently on Microsoft Exchange and would like to use Outlook with Sun Java Enterprise System. Sun provides a migration service to help move data and users from an existing Exchange deployment to Sun Java Enterprise System.


This section includes:

What’s New in This Release

New features in Sun Java System Connector for Microsoft Outlook 6 2004Q2 include:

Key Features in Sun Java System Connector
for Microsoft Outlook

The following key features and functionality are available with this release:

System Requirements

The following describes the system requirements and recommendations for Sun Java System Connector for Microsoft Outlook.


Bugs Fixed in This Release

The table below describes the bugs fixed in Sun Java System Connector for Microsoft Outlook 6:

Table 2  Fixed Bugs in Sun Java System Connector for Microsoft Outlook 6 2004Q2 

Bug Number

Description

5007229

Auto-archive process causes frequent screen flashes.

5007236

CPU utilization at 100 percent each time send or received is triggered.

5009342

Power user cannot install package.

5012162

Exchange calendar migration tool encounters dialog box from Connector for Microsoft Outlook.

5016367

SMTP fails to deliver message if sender email is incorrectly configured.

5028465

“Offline Task” label is not fully visible (Korean version).

5031317

Deleted folder continues to appear in folder list.

5031873

Undelivered email notice displays English text (Chinese version).

5033620

UserID becomes unrecognizable in “add user” dialog for calendar permission (Japanese version).

5033627

In Deployment Configuration Program, “User DN Pattern” label under LDAP tab is cut short (Japanese version).

5033662

UserID becomes unrecognizable in shared calendar folder (Japanese version).

5033748

Unrecognized characters appear in copyright in the “About Sun Java System Connector for Microsoft Outlook” dialog (Japanese version).

5033763

In Debug Logs dialog, the “Email for log level” label is not entirely displayed (Japanese version).

5034894

In offline mode, the button label text for “Deselect all” is not entirely displayed in the “Offline/cached Mailbox...” dialog (Korean version).

5034904

Message sent with no subject displays as English (“<No Subject>”) in Korean version.

5040590

In Deployment Configuration Program, reference to IMAPSP exists in “IMAP” tab.

5042029

A changed “reply-to” field only effective in Outlook.

5042526

Administrator login or access necessary to install.


Installation and Configuration Notes

Connector for Microsoft Outlook is an Outlook plug-in that requires installation on the end users’ desktop. A deployment and configuration program is provided to aid the organization in deploying Connector for Microsoft Outlook.


Note

Before you install Sun Java System Connector for Microsoft Outlook, please check http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage for the latest information about any required patches.


The installation and deployment is a three-step process:

  1. Install the administrator package.
  2. Create an installation package for the end user.
  3. Deploy the installation package.

The Connector for Microsoft Outlook packages ships an installer for the administrator package. The system administrator should prepare a special installation package called the Setup Wizard for the end user. The Setup Wizard installs and configures the Connector for Microsoft Outlook software on your desktop. This installation package is designed to simplify and automate the installation process.

For installation, configuration, and deployment instructions please see the following:

Converting Data

One of the optional steps that can be performed during setup and configuration of Connector for Microsoft Outlook is the conversion of data that resides on the desktop. This conversion process is invoked only if the administrator checks the “Convert existing profile” option during the creating of the end user installation package. Please note, this conversion process is not intended to, nor does it replace the need for server-based migration. Sun provides a migration service to help move data and users from an existing Exchange deployment to Sun Java Enterprise System.

The conversion step is also not intended for any other non-Exchange profiles that might exist for a user.

LDAP Attributes

In order for Connector for Microsoft Outlook to function correctly, the following LDAP attributes in the Sun Java System Directory Server should be indexed for at least presence and equality to improve the overall performance:

For more information on these attributes, see Sun Java System Calendar Server Administration Guide and Sun Java System Messaging Server Administration Guide.


Sun Java System Calendar Server 6 2004Q2 Considerations

Sun Java System Calendar Server 6 2004Q2 considerations for the Sun Java System Connector for Microsoft Outlook 6 2004Q2 release include:

Calendar Server Installation

The latest version of Calendar Server is available at http://www.sun.com/software/product_categories/email_calendar_collaboratoin.html.

It is recommended that customers also install the latest set of patches, which are available at Sun Solve (http://sunsolve.sun.com).

For detailed installation instructions, refer to the Sun Java Enterprise System Installation Guide. For configuration instructions, refer to the Sun Java System Calendar Server Administration Guide.

Required LDAP mail Attribute

Calendar Server 6 2004Q2 (and later) requires users to have the LDAP mail attribute for both user and resource calendars.

For clients to use Microsoft Outlook to schedule resource calendars (for example, for meeting rooms or equipment such as a notebook computer or overhead projector), each resource must have an email address, even though email is not actually needed. The LDAP mail attribute specifies this email address.

You might specifically need to add the LDAP mail attribute as follows:

Existing 5.x Installation. Before you run the cs5migrate migration utility, add the mail attribute to users for both user and resource calendars. To add the mail attribute, use the Calendar Server csattribute utility or a utility such as the Directory Server ldapmodify utility.

New 6.0 Installation. Provision the LDAP mail attribute for existing users for both user and resource calendars using the Calendar Server csattribute utility or a utility such as the Directory Server ldapmodify utility.

If you create new calendars or users after installation, use the required -m email option to specify an email address when you run these Calendar Server utilities:

For related information about csattribute, csresource, and csuser, refer to the Sun Java System Calendar Server Administration Guide. For related information about ldapmodify utility, refer to the Sun Java System Directory Server Resource Kit Tools Reference.

Example: Adding the email LDAP Attribute to a Resource Calendar

The following example adds the LDAP mail attribute for a conference room named “Room100” on the sesta.com server. This example configures Messaging Server. If you are using another email server, refer to that product’s documentation for the equivalent process.

  1. Add the mail attribute to the LDAP server using the csattribute utility:
  2. # ./csattribute -a mail=Room100@sesta.com add Room100

  3. To check that the attribute has been set, use the csattribute list command with the -v (verbose) option:
  4. # ./csattribute -v list Room100

    ...

    cn=Room 100,ou=conferenceRooms,dc=sesta,dc=com has mail: Room100@sesta.com

Example: Setting up the bitbucket Channel for the Resource Email

The following examples set up the bitbucket channel for Messaging Server or the equivalent for Sendmail for the email generated for resource calendars. These examples use a resource named “Room100” on the sesta.com server. If you don’t set up the bitbucket channel (or equivalent), you will need to periodically delete the email messages sent to the resource calendar.

For Messaging Server:

  1. Ensure the bitbucket channel is defined in the imta.cnf file.
  2. To direct messages to the bitbucket channel, create the email address for the resource using the csresource utility:
  3. # ./csattribute -a mail=Room100@bitbucket.sesta.com add Room100

For Sendmail:

  1. In the /etc/aliases file on the appropriate host, add an entry such as:
  2. # Resource/Conference room aliases

    Room100: /dev/null

  3. Add the email address for the resource to the LDAP directory using the csresource utility:
  4. # ./csattribute -a mail=Room100@sesta.com add Room100

 


Note

To enable these changes, you might also need to rebuild alias tables or configurations. Refer to the documentation for Messaging Server (or your email product) as well as your site's own documentation and procedures regarding changes to mail services.


Email Alias (mailalternateaddress Attribute)

If you need to setup an email aliases for a calendar user, use the LDAP mailalternateaddress attribute. The LDAP mail attribute provides the primary mail address, and the LDAP mailalternateaddress attribute is used for email aliases. Both attributes map the mail addresses to the user’s calendar ID (calid).

For example, to add the mailalternateaddress attribute for a user named John Smith with these values:

Use these Calendar Server utility commands:

# ./csuser -g John -s Smith -y password -l en -m john.smith@sesta.com -c johnsmith create johnsmith

# ./csattribute -a mailalternateaddress=johns@sesta.com add johnsmith

# ./csattribute -a mailalternateaddress=jsmith@sesta.com add johnsmith

Shared Calendar LDAP Lookup Configuration

If Directory Server requires authentication for the Shared Calendar LDAP lookup then the service.wcap.userprefs.ldapproxyauth parameter must be set in the ics.conf file as follows:

If service.wcap.userprefs.ldapproxyauth is “yes”, you must also set the appropriate LDAP ACI for the calmaster entry. For example, to set the calmaster ACI for proxy authentication for the sesta.com domain, use the ldapmodify tool as follows:

dn: o=sesta.com
changetype: modify
add: aci
aci: (target="ldap:///uid=*,o=sesta.com")(targetattr=*(version3.0;acl"allowAll-calmaster";allow
(all)(userdn="ldap:///uid=calmaster,o=sesta.com");)
aci: (target="ldap///uid=*,o=siroe.com")(targetattr="*")(version3.0;acl"allowproxy-calmaster";al low
(proxy)(userdn="ldap:///uid=*,o=sesta.com");)

Outlook Free-Busy Lookup and SSL

The Microsoft Outlook Free/Busy Lookup option is not supported for users who access Calendar Server in SSL mode. To use both SSL and non-SSL mode for the same Calendar Server instance, users must specify different port numbers, as follows:

For information about SSL, refer to Chapter 9, “Using SSL With Calendar Server” in the Sun Java System Calendar Server Administration Guide.

Calendar Server Delete Log Database

Calendar Server 6.0 includes the Delete Log database (ics50deletelog.db) to store deleted events and todos (tasks). For information, refer to Chapter 7, “Managing the Delete Log Database” in the Sun Java System Calendar Server Administration Guide.


Limitations and Issues

This section describes the limitations and known issues that exist in this release of Sun Java System Connector for Microsoft Outlook.

Limitations

Some limitations exist in this release of Sun Java System Connector for Microsoft Outlook. The key limitations are:

Known Issues

This section describes the known issues at the time of this release of Sun Java System Connector for Microsoft Outlook. If known, bug IDs are included in parentheses.

General Issues

Calendar

The following issues relate the calendar portion of Sun Java System Connector for Microsoft Outlook only:

The following issues relate to the interoperability between Sun Java System Connector for Microsoft Outlook and Sun Java System Communications Express:

Mail

The following issues relate the mail portion of Sun Java System Connector for Microsoft Outlook only:

The following issues relate to the interoperability between Sun Java System Connector for Microsoft Outlook and other email clients, such as Sun Java System Communications Express:

Localization Issues

The following issues affect the localized versions of Sun Java System Connector for Microsoft Outlook:


How to Report Problems and Provide Feedback

If you have problems with Sun Java System Connector for Microsoft Outlook, contact Sun customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:

Please provide the full document title and part number in the appropriate fields. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the part number of this Release Notes document is 817-6618-10.


Additional Sun Resources

Useful Sun Java System information can be found at the following Internet locations:


Copyright � 2004 Sun Microsystems, Inc. All rights reserved.

Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.

SUN PROPRIETARY/CONFIDENTIAL.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.

Use is subject to license terms.

This distribution may include materials developed by third parties.

Portions may be derived from Berkeley BSD systems, licensed from U. of CA.

Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.


Copyright � 2004 Sun Microsystems, Inc. Tous droits r�serv�s.

Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuels relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plus des brevets am�ricains list�s � l'adresse http://www.sun.com/patents et un ou les brevets suppl�mentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays.

Propri�t� de SUN/CONFIDENTIEL.

L'utilisation est soumise aux termes du contrat de licence.

Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.

Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD licenci�s par l'Universit� de Californie.

Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux Etats-Unis et dans d'autres pays.