Contents


About This Guide

Who Should Read This Book
What You Need to Know
How This Book is Organized
Document Conventions Used in This Guide

Monospaced Font
Bold Monospaced Font
Italicized Font
Square or Straight Brackets
Command-Line Prompts

Where to Find Related Information
Where to Find This Guide Online

Chapter 1 Planning the Migration

Overview of Data Migration
The Migration Process

How the Migration Process Works

Export Tool
Conversion Tool
Import Tool

What You Need to Know Before Beginning the Migration Process

Migration Checklist
Migration Tools Overview

Export Tool

Export Tool Modules
LDAP Database Export Module
Flat File Export Module
Certificate Export Module

Conversion Tool

Conversion Tool Modules
LDAP Database Conversion Module
Gateway Rules to Rewriter Rulesets Conversion Module
Desktop Conversion Module
Certificate Conversion Module

Import Tool

Import Tool Modules
LDAP Database Import Module
Flat Files Import Module
Certificate Import Module

Chapter 2 Migrating LDAP Data

Using the Export Tool

To Run the Export Tool

Using the Conversion Tool

To Run the Conversion Tool

Using the Import Tool

To Run the Import Tool

Writing Data Migration Modules
Setting the Sun ONE Portal Server 6.0 Organization to the Sun ONE Portal Server 3.0 Domain
Post-Migration Issues and Tasks

Cause 1

Pre-Migration Conditions
Post-Migration Condition
Solution

Cause 2

Pre-Migration Conditions
Post-Migration Condition
Solution

Chapter 3 Migrating Custom Authentication Modules

Moving Custom Authentication Modules from Sun ONE Portal Server 3.0 to iPlanet Directory Server Access Management Edition 5.1
Implementing the Factory Class com.iplanet.authentication.spi.AuthenticationModuleFactory
Implementing the Module Extending com.iplanet.authentication.spi.AuthenticationModule
Creating the iwtAuthModule.jar File
Creating the iwtAuthmodule.xml File
Modifying the amAuth.xml File

Chapter 4 Migrating The Rewriter

Overview of the Rewriter
Converting Gateway Attributes to Rules
Using the Export Tool

To Run the Export Tool

Using the Conversion Tool

To Run the Conversion Tool

Using the Import Tool

To Run the Import Tool

Writing Data Migration Modules

Chapter 5 Migrating The Desktop

Desktop Pre-Migration Issues and Tasks

Ensuring Files are Migrated

Using the Export Tool

To Run the Export Tool

Using the Conversion Tool

To Run the Conversion Tool

Using the Import Tool

To Run the Import Tool

Desktop Post-Migration Issues and Tasks

Desktop Links and Colors

Links
Colors

Background Color of the Channel Title Bar Does Not Line up with the Channel Border
Duplicate Portal Server / Sun ONE Portal Server Banner
RSS Channel Does Not Display Content
JavaScript Error

Writing Data Migration Modules
Migrating Custom Channels and Custom Providers

Overview of the Process of Migrating Custom Providers
Research and Planning

Reading Documentation
Training Your Staff
Defining the Features of Sun ONE Portal Server 6.0 You Plan to Use
Taking Inventory of Custom Provider Code Used in Your Sun ONE Portal Server 3.0 Deployment
Initiating a Project Plan for Ensuring Custom Provider Conversion
Preparing Your Test Environment
Running the Migration Tools
Validating Custom Provider Data Migration

Making Manual Changes to Provider Code
Common Errors Encountered and Recommended Fixes
Information About Channel Migration
Example Custom Provider: Manual Code Changes for Migration

Chapter 6 Migrating Certificates

Using the Export Tool

To Run the Export Tool

Using the Conversion Tool

To Run the Conversion Tool

Using the Import Tool

To Run the Import Tool

Migrating SSL Certificates on a Multi-Instance Installation
Migrating Open Mode SSL Sun ONE Portal Server 3.0 to Sun ONE Portal Server 6.0

Obtaining the Certificate
Creating and Initializing a New Sun ONE Portal Server 6.0 Instance
Requesting a Certificate
Installing the Certificate

Chapter 7 Migrating the Gateway, Netlet, and NetFile

Overview

Sun ONE Portal Server 3.0 Gateway and Server on the Same Machine
Sun ONE Portal Server 3.0 Gateway and Server on Different Machines

Migrating Sun ONE Portal Server 3.0 Gateway Data

Migrating Gateway Data From a Stand-Alone Gateway System
Migrating Gateway Data From a System Containing the Gateway and Server

To Run the Export Tool
To Run the Conversion Tool
To Run the Conversion Tool to Convert Display Profile Data
To Run the Import Tool
To Run the Import Tool to Import Display Profile Data

Verifying the Migration
Troubleshooting

Chapter 8 Migrating Sun ONE Compass Server

What You Need to Know Before Beginning the Sun ONE Compass Server Migration Process
Using the Sun ONE Compass Server Export Tool

To Run the Sun ONE Compass Server Export Tool

Using the Sun ONE Compass Server Import Tool

To Run the Sun ONE Compass Server Import Tool

Chapter 9 Changes in Sun ONE Portal Server APIs that Affect Migration

Changes From Sun ONE Portal Server 3.0 That Affect Application Development
Migrating Sun ONE Portal Server 3.0 Session to iPlanet Directory Server Access Management Edition 5.1 SSOToken
Migrating the Sun ONE Portal Server 3.0 Profile to iPlanet Directory Server Access Management Edition 5.1 User Management Classes and Service Management Classes
Migrating Sun ONE Portal Server 3.0 Logging to iPlanet Directory Server Access Management Edition 5.1 Logging APIs
Migrating Sun ONE Portal Server 3.0 Debug to iPlanet Directory Server Access Management Edition 5.1 Debug APIs
Migrating Sun ONE Portal Server 3.0 Provider APIs to Sun ONE Portal Server 6.0 Provider APIs

Chapter 10 Enabling Logon to a Different Organization or Suborganization

Appendix A Tool Design

Sun ONE Portal Server 3.0 Data Migration Tool Suite

Export Tool Design

Synopsis
Description
Options
Usage

Conversion Tool Design

Synopsis
Description
Options
Usage

Import Tool Design

Synopsis
Description
Options
Usage

Flow of Sun ONE Portal Server 3.0 Data Migration Tool Suite

Export Tool
Conversion Tool
Import Tool

Sun ONE Compass Server Migration Tools

Sun ONE Compass Server Export Tool Design

Synopsis
Description
Parameters
Usage

Sun ONE Compass Server Import Tool Design

Synopsis
Description
Parameters

Appendix B Sun ONE Portal Server 3.0 Data Migration Module Author's Guide

What Makes a Module?
Module Example

Desktop Module Files
Module Code Examples
Important Variables

Appendix C Public API Changes Between Sun ONE Portal Server 3.0 and Sun ONE Portal Server 6.0

Appendix D Tag and String Changes Made in Templates and JSPs by the Migration Tools

Appendix E Extended Sun ONE Portal Server 3.0 Component Migration

Options For Making Manual Changes After Migration

Option 1
Option 2

Example of Adding Custom iPlanet™ Directory Server Access Management Edition 5.1 Attributes for Sun ONE Portal Server 6.0.