4Support for Plug-Ins | Sun Microsystems 8190994 manual

Changes to the Installed Product Layout

Plug-Ins Previously Under ServerRoot/plugins

The following tables describes the new location of sample server plug-ins, and header files for plug-in development.

TABLE 5–4Support for Plug-Ins

Directory Server 5.2 Plug-In Directory	Directory Server 6.0 Plug-In Directory	Remarks

ServerRoot/plugins/slapd/slapi/examples	install-path/ds6/examples	Sample plug-ins

ServerRoot/plugins/slapd/slapi/include	install-path/ds6/include	Plug-in header files

SNMP support is no longer handled within Directory Server. SNMP monitoring is now handled by the Java Enterprise System Management Framework (Java ES MF). All plug-ins and binaries related to SNMP have therefore been deprecated within Directory Server.

These plug-ins include the following:

■ServerRoot/plugins/snmp/magt/magt

■ServerRoot/plugins/snmp/mibs/

■ServerRoot/plugins/snmp/sagt/sagt

For information about enabling monitoring Java ES MF monitoring, see “Enabling Java ES MF Monitoring” in Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide.

Utilities Previously Under ServerRoot/shared/bin

The following tables describes the new location of the administrative tools previously under ServerRoot/shared/bin. Note that as a result of the change to the administrative framework, some of these tools have been deprecated.

TABLE 5–5Tools Previously Under ServerRoot/shared/bin

	5.2 File	6.0 File	Purpose

	ServerRoot/shared/bin/admin_ip.pl	Deprecated	Change IP address

	ServerRoot/shared/bin/entrycmp	install-path/ds6/bin/entrycmp	Compare entries for replication

	ServerRoot/shared/bin/fildif	install-path/ds6/bin/fildif	Dump filtered LDIF

	ServerRoot/shared/bin/insync	install-path/ds6/bin/insync	Check replication
			synchronization

80	Sun Java System Directory Server Enterprise Edition 6.0 Migration Guide • March 2007
	Sun Confidential: Registered

Image 80

Sun Microsystems 8190994 Plug-Ins Previously Under ServerRoot/plugins, Utilities Previously Under ServerRoot/shared/bin

Contents

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