Sun Java Communications Suite 5 Installation Guide

Appendix B Calendar Server Pre-Installation Considerations

This appendix describes considerations you need to think about before installing Calendar Server.

This appendix contains the following sections:

Planning for Calendar Server Administrators

Administrators for Calendar Server include:

Calendar Server Administrator (calmaster)

The Calendar Server administrator is a specific user name with its associated password that can manage Calendar Server. For example, a Calendar Server administrator can start and stop Calendar Server services, add and delete users, create and delete calendars, and so on. This user has administrator privileges for Calendar Server but not necessarily for the directory server.

The default user ID for the Calendar Server administrator is calmaster, but you can specify a different user during Calendar Server configuration, if you prefer. After installation you can also specify a different user in the service.admin.calmaster.userid parameter in the ics.conf file.

The user ID you specify for the Calendar Server administrator must be a valid user account in your directory server. If the Calendar Server administrator user account does not exist in the directory server during configuration, the configuration program can create it for you.

See the Sun Java System Calendar Server 6.3 Administration Guide for the complete list of Calendar Server administrator configuration parameters in the ics.conf file.

Calendar Server User and Group

On Solaris systems, these special accounts are the user ID and group ID under which Calendar Server runs. Use the default values, icsuser and icsgroup, which are automatically created by the configuration program, if they do not exist. If you prefer, however, you can specify values other than icsuser and icsgroup when you run the Calendar Server configuration program. These values are stored in the local.serveruid and local.servergid parameters, respectively, in the ics.conf file.

Superuser (root)

On machines running Solaris software, you must log in as or become superuser (root) to install Calendar Server. You can also run as superuser to manage Calendar Server using the command-line utilities. For some tasks, however, you should run as icsuser and icsgroup (or the values you have selected) rather than superuser to avoid access problems for Calendar Server files.

Planning for Calendar Server Hosted Domains

Calendar Server supports hosted (or virtual) domains. In a hosted domain installation, each domain shares the same instance of Calendar Server, which enables multiple domains to exist on a single server. Each domain defines a name space within which all users, groups, and resources are unique. Each domain also has a set of attributes and preferences that you specifically set.

When installing and configuring hosted domains, use Schema 2 only.

Installing and configuring hosted domains on a server involves these high-level steps:

  1. Installing and configuring Directory Server

  2. Installing and configuring Web Server or Application Server

  3. Installing and configuring Access Manager

    Delegated Administrator is installed with Access Manager.

  4. Creating the domains for your site using Delegated Administrator

  5. Installing Calendar Server

  6. Running the script

    For instructions on running this script, see Calendar Server Postinstallation Configuration.

  7. Configuring Communications Services Delegated Administrator

    For instructions on configuring and using the Communications Services Delegated Administrator utility, see the Sun Java System Delegated Administrator 6.4 Administration Guide.

  8. Creating default domain and site administrator (calmaster)

    The default domain is created when Delegated Administrator is configured, but the domain entry must be modified to add Calendar (or Mail) services. Also, you must set up the site calendar administrator (calmaster). For instructions on how to perform these two tasks, see Part II, Post Installation Configuration for Calendar Server 6.3 Software, in Sun Java System Calendar Server 6.3 Administration Guide.

  9. Configuring Calendar Server

    For instructions on running the program, see Chapter 2, Initial Runtime Configuration Program for Calendar Server 6.3 software (, in Sun Java System Calendar Server 6.3 Administration Guide.

  10. Setting domain configuration parameters for Calendar Server

    For a list of the configuration parameters and their values, see Calendar Server Domain Configuration Parameters in Sun Java System Calendar Server 6.3 Administration Guide.

  11. Populating your domains with users and resources using Delegated Administrator

  12. Starting Calendar Server services

    For instructions, see Starting and Stopping Calendar Server 6.3 Processes in Sun Java System Calendar Server 6.3 Administration Guide.

    Note –

    Always perform your provisioning for Schema 2 with the Communications Services Delegated Administrator interface.

    Schema 1 provisioning tools do not support hosted domains.

Post-Installation Calendar Server Configuration

After you install the Calendar Server software, you must configure it. This step was previously performed as part of the installation process, but has now been separated out of the installer.

After you install Calendar Server, you must configure Calendar Server as follows:

  1. Run the Directory Server Setup script ( to configure Sun Java System Directory Server.

  2. Run the Calendar Server configuration program ( to configure your site’s specific requirements and to create a new ics.conf configuration file. For a description of the parameters in the ics.conf file, see Configuration Parameters (ics.conf) File in Sun Java System Calendar Server 6.3 Administration Guide.

    The script is located in the /opt/SUNWcomds/sbin directory, and the utility is located in the /opt/SUNWics5/cal/sbin directory.

    There are some configuration settings and changes that the Java Enterprise System installer and Calendar Server configuration utility ( do not make. You must manually make changes to the following items:

    • DWP and CLD Configurations. Edit the ics.conf file so that the CLD cache option is enabled. This cache stores the DWP host server information for calendar users and thus reduces calls to the LDAP directory server.

    • Default Time Zone. If your default time zone is not Americas/New York, change it by editing the ics.conf file. You also need to change it in the /opt/SUNWics5/cal/bin/html/default_user_prefs.xml file so that it is in sync with the ics.conf file.

    • Client-side Rendering. Calendar Server performs client-side rendering by downloading the XSLT processing to the end user’s browser, which in turn reduces the processing that must be done by Calendar Server. Calendar Server downloads the XSLT processing only if the browser is capable of rendering the XSLT processing. In the current release, this applies only to Internet Explorer 6.0. Edit the ics.conf file to make this performance improvement to client-side rendering.

    • Setting for tmpfs. Edit the tmpfs setting for performance enhancement.

    For more information on these changes, see the Sun Java System Calendar Server 6.3 Administration Guide.