Sun Java System Calendar Server Release Notes for HP-UX

Sun Java™ System Calendar Server Release Notes for HP-UX

Version 6 2005Q4

Part Number 819-4250-10

These Release Notes contain important information available at the time of release of Sun Java System Calendar Server 6 2005Q4 for HP-UX. Known issues and limitations, and other information are addressed here. Read this document before you begin using Calendar Server 6 2005Q4.

The most up-to-date version of these release notes can be found at the Sun Java System documentation web site: http://docs.sun.com/app/docs/prod/entsys.05q4. 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 product documentation.

These release notes contain the following sections:

Read these Release Notes before you install and configure Calendar Server.

Sun Java™ System Calendar Server was formerly Sun™ ONE Calendar Server.


Release Notes Revision History

Table 1  Revision History 

Date

Description of Changes

February 2006

Revenue release.

November 2005

Beta release.


About Calendar Server Version 6 2005Q4

Calendar Server is a scalable, web-based solution for centralized calendaring and scheduling for enterprises and service providers. Calendar Server supports user calendars for both events and tasks as well as calendars for resources, such as conference rooms and equipment. For a list of new features, see the following section.

Calendar Server offers two graphical user interfaces, Calendar Express and Communications Express. It also offers customers the flexibility to use the Web Calendar Access Protocol (WCAP) to access calendar data directly in either text/calendar or text/xml format.

This section includes:

What’s New in This Release

Calendar Server 6 2005Q4 includes the following changes and new features:

Hardware and Software Requirements

This section describes the hardware and software required and recommended for this release of Calendar Server.

Hardware Requirements and Recommendations

Software Requirements and Recommendations

Supported Software Platforms

HP-UX 11i v1 (PA-RISC)

Recommended Browsers for Client Computers

Sun Java System Calendar Express 6 2005Q4 requires a JavaScript-enabled browser. For optimal performance, the following browsers are recommended:

Table 2  Recommended Browser Versions for Calendar Server 6

Browser

HP-UX

Netscape™ Communicator

7.1, 7.2

Microsoft Internet Explorer

6.0

Mozilla

1.4.1, 1.72


Bugs Fixed in This Release

The table below describes the bugs fixed in Sun Java System Calendar Express 6 2005Q4:

Table 3  Fixed Bugs in Sun Java System Calendar Server 2005Q4

Bug Number

Description

6355152

Cal6.2: csdwpd service core file generated


Important Information

This section contains preinstallation information that you should know before you install Calendar Server 6 2005Q4, including:

Front-End and Back-End Machines and Operating Systems

For Calendar Server installations that separate functionality across front-end and back-end machines, the hardware platforms must be the same on each end.

For more information about installing Calendar Server on front-end and back-end machines, see the Sun Java System Calendar Server 6 20004Q4Administration Guide at:

HP-UX Platform Support

Java Enterprise System runs on the HP-UX platform. The default installation locations are listed for the following:

Calendar Server

The following table provides the directory path details for Calendar Server:

Table 4  Directory Path details on HP-UX Platforms

HP-UX Directory

/opt/sun/calendar

/etc/opt/sun/calendar/config

/var/opt/sun/calendar

Communications Express

The default installation location in HP-UX for Communications Express is:

/opt/sun/uwc

OS Patches

You must apply the required operating system patches before installing Calendar Server 6 2005Q4. Calendar Server Patches are available at http://sunsolve.sun.com.

Required Privileges

To run the Sun Java System Enterprise System installer or the Calendar Server 6 2005Q4 configuration program on HP-UX Systems, you must log in as or become the superuser (root).

Upgrading From an Earlier Version of Calendar Server 6

Do not attempt to upgrade Calendar Server using the Sun Java Enterprise System installer.

Patch Requirement Information

The following table gives the numbers and minimum versions for the alignment patches. All patches referred to in this section are the minimum version number required for upgrade. It is possible that a new version of the patch has been issued since this document was published. A newer version is indicated by a different version number at the end of the patch. For example: 123456-04 is a newer version of 123456-02 but they are the same patch ID. Refer to the README file for each patch listed for special instructions.

To access the patches, go to http://sunsolve.sun.com.

Table 5  Calendar Server 6 2005Q4 Alignment Patches Required for HP-UX

Patch Number

Patch Description

121393-01

HP-UX 11.11: Sun Java™ System Directory Server 5 2005Q4

121931-01

HP-UX 11.11: Sun Java™ System Directory Server 5 2005Q4 (Localization Patch)

121513-01

HP-UX 11.11: Directory Preparation Tool

121512-02

HP-UX 11.11: Sun Java™ System Calendar Server 6 2005Q4

121937-01

HP-UX 11.11: Lockhart Localization patch

For detailed information about Upgrade procedure of the Calendar Server from JES3 to JES4 refer Sun Java Enterprise System 2005Q4 Upgrade Guide for HP-UX located at http://docs.sun.com/app/docs/doc/819-4460.

Upgrading Your Calendar Database

If you have Calendar Server 6 installed, with Berkeley DB version 3.2.9, the conversion to the current 4.2 version will be done automatically. You do not need to run any other database migration programs.

If you have a Calendar Server 5 installation that uses Berkeley DB version 2.6, you must upgrade your calendar database to version 4.2. using the cs5migrate utility. The utility is available upon request from technical support.

If you have an existing Calendar Server 2 installation, you must upgrade to Calendar Server 5 before you can migrate to the current release.

The cs5migrate utility performs the following tasks:

In addition, if the -r option is specified, cs5migrate creates master and exception records for all recurring events and tasks. Going forward these records will be automatically generated by Calendar Server. If you need to migrate your database but do not plan to use the Connector for Microsoft Outlook, you do not need run cs5migrate with the -r option.

Contact technical support for the download location and documentation for either utility.


Caution

If your site has an earlier version of Calendar Server that is configured for limited virtual domain mode or has multiple instances of Calendar Server on the same machine, contact your Sun Microsystems, Inc. sales account representative for an evaluation of your migration requirements and to ensure that you have the specific migration utility that supports those requirements.

And, as always, never migrate your database without first performing a full backup


Java Enterprise System Installer

Install Calendar Server 6 2005Q4 using the Sun Java Enterprise System installer. The Java Enterprise System installer installs the Sun component product packages, including Calendar Server 6 2005Q4, and the shared components that are used by the various products.

This section covers the following topics:

Default Installation Directory

The default installation directory (cal_svr_base) for HP-UX packages (for core and API) is:

/opt/sun

After installation, HP-UX Calendar Server files are found in /opt/sun/calendar.

HP-UX Depot Files

The table below lists the Depot packages for the various Calendar Server related components.

Table 6  HP-UX Depot packages for Calendar Server Related Components

Component

Depot File

Calendar Server

  • sun-calendar-core
  • sun-calendar-api
  • Localized files:
    sun-calendar-core-es
    sun-calendar-core-ko
    sun-calendar-core-fr
    sun-calendar-core-zh_CH
    sun-calendar-core-de
    sun-calendar-core-ja
    sun-calendar-core-zh_TW

Communications Express

sun-uwc-de
sun-uwc-es
sun-uwc-fr
sun-uwc-ja
sun-uwc-ko
sun-uwc-zh_tw
sun-uwc-zh_ch

Post-Installation Configuration Steps

After installing Calendar Server 6 2005Q1, you must configure it as follows:

  1. Run the Directory Server Setup Script (comm_dssetup.pl) to configure Sun Java System Directory Server for Calendar Server schema.
  2. Run the Calendar Server Configuration Program (csconfigurator.sh) to configure your site’s specific requirements.

For instructions, refer to the Sun Java System Calendar Server 6 2005Q4 Administration Guide.

Where to Find Calendar Server Data and Utilities

For Java Enterprise System Release 3, Calendar Server provides the links for HP-UX locations shown in the table below.

Table 7  Directory Locations

File Names

HP-UX Locations*

Administrator utilities: start-cal, stop-cal, csattribute, csbackup, cscal, cscomponents, csdb, csdomain, csexport, csimport, csmonitor, csplugin, cspurge, csrename, csresource, csrestore, csschedule, csstats, cstool, and csuser

Migration utilities: csmig, csvdmig, ics2migrate and cs5migrate

Scripts: icsasm, legbackup.sh, legrestore.sh, and private2public.pl

/opt/sun/calendar/sbin

Administrator utilities: csstart and csstop

/opt/sun/calendar/lib

Configuration files: ics.conf, version.conf, counter.conf, and sslpassword.conf

LDAP server update files: 60iplanet-calendar.ldif, ics50-schema.conf, and um50-common-schema.conf

/opt/sun/calendar/config-template

Mail formatting (*.fmt) files

/etc/opt/sun/calendar/config/language

Schema IDIF files: 20subscriber.ldif, 50ns-value.ldif, 50ns-delegated-admin.ldif, 55ims-ical.ldif, 50ns-mail.ldif, 56ims-schema.ldif, 50ns-mlm.ldif, 60iplanet-calendar.ldif, 50ns-msg.ldif

/etc/opt/sun/calendar/config/schema

Library (.sl) files

SSL utilities: certutil and modutil

/opt/sun/calendar/lib

Session database

/opt/sun/calendar/lib/http

timezones.ics file

/opt/sun/calendar/data

Counter statistics files: counter and counter.dbstat

/opt/sun/calendar/lib/counter

Directory Server Performance

To improve the performance of your LDAP directory server, especially if you are using calendar searches of the LDAP directory consider the following items:

Indexing the LDAP Directory Server Attributes

To improve performance when Calendar Server accesses the LDAP directory server, add indexes to the LDAP configuration file for various attributes.

The configuration program, comm_dssetup.pl, will optionally do the indexing for you.

To see the performance difference indexing can give you, perform the following test:

  1. Enable calendar searches of the LDAP directory server by making sure the following parameter in the ics.conf file is set to “yes”:
  2. service.calendarsearch.ldap = "yes" (Default)

  3. Run the following LDAP command:

Tests have shown that with 60,000 entries, the above search took about 50-55 seconds without indexing icsCalendarOwned. After indexing, the above search took only about 1-2 seconds.

For more information about adding directory server indexes, refer to the Sun Java System Directory Server 5 2005Q4 documentation at:

http://docs.sun.com/app/docs/coll/1316.1.

Checking and Setting the Size Limit and the Look Through Limit Parameters

To determine if the Look Through Limit (nsslapd-lookthroughlimit) and Size Limit (nsslapd-sizelimit) parameters are set to appropriate values, try the following command:

ldapsearch -b "base"
"(&(icscalendarowned=*user*)(objectclass=icsCalendarUser))"

where, base is the LDAP base DN of the directory server where the user and resource data for Calendar Server is located, and user is the value that an end user can enter in the Calendar Express Subscribe > Calendar Search dialog.

If the LDAP server returns an error, the nsslapd-sizelimit or the nsslapd-lookthroughlimit parameter might not be large enough. Follow these guidelines to set these parameters:

Communications Express Using Schema 1

The issue with Schema 1 in Communications Express is:

Provisioning Tools

There are two tools for provisioning users, groups and domains for Calendar Server: The Delegated Administrator Utility and Calendar Server utilities. For information on Delegated Administrator, see the Sun Java System Communications Services 6 2005Q4Delegated Administrator Guide. For information on the Calendar Server utilities, see the Sun Java System Calendar Server 6 2005Q4 Administration Guide.


Note

Do not attempt to provision users through the Access Manager Console. Though it is possible to create users and assign them a calendar service, do not use this method as results will be unpredictable and negatively impact your deployment.


Calendar Server 6 Documentation

Calendar Server 6 includes the following documentation. Part numbers are in parentheses.

Calendar Express 6 2005Q4 Online Help is available with the Calendar Express software. Communications Express 6 2005Q4 Online Help is available with the Communications Express software.

Calendar Server 6 2005Q4 documentation is available on the following Web site:

http://docs.sun.com/app/docs/coll/1313.1.

Accessibility Features for People With Disabilities

To obtain accessibility features that have been released since the publishing of this media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. Updated versions of applications can be found at http://sun.com/software/javaenterprisesystem/get.html.

For information on Sun’s commitment to accessibility, visit http://sun.com/access.

Compatibility Issues

The following table lists the known incompatibilities between Calendar Server 6 2005Q4 and earlier versions.

Table 8  Compatibility Issues

Incompatibility

Impact

Comments

Access Manager now has two install types: Enhanced and Compatible.

At installation, you must choose Compatible as the install type on the following panel:

Access Manager: Administration (1 of 6)

If the wrong Access Manager is installed, you will not be able to run Delegated Administrator.

The Directory Preparation Tool (comm_dssetup.pl) under /opt/sun/calender/sbin doesn’t work.

comm_dssetup.pl is now in its own package installed in HP-UX /opt/sun/comms/comcli/dssetup/bin for Solaris

To install the package, be sure the Directory Preparation Tool is selected in the appropriate installer panel.

The configuration program for the Delegated Administrator has changed

Install Delegated Administrator and run the configuration program. The current program is located for HP-UX at: /opt/sun/comms/comcli/sbin/config-commda

Upgrade to the new Delegated Administrator when installing this version of Calendar Server.

This release of Communications Express is incompatible with the 2004Q2 version of Calendar Server.

If you upgrade Communications Express, you must also upgrade Calendar Server.

This also applies to Messaging Server.


Known Issues and Limitations

This section describes the known issues and limitations of Sun Java System Calendar Server 6 2005Q4 for HP-UX.

The following topics are the known issues and limitations:

Installation

Calendar Server installation fails in absence of nobody user and nobody group in the system (6290338)

Calendar Server installation fails if user nobody and group nobody is not available in the system.

Workaround

The system administrator has to create the following before installing Calendar Server using Java Enterprise System installer:

Security

Calendar DB files are created with the wrong permissions (6291250)

Anyone with access to the system has the potential to view private calendars and events due to wrong permissions.

Workaround

To overcome this security issue,

  1. Install the Calendar Server using Java Enterprise System installer.
  2. Once the installation succeeds, execute “umask 022."
  3. Run the Calendar Server configurator.

Calendar server log files world writeable by default (6291057)

Log files are created in the wrong mode 644 or 640, instead of mode 666.

Workaround

To overcome this security issue,

  1. Install the Calendar Server using Java Enterprise System installer.
  2. Once the installation succeeds, execute “umask 022."
  3. Run the Calendar Server configurator.

Limitations

The following section topics are the limitations:

Removing all Instances of Multi-Valued User Preferences

Each set_userprefs command removes only one instance of a multi-valued preference.

Workaround: To remove all instances of a multi-valued user preference, you must issue one set_userpref command per instance. For example: Perform a get_userprefs to list all of the user preferences. If there are multiple values for a preference, such as icsSubscribed, then you must issue one set_userprefs command to delete the preference for each of the values listed.

For example: Perform a get_userprefs to list all of the user preferences. If there are multiple values for a preference, such as 1csSubscribed, then you must issue one set_userprefs command to delete the preference for each of the values listed.

Finding Installed Patches in a Clustered Environment

There is no cluster specific showrev command that will show what is installed on the individual nodes of the cluster. (This is a generic problem, not just Calendar Server specific. You would run into the same difficulty with any product installed on a global file system.)

This is a problem when you want to update Calendar Server. You need to apply the patch to every node where Calendar Server was already installed. In addition you can’t apply the patch to a node if Calendar Server hasn’t already been installed on it. If you don’t know which nodes have Calendar Server installed and which do not, at the least, it will be confusing and cost you time trying to discover where Calendar Server is installed.

Workaround: Run the following command to see all of the nodes where Calendar Server is installed: pkgparam -v SUNWics5 | grep ACTIVE_PATCH

Pop-up Blockers

Certain Calendar Server windows will not display if you have a pop-up blocker enabled.

Workaround: Disable pop-up blockers for the Calendar URL to ensure all Calendar Server windows will display.

Exception: Neither the Norton Inet Security AD_BLOCKER nor the Mozilla built-in POP_BLOCKER will affect Calendar Server windows.

Provisioning Users for Communications Express in Schema 1 Mode

The csuser utility does not enable users it creates for Address Book.

Workaround: Enable the user using ldapmodify.

Multiple Domains (Hosted Domains)

The configuration program, csconfigurator.sh, configures only a single domain.

Workaround: If you need a multiple domain calendar environment (called either Virtual Domains or Hosted Domains), you must do two things:

  1. Enable hosted domains.
  2. Add the domains yourself using Delegated Administrator, or the csdomain utility if you are still using Sun LDAP Schema 1.

Reported Problems

The following is a list of problems reported on the product as of Beta.

Table 9  Reported Problems

Bug ID

Problems

4526765

Calendar Server utility cscal will not add more than two owners to a calendar at a time, no matter how many are specified in the command.

4958242

When a user modifies an event and chooses the option to modify today’s event and all future events, all previous events are deleted and will no longer display in the UI.

5019977

SSL initialization fails in SSLv2 mode. Unable to make use of SSLv2 client.

5060833

If you start a process (such as enpd) and then disable it in the ics.conf file, when stop-cal is issued, the system will not stop the disabled process.

Workaround

Re-enable the process in the ics.conf file and then issue the stop-cal command. After all processes are stopped, then disable any processes you do not want running before issuing start-cal.

6179278

Hot backup log file not being purged per ics.conf settings as other log files are. To keep file to a minimum, decrease verbosity. (verbosity level 3 is the default).

6186298

In Schema 1 mode with hosted domains, if the DC tree is missing or improperly provisioned, calendar utilities can fail. You must create the DC tree nodes prior to creating or otherwise managing calendars.

6216869

If DWP is disabled while the DWP process is running, stop-cal will not stop it. stop-cal should stop all services rather than just those enabled.

6216877

Vague error message. In a hosted domain environment, if the basednpassed tocsdomain does not exist. The actual message received is: “FAIL: icsLdapServer: Null argument to function.” This type of error message is vague because the error message originates several levels down and could be caused by many different circumstances. Rather than just passing the error through, the higher level program should interpret the error message before bubbling it up to the next higher level.

6219126

Leading white space stripped from description field when stored in calendar server.

6219906

In virtual domain mode, if maillookup is configured in the ics.conffile, a WCAP error is returned. Fixed in patch 1. Fix: In virtual domain mode, maillookup is ignored in favor of ugldap in the ics.conf file.

Workaround

Comment out the maillookup parameters in the ics.conf file.

6221452

SSL can not be enabled or disabled on individual hosted domains. (RFE)

6221999

The error messages given by csdomain are vague and need to be more explicit.

6265287

Trusted circle SSO fails when authentication filter is configured in calendar.

6269721

csresource -k option defaults differently depending on if you include it blank or just omit it.

6269822

Incorrect default ACE listed for resources in csresource merge.

6274603

External organizers get one reply per instance for recurring events when the attendee accepts all.

6274607

Import command puts in wrong organizer email address if organizer is external.

6274892

cscal -v list does not work.

6275605

csstored.pl not reporting warnings when there are more than two log files in the live calendar database.

6277086

Need a way to turn off local.user.authfilter for proxy authentication.

6355890

CSHTTPS hangs without error message if local.ldap.cache.homedir.path folder is invalid.

Workaround

Change the local.ldap.cache.homedir.path to a valid folder name in ics.conf file and restart the services.

6371072

func_events test shows difference in output. DTEND value is not shown in the output message of wcap command

Services

Hotbackup error message printed out on Calendar Server restart (6373819)

Calendar Server Hotbackup throws an error message on standard output while starting csstored daemon

Workaround

  1. Stop the csstored daemon. Use the following command: <install-location>/calendar/sbin/stop-cal
  2. Navigate <install-location>/calendar/lib. Open csstored.pl file using the following command:
  3. vi csstored.pl

  4. Go to the line number 216
  5. Change eq to ==
  6. Save the csstored.pl file
  7. Start the csstored daemon. Use the following command:
  8. <install-location>/calendar/sbin/start-cal


Redistributable Files

Sun Java System Calendar Server 6 2005Q4 contains the following set of files for which Sun Microsystems, Inc. grants you a non-exclusive, non-transferable, limited license to reproduce and distribute in binary form.

In addition, you may copy and use but not modify the listed header files and class libraries solely to cause your resulting binaries to be able to interface with Sun’s software APIs.

Sample code is provided solely for reference purposes pursuant to creating the above mentioned binaries.

All the redistributable files for Calendar Server are for the plugin API, known as CSAPI. The API is described in the Sun Java System Calendar Server 6 2005Q4Developer’s Guide at:

In the following files, cal_svr_base is the directory into which Calendar Server was installed. The default for Solaris is /opt/SUNWics5/cal, for Linux it is /opt/sun/calendar

Redistributable files are found in various subdirectories of cal_svr_base/csapi:

authsdk

The following are the redistributable files in this subdirectory (cal_svr_base/csapi/authsdk/):

cgiauth.c

expapi.h

login.html

nsapiauth.c

bin

The following are the redistributable files in this subdirectory (cal_svr_base/csapi/bin/):

libcsapi_xpcom10.sl

libicsexp10.sl

classes

The following are the redistributable files in this subdirectory (cal_svr_base/csapi/classes/):

ens.jar

jms.jar

include

The following are the redistributable files in this subdirectory (cal_svr_base/csapi/include/):

IIDS.h

nsIEnumerator.h

csIAccessControl.h

nsIEventQueueService.h

csIAuthentication.h

nsIFactory.h

csICalendarDatabase.h

nsIPtr.h

csICalendarLookup.h

nsIServiceManager.h

csICalendarServer.h

nsIServiceProvider.h

csIDBTranslator.h

nsISizeOfHandler.h

csIDataTranvslator.h

nsISupports.h

csIMalloc.hpluginscsIPlugin.h

nsISupportsArray.h

csIQualifiedCalidLookup.h

nsMacRepository.h

csIUserAttributes.h

nsProxyEvent.h

mozIClassRegistry.h

nsRepository.h

mozIRegistry.h

nsString.h

nsAgg.h

nsTraceRefcnt.h

nsCOMPtr.h

nsVector.h

nsCRT.h

nsUnicharUtilCIID.h

nsCom.h

nsXPComCIID.h

nsDebug.h

nsXPComFactory.h

nsError.h

nscore.h

nsHashtable.h

pasdisp.h

nsIAtom.h

publisher.h

nsICaseConversion.h

subscriber.h

nsICollection.h

xcDll.h

nsID.h

xcDllStore.h

plugins

This directory (cal_svr_base/csapi/plugins/) has redistributable files in the following subdirectories:

accesscontrol

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/accesscontrol/):

csAccessControl.cpp

csAccessControl.h

csAccessControlFactory.cpp

authentication

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/authentication/):

csAuthentication.cpp

csAuthentication.h

csAuthenticationFactory.cpp

datatranslator

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/datatranslator/):

csDataTranslator.cpp

csDataTranslator.h

csDataTranslatorFactory.cpp

userattributes

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/userattributes/):

csUserAttributes.cpp

csUserAttributes.h

csUserAttributesFactory.cpp

samples

This directory (cal_svr_base/csapi/samples/) has redistributable files in the following subdirectories:

authentication

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/authentication/):

authlogon.c

authlogon.h

authtest.c

csAuthenticationLocal.cpp

csAuthenticationLocal.h

csAuthenticationLocalFactory.cpp

datatranslator

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/datatranslator/):

csDataTranslatorCSV.cpp

csDataTranslatorCSV.h

csDataTranslatorCSVFactory.cpp

ens

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/ens/):

apub.c

asub.c

rpub.c

rsub.c

userattributes

The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/userattributes/):

csUserAttributesDB.cpp

csUserAttributesDB.cpp

csUserAttributesDBFactory.cpp


Communications Express

These Release Notes contain important information available at the time of release of Sun Java System Communications Express 6 2005Q4 for HP-UX. New features and enhancements, known issues and limitations, and other information are addressed here.

This release notes contains the following sections:

About Communications Express 6 2005Q4

Sun Java™ System Communications Express Version 6 2005Q4 provides an integrated web-based communication and collaboration client that consists of three client modules - Calendar, Address Book and Mail. The Calendar and Address Book client modules are deployed as a single application on any web container and are collectively referred as the Unified Web Client (UWC). Messenger Express is the standalone web interface mail application that uses the HTTP service of the Messaging Server.


Note

The Communications Express for JES 4 Release can be deployed on Sun Java System Application Server 8.1 and Sun Java System Web Server 6.1. The Communications Express configurator supports only the Domain Administration Server (DAS) deployment for Application Server 8.1.


Supported Browsers

Communications Express can be viewed using:

Bugs Fixed in This Release

This section lists the bugs fixed in Communications Express 6 2005Q4.

None

Installation Notes

The following services need to be installed and configured for Communications Express:

  Products to be installed for Communications Express

  1. Directory Server- Install Sun Java™ System Directory Server version 5.2.
  2. Calendar Server- Install Sun Java™ System Calendar Server version 6.2.
  3. Web Server- Install Sun Java™ System Web Server 6.1 SP4.
  4. Messaging Server- Install Sun Java™ System Messaging Server 6 2005Q4 (6.2).
  5. Access Manager- Install Sun Java™ System Access Manager 7.
  6. Application Server- Install Sun Java™ System Application Server 8.1.

  7. Note

    Communications Express has been tested and is supported only with the server versions mentioned above.


Refer to chapter 2, “Installing and Configuring Communications Express” of Sun Java™ Systems Communications Express Administration Guide for instructions on how to install and configure Sun Java System Communications Express.

Refer to chapter 4, “Implementing Single Sign-On” of Sun Java™ Systems Communications Express Administration Guide for instructions on how to configure Sun Java System Communications Express when Access Manager is deployed.

Patch Requirement Information

The following table gives the numbers and minimum versions for the alignment patches. All patches referred to in this section are the minimum version number required for upgrade. It is possible that a new version of the patch has been issued since this document was published. A newer version is indicated by a different version number at the end of the patch. For example: 123456-04 is a newer version of 123456-02 but they are the same patch ID. Refer to the README file for each patch listed for special instructions.

To access the patches, go to http://sunsolve.sun.com.

Table 10  Communications Express 6 2005Q4 Alignment Patches Required For HP-UX

Patch Number

Patch Description

121393-01

HP-UX 11.11: Sun Java™ System Directory Server 5 2005Q4

121931-01

HP-UX 11.11: Sun Java™ System Directory Server 5 2005Q4 (Localization Patch)

121512-02

HP-UX 11.11: Sun Java™ System Calendar Server 6 2005Q4

121510-01

HP-UX 11.11: Sun Java™ System Web Server 6.1 6 2005Q4

121935-01

HP-UX 11.11: Sun Java™ System Web Server 6.1 6 2005Q4 (Localization Patch)

121511-01

HP-UX 11.11: Sun Java™ System Messaging Server 6.2 2005Q4

121927-01

HP-UX 11.11: Sun Java™ System Messaging Server 6.2 2005Q4 (Localization Patch)

121514-01

HP-UX 11.11: Sun Java™ System Application Server 8.1 2005Q2

121934-01

HP-UX 11.11: Sun Java™ System Application Server 8.1 2005Q2 (Localization Patch)

121522-01

HP-UX 11.11: Sun Java™ System Communications Express 6 2005Q4

121925-01

HP-UX 11.11: Sun Java™ System Communications Express 6 2005Q4 (Localization Patch)

For detailed information about Upgrade procedure of the Communications Express from JES3 to JES4 refer Sun Java Enterprise System 2005Q4 Upgrade Guide for HP-UX located at http://docs.sun.com/app/docs/doc/819-4460.

Communications Express Known Issues and Limitations

This section contains a list of the known issues with Communications Express 6.

The Configurator Tool for Communications Express does not support the’Unconfigure’ option (5104756)

The Communications Express Configurator does not allow you to undeploy, remove files at the time of configuration, and remove files created during runtime.

Workaround

To unconfigure Communications Express:

  1. Remove the Communications Express package. For example on HP-UX type:
  2. swremove sun-uwc

  3. Remove the deploy directories
  4. Remove the WEBAPP entry from Web Server or Application Server server.xml file

Few softlinks are missing and creation of incorrect directory names with respect to Chinese locale(6376282)

Install UWC, and apply the work around before running UWC configurator.

Workaround

  1. cd /opt/sun/uwc/lib/config-templates/WEB-INF/domain
    1. mv zh_CN zh-CN
    2. mv zh_TW zh-TW
    3. ln -s ./zh-CN zh
    4. ln -s ./zh-TW zh-tw
  2. cd /opt/sun/uwc/lib/config-templates/WEB-INF/domain/defaultps
    1. mv dictionary-zh_CN.xml dictionary-zh.xml
    2. mv dictionary-zh_TW.xml dictionary-zh-TW.xml
    3. ln -s ./dictionary-zh.xml dictionary-zh-CN.xml
    4. ln -s ./dictionary-zh.xml dictionary-zh-cn.xml
    5. ln -s ./dictionary-zh-TW.xml dictionary-zh-tw.xml
  3. cd /opt/sun/uwc/lib/config-templates/WEB-INF/ui/html/abs
    1. Repeat the steps as in Step a to Step e.
    2. mv dictionary-zh_CN.xml dictionary-zh.xml
    3. mv dictionary-zh_TW.xml dictionary-zh-TW.xml
    4. ln -s ./dictionary-zh.xml dictionary-zh-CN.xml
    5. ln -s ./dictionary-zh.xml dictionary-zh-cn.xml
    6. ln -s ./dictionary-zh-TW.xml dictionary-zh-tw.xml
  4. cd /opt/sun/uwc/help
    1. mv zh_CN zh-CN
    2. mv zh_TW zh-TW
    3. ln -s ./zh-TW zh-tw
    4. ln -s ./zh-CN zh
    5. Execute the configurator, then access the UWC page in Chinese locale (that is with browser locale set to zh, zh-CN, zh-TW). You will find that displayed correctly.


How to Report Problems and Provide Feedback

If you have problems with Sun Java System Calendar Server, 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:

To assist in reporting problems, Sun provides the capture_environment.pl tool, a Perl script that captures the current Calendar Server environment, including the ics.conf file, log files, calendar database files, platform information, and core files (if available). These files can be useful to Calendar Server development to debug problems.

To run the capture_environment.pl tool:

  1. If necessary, download the capture_environment.pl tool from customer support.
  2. If necessary, install Perl and add it to your path. (If you cannot install Perl, see the instructions in the capture_environment.pl file that describe how to manually create a snapshot of your Calendar Server environment.)
  3. Log in as (or become) root.
  4. Run the capture_environment.pl tool. The tool copies the files to a directory named archive_directory. On UNIX systems, it places all files into a tar file named tar_file. On Windows 2000 systems, however, you must manually add the files in archive_directory to a Zip file.
  5. Send the tar file or Zip file to customer support.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the guide or at the top of the document.


Additional Sun Resources

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


Copyright � 2006 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 � 2006 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.