Migrate MiCollab with MiCollab Client IDS to MiCollab IDS

Migration of MiCollab Client IDS to MiCollab IDS must be performed manually. You must copy the IDS settings from MiCollab Client into the corresponding fields in the MiCollab IDS Connection page and IDS Attributes Mappings page.

  1. Review the General Guidelines and Limitations.

  2. Under Applications, click MiCollab Client Service.

  3. Under Configuration, click Configure MiCollab Client Service.

  4. Click the Synchronization tab.

  5. Click Active Directory/LDAP Synchronizer and then click the LDAP link.

  6. Click Connection Settings to display the AD/LDAP Connection Settings. Use this table to match the MiCollab Client AD/LDAP settings with the corresponding MiCollab IDS Connection page settings.

    MiCollab Client AD/LDAP Connection Settings MiCollab IDS Connection Parameters
    Description Primary Directory Server
    Domain name Domain
    Show LDAP Path Assistant
    LDAP path
    Server supports paging results
    Do not import disabled accounts from AD
    Search contents Search scope
    User Query
    Username Distinguished name
    Password Password
    Default feature profile
    Timestamp
    Timestamp attribute
    Timestamp syntax
  7. Click Field Mappings to display the AD/LDAP field attributes. The following table maps the default MiCollab Client IDS field attributes to the MiCollab IDS field attributes..

    MiCollab Client Attribute Directory Server Default Attribute MiCollab Attribute
    COMMON ATTRIBUTES
    Direct Inward Dial Number
    Directory key objectGUID User ID
    Login ID samAccountName Login
    distinguishedName distinguishedName Distinguished Name
    mail mail Email
    First name givenName First Name
    Last name sn Last Name
    Desk phone extension ipPhone (See Note 1 below) Home Element
    MiCollab ONLY
    department Department
    telephoneNumber Directory Number
    mobile Mobile Phone Directory Number
    objectClass Object Class
    otherTelephone Secondary Phone Directory Number
    preferredLanguage Language
    physicalDeliveryOfficeName Location
    employeeType Role
    MiCollab Client ONLY
    Middle name initials
    Soft phone extension otherIpTelephone
    PBX Node facsimileTelephoneNumber
    Company name company
    Address streetAddress
    City l
    State/Province st
    ZIP/Postal code postal code
    Display picture jpegPhoto
    Note: If you are migrating from MiCollab Client , you must either clear ipPhone attribute from the directory server or enter a different attribute.
  8. Synchronize the MiCollab Client database with the directory server database.

  9. Disable IDS (LDAP Integration) for the MiCollab Client application:

    • Click MiCollab Client Service in the MiCollab server manager.

    • Click Configure MiCollab Client Service.

    • Click the Synchronization tab.

    • Click None and click Apply.

  10. Run the MiCollab Client Integration Wizard.

    • In the MiCollab server manager, under Configuration click MiCollab Client Configuration Wizard.

    • Follow the screen prompts provided in the wizard screens.

  11. On MiCollab in the Network Element tab of the Users and Services application, disable Single Point Provisioning.

  12. Create a MiCollab synchronization account on the directory service domain. The account must have read access.

  13. If Active Directory Authentication is required, ensure that a valid Certificate Authority (CA) has been configured for Active Directory. If LDAP Authentication is not required, you assign users new passwords on MiCollab using roles and associated user templates.

  14. On the directory server, ensure that the user data fields contain entries for the following attributes: samAccountName, givenName, sn, and distinguishedName. Otherwise, failed update errors are generated on MiCollab during the synchronization. If an employeeType field is not specified the entry is sent to the detained queue.

  15. In the MiCollab Users and Services application, create user templates for the various roles in the enterprise. In the templates, assign the phone and application services that you want to apply to the user data that is obtained from the directory server. In the templates, also set a password policy for the user data. You have the option of creating these templates from the UCC default templates.

  16. In the MiCollab Users and Services application, create roles that correspond to the employeeType attribute entries on the directory service. You can create these roles from the UCC default roles. Note that when users are obtained from the directory server, if a user entry has a blank employeeType field, the update is sent to the detained user updates queue.

  17. Create a connection to the directory server:

  18. Configure Active Directory Authentication if required.

    • Check the Enable authentication box below the desired domain. You can only enable authentication on a single domain. So, if you want to select a different domain, you must first disable the currently selected domain.

      Note: You can connect the LDAP Authentication to a Global Catalogue on the domain controller. If multiple connections are used, and if those connections point to domains which are under the same forest, you can configure one connection to use the global catalogue. With global catalogue enabled, all users from all connections under the same forest should be able to authenticate. Note that using global catalogue limits the fields that can be used for synchronization.

    • Secure authentication requests are required as part of the IDS connection.

    • Click Save.

  19. Configure the IDS Attribute Mappings. Transfer any custom Directory Server Attributes that you recorded in the second table into the MiCollab IDS Attributes Mapping page.

    Note: If you are migrating from MiCollab Client , you must either clear ipPhone attribute from the directory server or enter a different attribute.
  20. By default, user service data and Active Directory authentication is synchronized for all users. Specify any user records that you do not want to receive changes from the directory service. To prevent a user record from receiving updates from the directory server:

    • Under Applications, click User and Services.

    • Locate the user using the Search function.

    • On the User tab in the Personal Information section, clear the IDS Manageable box.

    • Click Save.

  21. Schedule synchronizations with the directory server database to occur on a regular basis during off-business hours (for example: daily at 12:00 am). These re-occurring synchronizations keep the MiCollab database up to date with database changes that are entered on the directory server.

    • Under Configuration, click Integrated Directory Service.

    • Click Edit next to the directory service connection. The Manage IDS connections page opens.

    • Ensure the Re-initialize on next cycle box is clear.

    • In the Schedule field, set the schedule using the drop-down menus.

    • Click Save.

  22. Perform a full synchronization from MiCollab with the directory server database. The user entries are not distributed to the MiVoice Business because SPP is disabled.

  23. Resolve any detained IDS updates on MiCollab .

  24. After the full synchronization is complete and you have resolved the detained updates, both the MiCollab and MiVoice Business databases match the directory server database.