.. _provision_the_jabber_device_service:

Provision the Jabber or Dual Mode Device Service
------------------------------------------------

.. _18.1-Patch-Bundle-3|EKB-261:
.. _19.3.4|EKB-6094:


Procedure
.........

1. Choose **Subscriber Management > Quick Add Subscriber**. From the **Username**
   drop-down, select a user.
#. Select the **Jabber/Dual-Mode Device** check box. The **Jabber and Dual-Mode Devices**
   field appears.
#. Click + next to **Jabber and Dual-Mode Devices** to expose the **Jabber/Dual Mode
   Agent** drop-down and **Device Name** field.
#. Choose a device type from the **Jabber/Dual Mode Agent** drop-down. The **Device Name**
   field is automatically generated as follows:

   a. If no device name exists in the format *<device type prefix><username>*,
      then in this format:

      *<device type prefix><username>*
   
   b. If device name exists in the format *<device type prefix><username>* or *<device type prefix><username><number>*,
      then in the format:

      *<device type prefix><username><random number>*

      where *<random number>* is generated and unique.
   
   * <device type prefix> - always three characters, either BOT, CSF, TAB, TCT,
     CIM, or CTI.
   * <username> - 8 characters maximum. If a username contains '_' and '.' characters,
     these characters are removed from the automatically generated username.
     Automatically generated usernames can be edited if required.
   * <random number> - dependent on length of username, to make up a total of 11
     characters along with the username.
   
   See examples in table below. 

   Example Device Type and Device Name Combinations

   +------------------------------------------+----------------------------------------+
   | For this type of device                  | Device Name (automatically generated)  |
   |                                          |                                        |
   |                                          | Format (regex): "[a-zA-Z0-9]{1,15}"    |
   +==========================================+========================================+
   | Android                                  | For example: BOTJOHND003938            |
   | (Cisco Dual Mode for Android)            |                                        |
   +------------------------------------------+----------------------------------------+
   | CSF                                      | For example: CSFROBWOR77891            |
   | (Cisco Unified Client Services Framework)|                                        |
   +------------------------------------------+----------------------------------------+
   | iPad                                     | For example: TABRQUENT18947            |
   | (Cisco Jabber for Tablet)                |                                        |
   +------------------------------------------+----------------------------------------+
   | iPhone                                   | For example: TCTPDEVILLI156            |
   | (Cisco Dual Mode for iPhone)             |                                        |              
   +------------------------------------------+----------------------------------------+
   | Carrier Integrated Mobile                | For example: CIMJOHNSMI                |
   +------------------------------------------+----------------------------------------+
   | CTI Remote Device                        | For example: CTIJOHNSMI                |
   +------------------------------------------+----------------------------------------+

   For the following Agents, also select the **Mobile Identity** check box to
   enable Mobile Identity if required:

   * Android
   * iPhone
   * Carrier Integrated Mobile
   
#. Click **Save**.
#. Choose **Subscriber Management > Quick Add Subscriber**. From the **Username** list,
   choose the same user.
#. Choose the **Existing Services** tab.
#. Make sure that the **Phones** field displays the Jabber device.

For each device type, a Configuration Template that is associated with the Subscriber's
Quick Add Group is used to provision the device. For defaults, see: :ref:`quick_add_subscriber_group_default_model`.

.. note::

   If a CSF Jabber device type is selected, all lines are associated to the
   CSF Jabber device by default.