Who Should Use This Book | Sun Microsystems 8190994 manual

Preface

This Migration Guide describes how to migrate the components of Directory Server Enterprise Edition to version 6.0. The guide provides migration instructions for Directory Server, Directory Proxy Server, and Identity Synchronization for Windows.

Who Should Use This Book

This guide is intended for directory service administrators who are migrating to Directory Server Enterprise Edition 6.0. The guide might also be useful to business planners who are considering migrating to the new version.

Before You Read This Book

If you are not yet familiar with this version of Directory Server Enterprise Edition, you might want to start by evaluating the new features and capabilities of the product. For more information, see the Sun Java System Directory Server Enterprise Edition 6.0 Evaluation Guide and the Sun Java System Directory Server Enterprise Edition 6.0 Release Notes.

How This Book Is Organized

Chapter 1 describes the steps involved in migrating to Directory Server 6.0.

Chapter 2 explains how to use the migration tool provided with Directory Server 6.0.

Chapter 3 describes the process for manual migration of each part of Directory Server.

Chapter 4 describes the issues involved in migrating replicated servers.

Chapter 5 describes the architectural changes in Directory Server 6.0 that affect migration from a previous version.

Chapter 6 describes how the configuration properties in Directory Proxy Server 6.0 can be used to simulate a version 5 configuration.

Chapter 7 describes the steps involved in migrating to Identity Synchronization for Windows 6.0.

15

Sun Confidential: Registered

Image 15

Sun Microsystems 8190994 manual Who Should Use This Book, Before You Read This Book, How This Book Is Organized

Contents

Sun Microsystems, Inc Network Circle Santa Clara, CA Enterprise Edition 6.0 Migration Guide 070222@16599 Contents Architectural Changes in Directory Server Migrating a Replicated Topology Migrating Directory Proxy Server Migrating Identity Synchronization for Windows 105 Index 145 Sun Confidential Registered Figures Sun Confidential Registered Tables Mapping Between 5 and 6.0 Password Policy Attributes Tables Examples Sun Confidential Registered Who Should Use This Book Before You Read This BookHow This Book Is Organized Table P-1Directory Server Enterprise Edition Documentation Directory Server Enterprise Edition Documentation Set Table P-1 Directory Server Enterprise Edition Documentation Related Reading Default Paths and Command Locations Default PathsRedistributable Files Table P-2Default Paths Table P-3Command Locations Command Locations Table P-3 Command Locations Typographic ConventionsTable P-4Typographic Conventions Table P-5Shell Prompts Shell Prompts in Command ExamplesSymbol Conventions Symbol Conventions Search-termsitedocs.sun.com Documentation, Support, and TrainingThird-Party Web Site References Searching Sun Product Documentation Sun Welcomes Your Comments Before You Migrate Overview of the Migration Process for Directory Server Before You Migrate Outline of Migration Steps Deciding on the New Product Distribution 1Migration Matrix Showing Support for Automated Migration Deciding on Automatic or Manual Migration About the Automatic Migration Tool Automated Migration Using the dsmig Command Prerequisites for Running dsmig Using dsmig to Migrate the Schema Using dsmig to Migrate Configuration Data Using dsmig to Migrate Security Data Chained Suffix Configuration Data Plug-in Configuration Data Configuration Attributes Not Migrated by dsmig Configuration Data For Suffixes With Multiple BackendsReplication Configuration Data Configuration Data for o=netscapeRoot Nsproxiedauthorization NsbindtimeoutNsmaxresponsedelay Nsmaxtestresponsedelay Tasks to be Performed After Automatic Migration Using dsmig to Migrate User Data Sun Confidential Registered Chapter covers the following topics Before You Start a Manual Migration Values of the following attribute types must be migrated Migrating the Schema ManuallyMigrating Configuration Data Manually Migration of Specific Configuration Attributes Global Configuration Attributes NsKeyfile NsCertfile Security Configuration AttributesFeature Configuration Attributes Mapping Tree Configuration Attributes 2Fractional Replication Attribute Name Changes Replication Configuration AttributesDs5ReferralDelayAfterInit NsDS5Flags NsDS5ReplicaBindDN 1Change Log Attribute Name Changes Replication Agreement Configuration Password Policy Configuration Attributes 3Mapping Between 5 and 6.0 Password Policy Attributes UniqueID Generator Configuration Attributes Database Configuration AttributesSnmp Attributes NsActivechainingComponents NsTransmittedControls Chained Suffix Attributes Plug-In Configuration Attributes Nsslapd-pluginarg* nsslapd-pluginenabledNsslapd-pluginarg0 nsslapd-pluginenabled Nsslapd-pluginarg Nsslapd-pluginenabled Pass Through Authentication Plug-In Migrating Security Settings Manually Update the certificate database password$ dsadm set-flags instance-pathcert-pwd-prompt=on Migrating User Data Manually Start the new instance$ dsadm import instance-pathchangelog.ldif cn=changelog Tasks to be Performed After Manual Migration Migrating User Plug-Ins Manually Overview of Migrating Replicated Servers Migrating a Replicated Topology Migration of Referrals Issues Related to Migrating Replicated ServersIssues With the New Password Policy Migration of Replication Agreements Manual Reset of Replication Credentials Problems Related to Tombstone PurgingNew Replication Recommendations Migration Scenarios Migrating a Replicated Topology to an IdenticalMigrating the Consumers Master a Hub a Consumer a Master B Hub B Consumer B 3Migrating the version 5 Consumer Next step involves migrating the version 5 consumer 4Placing the 6.0 Consumer Into the Topology Migrating the Hubs 6Isolating the Hub From the Topology 7Migrating the version 5 Hub Next step involves migrating the version 5 hub 8Placing the 6.0 Hub Into the Topology Migrating the Masters Master a Master B Hub a 10Isolating the Master From the Topology Next step involves migrating the version 5 master Migrating a Replicated Topology to a New Topology 13Existing version 5 Topology Migrating All the Servers 14Existing Topology With Migrated Servers Promoting the Hubs 15Migrated Topology With Promoted Hub Replicas Promoting the Consumers 16New Fully-Meshed All-Master Topology Migrating Over Multiple Data Centers Sun Confidential Registered Removal of the ServerRoot Directory Changes in the Administration Framework Changes in Suffix-Level ACIs Changes to ACIsRemoval of the o=netscapeRoot Suffix Changes in the ACI Scope 1Directory Server 5 and 6 commands Command Line Changes Directory Server 5 and 6 commands 3Version 5 Commands That Have Been Deprecated Deprecated Commands Changes to the Console New Password Policy Password Policy Compatibility New-modeaction takes one of the following values Generates the new equivalent password policy attributesUsing fractional replication Password policy attributes in the database Changes to Plug-Ins New Plug-Ins in Directory ServerFollowing plug-ins have been added in Directory Server Following plug-ins have been deprecated in Directory Server Changes to the Installed Product LayoutPlug-Ins Deprecated in Directory Server Changes to the Plug-In API Online Help Previously Under ServerRoot/manual Binaries Previously Under ServerRoot/bin 5Tools Previously Under ServerRoot/shared/bin Plug-Ins Previously Under ServerRoot/pluginsUtilities Previously Under ServerRoot/shared/bin 4Support for Plug-Ins 6Location of Certificate and Key Files Certificate and Key Files 7Instance-Specific Subdirectories Silent Installation and Uninstallation TemplatesServer Instance Scripts Previously Under Server Instance Subdirectories Migrating Directory Proxy Server Mapping the Global Configuration Mapping the Global Configuration Administration Guide Mapping the Global Security Configuration Access Control on the Proxy Configuration 2Mapping of Security ConfigurationManaging Certificates 3Mapping of Connection Pool Attributes Mapping the Connection Pool Configuration Mapping the Groups Configuration Mapping the Group Object$ dpconf help-properties grep connection-handler Mapping the Network Group Object Mapping Bind Forwarding $ dpconf help-properties grep request-filtering-policy Mapping Operation Forwarding Mapping Subtree Hiding Mapping Search Request Controls$ dpconf help-properties grep resource-limits-policy Mapping Attributes Modifying Search Requests Mapping Compare Request Controls $ dpconf help-properties grep search-data-hiding-rule Mapping Attributes Restricting Search Responses Attributesattribute-name Mapping the Referral Configuration Attributes Mapping the Server Load Configuration Mapping the Properties Configuration Attribute Renaming PropertyForbidden Entry Property $ dpconf help-properties grep ldap-data-source Ldap Server Property Load Balancing Property $ dpconf help-properties grep ldap-data-source-pool Monitoring Backend Servers Log Property Search Size Limit Property 17Version 5 and Version 6 Log Functionality Mapping the Events Configuration Mapping the Actions Configuration Migrating Identity Synchronization for Windows Before You Migrate Identity Synchronization for Windows Migration Overview Preparing for Identity Synchronization for Windows Migration Exporting Version 1.1 Configuration Inserting Clear-Text Passwords Using the export11cnf Utility Following sample exported configuration file Sample Export Configuration File Insert Password Between the Double Quotes in the Above Field TopologyHost PortSSLOption=true SecurePort=3269 112 Field Checking for Undelivered Messages Using the checktopics Utility Rerun checktopics To Clear Messages Migrating Your System Forcing Password Changes on Windows NT 1Migrating a Single-Host Deployment Preparing for Migration JAVAHOME%\\bin\\jar -xf filename Uncompress -c filename tar xf On Solaris, type the following command On Windows, type the following commandTar cf /var/tmp/connector-state.tar persist etc To Uninstall Identity Synchronization for Windows Version Uninstalling Identity Synchronization for Windows Net stop Sun ONE Identity Synchronization for Windows On Windows type the following commands Installing or Upgrading the Dependent ProductsInstalling Identity Synchronization for Windows On Solaris type the following commands Idsync prepds arguments\ On Windows NT only, complete the following steps 124 Manually Uninstalling 1.1 Core and Instances from Solaris What to Do if the 1.1 Uninstallation Fails Usr/ucb/ps -gauxwww grep java To Manually Uninstall Core From a Solaris MachineUse the rm -rf command to remove the following directories ServerRoot/isw-hostname/imquninstall Pkginfo grep -i Identity Synchronization Etc/imq Var/imq Usr/bin/imq Var/sadm/install/productregistry Cn=pswsync,cn=plugins,cn=config Clean up the configuration directory as follows Manually Uninstalling 1.1 Core and Instances from Windows To uninstall Core from a Windows 2000 machine Net stop slapd-myhostname ServerRoot\\\lib\\psw-plugin.so Migrating Identity Synchronization for Windows 133 For example, C\Program Files\Sun\mps\isw-example \\Program Files\\Sun\\mps\\java\\jars\\isw Manually Uninstalling a 1.1 Instance from Windows NT ServerRoot\\\isw-hostname\ Migrating Identity Synchronization for Windows 137 138 For example, C\\Program Files\\Sun\\mps\\isw-example Other Migration Scenarios Sample deployment scenarios include Multi-Master Replication Deployment 2Migrating a Multi-Master Replication Deployment Multi-Host Deployment with Windows NT 2Multi-Host Deployment 3Migrating a Multi-Host Deployment with Windows NT Checking the Logs Change Detector subcomponents Index Instance-path,19 147 Synchronizing, changes with Directory Server XML configuration documents