Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Services 6 2005Q1 Schema Migration Guide 

Preface

This guide describes how to migrate Sun Java™ System LDAP Directory data from LDAP Schema 1 to LDAP Schema 2 for Sun Java™ System Communications Services, specifically Sun Java™ System Messaging Server and Sun Java™ System Calendar Server.

Topics covered in this chapter include:

Who Should Use This Book

You should read this manual if you currently have installed Messaging Server 5.x or Calendar Server 5.x, using LDAP Schema 1, and you want to take advantage of services provided by Sun Java™ System Access Manager (formerly called Identity Server).

To integrate Messaging Server and Calendar Server with Access Manager, you must migrate your LDAP directory data from Schema 1 to Schema 2.

The audience for this manual consists of:

Before You Read This Book

This book assumes that you have a general understanding of the following:

How This Book Is Organized

This book contains the following chapters and appendix:

Table 1  How This Book Is Organized 

Chapter

Description

Chapter 1, "Schema Migration Overview"

Explains the reasons for migrating to Schema 2 and provides an overview of the migration steps.

Chapter 2, “Migration Scenarios”

Describes sample scenarios that offer migration paths for various user deployments and priorities.

Chapter 3, "Using the Migration Utility"

Defines the syntax and options of the schema migration utility.

Chapter 4, "Upgrading and Configuring the Servers"

Describes how to upgrade and configure the Messaging Server and Calendar Server to use LDAP Schema 2.

Glossary

 

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table 2  Typographic Conventions 

Typeface

Meaning

Examples

AaBbCc123
(Monospace)

Any text that appears on the computer screen or text that you should type. Can be API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123
(Monospace bold)

Text you should type when it appears within a code example or other onscreen computer output.

% su
Password:

AaBbCc123
(Italic)

A placeholder in a command or path name that you should replace with a real name or value (for example, a variable).

Also can be a book title, new term, or word to be emphasized.

The file is located in the msg_svr_base/bin directory.

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.

Symbols

The following table describes the symbol conventions used in this book.

Table 3  Symbol Conventions 

Symbol

Description

Example

Meaning

[ ]

Contains optional command options.

ls [-l]

The -l option is not required.

{ | }

Contains a set of choices for a required command option.

-d {y|n}

The -d option requires that you use either the y argument or the n argument.

-

Joins simultaneous multiple keystrokes.

Control-A

Press the Control key while you press the A key.

+

Joins consecutive multiple keystrokes.

Ctrl+A+N

Press the Control key, release it, and then press the subsequent keys.

>

Indicates menu item selection in a graphical user interface.

File > New > Templates

From the File menu, choose New. From the New submenu, choose Templates.

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table 4  Default Paths and File Names

Term

Description

msg_svr_base

Represents the base installation directory for Messaging Server. The default value of the msg_svr_base installation is as follows:

Solaris™ systems: /opt/SUNWmsgsr

Linux systems: /opt/sun/messaging

cal_svr_base

Represents the base installation directory for Calendar Server. The default value of the cal_svr_base installation is as follows:

Solaris™ systems: /opt/SUNWics5

Linux systems: /opt/sun/calendar

Command Line Prompts

Command line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system you are using, you will see a variety of different command line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.

Related Documentation

The http://www.oracle.com/technetwork/indexes/documentation/index.htmlSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Messaging Server Documents

Use the following URL to see all the Messaging Server documentation:

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/MessagingServer_05q1

The following documents are available:

The Messaging Server product suite contains other products such as Sun Java™ System Console, Directory Server, and Administration Server. Documentation for these and other products can be found at the following URL:

http://www.oracle.com/technetwork/indexes/documentation/index.html/db/prod/sunone

In addition to the software documentation, see the Messaging Server Software Forum for technical help on specific Messaging Server product questions. The forum can be found at the following URL:

http://swforum.sun.com/jive/forum.jsp?forum=15

Calendar Server Documents

Use the following URL to see all the Calendar Server documentation:

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/CalendarServer_05q1

The following documents are available:

Communications Services Documents

Use either one of the following URLs to see the documentation that applies to all Communications Services products:

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/MessagingServer_05q1

or

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/CalendarServer_05q1

The following documents are available:

Where to Find This Manual Online

You can find the Sun Java™ System Communications Services Schema Migration Guide online in HTML and PDF formats.

To find this manual or other Messaging Server documentation, use the URL:

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/MessagingServer_05q1

Or, for this manual and other Calendar Server documentation, use the URL:

http://www.oracle.com/technetwork/indexes/documentation/index.html/coll/CalendarServer_05q1

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.

Related Third-Party Web Site References

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to http://www.oracle.com/technetwork/indexes/documentation/index.html and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java™ System Communications Services 6 2005Q1 Schema Migration Guide, and the part number is 819-0112-10.



Previous      Contents      Index      Next     

Copyright 2005 Sun Microsystems, Inc. All rights reserved.