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 2005Q4Calendar 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:
- The Delegated Administrator Console (graphical user interface) now supports Calendar Server. For information, see the Delegated Administrator Release Notes chapter of this book and other documentation found at http://docs.sun.com.
- The following WCAP parameter was added:
- This parameter tells the system whether or not to notify event attendees of changes being made to the event. For example, if a description change is made to an event, you might not want every attendee to get a new notification (value set to zero (0). If the meeting time is changing, however, you probably would want the attendees notified (value set to one (1).
The old user interface, Calendar Express, has been deprecated and will not appear in a future release of the product.
To that end, information in the Administration Guide and Developer’s Guide that referred to Calendar Express has been removed. If you are still using Calendar Express, you should make plans to convert to Communications Express as soon as possible. Documentation for Calendar Express can still be located in documentation for earlier versions at http://docs.sun.com.
- cs5migrate change-In the past, the cs5migrate utility, for migrating earlier versions of Calendar Server to version 5, was available as two separate downloads: one for databases with recurring events and tasks and one for databases without recurring data. The two have been consolidated. Now there is only cs5migrate with an option for recurring data.
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 ReleaseThe 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 InformationThis 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.
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.
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.
Post-Installation Configuration Steps
After installing Calendar Server 6 2005Q1, you must configure it as follows:
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.
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:
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.
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:
- Ensure that the value for the nsslapd-sizelimit parameter in the slapd.conf or equivalent file is large enough to return all the desired results; otherwise, truncation can occur, and no results will be displayed.
- Ensure that the value for the nsslapd-lookthroughlimit parameter in the slapd.ldbm.conf or equivalent file is large enough to complete a search of all the users and resources in the LDAP directory. If possible set nsslapd-lookthroughlimit to -1, which causes no limit to be used.
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.
Calendar Server 6 Documentation
Calendar Server 6 includes the following documentation. Part numbers are in parentheses.
- Sun Java System Calendar Server 6 2005Q4 Release Notes (819-4250)
- Sun Java System Calendar Server 6 2005Q4 Administration Guide (819-2433)
- Sun Java System Calendar Server 6 2005Q4 Developer’s Guide (819-2434)
- Sun Java System Communications Express 6 2005Q4 Administration Guide (819-2611)
- Sun Java System Communications Express 6 2005Q4 Customization Guide (819-2662)
- Sun Java System Communications Services 6 2005 Q4 Delegated Administration Guide (819-2658)
- Sun Java System Communications Services 6 2005Q4 Schema Reference (819-2657)
- Sun Java System Communications Services 6 2005Q4 Event Notification Service Guide (819-2699)
- Sun Java Enterprise System 2005Q4 Upgrade Guide for HP-UX (819-4460)
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.
Known Issues and LimitationsThis 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,
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,
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:
Reported Problems
The following is a list of problems reported on the product as of Beta.
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
- Stop the csstored daemon. Use the following command: <install-location>/calendar/sbin/stop-cal
- Navigate <install-location>/calendar/lib. Open csstored.pl file using the following command:
vi csstored.pl
- Go to the line number 216
- Change eq to ==
- Save the csstored.pl file
- Start the csstored daemon. Use the following command:
<install-location>/calendar/sbin/start-cal
Redistributable FilesSun 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/):
bin
The following are the redistributable files in this subdirectory (cal_svr_base/csapi/bin/):
classes
The following are the redistributable files in this subdirectory (cal_svr_base/csapi/classes/):
include
The following are the redistributable files in this subdirectory (cal_svr_base/csapi/include/):
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/):
authentication
The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/authentication/):
datatranslator
The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/datatranslator/):
userattributes
The following redistributable files are found in this subdirectory (cal_svr_base/csapi/plugins/userattributes/):
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/):
ens
The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/ens/):
userattributes
The following redistributable files are found in this subdirectory (cal_svr_base/csapi/samples/userattributes/):
Communications ExpressThese 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.
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
- Directory Server- Install Sun Java System Directory Server version 5.2.
- Calendar Server- Install Sun Java System Calendar Server version 6.2.
- Web Server- Install Sun Java System Web Server 6.1 SP4.
- Messaging Server- Install Sun Java System Messaging Server 6 2005Q4 (6.2).
- Access Manager- Install Sun Java System Access Manager 7.
- Application Server- Install Sun Java System Application Server 8.1.
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.
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:
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
How to Report Problems and Provide FeedbackIf you have problems with Sun Java System Calendar Server, contact Sun customer support using one of the following mechanisms:
- Sun Software Support services online at
http://www.sun.com/service/sunone/software
- The IT Resource Center website for HP-UX at
www1.itrc.hp.com- The telephone dispatch number associated with your maintenance contract
So that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
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:
- If necessary, download the capture_environment.pl tool from customer support.
- 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.)
- Log in as (or become) root.
- 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.
- 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 ResourcesUseful Sun Java System information can be found at the following Internet locations:
- Sun Java System Documentation
http://docs.sun.com/app/docs/prod/entsys.05q4- Documentation for Sun Java System Calendar Server 6
http://docs.sun.com/app/docs/coll/1313.1- Documentation for Sun Java System Communications Express
http://docs.sun.com/app/docs/coll/1313.1- Sun Java System Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Software Products and Service
http://www.sun.com/software- Sun Java System Software Support Services
http://sunsolve.sun.com/pub-cgi/show.pl?target=help/collections- Sun Java System Support and Knowledge Base
http://www.sun.com/service/support/software- Sun Java System Software Support Services
http://www.sun.com/support/- Sun Java System Consulting and Professional Services
http://www.sun.com/service/sunps/sunone- Sun Java System Developer Information
http://developers.sun.com/prodtech/index.html- Sun Developer Support Services
http://www.sun.com/developers/support- Sun Java System Software Training
http://training.sun.com/- Sun Software Data Sheets
http://wwws.sun.com/software
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.