Sun Java logo     Copyright      Index      Next     

Sun logo
Sun Java System Portal Server 6 2004Q2 Migration Guide 

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
Related Third-Party Web Site References
Where to Find Related Information
Where to Find This Guide Online

Part I Migrating from Sun ONE Portal Server 3.0 to Sun ONE Portal Server 6.2

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.2 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
Implementing the Authentication Service Provider Interface (SPI)
Creating the AuthModule.jar File
Creating the XML Service File
Creating the Authentication Module Configuration File
Creating the Localization Properties 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
Online Help Is Not Localized
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.2 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.2
Obtaining the Certificate
Creating and Initializing a New Sun ONE Portal Server 6.2 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
To Add the Migration Tools to the Sun ONE Portal Server 3.0 Gateway Machine
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
Migrating the Personal Interest Profile (PIP)
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 Sun ONE Identity Server SSOToken
Migrating the Sun ONE Portal Server 3.0 Profile to Sun ONE Identity Server User Management Classes and Service Management Classes
Migrating Sun ONE Portal Server 3.0 Logging to Sun ONE Identity Server Logging APIs
Migrating Sun ONE Portal Server 3.0 Debug to Sun ONE Identity Server Debug APIs
Migrating Sun ONE Portal Server 3.0 Provider APIs to Sun ONE Portal Server 6.2 Provider APIs

Chapter 10   Enabling Logon to a Different Organization or Suborganization
Part II Upgrading from Sun Java System Portal Server 6.0 to Sun ONE Portal Server 6.2

Chapter 11   Planning the Upgrade from Sun Java System Portal Server 6.0 to Sun Java System Portal Server 6.2
Overview of Upgrade Process
Upgrading Certificates
Upgrading Multiple Nodes

Chapter 12   Upgrading from Sun ONE Identity Server 5.1 to Sun™ ONE Identity Server 6.1
Overview Sun ONE Identity Server Upgrade Process
Backing Up Existing Installation
Removing Sun ONE Portal Server 6.0 Packages and Backing Up Templates
Upgrading the Web Container
Upgrading to Sun ONE Web Server 6.1 Software
Upgrading to Sun ONE Application Server 7.0 Update 1 Software
Uninstalling Sun ONE Identity Server 5.1 Components and Schema
Upgrading the Existing Directory Server Installation with the Sun ONE Identity Server 6.1 Schema
Retaining the Top Level Entry of the Directory Information Tree (DIT)
Installing Sun ONE Identity Server 6.1 Components on the Existing Directory Server Installation
Migrating Sun ONE Identity Server 5.1 Services, Policies, Authentication Entries, and Top Level Organization Data

Chapter 13   Upgrading from Sun ONE Identity Server 6.0 to Sun™ ONE Identity Server 6.1
Overview of the Sun ONE Identity Server Upgrade Process
Backing Up and Removing the Sun ONE Identity Server 6.0 Installation
Installing Sun ONE Identity Server 6.1 Software
Completing the Upgrade

Chapter 14   Upgrading Sun™ ONE Portal Server Software from Version 6.0 to Version 6.2
The Upgrade Process
Installing Sun ONE Portal Server 6.2 Software
Restoring the Customized Files
Localizing Online Help
Upgrading Sun ONE Portal Server: Secure Remote Access Pack

Part III Upgrading from Portal Server 6.1 to Sun ONE Portal Server 6.2

Chapter 14   Planning the Upgrade from Sun Java System Portal Server 6.1 to Sun Java System Portal Server 6.2
Overview of Upgrade Process
Upgrading Certificates
Upgrading Multiple Nodes

Chapter 15   Upgrading Sun™ ONE Portal Server Software from Version 6.1 to Version 6.2
Overview of the Sun ONE Portal Server Upgrade Process
Removing Sun ONE Portal Server 6.1 Packages and Backing Up Templates
Installing Sun ONE Portal Server 6.2 Software
Completing the Upgrade
Localizing Online Help

Part IV Upgrading from Sun ONE Portal Server 6.2 to Sun Java System Portal Server 6 2004Q2

Chapter 17   Planning the Upgrade from Sun ONE Portal Server 6.2 to Sun Java System Portal Server 6 2004Q2
Overview of Upgrade Process
Installing Portal Server and Identity Server on Separate Machines
Upgrading Multiple Nodes

Chapter 18   Upgrading from Sun ONE Portal Server 6.2 to Sun Java System Portal Server 6 2004Q2
Accessing Patches
Backing up Web Container Customized Files
Upgrading the Sun Web Container Software
Upgrading Identity Server
Using Web Server 6 2004Q2 as a Web Container
Backing up the Administration Console Help Files
Enabling Client Detection
Verifying the Upgrade
Upgrading Portal Server
Upgrading Portal Server on a Sun Web Container
Upgrading Portal Server on a Third-Party Web Container
Upgrading Using a WebLogic Web Container
Upgrading Using a WebSphere Web Container
Upgrading the Gateway
Upgrading the Rewriter Proxy
Upgrading the Netlet Proxy
Upgrading Localization

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.2
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 Sun ONE Identity Server Attributes for Sun ONE Portal Server 6.2

Appendix F   Authentication Framework Changes Between Sun ONE Portal Server 6.0 and Sun ONE Portal Server 6.2
Authentication Framework
Authentication Configuration and Property Files
amAuth.xml File
XML Service File
Localization Properties File
Authentication Module Configuration File
Rewriting the Authentication Modules

Appendix G   Example of Sun ONE Portal Server 3.0 Provider Migrated to Sun ONE Portal Server 6.x

Copyright      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.