Preparing for Migration

Use the following procedure to prepare for migration to version 6.0.

Preparing to migrate from version 1.1, and 1.1 SP1, to version 6.0

1. Open a terminal window or command prompt.

   • On Solaris type the following command.

     uncompress -c filename | tar xf -

   • On Windows type the following command or use any archive program for Windows, such as WinZip.

     %JAVA_HOME%\\bin\\jar -xf filename
     

   When the binaries are unpacked, the following subdirectories contain the required migration tools:

   • installer/

   • lib/

   • migration/

   Solaris	Windows
   export11cnf.jar	export11cnf.jar
   	forcepwchg.exe
   checktopics.jar	checktopics.jar

2. Export your version 1.1 configuration settings to an XML file.

   From the migration directory, execute export11cnf as described in Using the export11cnf Utility.

   java -jar export11cnf.jar -D “cn=directory manager” -w - \
    -s “dc=example,dc=com” -q - -f export.cfg

3. Add passwords to the exported XML file.

   Enter a password between the double quotes for each cleartextPassword field in the exported configuration file. For more information, see Inserting Clear-Text Passwords.

4. Stop synchronization as described in Starting and Stopping Synchronization in Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.

5. Verify that your system is in a stable state.

   From the migration directory, execute checktopics as described in Using the checktopics Utility. The following example shows the execution of the checktopics command.

   java -jar checktopics.jar -D “cn=directory manager” -w - \
    -s “dc=example,dc=com” -q -Z

6. Stop Identity Synchronization for Windows services (daemons) as described in Starting and Stopping Services in Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.

   ---

   Note –

   Do not stop the Sun ONE Message Queue service.

   ---

7. On Windows NT only, perform the following steps.

   1. Stop the Sun One NT Change Detector Service by typing the following command.

      net stop “Sun One NT ChangeDetector Service”

   2. Save the NT Change Detector Service counters.

      1. Open the Registry Editor by executing regedt32.exe.

      2. Select the HKEY_LOCAL_MACHINE window.

      3. Navigate to the SOFTWARE\\Sun Microsystems\\PSW\\1.1 node.

      4. Save the following registry values.

         • HighestChangeNumber

         • LastProcessedSecLogRecordNumber

         • LastProcessedSecLogTimeStamp

         • QueueSize

8. Save the connector states by backing up the persist and etc directories from the existing 1.1 installation tree.

   • On Solaris, type the following command.

     cd serverRoot/isw-hostname
     tar cf /var/tmp/connector-state.tar persist etc

   • On Windows, type the following command.

     cd serverRoot\isw-hostname
      zip -r C:\\WINNT\Temp\connector-state.zip persist 
      etc%JAVA_HOME%\bin\jar -cfM %TEMP%\connector-state.jar persist etc

     Alternatively, use any archive program for Windows, such as WinZip.

9. Start the Identity Synchronization for Windows services. For more information, see Starting and Stopping Services in Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide.