CorporateTime Server 5.2

and

LDAP Connector 1.5 for ISOCOR Global Directory Server

LDAP Connector 1.5 for Control Data Global Directory Server

LDAP Connector 1.5 for Netscape Directory Server

This file was last modified 02.03.12

---

Thank you for choosing CorporateTime Server. These release notes contain supported platforms, system requirements, features, and known limitations of this product. Please see the CorporateTime Server Administrator's Guide and Reference Manual for information about configuring, administering and maintaining your calendar server. PDF versions of these manuals are also available on the Steltor web site (Administrator's Guide | Reference Manual). Please see the readme for installation instructions.

This product can be used with an internal directory or an external LDAP directory server. Support for the Lightweight Directory Access Protocol (LDAP) is offered through separate connectors: LDAP Connector 1.5 for ISOCOR Global Directory Server, LDAP Connector 1.5 for Control Data Global Directory Server, and LDAP Connector 1.5 for Netscape Directory Server. If you already use an LDAP Connector of version 1.3, no manual upgrade procedure is necessary.

---

Contents of this file

• System requirements
• How to report problems
• What's new in this release
• Patches and Enhancement Packs
• Limitations, caveats, and known problems with this release

---

System requirements

NT:

• one of the following operating systems:
  • Windows NT 4.0 (Server) with Service Pack 4 or higher
  • Windows 2000 5.0 (Server)

UNIX:

• one of the following operating systems:
  • Sun Solaris 2.6, 7 or 8
  • HP-UX 10.20 or 11.0
  • IBM AIX 4.3.2/4.3.3
  • Compaq Tru64 UNIX 5.0
  • Red Hat Linux 6.1

All Platforms

• 64 Mb RAM or more is recommended for computers handling a large number of users or running services in addition to those of the calendar server
• 70 Mb of disk space for operation, plus space for the calendar database and log files
• an HTML browser to use the Calendar Administrator (must support Javascript, cookies, frames and tables) and to view the on-line manual
• SMTP messaging server for mail notifications
• for installations using a directory server, one of the following combinations:
  • ISOCOR Global Directory Server 3.0 and LDAP Connector 1.5 for ISOCOR Global Directory Server
  • Control Data Global Directory Server 2000 and LDAP Connector 1.5 for Control Data Global Directory Server
  • Netscape Directory Server 3.11 or 4.0 and LDAP Connector 1.5 for Netscape Directory Server

Note:

Up to 150 Mb free disk space may be necessary for installation.

---

How to report problems

Please contact Steltor's technical support department at support@steltor.com or call (514)733-8500.

---

What's new in this release

The following features are new to CorporateTime Server 5.2. Please see the CorporateTime Server 5.1 release notes for an account of the functionality enhancements made between the 5.0 and 5.1 releases.

• Performance enhancements
• 5.1 enhancement packs
• Server-side reminders in multiple languages
• Chinese-language environments
• Time zone updates
• New utilities and options
• New parameters
• Bug fixes

Performance enhancements

A number of improvements have been made to the speed at which the calendar server conducts transactions, locks and unlocks files, and rebuilds key files. In addition, the performance of a number of utilities, including unistop, uniwho and unidbfix, has been improved. The 5.2 release also offers significant performance enhancements for users of CorporateTime Outlook Connector, particularly at initial sign-in.

5.1 enhancement packs

All new features and bug fixes introduced in patches and enhancement packs offered for the 5.1 release of CorporateTime Server have been incorporated into the 5.2 release.

Server-side reminders in multiple languages

The calendar server can now send e-mail and Short Message Service (SMS) reminders in English, French, German, Portuguese, Finnish, Japanese and Chinese. Set users' languages using the new uniuser "LANG=" key, or the new user.ini [GEN] Language parameter. (Note: e-mail reminders are only available through Steltor's Web clients, and SMS reminders require Wireless Data Server)

Chinese-language environments

CorporateTime Server now offers full support for Chinese-language environments.

Time zone updates

The calendar server's time zone rules have been updated with the latest information.

New utilities and options

For details on these utilties and options, please consult Reference Appendix C of the calendar server Reference Manual.

unib2lendian	Existing utility now included in product package; converts a calendar node from a format for big-endian UNIX processors to a format for little-endian Windows processors.
unidbfix -kp	New option to speed up unidbfix by specifying the number of pages used for key rebuilding.
unil2bendian	Existing utility now included in product package; converts a calendar node from a format for little-endian Windows processors to a format for big-endian UNIX processors.
unil2lendian	Existing utility now included in product package; converts a calendar node from a format for little-endian Windows processors to a format for little-endian UNIX processors, and vice-versa.
uniuser	New key-value pair to specify a user's language for server-side e-mail and SMS reminders: "LANG="

New parameters

user.ini

[GEN]

Language

Set a user's language for server-side e-mail and SMS reminders.

uniwebadm.ini

[ADMINSETTINGS]

cgimode

Specify whether the Calendar Administrator should run as a CGI or FastCGI.

unison.ini

[ACE]	libcachecount	Determines the number of shared libraries that can be loaded at the same time for each type of method (authentication, compression, encryption).
	minbufsizetocompress	Specifies the minimum size requirement for a buffer to be compressed.
	workbufsize	Specifies the size of the buffer used for compression and encryption.
[AUTHENTICATION]	keepresourcepswincaldb	Determines whether resource passwords are kept in the calendar database or in the database of the configured authentication mechanism.
[CLUSTER]	remotemasternode	Specifies the master node of the cluster.
[CWS]	smsnotifyprogram	Specifies the location of the smsnotify utility, used to send notifications and reminders via Short Message Service (SMS). Requires Wireless Data Server.
	smsnotifyprogramparam	Specifies the options and arguments to be passed to smsnotify. Requires Wireless Data Server.
	smtpmailmaxcommandlinesize	Sets the maximum buffer size for a sendmail request. Larger requests will be split into multiple smaller requests.
	smtpmailmaxrecipients	Sets the maximum number of recipients to allow in a sendmail request. Larger requests will be split into multiple smaller requests.
[DAS]	diritembindonread	Forces the DAS to bind to the directory server for read-only operations (i.e. searches).
[ENG]	readmaxlocktime	Sets the maximum time an operation can hold a read lock on the calendar database before being forced to release and re-lock.
	writemaxlocktime	Sets the maximum time an operation can hold a write lock on the calendar database before being forced to release and re-lock.
[LDAP]	attr_version	Specifies the version of the LDAP protocol used by the directory server.
	passwordencryption	Determines whether or not to encrypt passwords before sending them to the directory server.
	resourcerelativedn	Specify a DN in which to locate resources by default.
[NOTIFY]	sms	Enables notification and reminders via Short Message Service (SMS). Requires Wireless Data Server.
[YOURHOSTNAME, unidas]	connect_timeout	Determines the timeout for connecting to the directory server.

Bug fixes

• unisnapshot correctly includes the das.log file. (13847)
• unidbfix correctly fixes duplicate meetings with start time equal to the maximum. (13844)
• Synchronizing agendas correctly returns contact data only once. (13788)
• Conflict checking is performed correctly on meetings that span UCT midnight. (13726)
• The Corporate-Wide Services daemon correctly handles e-mail messages with extremely long subject lines. (13631)
• After irregular shutdowns, the server correctly deletes *.sck files from /users/unison/tmp.
• unimvuser correctly moves users with recurring meetings created using CorporateTime Outlook Connector 3.0.
• unidbbackup behaves correctly in installations using a symbolic link to replace the /users/unison/ directory.
• The act.log file correctly records only sign-on entry for CorporateTime desktop clients 5.1 and greater.
• Upgrading from pre-5.1 versions of the calendar server correctly assigns users' PUBLISHEDTYPE attribute to NOTPUBLISHED.
• Adding two users simultaneously with the same UID correctly creates only one account.
• Message queues are correctly deleted only once when Engines exit.
• New users are correctly created with SMS services enabled by default on all platforms.
• unidsup output

---

Patches and Enhancement Packs

Web authentication plug-in

The Web authentication plug-in is an extension to the Authentication, Compression and Encryption (ACE) framework of Steltor's calendar server. With it, the calendar server trusts Web server authentication methods, allowing users to view their calendars without having to sign in explicitly to the calendar server.

The Web authentication plug-in is available only for Steltor Web clients of version 3.0 or greater, and for calendar servers running on Windows NT or Solaris platforms. For more information, including installation and configuration instructions, see the Web authentication plug-in readme file.

Patch01

Patch01 corrects a number of issues concerning on-line address books and synchronization. It is recommended for all installations of CorporateTime Server, and is required for the use of CorporateTime 6.0 native clients, CorporateSync 3.0 and OutlookConnector 3.3.

Installing Patch01 requires a full unidbfix database verification procedure. It is recommended that you install this patch during your next available maintenance window.

This patch is available for Windows NT and 2000, Solaris 2.6, 7 and 8, HP-UX 10.20 and 11, Red Hat Linux 6.1, Compaq Tru64 UNIX 5.0 and IBM AIX 4.3.3.

---

Limitations, caveats, and known problems with this release

• HP-UX 10.20 patch
• Solaris 2.6 and 7 patches
• Upgrades from CorporateTime Server 4.0 and 5.0
• Installing CorporateTime Server 5.2 over CorporateTime Server Administrator (admin GUI)
• unimvuser and UIDs
• Creating users in external directory contexts
• Moving a node between two platforms, key file rebuilding, and node UIDs
• Creating holidays on large nodes
• Using SASL encryption with the Calendar Administrator and CorporateTime Server Administrator
• Moving users in cluster environments
• Upgrading large installations
• Resource double-booking
• Using Secure Sockets Layer (SSL) to connect to an external LDAP directory server
• Linking to an NFS file system

Errors in published documentation

• unidsup output
• [ACE] slibcachecount parameter
• uninode utility: -cws | -snc | -retry | -reset options
• uninodeuid utility: server must be up
• Japanese server configuration
• Using the unil2lendian utility
• [NOTIFY] checkreminderinterval parameter

HP-UX 10.20 patch

Before installing CorporateTime Server 5.2 on an HP-UX 10.20 system, you must apply patch PHSS_15043 (or the newer version if this one is superceded). For HP-UX 11.0 systems, the necessary patch number is PHSS_16587 (or the newer version if this one is superceded). These patches can be downloaded from http://us-support.external.hp.com or http://europe-support.external.hp.com.

Solaris 2.6 and 7 patches

Due to a change in compilers, CorporateTime Server 5.2 for Solaris 2.6 and 7 now requires the C runtime library libCrun.so.1. This library is available in the latest Solaris 2.6 and 7 operating system patches — ID 105591 for Solaris 2.6 and ID 106327 for Solaris 7 — at http://www.sun.com. The appropriate patch must be installed before installing the calendar server.

NOTE: Please DO NOT install the following versions of the patches:

• for Solaris 2.6: Patch ID 105591-08
• for Solaris 7: Patch ID 106327-07

If you have installed either, please unistall it and re-install the latest patch.

Upgrades from CorporateTime Server 4.0 and 5.0

To upgrade Windows NT installations of CorporateTime Server 4.0 or 5.0 to CorporateTime Server 5.2, first upgrade to CorporateTime Server 5.1, then upgrade from CorporateTime Server 5.1 to CorporateTime Server 5.2.

On all platforms, the first time unidbfix is run following an upgrade from CorporateTime Server 4.0 to CorporateTime Server 5.2 the utility will report a database corruption. Run unidbfix in fix mode to correct the problem.

Installing CorporateTime Server 5.2 over CorporateTime Server Administrator (admin GUI)

Before installing CorporateTime Server 5.2 on a machine that hosts CorporateTime Server Administrator, the NT-based administration GUI, you must first uninstall CorporateTime Server Administrator. If the admin GUI is not removed first, the installation will fail. The admin GUI is included in a successful installation of CorporateTime Server (NT version).

unimvuser and UIDs

unimvuser cannot move a user specified only by the UID key.

Event calendars and "Can invite me to events" setting

Event calendar entries should be created with "Can invite me to events" disabled by default. This does not occur in the web client.

Creating users in external directory contexts

New users created in an installation using an external LDAP directory server are incorrectly created with their SMS messages suspended. To override this default:

• uniuser utility: Specify "MOB-ENABLE=TRUE" in the user argument.
• Calendar Administrator: After you create the new user, select "Modify" from the "User" menu. Search for the new user, and select his or her name from the list of search results. On the "Wireless settings" form, deselect the "Disable all messages" checkbox.
• CorporateTime Server Administrator (Windows NT GUI): After you create the new user, select "Properties" from the "User" menu. Search for and select the new user. On the "Wireless Notification" tab, deselect the "Disable all messages" checkbox.

Moving a node between two platforms, key file rebuilding, and node UIDs

If you use unidbfix to rebuild a node's key files after using either of the unib2lendian and unil2bendian utilities, that node's UID will be permanently lost. If you need to move a node between two different platforms, please contact Steltor support at support@steltor.com.

Creating holidays on large nodes

Problems encountered when creating holidays on nodes with large user counts may be caused by the value of the [ENG] readlocktimeout and writelocktimeout parameters. Wait until after normal business hours, raise the parameter values, add the holidays, and when finished lower the parameters to their previous values.

Using SASL encryption with the Calendar Administrator and CorporateTime Server Administrator

If SASL is the only supported encryption mechanism on your server, you will not be able to connect through the Calendar Administrator or CorporateTime Server Administrator unless you install the SASL library (libsasl) on the client machine. This library should be installed in the <cgi-bin>/caladmin/ directory for the Calendar Administrator; for the CorporateTime Server Administrator, it should be installed in the C:\WINNT\System32 directory.

Moving users in cluster environments

After using the unimvuser utility to move a user between nodes, there may be a delay before that user's new location is replicated to the master node of the cluster. During this time, that user will not be able to sign in.

Upgrading large installations

Due to a limitation of the UNIX tar utility, you may encounter problems when upgrading to CorporateTime Server 5.2 if the total size of the files in your /users/unison directory exceeds 2 GB. Contact Steltor Support at support@steltor.com for information on bypassing this limitation.

Resource double-booking

It is not currently possible to configure some resources to allow double-booking and some not to allow double-booking, even by locating those groups of resources on different servers within the node network. The [ENG] allowresourceconflicts and [LIMITS] resourceconflicts parameters must be set to the same value for all servers in your installation.

Using Secure Sockets Layer (SSL) to connect to an external LDAP directory server

Make sure that you have a recent version of the Netscape LDAP SSL API. Version 4.1 has been certified; Version 3.0 is not supported. The most recent version is available at http://www.iplanet.com/downloads/developer/.

In addition, the value of the [LDAP] certdbpath parameter must follow UNIX path syntax, even on Windows NT installations of the calendar server. For example, on Windows platforms, use /Program Files/Netscape/Users/ngaiom/cert7.db instead of C:\Program Files\Netscape\Users\ngaiom\cert7.db.

Linking to an NFS file system

UNIX installations of CorporateTime Server support linking the users/unison/db directory to a remote NFS file system; however, you may not link the entire users/unison tree to an NFS file system. All other directories must remain local.

unidsup output

Contrary to the Reference Manual, the unidsup utility produces the following output when it finds that the directory server is running: directory server is up. To override this behaviour and have the utility produce no output, specify the -q option.

[ACE] slibcachecount parameter

The [ACE] slibcachecount parameter is incorrectly documented in the Reference Manual as [ACE] libcachecount.

uninode utility: -cws | -snc | -retry | -reset options

Contrary to the Reference Manual, the -cws, -snc, -retry and -reset options of the uninode utility do not require a node-ID, host name or group to be supplied. If no node-ID, host name or group is specified, the utility will behave as if the value "all" were specified.

uninodeuid utility: server must be up

Contrary to the Reference Manual, the calendar server must be up to run the uninodeuid utility.

Japanese server configuration

Appendix E of the CorporateTime Server Administrator's Guide, under the Japanese server configuration heading, incorrectly refers to the [CWS] emailcharset parameter; it should instead refer to the [CWS] emailcharsetmap parameter.

Using the unil2lendian utility

The unil2lendian utility is only available for UNIX platforms. Therefore, when moving a node from a little-endian UNIX server to a Windows NT server, you must run unil2lendian before moving the node. When moving a node from a Windows NT server to a little-endian UNIX server, however, you must move the node before running unil2lendian.

[NOTIFY] checkreminderinterval parameter

The CorporateTime Server Reference Manual incorrectly describes the unison.ini [NOTIFY] checkreminderinterval parameter as the interval, in seconds, that the CWS daemon/service waits between checks for reminders. In fact this parameter specfies the interval in minutes, and the default value is 2, not 180.

Copyright 1993-2002 Steltor Inc. All rights reserved.