Sun Java System Communications Services 6 2005Q4 Schema Migration Guide

Single Server - Migrate to Native Mode

This scenario makes the following assumptions:

Your applications are running on a single-server system.
The following applications are installed on your system:
- One installation of Messaging Server, or
- One installation of Calendar Server, or
- One installation each of Messaging Server and Calendar Server
The system does not include user-developed applications that rely on Schema 1.

Characteristics of This Scenario

Simple and straightforward migration method

Migration Steps

The following steps outline how to migrate a single-server system directly to Schema 2, native mode:

To Migrate a Single-server System to Schema 2, Native Mode

Steps

Upgrade Messaging Server and Calendar Server from version 5.x to version 6 (if you have not already done so).

For information about upgrading Messaging Server, see Upgrading Messaging Server to Version 6

For information about upgrading Calendar Server, see Upgrading Calendar Server to Version 6

Be sure that the upgraded (version 6) servers are still configured for Schema 1.

During the server upgrade, you run the Communications Services Directory Server Setup Perl script, comm_dssetup.pl. The script asks you to specify the schema version Directory Server will use:
- Specify Schema 1.
  
  Set the comm_dssetup.pl -t option as follows: -t 1
  
  You only need to run the comm_dssetup.pl once for each Directory Server used by the Messaging and Calendar servers, although it does no harm to run the script more than once.
  
  For information about running comm_dssetup.pl, see Running the Directory Server Setup Script

Install Access Manager 6.1 or later.

Follow the Access Manager installation instructions in the Sun Java Enterprise System 2005Q4 Installation Guide for UNIX.
1. Before you run the Java Enterprise System installation program, gather the information needed to install Access Manager with a provisioned directory. For details, see the Access Manager: Provisioned Directory Information in Sun Java Enterprise System 2005Q4 Installation Reference section of the Sun Java Enterprise System Installation Guide.
  
  Part 1: Installation Configuration Information Access Manager Configuration Information Access Manager: Provisioned Directory Information
2. During the installation, you are asked if you want Access Manager to use an existing provisioned directory. Answer yes.
  
  The installation program asks you to specify the following parameters associated with your directory:
  
  Organization Object Marker Class: Object class defined for the organization in the existing provisioned directory. The default value is SunManagedOrganization.
  
  Organization Naming Attribute: Naming attribute used to define organizations in the existing provisioned directory. The default value is o.
  
  User Marker Object Class: Object class defined for users in the existing provisioned directory. The default value is inetorgperson.
  
  User Naming Attribute: Naming attribute used for users in the existing provisioned directory. The default value is uid.
3. After you install Access Manager, configure Access Manager to operate with the existing directory. .
  
  Follow the steps in “Chapter 4, Configuring Access Manager With an Existing Directory Server” in Sun Java System Access Manager 6 2005Q1 Migration Guide.
  
  Note –
  Do not provision your LDAP directory with Access Manager tools before you have migrated the directory to Schema 2. The Messaging and Calendar servers cannot recognize any new domain information provisioned by Access Manager tools until you perform the migration to Schema 2 and reconfigure the servers for Schema 2.

Install and configure the Communications Services Delegated Administrator console and utility (commadmin).

Use the Sun Java Enterprise System Installer to install Delegated Administrator.

After the installation, you must run the Delegated Administrator configuration program, config-commda.

For details, see Chapter 3, Configuring Delegated Administrator, in Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide.

Back up the LDAP directory.

Migrate the LDAP directory from Schema 1 to Schema 2, native mode.

Use the Schema Migration utility, commdirmig, to perform the migration.

Do not provision the directory while commdirmig is running.

For information on running the commdirmig utility and on the utility options and syntax, see Chapter 3, Using the Migration Utility

Configure Messaging Server and Calendar Server to use Schema 2, native mode.

For information about reconfiguring Messaging Server, see Configuring Messaging Server for Schema 2

For information about reconfiguring Calendar Server, see Configuring Calendar Server to Use Schema 2

Stop and restart the Administration Server.

You can use the following commands:
/usr/bin/mpsadmserver stop
/usr/bin/mpsadmserver start

Verify that the following processes are functioning properly:
- The servers are working with the migrated schema
- Provisioning can take place successfully

If you wish, remove the DC Tree (the defunct Schema 1 directory elements).

Note –
Do not remove the DC Tree until you have verified that the migration was completed successfully (as described in the preceding “verify” step).

You can use an LDAP command-line tool to remove the DC Tree.

This step is optional. The DC Tree is not used in Schema 2, but it does no harm to leave the deprecated DC Tree in the LDAP directory after Schema 2 is in place.