Release and General Information

These release notes describe new features, requirements, restrictions, and caveats for Cisco Jabber Softphone for VDI—Windows Release 12.5. These release notes are updated for every maintenance release but not for patches or hot fixes.

Before you install Cisco Jabber Softphone for VDI, we recommend that you review this document for information about issues that may affect your system.

Introduction to Cisco Jabber Softphone for VDI

In this release notes document, the term thin client refers to any supported device (including reused PCs) used to access the hosted virtual desktops (HVD).

Cisco Jabber Softphone for VDI extends the Cisco collaboration experience to virtual deployments. With supported versions of Cisco Jabber for Windows, users can send and receive phone calls on their hosted virtual desktops (HVD). The software routes all audio and video streams directly from one thin client to another, or to a phone, without going through the HVD.

The Cisco Jabber for Windows version must match your Cisco Jabber Softphone for VDI version. The Cisco JVDI Agent and Cisco JVDI Client versions must be the same.

For more information about Cisco Jabber, see the Release Notes for Cisco Jabber for Windows for your release:

https://www.cisco.com/c/en/us/support/unified-communications/jabber-windows/products-release-notes-list.html

Languages

The Cisco JVDI Agent and Cisco JVDI Client installation programs, and Device Selector are localized in the following languages:

  • Arabic

  • Bulgarian

  • Catalan

  • Chinese Simplified

  • Chinese Traditional

  • Croatian

  • Czech

  • Danish

  • Dutch

  • English(US)

  • Finnish

  • French

  • German

  • Greek

  • Hebrew

  • Hungarian

  • Italian

  • Japanese

  • Korean

  • Norwegian

  • Polish

  • Portuguese Brazil

  • Portuguese Portugal

  • Romanian

  • Russian

  • Serbian

  • Slovak

  • Slovenian

  • Spanish

  • Swedish

  • Thai

  • Turkish

Cisco Jabber Softphone for VDI Copyright

Copyright © 2018–2020 Cisco or its affiliated entities. All Rights Reserved.

New in This Release for Cisco Jabber Softphone for VDI

Cisco Jabber Softphone for VDI for Windows Release 12.5 adds support for the following programs and features.

  • Cisco Jabber for Windows Release 12.5

  • Firmware upgrade for Cisco headsets, on the thin clients

    With this feature, users can plug Cisco headsets into their thin clients and receive notification that a firmware update is available. Users can choose to proceed with the upgrade, or to postpone it. If the upgrade is postponed, Cisco Jabber again prompts them to upgrade the next time they sign in.

  • Multiple hosted virtual desktops (HVD)

    This feature fixes an issue that occurred with Citrix XenApp (published desktop or published application). This issue caused a loss of softphone functionality and a connection error. When a VDI or App session closes, the virtual channel receives a closed signal and the JVDI Client disconnects from the channel.

  • Support for enabling JVDI mode by using a registry key

    With this feature, administrators can use the following registry key to enable VDI mode:

    [HKEY_CURRENT_USER\Software\Cisco Systems, Inc.\JVDI] "isVDIEnabled"="true"

  • Support for collecting memory dumps from the thin clients

    With this feature, administrators can modify the cisco.conf file so that the Problem Reporting Tool automatically collects a memory dump from the thin client. Add the following lines to the file, and then restart the vxc process by logging out and back in to the HVD.

    dump_type = Minidump (The dump type can be Fulldump, or Minidump; the default is Minidump.)

    dump_when_collect_log = True (Set to True to generate a log dump when the PRT compiles a report.)

    The file is located in C:\Program Files (x86)\Cisco Systems\Cisco VXME\cisco.conf.

  • VMware Blast Extreme display protocol support

Cisco Jabber Support

This release supports Cisco Jabber for Windows Release 12.5.

Cisco Jabber Softphone for VDI supports all Cisco Jabber for Windows features, with the following exceptions:

  • Active Control

  • Audio device selection from the Hub Menu

  • Binary Floor Control Protocol (BFCP) Desktop Share

  • Cisco Unified Survivable Remote Site Telephony (SRST)

  • Collaboration Edge

  • Device Selection menu on the Call Conversation window

  • Far End Camera Control (FECC)

  • Federal Information Processing Standard, Publication 140-2 (FIPS 140-2) and Information Assurance (IA) Compliance

  • Jabber to Jabber Call

  • Jabber desk phone video (display of video on the desktop when the thin client is connected to the user's desk phone)

  • Kerberos and Common Access Card (CAC) with Single Sign On (SSO)

  • Multiline

    Only the first line of a multiline account is available. If a second call comes in, while the first line is in use, the second line rings, but no incoming call notification appears.

  • PreferP2PDesktopShare (configuration parameter to prioritize person to person screen sharing over video sharing in the Jabber configuration file)

System Requirements


Important

Each of the components listed in the following table must meet the requirements. Use of unsupported components can result in a nonfunctional deployment.

Only the components, versions, and minimum hardware requirements listed in the table are supported.


Component

Requirements

Microsoft Windows-based thin client hardware

  • Installed RAM 2 GB

  • Free Physical Memory 128 MB

  • Free Disk Space 256 MB

  • CPU Mobile AMD Sempron Processor 3600+, 2-GHz Intel Core 2 CPU, or T7400 2.16 GHz

  • DirectX 11 compatible GPU

  • USB 2.0 for USB camera and audio devices

Note 
Cisco Jabber Softphone for VDI for Windows does not require the Microsoft .NET Framework or any Java modules.

Microsoft Windows-based thin client OS

  • Microsoft Windows 7 32 bit

  • Microsoft Windows 7 64 bit

  • Microsoft Windows 8 32 bit

  • Microsoft Windows 8 64 bit

  • Microsoft Windows 8.1 32 bit

  • Microsoft Windows 8.1 64 bit

  • Microsoft Windows 10 32 bit

  • Microsoft Windows 10 64 bit

  • Windows Thin PC 32 bit

Windows Embedded Standard-based thin client hardware

  • Installed RAM 2 GB

  • Free Physical Memory 128 MB

  • Free Disk Space 256 MB

  • CPU performance affects the maximum video resolution. With Windows Embedded Standard thin clients, the expected resolution depends on the CPU:

    • Up to 720p with quad-core AMD GX-420CA SOC 2 GHz or similar

    • Up to 240p with dual-core AMD G-T56N 1.65 GHz or similar

    • Audio-only support with dual-core VIA Eden X2 U4200 1 GHz or similar CPU

    Note 
    These hardware specifications are only guidelines for the expected resolutions. Other factors can affect video resolution.
  • DirectX 11 compatible GPU

  • USB 2.0 for USB camera and audio devices

Note 
Cisco Jabber Softphone for VDI for Windows does not require the Microsoft .NET Framework or any Java modules.

Windows Embedded Standard-based thin client OS

  • Windows Embedded Standard 7 32 bit

  • Windows Embedded Standard 7 64 bit

  • Windows Embedded Standard 8 64 bit

  • Windows 10 IoT Enterprise

Hosted virtual desktop OS (server-side)

  • Microsoft Windows 7 32 bit

  • Microsoft Windows 7 64 bit

  • Microsoft Windows 8 32 bit

  • Microsoft Windows 8 64 bit

  • Microsoft Windows 8.1 32 bit

  • Microsoft Windows 8.1 64 bit

  • Microsoft Windows 10 32 bit

  • Microsoft Windows 10 64 bit

Connection broker for the hosted virtual desktop

1
  • Citrix XenDesktop 7.5 and later 7.x versions

  • Citrix XenApp 7.5 and later 7.x versions—Published Desktop and Published Application

    Important 

    Published Application is not supported in full-screen mode.

  • VMware Horizon 6.0 (with View)—Published desktops only

  • VMware Horizon 6 version 6.1.0—Published desktops only

  • VMware Horizon 6 version 6.2.0—Published desktops only

  • VMware Horizon 7 version 7.x—Published desktops only

    Attention 

    For information about an issue that occurs when using some VMware Horizon 7.3.x versions, see CSCvk30137.

Citrix Receiver or

VMware Horizon Client

2

(Installed on the thin client)

  • Citrix Receiver (ICA) for Windows 4.4.1000 and later 4.x versions

  • VMware Horizon Client for Windows 4.1.0, 4 and later 4.x version. (Versions 4.3 and 4.4 are not supported.)

    To enable JVDI support with versions 4.5 and later, check 32-bit Core Remote Experience on this 64-bit machine during the VMWare Horizon installation (new install or upgrade). For more information about this setting, see the VMWare Horizon documentation.

Important 

Before you install the Cisco JVDI Client, install the Citrix Receiver or VMware Horizon Client on the thin client.

If you change from a Citrix environment to a VMware environment (or from VMware to Citrix), reinstall the Cisco JVDI Client.

Cisco Unified Communications client on the hosted virtual desktop:

Cisco Jabber for Windows.

Cisco Jabber for Windows 12.5 running on the hosted virtual desktop (HVD).

Cisco Jabber Softphone for VDI is compatible with all future 12.5(x) Cisco Jabber for Windows versions.

For complete information about virtual environment compatibility, see the documentation for Cisco Jabber.

Cisco Unified Communications Manager

  • Recommended CUCM Release 11.5(1)SU3 or later

  • Minimum CUCM Release 10.5

Accessories

For a complete listing of supported audio and video accessories, see Unified Communications Endpoint and Client Accessories, at http://www.cisco.com/c/en/us/products/unified-communications/uc_endpoints_accessories.html.

Important 
Ensure that all Jabra devices are running the latest firmware. You can use the Jabra Direct to update the firmware. For more information visit: http://www.jabra.com.
1

A connection broker is software that creates connections to hosted virtual desktops. A connection broker performs a number of tasks that include

  • Validating the username and providing a connection for the user.

  • Allowing the user to connect to a specific virtual desktop.

2

The Citrix Receiver or VMware Horizon Client provides a user interface for the corresponding connection broker.

(PCoIP only)

Installation and Upgrade Notes

The following upgrade paths are supported:

  • From Cisco Jabber Softphone for VDI—Windows 12.0 to Cisco Jabber Softphone for VDI—Windows Release 12.5

  • From Cisco Jabber Softphone for VDI—Windows Release 12.1 to Cisco Jabber Softphone for VDI—Windows Release 12.5

Important Notes

Cisco Audio Session Tunnel

Cisco Audio Session Tunnel (CAST) connection to the HVD is not supported.

Cisco Jabber Installed on the Thin Client

We recommend that you do not install Cisco Jabber on the thin clients. If you do install Cisco Jabber on the thin clients, ensure that users sign out of Cisco Jabber before they sign in to their hosted virtual desktops. Cisco Jabber Softphone for VDI works only with Cisco Jabber installed on the HVD.

Cisco Unified Communications Manager Failover

When a failover from one Cisco Unified Communications Manager to another occurs, Cisco Jabber for Windows retains phone functionality. However, with Cisco Jabber Softphone for VDI, phone functionality is lost. This issue occurs because CTI failover is not supported in the virtual environment.

Cisco Expressway

Cisco Jabber Softphone for VDI does not support the use of Mobile Remote Access and Cisco Expressway.

Citrix XenApp Support

Citrix XenApp Published Application is not supported in full-screen mode. You can disable full-screen mode in the Citrix Receiver > Connection Center, on the thin client.

Echo Cancellation

Echo cancellation is enabled only for audio calls.

Display Settings

For optimal video performance, use the recommended settings for Citrix or VMware.

With Citrix XenDesktop and VMware, only full-screen mode is supported on the Linux-based platforms:

  • Cisco Virtualization Experience Client—HP Thin Pro and Ubuntu

  • Cisco Virtualization Experience Client—SUSE Linux

  • Cisco Virtualization Experience Client—Unicon eLux

Citrix XenApp Published Application is supported only on Cisco Virtualization Experience Client—Windows, in windows mode only.

Citrix

Cisco Virtualization Experience Client supports only the Preferences > Display > Best resolution (Recommended) display option.

VMware

Have users check their VMware options to ensure that the Allow Display Scaling option is unchecked.

Remote Display Protocol Support

Cisco Jabber Softphone for VDI supports only PC-over-IP (PCoIP) for VMware and ICA for Citrix.

SIP Profiles

When you create a Cisco Unified Client Services Framework (CSF) device, you specify a SIP Profile for the device. SIP profiles provide specific SIP information for the phone, such as registration and keepalive timers, media ports, and Do Not Disturb control.

You can use Certificate Authority Proxy Function (CAPF) to manage the phone certificates for the hosted desktop versions of Jabber for Windows. When you change the CAPF Certificate Operation from No Pending Operation to Install/Upgrade, the users must reset Jabber for Windows and sign in to complete the certificate installation.


Important

Do not choose Authentication Mode By Null string when using the Certificate Authority Proxy Function (CAPF).

This setting breaks Cisco Jabber Softphone for VDI registration to Cisco Unified Communications Manager.


USB Camera Redirection Not Supported with VMware View

USB camera redirection is not supported with VMware View.

VMware Installation—Required Setting

To enable Cisco Jabber Softphone for VDI (32–bit only) support with versions 4.5 and later, perform a custom installation of VMware Horizon.


Attention

This setting is not for 64–bit versions of Cisco Jabber Softphone for VDI.


Figure 1. Select Customize Installation
VMware installation page with the option to customize the installation.

Check the following setting during the installation (new install or upgrade): 32-bit Core Remote Experience on this 64-bit machine.

Figure 2. VMware Customized Installation Settings
A red border indicates the required setting.

For more information about this setting, see the VMware Horizon documentation.

HDX RealTime Webcam with Citrix

Cisco Jabber Softphone for VDI does not support HDX Plug-n-Play for cameras. Citrix recommends using HDX Webcam for camera interactions.

Silent Monitoring and Call Recording

Cisco Jabber Softphone for VDI supports silent monitoring and call recording. To enable these audio path functions for a device, you configure Cisco Unified Communications Manager. For step-by-step instructions, the Cisco Unified Communications Manager Features and Services Guide for your release.

  • Cisco Jabber does not provide any interface to start silent monitoring or call recording. Use the appropriate software to silently monitor or record calls.

  • Cisco Jabber does not currently support monitoring notification tone or recording notification tone.

  • You can use silent monitoring and call recording functionality only. Cisco Jabber does not support other functionality such as barging or whisper coaching.

  • You might need to download and apply a device package to enable monitoring and recording capabilities on the device, depending on your version of Cisco Unified Communications Manager.

Determine Device Package Requirements

Use Cisco Unified Communications Manager Administration to determine whether a device requires a device package to enable silent monitoring and recording.
Procedure

Step 1

Navigate to and open the Phone Configuration window for the device, for which you want to enable monitoring and recording.

Step 2

Locate the Built-in-Bridge field.

If the Built-in-Bridge field is not available, download and install a device package for the device.


Accessories

Jabra Firmware

Ensure that all Jabra devices are running the latest firmware. You can use Jabra Direct to update the firmware. For more information, visit the Jabra website.

Adjust Settings for Jabra Bluetooth Devices

Most Jabra Bluetooth devices introduce a short delay in bringing up the audio path (about 1 to 3 seconds). For supported Jabra Bluetooth devices, you can eliminate the delay by changing the device settings in Jabra Direct. For more information, visit the Jabra website.

Before you begin

Jabra Direct must be installed.

Procedure

Step 1

Open Jabra Direct.

Step 2

Click the Jabra device for which you want to modify the settings.

Step 3

Click Settings.

Step 4

Click to expand Softphone (PC).

Step 5

From the Preferred softphone list, select Cisco Jabber.

Step 6

Set Open phone line to On.

Step 7

Set PC audio to Off.

Step 8

Click Apply.


Camera Hot Swap

Cisco Jabber Softphone for VDI establishes video quality at the start of a call. If you start a call with one of the supported HD cameras, and then switch to a standard-definition camera, video quality is affected. We recommend that you switch cameras between calls.

Caveats

Search for Bugs

Bug Classification

Known defects, or bugs, have a severity level that indicates the priority of the defect. Development managers usually define bug severity. Severity helps the product team focus on bug fixes for future releases and prioritize fixes.

The following table describes bug severity levels:
Severity level Description
1 Catastrophic Reasonably common circumstances cause the entire system to fail, or a major subsystem to stop working, or other devices on the network to be disrupted. No workarounds exist.
2 Severe Important functions are unusable and workarounds do not exist. Other functions and the rest of the network is operating normally.
3 Moderate Failures occur in unusual circumstances, or minor features do not work at all, or other failures occur but low-impact workarounds exist.

This is the highest level for documentation bugs.

4 Minor Failures occur under very unusual circumstances, but operation essentially recovers without intervention. Users do not need to install any workarounds and performance impact is tolerable.
5 Cosmetic Defects do not cause any detrimental effect on system functionality.
6 Enhancement Requests for new functionality or feature improvements.

Search for Bugs

Use the Bug Search page to obtain more information about a bug.
  1. Go to https://tools.cisco.com/bugsearch.
  2. Sign in with your Cisco.com user ID and password.
  3. Enter a bug ID or specify search parameters.
For more information, select Help at the top right of the Bug Search page.

Closed Caveats

There are no closed caveats (bugs) for Cisco Jabber Softphone for VDI—Windows Release 12.5.

Open Caveats

The following table list the caveats (bugs) that are open for this release.

Table 1. Open Caveats for Cisco Jabber Softphone for VDI—Windows Release 12.5

Caveat ID Number

Severity

Description

CSCvn31572

3

Jabber softphone not registering in Citrix environment

Resolved Caveats

The following table lists the caveats (bugs) that are fixed in this release.

Table 2. Resolved Caveats for Cisco Jabber Softphone for VDI—Windows Release 12.5

Caveat ID Number

Severity

Description

CSCvj80899

3

Jabber softphone services doesn't register the first time in VXME environment intermittently

CSCvk25632

3

Jabber a split second of video from previous call is seen

CSCvk26994

3

Jabber missing ring back intermittently in VXME environment

CSCvk30137

3

JVDI Agent fail to launch on specific VMWare VDI (7.3.x)

CSCvm03694

3

Jabber softphone doesn't connect after switching from CTI (extend and connect)

CSCvm10783

3

JVDI 12.1.0 - Volume Setting Changes are not saved.

CSCvm41595

3

Self-View is not visible during a video call between two JVDI clients in full screen mode