4.1 Prerequisites

To fulfill the prerequisites for migrating to Configuration Management:

  1. Make sure that the version of ZENworks you are migrating from is one of the following:

    • ZENworks for Desktops 4.0.1

    • ZENworks Desktop Management 6.5

    • ZENworks 7.x Desktop Management

    IMPORTANT:For your current installation of a traditional ZENworks system, you must have a Novell eDirectory tree with the ZENworks schema installed and have ZENworks eDirectory objects listed in the tree. The ZENworks Migration Utility cannot be used to create new objects or attributes in Configuration Management that do not exist in your traditional version of ZENworks, but you can use the utility to create new folders in Configuration Management.

  2. Install the Configuration Management software to at least one Primary Server with the ZENworks Configuration Management database in order to establish the Management Zone and to provide the target ZENworks database for migrating the eDirectory data.

    For more information, see the ZENworks 10 Configuration Management Installation Guide.

  3. Use ZENworks Control Center to configure the user source for your users so that the eDirectory items that they are associated with allows for a successful migration. For more information on configuring the user source, see User Sources in ZENworks 10 Configuration Management System Administration Reference.

    If you want to continue using eDirectory as the user source in ZENworks Configuration Management, you must update the version of eDirectory to meet the minimum requirements. For more information on the minimum eDirectory requirements in ZENworks Configuration Management, see Authoritative user source in the ZENworks 10 Configuration Management Installation Guide.

    However, a user source is not required if you do not have any user associations with traditional ZENworks objects in eDirectory.

  4. If you are running a version of eDirectory that is 8.7 or lower, or you have upgraded from Starter Pack 1.0, you should make sure that the LDAP attributes listed in Step 4.b are properly mapped because LDAP is used to read existing application attributes during migration.

    Newer versions of eDirectory automatically map spaces and colons to the newer attribute names. If you have multiple versions of an attribute in your version of eDirectory (one using the colon, and another using a space), it is possible that the automatic mapping functionality will provide the Migration Utility with the version that uses only spaces. However, attributes using colons are the preferred versions for migration.

    To configure attribute mapping for migrating applications to Configuration Management:

    1. In ConsoleOne, select your LDAP Group object, then click the Attribute Mapping tab.

    2. Locate the following attributes and map them to the correct name:

      Old Attribute Name

      New Attribute Name







      App:Working Directory


      App:Drive Mappings


      App:Printer Ports






      App:Startup Script


      App:Shutdown Script


    3. Save the changes.

  5. Download and install the ZENworks Migration Utility executable to the Windows device where you will be running the utility. For more information, see Section 3.2, Installing the ZENworks Migration Utility.

  6. Plan your migration.

    You can use the ZENworks Migration Utility as a modeling tool to help in your planning. For more information, see Section 3.4, Planning Your Migration.

  7. Continue with Section 4.2, Starting the ZENworks Migration Utility.