- Cisco Jabber Overview
- Configuration and Installation Workflows
- Configure Directory Integration
- Set Up Certificate Validation
- Configure Service Discovery
- Configure a Service Profile
- Configure IM and Presence Service
- Configure Voice and Video Communication
- Configure Voicemail
- Configure Conferencing
- Configure the Clients
- Integrate with Directory Sources
- Install the Clients
- Remote Access
- Cisco Jabber Features and Options
- Cisco Jabber Reference Information
- Install Cisco Jabber for Windows
Install the Clients
Install Cisco Jabber for Windows
Cisco Jabber for Windows provides an MSI installation package that you can use in the following ways:
Use the Command Line—You can specify arguments in a command line window to set installation properties.
Choose this option if you plan to install multiple instances.
Run the MSI Manually—Run the MSI manually on the file system of the client workstation and then specify connection properties when you start the client.
Choose this option if you plan to install a single instance for testing or evaluation purposes.
Create a Custom Installer—Open the default installation package, specify the required installation properties, and then save a custom installation package.
Choose this option if you plan to distribute an installation package with the same installation properties.
Deploy with Group Policy—Install the client on multiple computers in the same domain.
You must be logged in with local administrative rights.
Use the Command Line
Specify installation arguments in a command line window.
Example Installation Commands
Review examples of commands to install Cisco Jabber for Windows.
Cisco Unified Communications Manager, Release 9.x
msiexec.exe /i CiscoJabberSetup.msi /quiet CLEAR=1
- CLEAR=1 — Deletes any existing bootstrap file.
- /quiet — Specifies a silent installation.
Cisco Unified Communications Manager, Release 8.x in Default Mode
msiexec.exe /i CiscoJabberSetup.msi /quiet CLEAR=1 AUTHENTICATOR=CUP CUP_ADDRESS=1.2.3.4
- CLEAR=1 — Deletes any existing bootstrap file.
- AUTHENTICATOR=CUP — Sets Cisco Unified Presence as the authenticator.
- CUP_ADDRESS=1.2.3.4 — Sets 1.2.3.4 as the IP address of the presence server.
- /quiet — Specifies a silent installation.
Cisco Unified Communications Manager, Release 8.x in Phone Mode
If you are integrating with UDS when you are installing in phone mode, you must first define the <PresenceDomain>Domain address of your Presence server</PresenceDomain> parameter.
msiexec.exe /i CiscoJabberSetup.msi /quiet CLEAR=1 PRODUCT_MODE=Phone_Mode AUTHENTICATOR=CUCM TFTP=1.2.3.4 CTI=5.6.7.8
- CLEAR=1 — Deletes any existing bootstrap file.
- PRODUCT_MODE=Phone_Mode — Sets the client to phone mode.
- AUTHENTICATOR=CUCM — Sets Cisco Unified Communications Manager as the authenticator.
- TFTP=1.2.3.4 — Sets 1.2.3.4 as the IP address of the TFTP server that hosts the client configuration.
- CTI=5.6.7.8 — Sets 5.6.7.8 as the IP address of the CTI server.
- /quiet — Specifies a silent installation.
Cisco WebEx Messenger Service
msiexec.exe /i CiscoJabberSetup.msi /quiet CLEAR=1 AUTHENTICATOR=WEBEX
- CLEAR=1 — Deletes any existing bootstrap file.
- AUTHENTICATOR=WEBEX — Sets the Cisco WebEx Messenger service as the authenticator.
- /quiet — Specifies a silent installation.
Cisco WebEx Messenger Service with SSO
msiexec.exe /i CiscoJabberSetup.msi /quiet CLEAR=1 AUTHENTICATOR=WEBEX SSO_ORG_DOMAIN=example.com
- CLEAR=1 — Deletes any existing bootstrap file.
- AUTHENTICATOR=WEBEX — Sets the Cisco WebEx Messenger service as the authenticator.
- SSO_ORG_DOMAIN=example.com — Sets example.com as the single sign-on (SSO) domain.
- /quiet — Specifies a silent installation.
Command Line Arguments
Review the command line arguments you can specify when you install Cisco Jabber for Windows.
- Override Argument
- Mode Type Argument
- Authentication Arguments
- Common Installation Arguments
- SSO Arguments
Override Argument
The following table describes the parameter you must specify to override any existing bootstrap files from previous installations:
Argument |
Value |
Description |
---|---|---|
CLEAR |
1 |
Specifies if the client overrides any existing bootstrap file from previous installations. The client saves the arguments and values you set during installation to a bootstrap file. The client then loads settings from the bootstrap file at startup. |
msiexec.exe /i CiscoJabberSetup.msi CLEAR=1
Mode Type Argument
Argument | Value | Description |
---|---|---|
PRODUCT_MODE |
Phone_Mode |
|
When to Set the Product Mode
Cisco Unified Communications Manager, Release 9.x and Later — You should not set PRODUCT_MODE during installation. The client gets the authenticator from the service profile. After the user signs in, the client requires a restart to enter phone mode.
Cisco Unified Communications Manager, Release 8.x — You can specify phone mode during installation if you set Cisco Unified Communications Manager as the authenticator. The client reads the bootstrap file on the initial launch and determines it should start in phone mode. The client then gets Cisco Unified Communications Manager as the authenticator from the bootstrap file or manual settings. After the user signs in, the client does not require a restart.
Change Product Modes
To change the product mode, you must change the authenticator for the client. The client can then determine the product mode from the authenticator.
![]() Note | In all deployments, the user can manually set the authenticator in the Advanced settings window. In this case, you must instruct the user to change the authenticator in the Advanced settings window to change the product mode. You cannot override the manual settings, even if you uninstall and then reinstall the client. |
Change Product Modes with Cisco Unified Communications Manager Version 9.x and Later
To change product modes with Cisco Unified Communications Manager version 9.x and later, you change the authenticator in the service profile.
After the user restarts the client, the product mode change is complete.
Change Product Modes with Cisco Unified Communications Manager Version 8.x
To change product modes with Cisco Unified Communications Manager version 8.x, you must reinstall Cisco Jabber for Windows to change the authenticator.
- Change Default Mode > Phone Mode
-
Set the following arguments, at a minimum: - Change Phone Mode > Default Mode
-
Set the following arguments, at a minimum:
Authentication Arguments
TFTP Server Address
To minimize effort, you should host your client configuration files on the Cisco Unified Communications Manager TFTP service. You then have only one TFTP server address for all configuration files and can specify that address as required.
You can, however, host your client configuration on a different TFTP server to the one that contains the device configuration. In this case, you have two different TFTP server addresses, one address for the TFTP server that hosts device configuration and another address for the TFTP server that hosts client configuration files.
Default Deployments
This section describes how you should handle two different TFTP server addresses in deployments that have a presence server.
-
Retrieves the address of the Cisco Unified Communications Manager TFTP service from the bootstrap file.
-
Gets device configuration from the Cisco Unified Communications Manager TFTP service.
-
Connects to the presence server.
-
Retrieves the address of the TFTP service that hosts the client configuration from the presence server.
-
Gets client configuration from the TFTP server.
Phone Mode Deployments
This section describes how you should handle two different TFTP server addresses in phone mode deployments.
-
During installation, specify the address of the TFTP server that hosts the client configuration with the TFTP argument.
-
Specify the address of the TFTP server that hosts the device configuration in your client configuration file with the following parameter: TftpServer1.
-
Host the client configuration file on the TFTP server.
-
Retrieves the address of the TFTP server from the bootstrap file.
-
Gets client configuration from the TFTP server.
-
Retrieves the address of the Cisco Unified Communications Manager TFTP service from the client configuration.
-
Gets device configuration from the Cisco Unified Communications Manager TFTP service.
Common Installation Arguments
The following table describes command line arguments that are common to all deployments:
Argument | Value | Description | ||
---|---|---|---|---|
LANGUAGE |
Defines the Locale ID (LCID), in decimal, of the language that Cisco Jabber for Windows uses. The value must be an LCID in decimal that corresponds to a supported language. This argument is optional. If you do not specify a value, Cisco Jabber for Windows uses the system locale language as the default. See the Supported Languages topic for a full list of the languages you can specify. |
|||
FORGOT_PASSWORD_URL |
Specifies the URL where users can reset lost or forgotten passwords. This argument is optional but recommended.
|
|||
TFTP_FILE_NAME |
Specifies the unique name of a group configuration file. You can specify either an unqualified or fully qualified filename as the value. The filename you specify as the value for this argument takes priority over any other configuration file on your TFTP server. You can specify group configuration files in the Cisco Support Field on the CSF device configuration on Cisco Unified Communications Manager. |
|||
LOGIN_RESOURCE |
Controls user sign in to multiple client instances.
|
|||
LOG_DIRECTORY |
Absolute path on the local filesystem |
Defines the directory where the client writes log files. Use quotation marks to escape space characters in the path, as in the following example: "C:\my_directory\Log Directory" The path you specify must not contain Windows invalid characters. The default value is %USER_PROFILE%\AppData\Local\Cisco\Unified Communications\Jabber\CSF\Logs |
||
CLICK2X |
DISABLE |
Disables click-to-x functionality with Cisco Jabber.
|
||
Telemetry_Enabled |
true false |
Specifies whether analytics data is gathered. The default value is true. To improve your experience and product performance, Cisco Jabber may collect and send non-personally identifiable usage and performance data to Cisco. The aggregated data is used by Cisco to understand trends in how Jabber clients are being used and how they are performing. Full details on what analytics data Cisco Jabber does and does not collect can be found in the Cisco Jabber Supplement to Cisco’s On-Line Privacy Policy at http://www.cisco.com/web/siteassets/legal/privacy_02Jun10.html. |
SSO Arguments
This section describes the command line arguments you can use to deploy Cisco Jabber for Windows with single sign on (SSO) capabilities.
Cloud-Based SSO Arguments
Run the MSI Manually
You can run the installation program manually to install a single instance of the client and specify connection settings in the Advanced settings window.
Step 1 | Launch CiscoJabberSetup.msi. The installation program opens a window to guide you through the installation process. |
Step 2 | Follow the steps to complete the installation process. |
Step 3 | Start Cisco Jabber for Windows. |
Step 4 | Select Manual setup and sign in. The Advanced settings window opens. |
Step 5 | Specify values for the connection settings properties. |
Step 6 | Select Save. |
Create a Custom Installer
You can transform the default installation package to create a custom installer.
![]() Note | You use Microsoft Orca to create custom installers. Microsoft Orca is available as part of the Microsoft Windows SDK for Windows 7 and .NET Framework 4. Download and install Microsoft Windows SDK for Windows 7 and .NET Framework 4 from the Microsoft website. |
Get the Default Transform File
You must have the default transform file to modify the installation package with Microsoft Orca.
Create Custom Transform Files
To create a custom installer, you use a transform file. Transform files contain installation properties that you apply to the installer.
The default transform file lets you specify values for properties when you transform the installer. You should use the default transform file if you are creating one custom installer.
You can optionally create custom transform files. You specify values for properties in a custom transform file and then apply it to the installer.
Create custom transform files if you require more than one custom installer with different property values. For example, create one transform file that sets the default language to French and another transform file that sets the default language to Spanish. You can then apply each transform file to the installation package separately. The result is that you create two installers, one for each language.
The transform file you created is saved as file_name.mst. You can apply this transform file to modify the properties of CiscoJabberSetup.msi.
Transform the Installer
Apply a transform file to customize the installer.
![]() Note | Applying transform files will alter the digital signature of CiscoJabberSetup.msi. Attempts to modify or rename CiscoJabberSetup.msi will remove the signature entirely. |
Step 1 | Start Microsoft Orca. |
Step 2 | Open
CiscoJabberSetup.msi in
Microsoft Orca.
The installation package opens in Microsoft Orca. The list of tables for the installer opens in the Tables pane. |
Step 3 | Remove all
language codes except for 1033 (English).
You must remove all language codes from the custom installer except for 1033 (English). Microsoft Orca does not retain any language files in custom installers except for the default, which is 1033. If you do not remove all language codes from the custom installer, you cannot run the installer on any operating system where the language is other than English. English is set as the language for your custom installer. |
Step 4 | Apply a transform file. |
Step 5 | Select
Property from the list of tables in the
Tables pane.
The list of properties for CiscoJabberSetup.msi opens in the right panel of the application window. |
Step 6 | Specify values for the properties you require. |
Step 7 | Drop any properties that you do not require. It is essential to drop any properties that are not being set, otherwise the properties being set will not take effect. Drop each property that is not needed one at a time. |
Step 8 | Enable your custom installer to save embedded streams. |
Step 9 | Save your custom installer. |
Installer Properties
These properties correspond to the installation arguments and have the same values.
Deploy with Group Policy
Install Cisco Jabber for Windows with Group Policy using the Microsoft Group Policy Management Console (GPMC) on Microsoft Windows Server.
![]() Note | To install Cisco Jabber for Windows with Group Policy, all computers or users to which you plan to deploy Cisco Jabber for Windows must be in the same domain. |
Set a Language Code
Altering the installation language is not necessary in Group Policy deployment scenarios where the exact MSI file provided by Cisco will be used. The installation language will be determined from the Windows User Locale (Format) in these situations. You must use this procedure and set the Language field to 1033 only if the MSI is to be modified by Orca in any way.
Step 1 | Start Microsoft Orca. Microsoft Orca is available as part of the Microsoft Windows SDK for Windows 7 and ,NET Framework 4 that you can download from the Microsoft website. |
Step 2 | Open CiscoJabberSetup.msi. |
Step 3 | Select . |
Step 4 | Locate the Languages field. |
Step 5 | Set the Languages field to 1033. |
Step 6 | Select OK. |
Step 7 | Enable your custom installer to save embedded streams. |
Step 8 | Save your custom installer. |
Deploy the Client with Group Policy
Complete the steps in this task to deploy Cisco Jabber for Windows with Group Policy.
Step 1 | Copy the installation package to a software distribution point for deployment. All computers or users to which you plan to deploy Cisco Jabber for Windows must be able to access the installation package on the distribution point. |
Step 2 | Select and then enter the following command:GPMC.msc The Group Policy Management console opens. |
Step 3 | Create a new group policy object. |
Step 4 | Set the scope of your deployment. |
Step 5 | Specify the installation package. |
Group Policy installs Cisco Jabber for Windows on each computer the next time each computer starts.
Supported Languages
|
|
|
![]() Note | Cisco Jabber for Windows does not support Locale IDs for all sub-languages. For example, if you specify French - Canada, Cisco Jabber for Windows uses French - France. |
Cisco Media Services Interface
Cisco Jabber for Windows supports Cisco Media Services Interface version 4.1.2 for Microsoft Windows 7 and later.
Desk Phone Video Capabilities
Install Cisco Media Services Interface
Step 1 | Download the Cisco Media Services Interface installation program from the download site on cisco.com. |
Step 2 | Install
Cisco Media Services Interface on each computer on which you
install
Cisco Jabber.
See the appropriate Cisco Medianet documentation for installing Cisco Media Services Interface. |
Uninstall Cisco Jabber for Windows
You can uninstall Cisco Jabber for Windows using either the command line or the Microsoft Windows control panel. This document describes how to uninstall Cisco Jabber for Windows using the command line.
Use the Installer
If the installer is available on the file system, use it to remove Cisco Jabber for Windows.
The command removes Cisco Jabber for Windows from the computer.
Use the Product Code
If the installer is not available on the file system, use the product code to remove Cisco Jabber for Windows.
The command removes Cisco Jabber for Windows from the computer.
Install Cisco Jabber for Mac
Supported Languages for Mac
Cisco Jabber for Mac supports the following languages:
Prepare Your Network
To install Cisco Media Service Interface for traffic marking, you must prepare your network.
Step 1 | Install Cisco Prime Collaboration manager. |
Step 2 | Install routers or switches enabled for Cisco Medianet where appropriate. |
Step 3 | Configure your network to handle the metadata attributes that Cisco Media Service Interface applies to applications. Not all devices on your network must support Cisco Medianet. The first hop should prioritize traffic based on the metadata attributes from Cisco Media Service Interface. As the traffic traverses the network, all other devices should also prioritize that traffic unless you configure policies on those devices to handle the traffic differently. |
Distribute the Cisco Jabber for Mac client
Visit the Cisco Software Center to download the Cisco Jabber for Mac client.
Upgrading in the Mac OS X environment is performed automatically by the application, with permission from the user.