21.2 Migration Procedure

DSfW migration follows the Transfer ID migration process. For more information about Transfer ID, see Section IV, Transfer ID Migration.

IMPORTANT:Ensure that you do not patch or register the migration server for updating before installing the OES Pre-migration Server pattern and the DSfW pattern.

Follow the instructions given below to perform the migration:

  1. Install and configure eDirectory with pre-migration pattern on the target server.

    NOTE:You must ensure that the target server is installed only with eDirectory and the OES pre-migration pattern. OES pre-migration and eDirectory pattern must be installed using Software Management tool provided by the YaST utility.

    If services such as iPrint, NSS, and SMS are configured on the DSfW server that is migrated, then configuration data related to these services will also be migrated as part of the DSfW migration process. However, migration of service specific data needs to be migrated as per the migration procedure for a particular service. For information on migrating iPrint, see Section 24.0, Migrating iPrint to OES 2023. For information on migrating NSS, see Section 16.0, Migrating File Systems to OES 2023.

  2. If the source server has proxy user configured for services such as LUM, see Section 28.0, Migrating Proxy users to OES 2023.

  3. Install the DSfW pattern on top of the preexisting patterns on the target server but do not configure it.

  4. Reboot the target server.

  5. Ensure that you have copied the SSH keys to avoid multiple password prompts:

    1. Enable SSH on the source server and the target server.

    2. Enter the # ssh-keygen -t rsa command on the target server.

    3. When you are prompted to enter the file in which to save the key, press Enter.

      The ssh keys are stored in the default location (/root/.ssh/id_rsa).

    4. When you are prompted to enter the passphrase, leave it empty for no passphrase, then press Enter.

    5. Copy the key value (the output of the # ssh-keygen -t rsa command) to the source server using the following command:

      ssh-copy-id -i /root/.ssh/id_rsa.pub root@source-ip-address 

      Where -i /root/.ssh/id_rsa.pub is the output of # ssh-keygen -t rsa command.

      Replace <source-ip-address> with the IP address or the hostname of the source server.

  6. Run the DSfW migration script on the target server. The purpose of this script is to migrate the DSfW-specific data to the target server.

    ./opt/novell/xad/sbin/migrate_dsfw.pl --source=source-ip --all

    The migration script invokes the miggui tool.

    The Transfer ID operation migrates eDirectory, LUM, and other associated services of the source server. For more information, see Select the Source and Target Server and the Migration Type.

  7. Reboot the target server.

  8. After you reboot the server, you are prompted to configure additional features like WINS and Sites. This can be done using the DSfW Feature Configuration Wizard.

    IMPORTANT:You are prompted to configure these features only once. If you fail to configure these features during the first instance, you will not be able to configure these features later.

    Enter the authentication details in the login dialog box, depending on the scenario in which you are provisioning, then click OK.

    Provisioning Scenario

    Authentication Details Required

    Non-name-mapped, forest root domain

    The current domain credentials.

    Name-mapped, forest root domain

    The current domain credentials and the tree admin credentials.

    Non-name-mapped child

    The current domain credentials, the parent domain credentials, and the tree/container admin credentials.

    Name-mapped child

    The current domain credentials, the parent domain credentials, and the tree/container admin credentials.

    Additional Domain Controller

    The current domain credentials and the tree admin credentials.

    IMPORTANT:If you are installing a first-level child domain in a non-name-mapped scenario, the tree admin and the parent domain credentials are the same.

  9. Select the feature that you want to configure, then click Next.

  10. On the task list page, click Run to manually execute a task or click Run All to execute all the tasks sequentially without any manual intervention.

  11. After you complete executing the DSfW Feature Configuration Wizard, you must verify if all the daemons are up and running by executing the following command:

    xadcntrl status

  12. Run the following command to verify if the schema has been extended, rights on the domain controller objects have been added, and the unique domain id on the domain root has been added.

    /opt/novell/xad/sbin/domaincntrl --preps