• These contacts are moved to Webex Teams:

    • Jabber directory contacts whose emails also exist in the cloud Identity Service (the same service that Webex Teams uses).

    • Custom contacts and photos

    • XMPP federated contacts


    If any contacts cannot be moved, the built in tool allows users to export these contacts as a CSV file that they can review. Users must also restart their Webex Teams app for changes to take effect.

  • These user preferences are moved to Webex Teams:

    • Chat notification settings (including mute all), unless otherwise noted in the Jabber version information above

    • Call notification settings (including mute all)

    • Audio device and video device selection (except for VDI)

    • Video preferences for incoming calls (start with video or no video)

Before You Begin

  • The tool supports Jabber users on Webex Messenger, Unified CM IM and Presence, Jabber Team Messaging Mode, and phone-only mode with contacts.

  • Make sure your organization uses the following supported releases of Jabber and Webex Teams:

    Table 1. Supported Versions of Jabber

    Platform

    Versions

    Patch

    What's Migrated

    Jabber for Windows

    12.9(2)

    N/A

    All contacts and settings mentioned in this article are moved over

    12.7.2, 12.8.3, 12.9.1

    No

    Chat notification settings are not moved over to Webex Teams

    12.1, 12.5, 12.6, 12.7, 12.8, 12.9, or 12.9.1

    Yes—Download from here

    All contacts and settings mentioned in this article are moved over

    Jabber for Mac

    12.8.3, 12.9.1, or 12.9.2

    N/A

    All contacts and settings mentioned in this article are moved over

  • Make sure you meet the Webex Teams requirements:

    • Webex Teams: September release or later must be installed; you may need to sign in before the Jabber data can be moved over.

    • We recommend that you download Webex Teams from https://www.webex.com/downloads.html or from the site your administrator directed you to and then install it on the system that you're already using Jabber on.

  • Users must be authenticated through Active Directory for contact access.

  • All directory users must be synchronized to the identity service, otherwise the Webex Teams contact cannot be located.


    Custom contacts are moved as-is from Jabber to Webex Teams.

1

Open the Cisco Unified CM Administration interface.

2

Select User Management > User Settings > UC Service.

3

Choose one:

  • For a new configuration, select Add New, and then choose Jabber Client Configuration (jabber-config.xml) as the UC Service Type.
  • For an existing configuration, choose an existing UC Service that you configured with Jabber Client Configuration (jabber-config.xml) as the UC Service Type.
4

Select Next.

5

Enter a name in the UC Service Information section, refer to the Unified CM Help for more requirements.

6

Enter the parameters in the Jabber Configuration Parameters section.

Jabber to Webex Teams Migration Parameters

Parameter

Value

Description

EnableJabber2TeamsMigration

true

false

Tags users as candidates for moving their data from Jabber to Webex Teams. This process brings over the users' contact (buddy) list and calling preferences to Webex Teams.

true
Moving data from Jabber to Webex Teams is available to the user if they have a matching email address for both applications. The data move starts between 5 minutes–3 hours after a user signs into Jabber or when they manually initiate the move from the help menu.
false (default)
Moving data from Jabber to Webex Teams does not appear for the user.

WebexTeamsDownloadURL

Download URL

Specifies where users can download Webex Teams if they did not download while doing the upgrade. Add a value for this URL, otherwise users are asked to contact an administrator for help.

For example (using the official download page):

<WebexTeamsDownloadURL>https://www.webex.com/downloads.html
</WebexTeamsDownloadURL>
7

Select Save.

What to do next

Users need to restart Jabber to load the patch or MR. Selected users are presented with a screen to ask if they want to move their local data and settings. Users can proceed with the steps or skip it if they're not ready yet.


The screen shows up between 5 minutes–3 hours after a user signs into Jabber or when they manually initiate the move from the help menu.


If that data fails to move because of a network issue, server issue, or other reasons, the data transfer stops but users can retry this step on Webex Teams. If the step doesn't work even after they retry, users are prompted again after 24 hours if Webex Teams remains logged in. Users are also prompted immediately if Webex Teams is relaunched.