Sun Java System Communications Services 6 2005Q4 Schema Migration Guide

Configuring Calendar Server for Hosted Domain Support

To support Schema 2, Calendar Server also must be configured to support hosted (virtual) domains. This section briefly summarizes the procedures for supporting hosted domains. For more information, see Chapter Chapter 13, Administering Hosted Domains, in Sun Java System Calendar Server 6 2005Q4 Administration Guide.

To migrate a site to use hosted domains, you must perform the following tasks:

Configuring Calendar Server for Hosted Domain Support describes the parameters in the ics.conf file used for hosted domain support. If any of the following parameters are not in the ics.conf file, add the parameter and its associated value to the file and then restart Calendar Server for the values to take effect.

For more information about editing the ics.conf file, see AppendixAppendix E, Calendar Server Configuration Parameters, in Sun Java System Calendar Server 6 2005Q4 Administration Guide.

Table 4–1 Configuration Parameters for Hosted Domain Support



Enables (y) or disables (n) support for hosted (virtual) domain mode. Default is n. 


Specifies the version of the LDAP schema: 

  • “1" = Schema 1. See also service.dcroot.

  • “2" = Schema 2. See also service.schema2root.

    Default is “1"


Specifies the root suffix of the DC tree in the LDAP directory, if local.schemaversion = "1"

For example: "o=internet"

In hosted (virtual) domain mode, Calendar Server uses the service.dcroot parameter and not the local.ugldapbasedn and local.authldapbasedn parameters.

Conversely, in non-hosted (virtual) domain mode, Calendar Server uses the local.ugldapbasedn and local.authldapbasedn parameters and not the service.dcroot parameter.


Specifies the root suffix underneath which all domains are found, if local.schemaversion = "2"

For example: “


Specifies the default domain for this instance of Calendar Server. Used when a domain name is not supplied during a login. 

For example: “"


Specifies a string of separators used for the login-separator when Calendar Server parses “userid[login-separator]domain


Calendar Server tries each separator in turn. 

Default is “@+


Specifies the user ID of the domain administrator. 

For example:

service.virtualdomain.scope = "select"

Controls cross domain searching: 

  • primary" = Search only within the domain where the user is logged in.

  • select" = Search in any domain that allows the search.

    Default is “select"


Specifies the language for the domain. Default is “en" (English).