Cisco Jabber for Android Release 8.6.x Administration Guide
Administration

Administration

Set up Cisco Jabber

Perform this series of procedures to set up all your Cisco Jabber features on your Unified CM, and then provide users with instructions for setting up Cisco Jabber on their devices.

Perform the following procedures in order

  1. Add a test device with basic telephony features. See Add user device.
  2. Set up any additional features on your test device. These features are optional. See Feature setup.
  3. After you verify that all features work on your test device, set up individual users and devices in bulk. See Bulk configuration.
  4. Provide users with instructions for setting up their Cisco Jabber clients. See User instructions.

Add user device

Before You Begin
  • Set up and test voicemail for the extension you will assign to this device, following standard procedures for any device. Make sure you set up the voicemail number as a regular phone number so users can call in to the voicemail system using an Enterprise VoIP or mobile call.
  • Verify that the Device Pool that you will assign to the Cisco Jabber device is associated with a region that includes support for the G.711 codec.
  • Determine whether you want to enable or disable usage and error tracking for each user. For information, see Usage and error tracking.
Procedure
    Step 1   Sign in to Cisco Unified Communications Manager Administration.
    Step 2   Add a new phone device with Cisco Dual Mode for Android as the Phone Type.
    Step 3   Enter settings for Device-Specific Information.

    Restrictions and requirements that are not specific to Cisco Jabber may apply to these values. If you require additional information about any option on the device configuration page, see the online help in Cisco Unified Communications Manager.

    1. Enter the Device Name The Device Name:
      • Must start with BOT
      • Must be uppercase
      • Can contain up to 15 characters
      • Can include only the following characters: A to Z, 0 to 9, dash (-), or underscore (_)
      We recommend that the device name include the username of the user so it is easily remembered.

      Example:For example the device name of user jsmith would be BOTJSMITH.
    2. Choose Standard Dual Mode for Android for the Phone Button Template.
    3. Configure the following settings to prevent confusion for the person the user calls.
      • Media Resource Group List
      • User Hold MOH Audio Source
      • Network Hold MOH Audio Source

      These settings are not specific to this device. For information, see the Cisco Unified Communications Manager documentation.

    4. Choose desk phone as the Primary Phone if the user has a desk phone.
    Step 4   Enter settings for Protocol Specific Information.
    1. In the Device Security Profile drop-down list, select Cisco Dual Mode for Android - Standard SIP Non-Secure Profile.
    2. In the SIP Profile drop-down list, select the appropriate SIP profile. See Create dedicated SIP profile.
    Values that are not described in this document are not specific to Cisco Jabber but may need to be entered for the device to work properly.
    Step 5   Enter settings for the Product Specific Configuration Layout section.
    1. Select the appropriate level of usage tracking in the Cisco Usage and Error Tracking drop-down list. See Usage and error tracking.
    2. In the Application Dial Rules URL field:
      • For Cisco Unified Communications Manager Release 8.6 and later, leave this field blank.
      • If you are using Cisco Unified Communications Manager Release 8.5 or earlier and you want Cisco Jabber devices to apply Application Dial Rules, you must specify the path to these dial rules files, including the filenames. Use the following format: tftp://ip address of TFTP server/pathname to the XML file/XML filename
    3. If your directory server requires authentication, enter LDAP username and password; otherwise leave these fields blank.

      These credentials can be for a single read-only account for all users. These credentials are sent to the client in clear text in the TFTP file. Therefore, we strongly recommend that LDAP directory administrators generate a directory query account that has no other rights. Create this account with a value that is low enough to ensure that its credentials are semi-public (available to anyone on the local network).

    4. Enter any designated emergency numbers in the Emergency Numbers field.

      You can enter a comma-separated list of additional emergency numbers that will always be dialed direct for this user. These numbers must contain only numerical digits. No spaces, dashes, or other characters are permitted.

      Emergency numbers as defined on the device are always dialed direct using the mobile network (never dialed using Enterprise VoIP) to allow the location of the caller to be sent automatically to emergency services personnel where this service is available. Direct-dial numbers can be useful for users who frequently travel to countries other than the country of their mobile network provider, if the emergency number differs depending on the users' location, or if your company has a dedicated security number.

    5. Enter your domain in the Domain Name field if the Cisco Unified Communications Manager setting in System > Server is a hostname that does not include the domain name.

      Example:cisco.com
    6. Enter a list of up to three SSIDs separated by forward slashes (/) in the Preset Wi-Fi Networks field.

      Cisco Jabber attempts to connect to Cisco Unified Communications Manager only after the mobile device is connected to an SSID that you list here, or one that the user selects in the client. Cisco Jabber must be able to reach Cisco Unified Communications Manager when it is connected to these SSIDs. Typically, these are your corporate Wi-Fi SSIDs. SSIDs can be up to 32 characters long and are case-sensitive.

    Step 6   Select Save.
    Step 7   Select Apply Config.
    Step 8   Select [Line n] - Add a new DN.
    Step 9   Enter the Directory Number of this device.

    This can be a new DN; a desk phone with the same DN is not required.

    Step 10   If this device is a standalone device (not sharing a DN with a desk phone), configure these settings to forward calls when Cisco Jabber is not running and connected to the network, so callers do not receive an error message:
    1. Forward Unregistered Internal
    2. Forward Unregistered External

    For more information about these settings, see the online help in Cisco Unified Communications Manager for the Forward All and other settings.

    Step 11   Set the No Answer Ring Duration to 24 seconds to allow time for Cisco Jabber to ring before calls go to voicemail.

    See general restrictions in the online help in Cisco Unified Communications Manager.

    Step 12   Select Save.
    Step 13   Navigate to the End User page for the user.
    Step 14   Associate the Cisco Dual Mode for Android device that you just created for this user.

    The device should now appear in the Controlled Devices box in either the Device Information or Device Associations section (depending on your release of Unified CM).

    Step 15   If this user has a desk phone, select the desk phone as the Primary User Device.
    Step 16   If the device is a standalone device that runs without an associated desk phone, you may need to enter other information that is standard for all devices in your system.

    What to Do Next

    Verify that your configuration works:

    • Make sure the mobile device is connected to the corporate network. Verify that you can access a web page on your corporate intranet using the browser on your device.
    • Launch Cisco Jabber and complete the setup wizard. Enter the IP address of your TFTP server (generally the IP address of your Cisco Unified Communications Manager server) and the Device Name (BOTXXXX) of the device you just added.
    • Wait for a notice that the device is registered. The Cisco Jabber icon in the status bar turns black when the device is connected to Cisco Unified Communications Manager.
    • Test basic telephony features in Cisco Jabber, such as the ability to make, hold, and transfer calls.

    Changes to user device

    If you change settings on the Cisco Unified CM Administration pages (for example, LDAP, call control, dial plan), Cisco Jabber reregisters after you click Save and then click Apply Config. The application reregisters again 30 seconds later. If the user is on a call when the application reregisters, the call drops and the application restarts automatically.

    If the device is out of coverage at the time you apply the changes, it is updated when it reregisters to Cisco Unified Communications Manager.

    If you delete the device from Cisco Unified Communications Manager, Cisco Jabber drops any active calls and after several reregister attempts the user receives an error message that it cannot connect. Client information is not erased from the device. To remove all client information (for example, if the employee leaves the company), use the appropriate device management solution, such as Active Sync.

    To delete a device, see the “Deleting a Phone” topic in the Cisco Unified Communications Manager Administration Guide for your release at

    http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.

    Bulk configuration

    Use the information in this document to set up individual users and devices as the basis for completing a Bulk Administration template to set up users and devices.

    When you are ready for bulk processes, follow the instructions in the Bulk Administration Guide for your release of Unified CM, available from http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.


    Note


    The settings in the Product Specific Configuration Layout section of the device configuration page are not handled as individual columns in the exported spreadsheet. Instead, all of those settings, and the information they contain, appear as XML code in a single cell for each device. If you edit user-specific information in this cell, do so cautiously.


    User instructions

    After you finish setting up devices in Cisco Unified Communications Manager, give your users the following information:
    • Instructions for connecting the mobile device to the corporate Wi-Fi. This process is independent of Cisco Jabber.
    • User documentation with instructions for setting up Cisco Jabber, available from http://www.cisco.com/en/US/partner/products/ps11678/products_user_guide_list.html.

      Note


      Users must perform the initial setup of Cisco Jabber for Android within the corporate network.


    • Direction to download and install Cisco Jabber from the Android Market.
    • The device name of their Cisco Dual Mode for Android device, for example BOTJSMITH.
    • The IP address of the TFTP server.
    • The email address to which users should send problem reports (troubleshooting logs).
    • (If applicable) Credentials required to access the corporate directory. The username should be in the format userid@company.com or the full DN format, cn=userid,ou=organization,dc=company,dc=com.
    • (If applicable) Information required to access the corporate network remotely, using the secure connect feature. This information includes information such as the gateway address, group names, user ID, and if applicable, user password.