Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Services 6 2005Q1 Deployment Planning Guide 

Chapter 20
Understanding Calendar Server Pre-Installation Considerations

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

This chapter contains the following sections:

Calendar Server Installation Considerations

The installation and configuration of Calendar Server has significantly changed from earlier Calendar Server releases (pre-2003Q4 versions). There is no longer a standalone installer for Calendar Server.

If you do not already have Calendar Server installed, you must use the Sun Java Enterprise System installer to get the 2005Q1 version. With this installer, you can also install other Sun Java System component products and packages. For information about the Java Enterprise System installer, refer to the Sun Java Enterprise System 2005Q1 Installation Guide:

If you want to upgrade from Calendar Server 6 2003Q4 to Calendar Server 6 2005Q1, the upgrade process is described in “Upgrading from Java Enterprise System 2003Q4” in the Sun Java Enterprise System 2005Q1 Upgrade and Migration Guide:

For information about migrating from older versions of Calendar Server, up through version 5.x, see the Migrations Utility chapter in the Sun Java Systems Calendar Server Administration Guide (covers up to version 5.x):

For migrating from versions later than 5.x, contact your Sun support representative.

Which Calendar Server Components to Configure?

When you install Calendar Server software, the Java Enterprise System installer installs all the Calendar Server packages. You then configure the appropriate Calendar Server component on a Calendar host through the Calendar Server configurator program.

The following table shows which components you need to configure for each type of Calendar host.

Table 20-1  Which Calendar Server Components to Configure?  

Type of Calendar Host Being Configured

Needs These Components Selected in the Configurator Program

Front end

HTTP service(s) and Administration service

Back end

Notification Service, Event Notification Service, Distributed Database Service and Administration Service

The Distributed Database Service (csdwpd) is required only on back-end servers, that is, a server that has a calendar database, but does not provide user access services (cshttpd). It is not required on front-end servers that do not have a calendar database. The csdwpd service enables you to link front-end and back-end servers within the same Calendar Server configuration to form a distributed calendar store.

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 Serve 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
  4. The Delegated Administrator is installed with Access Manager.

  5. Installing Calendar Server
  6. Running the script
  7. For instructions on running this script, see Chapter 2 in the Sun Java System Calendar Server Administration Guide:

  8. Configuring Communications Services Delegated Administrator
  9. For instructions on configuring and using the Communications Services Delegated Administrator utility, see the Sun Java System Communications Services Delegated Administrator Guide:

  10. Creating default domain and site administrator (calmaster)
  11. The default domain is created when commadmin is configured, but the domain entry must be modified to add Calendar (or Mail) services. Also, the site calendar administrator (calmaster) must be set up. For instructions on how to perform these two tasks, see “Post Configuration Tasks” in the Sun Java System Calendar Server Administration Guide.

  12. Configuring Calendar Server
  13. For instructions on running the program, see Chapter 3 in the Sun Java System Calendar Server Administration Guide.

  14. Setting hosted domain configuration parameters for Calendar Server
  15. For a list of the configuration parameters and their values, see “Hosted Domain Configuration Parameters” in the Sun Java System Calendar Server Administration Guide.

  16. Creating the hosted domains for your site by using the commadmin utility
  17. Populating your hosted domains with users and resources by using the commadmin utility
  18. Starting Calendar Server services
  19. For instructions, see the Sun Java System Calendar Server Administration Guide.


    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 the Sun Java System Calendar Server Administration Guide:
  3. /docs/cd/E19955-01/819-0024

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:

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

Previous      Contents      Index      Next     

Part No: 819-0063-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.