Configuration Guide for Cisco Unified Videoconferencing Manager Release 5.6
Configuring Cisco Unified Videoconferencing Desktop

Table Of Contents

Configuring Cisco Unified Videoconferencing Desktop

Accessing the Administration Interface

Viewing Server Status and Port Resource Usage

How to Configure Cisco Unified Videoconferencing Desktop Server Settings

Configuring Settings for Single/Multiple-NIC Deployments

Configuring Desktop Server Network Interface

Configuring Gatekeeper IP Address

Configuring Client-Related Settings

How to Configure Meeting Control Settings

Configuring Server Type

Configuring Cisco Unified Videoconferencing 3500 MCU Server Settings

Configuring Cisco Unified Videoconferencing Manager Server Settings

Defining Security Settings

Configuring Meeting Features

How to Configure Streaming Server Settings

Configuring This Desktop Server to Manage Streaming

Configuring an Alternate Desktop Server for Watching Webcasts

How to Configure Recording Server Settings

Viewing Recording Server Status

About Configuring the Desktop Recording Server Connection

Configuring This Cisco Unified Videoconferencing Desktop Server to Manage Recording

Configuring an Alternate Cisco Unified Videoconferencing Desktop Server to Manage Recording

Configuring Recording Parameters

Modifying the Disk Space and Storage Location for Recordings

Disabling Automatic Recording Feature

How to Manage Recordings

Viewing Recording List

Editing Recording Attributes

Setting Categories for Multiple Recordings

Deleting Recordings

Stopping Recordings in Progress

Recording Meetings

Managing Categories

How to Restore Recordings

Backing up Recordings

Restoring Recordings

How to Brand Desktop User Interface

Replacing Images

Modifying Strings

Saving or Restoring Branding-related Changes

Restoring Default Images and Strings

Viewing the Cisco Unified Videoconferencing Desktop Online Help


Configuring Cisco Unified Videoconferencing Desktop


Accessing the Administration Interface

Viewing Server Status and Port Resource Usage

How to Configure Cisco Unified Videoconferencing Desktop Server Settings

Configuring Gatekeeper IP Address

Configuring Client-Related Settings

How to Configure Meeting Control Settings

Defining Security Settings

Configuring Meeting Features

How to Configure Streaming Server Settings

How to Configure Recording Server Settings

How to Manage Recordings

How to Restore Recordings

How to Brand Desktop User Interface

Viewing the Cisco Unified Videoconferencing Desktop Online Help

Accessing the Administration Interface

Procedure


Step 1 Open the Internet browser.

Step 2 Enter the following URL:

http://<host>[:<port>]/cuvm/admin

where <host> is the location of your corporate Cisco Unified Videoconferencing Desktop Server.

Step 3 On the Administration page, enter your user name and password.

Step 4 Click Sign In.

The default user name and password are both "admin".


Viewing Server Status and Port Resource Usage

The Cisco Unified Videoconferencing Desktop Status tab displays status information about the Cisco Unified Videoconferencing Desktop Server and other servers with which it interacts:

Gatekeeper—A Cisco IOS H.323 Gatekeeper.

Streaming—The Cisco Unified Videoconferencing Streaming Server. This information appears only if the Desktop Server is configured to manage streaming.

Cisco Unified Videoconferencing 3500 MCU or Cisco Unified Videoconferencing Manager—An optional server used to moderate the Desktop meetings. If no server is configured to moderate Desktop meetings, no link appears on this tab.


Note In the Desktop Server GUI, Cisco Unified Videoconferencing 3500 MCU is referred to as `CUV MCU'.


Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Status in the sidebar.

Step 2 Click the Cisco Unified Videoconferencing Desktop Server tab.

Step 3 Click the link showing the IP address of a server to display the settings for that server.

The indicator next to each link shows whether or not the connection to the target server or registration with the Gatekeeper is successful. When the indicator is red, a tooltip containing error details is available. Click the red indicator to view further error information.


Related Topics

How to Configure Streaming Server Settings

How to Configure Meeting Control Settings

How to Configure Cisco Unified Videoconferencing Desktop Server Settings

Configuring Settings for Single/Multiple-NIC Deployments

Configuring Desktop Server Network Interface

Configuring Settings for Single/Multiple-NIC Deployments

The Desktop Server can have multiple Network Interface Cards (NICs). Depending on the deployment and network configuration, you might want to control which NIC is used for various server communications.

For example, in secure multiple NIC deployments you can use a NIC configured behind the firewall to communicate with various servers, while using another NIC for Desktop Clients to connect to. In this case you must configure the Desktop network interface address to represent the NIC behind the firewall, and then in the Public Address field enter a DNS name which resolves to the NIC outside the firewall and is accessible both inside and outside the corporate network.

For single NIC deployments, the network interface address represents the Desktop Server IP address that clients use to connect to Cisco Unified Videoconferencing Desktop. In single NIC deployments with both internal and external clients, this value represents an external, statically-mapped Desktop Server IP address.

Desktop Clients can connect to the Desktop Server either by an IP or a DNS name. If a DNS name is not specified in the Public Address field, the Desktop network interface address is used. However, in many deployments the Desktop Server network interface address is not accessible to clients outside the intranet, due to NAT or firewall restrictions. Therefore, we recommend that you specify the Public Address, which must be a DNS name resolving to the correct Desktop Server IP address both inside and outside the corporate network.

Configuring Desktop Server Network Interface

The Desktop Server communicates with the following types of servers in the deployment:

Cisco Unified Videoconferencing 3500 MCU and Cisco IOS H.323 Gatekeeper—For media and call setup.

Cisco Unified Videoconferencing Manager or Cisco Unified Videoconferencing 3500 MCU—For moderation and meeting control.

Cisco Unified Videoconferencing Streaming Server—For media and control.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Settings in the sidebar.

Step 2 Click the Server tab.

Step 3 From the CUVC Desktop Network Interface list, choose the IP address that the Desktop Server must use to communicate with various servers.

The indicator next to the Address field shows whether connection to the Desktop Server is successful or not. When the indicator is red, a tooltip containing error details is displayed.

Step 4 For secure multiple NIC deployments, enter a DNS name in the Public Address field.

Step 5 Click the Client tab.

Step 6 Click OK or Apply.


Configuring Gatekeeper IP Address

Cisco Unified Videoconferencing Desktop is designed to work with either a single Cisco Unified Videoconferencing 3500 MCU, or with Cisco Unified Videoconferencing Manager which manages multiple MCUs. If Cisco Unified Videoconferencing Manager is configured to moderate Desktop meetings, use the IP address of a gatekeeper managed by Cisco Unified Videoconferencing Manager. If Cisco Unified Videoconferencing Manager manages more than one gatekeeper, use the IP address of a gatekeeper assigned to the same Cisco Unified Videoconferencing Manager zone as the Desktop Server.

If a single Cisco Unified Videoconferencing 3500 MCU is configured to moderate Desktop meetings, use the IP address of the same gatekeeper to which the MCU is registered. If no server is configured to moderate Desktop meetings, use the IP address of a gatekeeper configured for the Desktop deployment.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Settings in the sidebar.

Step 2 Click the Server tab.

Step 3 Enter the required address in the Gatekeeper IP Address field.

The indicator next to the Address field shows whether registration to the Gatekeeper is successful. When the indicator is red, a tooltip containing error details is displayed.

Step 4 Click OK or Apply.


Configuring Client-Related Settings

During this procedure you choose the video quality:

Standard Definition

This option limits Desktop Clients to a connection of standard definition at the maximum call rate you specify. If you define a service on the Cisco Unified Videoconferencing 3500 MCU that enables H.323 endpoints to use a higher bandwidth rate or high definition, Desktop calls using this service are transcoded down to the lower rate at standard definition (CIF resolution) for the Desktop Client. If you select a Cisco Unified Videoconferencing 3500 MCU service with a bandwidth rate lower than the value set in the Maximum Call Rate list, then the latter is used for the standard definition call to the Desktop Client.

High Definition

This option allows Desktop Clients to connect to a conference in high definition mode. If you select this option, you must select a maximum call rate of at least 1 MB and a minimum video rate of 768 Kbps to enable the conference to continue in 720p high definition video resolution for all clients. The Desktop Client sends up to 512 Kbps of 480p video resolution and receives the maximum call rate or rate of the service selected (the lower value of the two) of 720p video resolution. If you select a lower maximum call rate you can force the high definition service to send 480p to all clients at the lower bandwidth. If you select a lower minimum video rate you can enable a 720p service to decrease to 480p if bandwidth limitations during the conference require it.

When in high definition mode and connected to a high definition service, Desktop limits fast update requests so that it does not request more than one keyframe within 30 seconds. This allows to avoid degradation of the video quality or frame rate to all the connected endpoints.

If a Desktop connects to a standard definition service, then the standard definition quality is used during a Desktop conference.

You can also configure the maximum transmission unit (MTU) size the Desktop Client uses for communicating with Desktop. The default value is 1360. This setting should match the setting on the Cisco Unified Videoconferencing 3545 MCU used and your network setting to avoid fragmentation.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Settings in the sidebar.

Step 2 Click the Client tab.

Step 3 To configure settings for standard definition:

a. From the Maximum Video Quality list, choose Standard Definition.

b. From the Maximum Call Rate list, choose a bandwidth rate.

The default call rate value defined for the Desktop service configured on the Cisco Unified Videoconferencing 3545 MCU is 384 Kbps.

Step 4 To configure settings for high definition:

a. From the Maximum Video Quality list, choose High Definition.

The Minimum Video Bandwidth list is automatically updated to display 512 Kbps as the lowest available value.

b. From the Minimum Video Bandwidth list, choose a bandwidth rate.


Note Desktop does not flow control calls below the minimum video bandwidth rate. If this value is set to 512, Desktop negotiates a call down to 512 Kbps, which changes the video sent by Cisco Unified Videoconferencing 3545 MCU from 720 p to 480 p.


c. From the Maximum Call Rate list, choose a bandwidth rate.

Step 5 In the Maximum MTU Size field, enter a value.

Step 6 Click OK or Apply.


How to Configure Meeting Control Settings

Configuring Server Type

Configuring Cisco Unified Videoconferencing 3500 MCU Server Settings

Configuring Cisco Unified Videoconferencing Manager Server Settings

Configuring Server Type

Configure the type of server according to these recommendations:

For a simple deployment including a single Cisco Unified Videoconferencing 3500 MCU, configure the MCU.

For deployments containing Desktop with multiple Cisco Unified Videoconferencing 3500 MCUs but without Cisco Unified Videoconferencing Manager, you can connect to multiple MCUs but you do not have moderation control. Without Cisco Unified Videoconferencing Manager, the Cisco Unified Videoconferencing 3500 MCUs do not cascade MCUs into virtual meetings.

For more complex deployments, select the Cisco Unified Videoconferencing Manager.


Note When you configure Desktop to work with Cisco Unified Videoconferencing Manager, participants can access their own virtual room settings via the Virtual Room button in the Preferences screen on the Desktop entry page.


Related Topics

Configuring Settings for Single/Multiple-NIC Deployments.

Configuring Cisco Unified Videoconferencing 3500 MCU Server Settings

Configuring Cisco Unified Videoconferencing Manager Server Settings

Configuring Cisco Unified Videoconferencing 3500 MCU Server Settings

This section describes how to configure a Cisco Unified Videoconferencing 3500 MCU to moderate your Cisco Unified Videoconferencing Desktop meetings.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Meeting Control in the sidebar.

Step 2 From the server type list, choose CUV MCU.

Step 3 Enter the MCU IP address.

The indicator next to the Address field shows whether or not the connection to the target server is successful.

Step 4 Enter a user name and password for accessing the MCU Administration web user interface.

Step 5 Re-enter the password in the Confirm field.

The default user name is "admin". By default, there is no password.

Step 6 From the CUVC Desktop Network Interface list, choose the IP address that the Desktop Server.

The Desktop Server uses this IP address for MCU Server communications.

Step 7 If necessary, click Enable Raise Hand feature in Desktop meetings.

For deployments with multiple Desktop Servers, we recommend that you clear this check box. A moderator using one Desktop Server cannot see a request made by a participant using another Desktop Server.

Step 8 Click OK or Apply.


Configuring Cisco Unified Videoconferencing Manager Server Settings

The source H.323 ID is used only for advanced routing with Cisco Unified Videoconferencing Manager. Cisco Unified Videoconferencing Manager contains a corresponding field and uses the source H.323 ID to identify clients from a particular Desktop Server, and then route clients to the appropriate Cisco Unified Videoconferencing 3500 MCU.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

To allow the Desktop clients to connect to the Desktop server via port 80, go to Control Panel > Administrative Tools > Services on the Cisco Unified Videoconferencing Manager server and disable the IIS Administration service, HTTP SSL service, and World Wide Web Publishing services. This can be done either before installing the CUV Desktop server software or when receiving the "ip address/ port is in use" error during the installation. After disabling these services, the installer will complete normally and the desktop clients will be able to connect to the desktop server using port 80.

Procedure


Step 1 Click Meeting Control.

Step 2 From the server type list, choose Cisco Unified Videoconferencing Manager.

Step 3 Enter the address of the Cisco Unified Videoconferencing Manager server.

When using Single Sign-On (SSO) with the Cisco Unified Videoconferencing Manager, we recommend that you enter the local server name rather than the DNS name or IP address. For example, if the DNS name is <server1.company.com>, configure this setting to <server1>.

Step 4 Enter the HTTP port of the Cisco Unified Videoconferencing Manager server.

The default HTTP port is 8080.

Step 5 Enter the source H.323 ID of the Desktop.

Step 6 From the CUVC Desktop Network Interface list, choose the IP address. The Desktop Server uses this IP address for Cisco Unified Videoconferencing Manager Server communications.

Step 7 If necessary, click Enable Raise Hand feature in Desktop meetings.

For deployments with multiple Desktop Servers, we recommend that you clear this check box. A moderator using one Desktop Server cannot see a request made by a participant using another Cisco Unified Videoconferencing Desktop Server.

Step 8 Click OK or Apply.

The indicator next to the Address field shows whether or not the connection to the target server is successful.


Defining Security Settings

This section describes how to define access control to the Cisco Unified Videoconferencing Desktop Server Administration web user interface and to enable sRTP media encryption between Desktop Clients and the Desktop Server.

Encrypting media (audio, video, presentation) between Desktop Server and the Desktop Client might be used, for example, in a corporate deployment where the Desktop Server is used to bring in people from outside your network. Since this option only enables secure encryption of the media, you need also to secure the web portal. Choosing the Allow Users to have CUVC Desktop call them back option enables the video device callback option on the Desktop user entry page. When users select Use my computer for presentation only on connecting to a meeting, the Callback my video device number option becomes available. The Callback my video device number provides the option to call back the H.323 device when the users connect, so that users can connect in the "data only" mode to a meeting from their computers and automatically connect their H.323 devices at the same time.


Note In the "data only" mode, users can see the participant list, moderate, chat, and show or view presentations. Users can view or send neither audio nor video.


The H.323 device can be disconnected automatically when users disconnect their computers from the call.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Settings in the sidebar.

Step 2 Click the Security tab.

Step 3 Locate the Access Control area.

Step 4 Enter the administrator login information in the relevant fields.

Step 5 Locate the Security area.

Step 6 If necessary, click Encrypt Media (between Desktop and Server).

Step 7 If necessary, click Allow Users to have CUVC Desktop call them back.

This option is available only after you define a meeting control server for Cisco Unified Videoconferencing Desktop.

Step 8 Click OK or Apply.


Related Topics

Design Guide for the Cisco Unified Videoconferencing Solution Using Desktop Component

Configuring Meeting Features

This section describes how to configure meeting features including the Desktop Sharing and Chat options and Push to Talk option as well as displaying an additional panel.

When the Desktop Sharing option is enabled, the Cisco Unified Videoconferencing Desktop participants can present applications and share their desktops with other participants. You can optionally allow only moderators to share their desktops. When desktop sharing is not enabled, the video display layout in the Desktop Client changes to display the local video in a small frame and the remote video in a large frame. The Present and PIP buttons are unavailable and participants cannot change this layout.

Configure the Push to Talk option to define how participants use the microphone button in the Desktop Live Meeting Console:

Allow users to join a meeting with their microphone on—The microphone is on and the audio output is sent when participants enter a meeting. The participants must click the microphone button to mute themselves.

Force users to join a meeting with their microphone off—The microphone is off and the audio output is not sent when participants enter a meeting. The participants must click the microphone button to unmute themselves.

Force users to hold down their microphone button while speaking—Participants must click and hold down the microphone button to activate their microphones and to send their audio output.

You can enable the custom panel option to display an additional custom panel in the Desktop Live Meeting Console. The custom panel docking location is preconfigured and cannot be changed; meeting participants can move the panel after undocking it.

The URL parameters are passed to the custom URL as follows:

?meetingid=NNN&nickname=XXX, where NNN is the ID of the meeting that the user is connected to, and XXX is the nickname of the connected user.

You can also use the custom panel URL to specify additional URL parameters. You must use the URL-encoding for the additional URL parameters. For example, if the custom panel URL is "http://www.mycustompanel.com/myservlet?arg1" and the Desktop entry page or conference room is launched with the additional argument "?CUSTOM=arg2%26arg3% 3D123", the custom panel opens to the URL "http://www.mycustompanel.com/myservlet? arg1&arg2&arg3=123".

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Settings in the sidebar.

Step 2 Click the Meeting Features tab.

Step 3 Define the Enable Desktop Sharing and Enable Chat options as desired.

For deployments with multiple Desktop Servers, we recommend that you do not enable the chat option. A participant using one Desktop Server cannot join the chat started by a participant using another Desktop Server.

Step 4 Define the additional custom panel option as desired:

a. Click the Display an additional panel in the conference room check box to enable the option.

b. Enter the URL in the field.

Step 5 Define the Push to Talk option as desired.

Step 6 Click OK or Apply.


How to Configure Streaming Server Settings

This section describes how to configure Cisco Unified Videoconferencing Desktop streaming settings of the Cisco Unified Videoconferencing Manager. Streaming can be managed either by a single Cisco Unified Videoconferencing Desktop Server or by multiple Desktop Servers. If a single Desktop Server is set to manage streaming, all other participants are directed to this server. If multiple Desktop Servers are configured to manage streaming, they manage streaming independently.

To designate a single Desktop Server to manage streaming, enable streaming on this Desktop Server. In this case you must disable streaming on other Desktop Servers in the same deployment. However, you can configure those server to allow watching of webcasts from the Cisco Unified Videoconferencing Desktop Server on which streaming is enabled.

To enable multiple Desktop Servers for managing streaming, enable streaming on each Desktop Server in this deployment.


Note When multiple Desktop Servers manage streaming, streaming must be enabled or disabled on each individual Desktop Server. For example, if streaming is enabled for a meeting or virtual room, a moderator cannot disable it, because each Desktop Server manages streaming independently. If a moderator connected to one Desktop Server disables streaming, the other Desktop Server still continues to stream, unless it is disabled by its moderator as well.


Table 28-1 compares using a single Desktop Server to using multiple Cisco Unified Videoconferencing Desktop Servers for streaming.

Table 28-1 Comparison of Deployment Characteristics 

Characteristic
Single Desktop Server enabled for streaming
Multiple Desktop Servers enabled for streaming

HTTP performance

Slower HTTP performance over the Internet between dispersed sites and the designated Desktop Server.

Faster HTTP performance within local sites.

Load on Streaming Server

Many streaming clients at different sites sharing the resources of a single streaming server.

Streaming clients at individual sites share a local streaming server.

Desktop Server management

Single location for managing streaming.

Streaming must be enabled or disabled on each individual Desktop Server.

Participant count

All participants connected to the central Desktop Server are shown in the meeting display.

Only participants connected to a specific local Desktop Server are shown.


Configuring This Desktop Server to Manage Streaming

Configuring an Alternate Desktop Server for Watching Webcasts

Configuring This Desktop Server to Manage Streaming

This section describes how to enable this Desktop Server to manage streaming and to configure settings for this server.

The public address you define during this procedure performs a similar role to the public address defined for the Desktop Server. If the Streaming Server resides behind a NAT, the clients might not resolve the Streaming Server IP address. In this case the clients use the public address to connect to the Streaming Server.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Streaming in the sidebar.

Step 2 Click the Connection tab.

Step 3 Choose Enable Streaming from the list.

Step 4 Enter the IP address of the Streaming Server.

Step 5 From the CUVC Desktop Network Interface list, choose the IP address.

The Desktop Server uses this IP address for Cisco Unified Videoconferencing Streaming Server communications.

Step 6 In the TCP Port field, enter a TCP streaming port.

The default port is 7070.


Note If you use a TCP port different from the default value of 7070, you must open this port on the firewall.
For more information about configuring a UDP connection, refer to the "Configuring Streaming or Playback using the UDP connection" section of the Design Guide for the Cisco Unified Videoconferencing Solution Using Desktop Component at http://www.cisco.com/en/US/products/hw/video/ps1870/products_implementation_design_guides_list.html.


Step 7 In the Public Address field, enter a FQDN.

We recommend that you use a FQDN that clients can resolve.

Step 8 Click OK or Apply.

Step 9 Click the Settings tab.

Step 10 Define the size of the video used for streaming by choosing one of the options: Small (QCIF) or Medium (CIF).

Step 11 From the Rate list, choose a value to define the bit rate for the streaming feed between Cisco Unified Videoconferencing 3500 MCU and the Desktop Server.

Step 12 Click OK or Apply.

The indicator next to the Address field shows whether not registration to the Cisco Unified Videoconferencing Streaming Server is successful. When the indicator is red, a tooltip containing error details is displayed.


Related Topics

Configuring Settings for Single/Multiple-NIC Deployments

How to Configure Cisco Unified Videoconferencing Desktop Server Settings

Configuring an Alternate Desktop Server for Watching Webcasts

This section describes how to configure the Desktop Server to refer to an alternate Desktop Server which is used for streaming in order to watch webcasts.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Streaming in the sidebar.

Step 2 Click the Connection tab.

Step 3 Choose Disable Streaming from the list.

Step 4 Check the Allow watching of webcasts from an alternate Desktop server option.

Step 5 In the Server URL field, enter the URL of the alternate Desktop Server.

Step 6 Click OK or Apply.


How to Configure Recording Server Settings

Cisco Unified Videoconferencing Desktop allows users to record meetings and to view recorded meetings. A recording includes all media types: the audio, video and presentation. Servers used for recording meetings must have a recording license installed on them. Cisco Unified Videoconferencing Desktop supports up to 10 simultaneous recordings.

Viewing Recording Server Status

About Configuring the Desktop Recording Server Connection

Configuring Recording Parameters

Modifying the Disk Space and Storage Location for Recordings

Disabling Automatic Recording Feature

Viewing Recording Server Status

The Recording Status tab displays this information:

Recording Server—Displays the address of the Desktop Recording Server.

Recorder—Displays the connection status between the Desktop Recording Server and the Desktop Conference Server.

Gatekeeper—Displays the address of the gatekeeper to which the Conference Server is registered. In the special case that the Desktop Recording Server is installed separately from the Cisco Unified Videoconferencing Desktop Server and has its own Conference Server, the Conference Server must be registered to the same gatekeeper as the Cisco Unified Videoconferencing Desktop Server.

NIC Address—Displays the NIC address used by the Desktop Recording Server to communicate with the Cisco Unified Videoconferencing 3545 MCU.

Recordings Folder—Displays the location of the folder on the Desktop Recording Server used for storing recordings.

Remaining Disk Space—Shows how much space is remaining on the disk on which recordings are stored.

If the remaining disk space is less than the disk space allocated for recordings, a warning icon is displayed. Click the icon for details.

Disk Usage—Shows the amount of disk space used by all recordings. The maximum value is configured during installation.

To change the maximum disk space, run the installer on the Desktop Recording Server in the modification mode.

Recordings in progress—Shows the number of recordings being recorded at the present moment. The maximum value appears as specified in the recording license installed for this Desktop.

Completed recordings—Shows the total number of completed recordings available for watching.

Reconstructed recordings—Shows the number of reconstructed recordings.

Desktop saves actual recordings and recording attributes in different folders. If a user restores only a recording without restoring its attributes, the recording appears as reconstructed. In this case you need to manually define recording attributes, such as the name and the owner PIN, to finalize reconstruction of a recording. Only after the reconstruction is completed the recording appears on Watch Recording page of the Cisco Unified Videoconferencing Desktop portal. If recording attributes are not reconstructed, the yellow attention icon is displayed. Click the icon for more information.

Evaluation license—Displays information about an evaluation license if it is used.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Status in the sidebar.

Step 2 Click the Recording Status tab.

Step 3 Click the link showing the IP address of the recording server to display the Recording Connection Settings page.

The indicator next to each link shows whether or not the connection to the target server or registration with the Gatekeeper is successful. When the indicator is red, a tooltip containing error details is available. Click the red indicator to view further error information.


About Configuring the Desktop Recording Server Connection

This section describes how to configure Desktop Recording Server settings. Recording can be managed either by a single Cisco Unified Videoconferencing Desktop Server or by multiple Cisco Unified Videoconferencing Desktop Servers.

If a single Cisco Unified Videoconferencing Desktop Server is set to manage recording, only participants connected through that Cisco Unified Videoconferencing Desktop Server can start or stop recording. In this case, you can configure other Cisco Unified Videoconferencing Desktop Servers in the deployment to display the list of recordings from the Cisco Unified Videoconferencing Desktop Server configured to manage recording.

If you configure multiple Cisco Unified Videoconferencing Desktop Servers to manage recording, the servers manage recording independently causing each Desktop portal to display its own list of recordings.

To designate a single Cisco Unified Videoconferencing Desktop Server to manage recording, enable recording on this Cisco Unified Videoconferencing Desktop Server. In this case you must disable recording on other Cisco Unified Videoconferencing Desktop Server in the same deployment, and enable them to allow playback of recordings from an alternate Cisco Unified Videoconferencing Desktop Server in order to display a list of recordings in the portal.

To enable multiple Cisco Unified Videoconferencing Desktop Server for managing recording, enable recording on each Cisco Unified Videoconferencing Desktop Server in this deployment.

Configuring This Cisco Unified Videoconferencing Desktop Server to Manage Recording

The public address you define during this procedure performs a similar role to the public address defined for the Desktop Server. If the Desktop Recording Server resides behind a NAT, the clients might not resolve the Desktop Recording Server IP address. In this case the clients use the public address to connect to the Desktop Recording Server.

You can configure recording settings as well as manage recordings if you select this server to manage recording.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recordings in the sidebar.

Step 2 Click the Connection tab.

Step 3 From the list, choose Enable recording.

Step 4 Enter the IP address of the Recording Server.

Step 5 In the Public Address field, enter a FQDN.

We recommend that you use a FQDN that clients can resolve.

Step 6 Enter the TCP port.

This port is used by clients to access the recording in case a UDP connection fails.

You must configure the TCP port on the Cisco Unified Videoconferencing Streaming Server and open this port on the firewall.
For more information about configuring a UDP connection, refer to the "Configuring Streaming or Playback using the UDP connection" section of the Design Guide for the Cisco Unified Videoconferencing Solution Using Desktop Component.

Step 7 From the CUVC Desktop Network Interface list, choose the IP address.

The Desktop Server uses this IP address for communications with Cisco Unified Videoconferencing Streaming Server and TCP Proxy.

Step 8 Click OK or Apply.

The indicator next to the Address field shows whether not registration to the Cisco Unified Videoconferencing Streaming Server is successful. When the indicator is red, a tooltip containing error details is displayed.


Related Topics

Design Guide for the Cisco Unified Videoconferencing Solution Using Desktop Component at http://www.cisco.com/en/US/products/hw/video/ps1870/products_implementation_design_guides_list.html

Configuring an Alternate Cisco Unified Videoconferencing Desktop Server to Manage Recording

If you select an alternate server to manage recording, you can configure neither recording settings nor manage recordings.

Before You Begin   

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recordings in the sidebar.

Step 2 Click the Connection tab.

Step 3 From the list, choose Enable recording.

Step 4 In the Server URL field, enter the URL of the alternate Desktop Server.

Step 5 Click OK or Apply.


Configuring Recording Parameters

During the configuration described in this section you define the recording policy by enabling the recording option for Desktop users and by specifying the type of meetings the users can record.

If you disable recording for users, you do not need to choose a meeting type.

If Cisco Unified Videoconferencing Manager is configured to moderate Desktop Server meetings, both Cisco Unified Videoconferencing Manager and Cisco Unified Videoconferencing Desktop control recording. If the recording policy is differently configured on Cisco Unified Videoconferencing Manager and Cisco Unified Videoconferencing Desktop, the more restrictive settings overrule the less restrictive settings, creating a unified recording policy. For example, if the recording policy of Cisco Unified Videoconferencing Desktop is configured to allow recording of any meeting, while the policy of Cisco Unified Videoconferencing Manager is set to enable recording only for certain virtual rooms, recording of meetings in the specified virtual rooms will be allowed.

You also define the following parameters during this configuration:

Video size and Recording bit rate—These parameters are used to control the quality of recordings.

Setting the recording bit rate to a value lower than 256 Kbps can affect the quality and framerate of the H.239 Data in the live connection and streaming modes. We recommend that you set the recording bit rate to 384 Kbps.

Maximum Recording Duration—The value set for this parameter controls maximum allowed duration for any recording.

Send tone periodically during recording—This parameter defines the frequency of the tone played during a recording which serves to remind users that their meeting is being recorded.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recordings in the sidebar.

Step 2 Click the Settings tab.

Step 3 From the Video Size list, choose an option.

Step 4 From the Recording bit rate list, choose a value.

Step 5 Select the check box to enable recording for Desktop users.

Step 6 If you enabled recording for users, choose a meeting type:

Any meeting

Only moderated meetings—Users are allowed to record only meetings for which a moderator PIN is configured.

Step 7 In the Maximum Storage Capacity field, enter a value.

Step 8 In the Maximum Recording Duration field, enter a value.

Step 9 From the Send tone periodically during recording list, choose an option.

Step 10 Click OK.


Related Topics

Modifying the Disk Space and Storage Location for Recordings

Modifying the Disk Space and Storage Location for Recordings

By default Cisco Unified Videoconferencing Desktop stores recordings at a location defined during Cisco Unified Videoconferencing Desktop Server installation, however, you can modify this location if required.

During this procedure all recording services are stopped. After the new location is defined, all new recordings are stored at it. You must manually transfer the existing recordings into the new location. The recordings that are left in the previous location do not appear on the Watch Recording page of the Cisco Unified Videoconferencing Desktop portal.

Procedure


Step 1 Insert the Cisco Unified Videoconferencing Desktop Server product CD-ROM and click the Modify Cisco Unified Videoconferencing Desktop Server button in the autorun application to access the Cisco Unified Videoconferencing Desktop Server installer.

Step 2 In the Choose Setup Language screen, choose the installation language from the list, and click Next.

Step 3 In the Welcome screen click Next.

Step 4 In the License Agreement screen, choose I accept the terms in the license agreement, and click Next.

Step 5 In the Desktop Serial Key screen, enter your Cisco Unified Videoconferencing Desktop Server serial key acquired from Cisco support, and then click Next.

Step 6 In the Desktop Network Configuration screen, click Next.

Step 7 In the Desktop Hostname Configuration screen, click Next.

In the Desktop Recording Configuration screen is displayed.

Step 8 To modify the storage location, perform the following:

a. Click Change.

b. Navigate to a new location.

c. Click OK.

Step 9 To modify the maximum amount of disk space, enter new value in the field.

Step 10 Click Next.

Step 11 Click Install.


Disabling Automatic Recording Feature

You can use the Cisco Unified Videoconferencing Manager to automatically record either a virtual room or a scheduled meeting when the meeting begins. In this case Desktop records the meeting unless one of the following problems interferes with recording:

There are not enough available recording ports on the Desktop at the time when the meeting is scheduled

There is not enough disk space the disk on which recordings are stored

The maximum number of simultaneous recordings is reached

If the deployment in use comprises multiple Cisco Unified Videoconferencing Desktop Servers, automatic recording is performed on all Cisco Unified Videoconferencing Desktop Servers and several identical recordings are created. In this case we recommend that you allow one of the Cisco Unified Videoconferencing Desktop Servers to perform automatic recording, while disabling the automatic recording feature on the rest of the Cisco Unified Videoconferencing Desktop Servers in the deployment. The procedure in this section describes how to disable the automatic recording feature on a Cisco Unified Videoconferencing Desktop Server.

Procedure


Step 1 Stop the service "Desktop - Apache Tomcat".

Step 2 Modify the ctmx.ini file:

a. Using either the Microsoft Notepad or the Microsoft Wordpad application, open the following file:

<installDir>\tomcat\webapps\\WEB-INF\data\ctmx.ini

where <installDir> represents the actual installation directory.

b. Locate the section [meetingmgr].

c. Find the entry for autorecord and set the value to "false".

d. Save the file.

e. Close the application you used for editing the file.

Step 3 Start the service "Desktop - Apache Tomcat".


How to Manage Recordings

Viewing Recording List

Editing Recording Attributes

Setting Categories for Multiple Recordings

Deleting Recordings

Stopping Recordings in Progress

Recording Meetings

Viewing Recording List

You can review the list of recordings made on this Cisco Unified Videoconferencing Desktop using the Recordings tab. The following information is displayed:

Meeting ID

Name

Start Time

Duration

For meetings that are currently being recorded, the "In progress" indication is displayed.

PIN-protected indicator

You can also access for the following additional information for a specific recording:

Description

Categories—Keywords associated with recordings.

Recording URL

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recordings in the sidebar.

Step 2 Click the Recordings tab.

The Recordings tab is displayed showing a list of recordings. By default all recordings are displayed.

Step 3 To filter recordings, select a category from the Show list.

Step 4 To sort recordings, click one of the columns:

Meeting ID

Name

Start Time

Duration

Step 5 To search for a specific recording by an attribute:

Meeting ID—Click the Meeting ID column, enter the meeting ID in the Search field, and then click the Search button.

Meeting Name—Click any column except the Meeting ID column, enter the meeting name in the Search field, and then click the Search button.

Step 6 To display additional information for a specific recording, click the Information icon. The Meeting Information window opens.


Editing Recording Attributes

You can assign an owner and an access PIN for recording protection. The access PIN is optional and is used for watching a recording. In the list of recorded meetings protected by an access PIN are marked by a key icon. The owner PIN is used only for editing a recording.

You can define what part of a recorded meeting is played by setting offsets. In this case while the playback of a recording changes, the duration of the recording itself is not shortened. For example, to omit the first five minutes of a recording, set the Start offset to 5 minutes.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recording in the sidebar.

Step 2 Click the Recordings tab.

Step 3 Locate the required recording in the list.

Step 4 Click the Edit icon.

The Edit Recording window is displayed.

Step 5 To modify the recording name and description, enter new text in relevant fields.

Step 6 To set offsets:

Pull sliders

Or

Edit values in the fields.

Step 7 To modify categories for the recording, select a category in the relevant pane and click the Transfer button.

Step 8 To set the owner PIN for the recording, enter the owner PIN.

Step 9 To set the access PIN, enter the access PIN.

Step 10 Click OK.


Setting Categories for Multiple Recordings

You can set categories for multiple recordings at one time.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recording in the sidebar.

Step 2 Click the Recordings tab.

Step 3 In the recording list, click check boxes to select recordings.

Step 4 Click Categorize.

The Categorize Recordings window opens.

Step 5 To assign a category, which is not currently assigned to selected recordings:

a. In the left pane, click the check box for this category.

b. Click Assign.

Step 6 To remove a category, which is currently assigned to selected recordings:

a. In the right pane, click the check box for this category.

b. Click Remove.


Deleting Recordings

You can permanently remove a recording from Cisco Unified Videoconferencing Desktop by deleting it from the recording list.

When you delete a recording which is in progress, the meeting participants are notified that the recording is stopped. The meeting moderator receives a notification that the recording is deleted by the administrator.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recordings in the sidebar.

Step 2 Click the Recordings tab.

Step 3 In the recording list, click the check box for recordings you wish to delete.

Step 4 Click Delete.

Step 5 Click Yes in the confirmation message.


Stopping Recordings in Progress

You can stop any recording that is in progress. When you stop a recording in progress, meeting participants are notified that the recording is stopped. The meeting moderator receives a notification that the recording is stopped by the administrator.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recording in the sidebar.

Step 2 Click the Recordings tab.

Step 3 In the recording list, click the check box for recordings you want to stop.

Step 4 Click Stop.

Step 5 Click Yes in the confirmation message.


Recording Meetings

You can record meetings using the Desktop Server Administration web user interface.

Before You Begin

Verify that you have the ID of a meeting you want to record.

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recording in the sidebar.

Step 2 Click the Recordings tab.

Step 3 In the Start recording meeting ID field, enter ID.

Step 4 Click Record.

The Start Recording window is displayed.

Step 5 Enter recording name and description.

Step 6 Assign categories as necessary.

Step 7 To set the owner PIN for the recording:

a. Choose either the Use the moderator PIN as the Owner PIN or Specify an Owner PIN option.

b. Enter the owner PIN.

c. Enter the owner PIN in the Confirm field.

Step 8 To set the meeting PIN:

a. Choose the Use the meeting PIN as the Access PIN or Specify an Owner PIN option.

b. Enter the access PIN.

c. Enter the access PIN in the Confirm field.

Step 9 Click Start Recording.

The meeting appears in the list, and its duration is indicated as "In Progress".


Managing Categories

Apart from standard attributes like an ID, name, and duration, Cisco Unified Videoconferencing Desktop provides a category—a special attribute that can help organizing and searching recordings. Both users and administrators can assign categories to recordings. Administrators manage categories by modifying a list of existing categories, while users can only select categories from this list to associated them with recordings.

If you rename an existing category, Cisco Unified Videoconferencing Desktop automatically updates attributes for all recordings belonging to the modified category. Deleting a category does not cause Cisco Unified Videoconferencing Desktop to delete recordings belonging to the deleted category.

Before You Begin

Navigate to the Desktop Server Administration web user interface.

Procedure


Step 1 Click Recording in the sidebar.

Step 2 Click the Categories tab.

Step 3 To create a new category:

a. In the Create a new category field, enter the name.

b. Click Create.

The new category appears in the list.

Step 4 To edit an existing category:

a. Click the Edit icon.

b. Enter the new name for the category.

c. Click OK.

Step 5 To delete an existing category:

a. Click the Delete icon.

b. Click Yes.


How to Restore Recordings

Desktop saves actual recordings and recording attributes in different folders. In order to restore a recording you need to restore both folders.

Backing up Recordings

Restoring Recordings

Backing up Recordings

Perform the backup procedure described in this section on the Desktop Recording Server. During the backup procedure, you copy the xml file that contains the database of categories configured, the recordings folder containing recording attributes, and the folder containing actual recordings to a location outside the installation directory.

Procedure


Step 1 Navigate to the following directory: <installdir>\CSAgent\data.

Step 2 Copy recorder_categories.xml file into a location outside the installation directory.

Step 3 Copy the recordings folder into a location outside the installation directory.

Step 4 Navigate to the folder where recordings are stored.

By default, the recordings are stored in the <installdir>\recordings, if not configured otherwise.

Step 5 To check the location where recordings are stored:

a. Access the Cisco Unified Videoconferencing Desktop Server Administration web interface.

b. Click Status in the sidebar.

c. Click the Recording Status tab.

The Recordings Folder information is displayed on the tab.

Step 6 Copy that folder into a location outside the installation directory.


Restoring Recordings

Procedure


Step 1 Stop the service "Desktop - Apache Tomcat".

Step 2 Stop the service "Desktop- TCP Proxy".

Step 3 Navigate to the following directory: <installdir>\csagent\data.

Step 4 Replace recorder_categories.xml file with the backup file.

Step 5 Replace the recordings folder with the backup folder.

Replacing the recordings folder with the backup folder erases any categories that are currently defined in Desktop.

Step 6 Navigate to the folder in which recordings are stored.

Step 7 By default, this will be <installdir>\recordings, but this can be changed.

By default, the recordings are stored in the <installdir>\recordings, if not configured otherwise.

Step 8 To check the location where recordings are stored:

a. Access the Cisco Unified Videoconferencing Desktop Server Administration web interface.

b. Click Status in the sidebar.

c. Click the Recording Status tab.

The Recordings Folder information is displayed on the tab.

Step 9 Replace that folder with the backup folder.

Step 10 Start the service "Desktop - Apache Tomcat".

Step 11 Start the service "Desktop - TCP Proxy".


How to Brand Desktop User Interface

Cisco Unified Videoconferencing Desktop Server is released with a set of default images appearing in the Desktop user interface. However, you can change images and strings displaying irrelevant branding information using the Desktop Branding application.

Replacing Images

Modifying Strings

Saving or Restoring Branding-related Changes

Restoring Default Images and Strings

Replacing Images

You can replace images appearing in the Desktop user interface by using the Branding application on Cisco Unified Videoconferencing Desktop Server. Replacement takes affect immediately, therefore we recommend that you should not replace images on a server that is currently in service. Replacement does not affect the proper function of the Desktop user interface.

Most web browsers store local copies of images to accelerate future views of the same image. This practice is called caching. Any browser that has previously loaded an image that you replace might display its local copy of the old image rather than your replacement image. If an image in the Desktop user interface does not appear to be the same as the one displayed as the currently installed image, then you must clear your browser's cache.

Cisco Unified Videoconferencing Desktop Server is released with a set of default images that you can restore at any time.

Procedure


Step 1 Click Start.

Step 2 Choose Programs > Desktop > Branding Application.

The branding application starts.

Step 3 Click the Images tab.

The images that can be replaced are displayed together with the recommended size and a brief description of each image.

If an image has a transparent background, it appears with a gray and white "checkerboard" background in the preview fields.

Step 4 From the list, choose the image you want to replace.

A brief description of the image is displayed along with the recommended image size. The Default image area shows the image that was originally distributed with the product. The Currently installed image shows the image that appears in the user interface.

Step 5 Click Select File, and then choose the replacement image.

A preview of the image is displayed.

If you use an image that the application indicates as not properly sized, a warning appears below the image description. Using an image that does not match the original image size might result in incorrect image display.

Step 6 If you use an image that is not properly sized, verify that the image is displayed correctly:

a. Verify that the Cisco Unified Videoconferencing Desktop Server is running.

b. Review the Desktop user interface after replacement to verify that the image appears correctly.

Step 7 Click Install Image to use the replacement image.

This image is replaced.

If an old image still appears, see your browser's documentation for information about removing temporary internet files.

Step 8 To restore a default image, click Restore Original Image.

Step 9 Repeat Step 4 through Step 7 for other images.


Modifying Strings

You can modify some strings appearing in the Desktop user interface. New string values you set using the Branding application appear in the user interface only after Cisco Unified Videoconferencing Desktop Server starts and reads these values. Therefore, you can see modified strings only after the changes are applied and after the server is restarted if it was running when you made the changes.

Procedure


Step 1 Click Start.

Step 2 Choose Programs > Desktop > Branding Application.

Step 3 Click the Strings tab.

The strings that can be replaced are displayed along with the their values:

The Rebranded Value column displays values that are currently saved. When the Cisco Unified Videoconferencing Desktop Server is restarted, these are the values that appear in the user interface.

The Default Value column displays values that are the original strings that were distributed with Desktop.

Step 4 Click the relevant cell in the New Value column and type in the new string you want to use.

Or

Double-click a value in the Rebranded Value column or the Default column to copy it into the New Value column.

Step 5 Repeat Step 4 for other strings if necessary.

Step 6 Click Apply.

The new values are saved. The modified values appear in the Rebranded Value column.

Step 7 Restart the "Desktop - Apache Tomcat" service for the changes to take affect.

Step 8 To restore default strings:

a. Click Restore All Default Strings.

b. Click Apply.

c. Restart the "Desktop - Apache Tomcat" service for the changes to take affect.


Saving or Restoring Branding-related Changes

You can save modified images and strings by exporting them to a file. You can later use this file to import values from it, thus restoring them.

Procedure


Step 1 Click Start.

Step 2 Choose Programs > Desktop > Branding Application.

Step 3 To save modified images and strings:

a. From the File menu, choose Export.

b. Specify the location in which you want to save the file.

c. Click Save.

Step 4 To restore the modified images and strings from the file:

a. From the File menu, choose Import.

b. Navigate to the export file.

c. Click Import.

Step 5 Restart the "Desktop - Apache Tomcat" service for the changes to take affect.


Restoring Default Images and Strings

Cisco Unified Videoconferencing Desktop Server is released with a set of default images and string values. You can restore both default images and default string values in one go. Restoring default images and strings overwrites currently used images and string values with default ones.

Procedure


Step 1 Click Start.

Step 2 Choose Programs > Desktop > Branding Application.

Step 3 From the File menu, choose Restore all.

Step 4 Restart the "Desktop - Apache Tomcat" service for the changes to take affect.


Viewing the Cisco Unified Videoconferencing Desktop Online Help

Procedure


Step 1 Access the Desktop Server Administration web interface.

Step 2 Click the Help icon in the top right corner of the Administration web user interface.


Related Topics

Accessing the Administration Interface