Configuration Guide for Cisco Unified Videoconferencing Manager Release 5.6
Using the Resource Manager Configuration Tool

Table Of Contents

Using the Resource Manager Configuration Tool

Setting Up the Java Runtime Environment

Launching the Configuration Tool

Retrieving an Administrator Password

Uninstalling the Resource Manager Configuration Tool

How to Modify General Settings

Defining E-Mail Server Settings

Defining the Unconnected Endpoint Timeout Period

Defining Table Row Display

Defining the Command Delay

Defining the Parent Zone Authorization Filter

Defining the Log Level

Defining the In-Meeting Control Refresh Rate

Defining the Resource Manager Server Name and Web Port

Defining the Online Help Host URL

How to Modify Scheduling Settings

Changing Call Authorization Settings

Dynamically Cascading Multiple EMPs for a Single Conference

Modifying Default Meeting Settings

Modifying Default Recurring Meeting Settings

Hiding Resource Manager User Interface Screens

How to Manage Custom Time Zones

Selecting a Time Zone Profile

Viewing a Time Zone Profile

Adding Daylight Saving to a Time Zone Profile

Creating a Customized Time Zone Profile

Removing a Customized Time Zone Profile

Reverting to Default Time Zone Settings

Customizing Product and Vendor Logos

Creating a Customized Billing Field

Defining Database Server Settings

How to Define Security Settings

Defining Password Settings

Defining a Login Message

Unlocking a User Account

How to Define Call Data Record (CDR) Settings

Creating CDR Information in XML Format

Defining Required Terminal Connection Duration

Defining a CDR File Prefix

Defining How Often CDRs Are Produced

Enabling Streaming to a Radius Server


Using the Resource Manager Configuration Tool


During initial installation of Cisco Unified Videoconferencing Manager, defined network environment settings and other configurable elements, such as page length and meeting identifiers, are set to default values. This enables Resource Manager to run upon installation without the need for additional configuration.

The Resource Manager Configuration Tool, a client-server application based on Java™ Web Start, enables the system administrator to configure Resource Manager system settings, set CDR preferences, and modify default value settings.

Setting Up the Java Runtime Environment

Launching the Configuration Tool

Retrieving an Administrator Password

Uninstalling the Resource Manager Configuration Tool

How to Modify General Settings

How to Modify Scheduling Settings

Hiding Resource Manager User Interface Screens

How to Manage Custom Time Zones

Customizing Product and Vendor Logos

Creating a Customized Billing Field

Defining Database Server Settings

How to Define Security Settings

How to Define Call Data Record (CDR) Settings

Setting Up the Java Runtime Environment

Install Java Runtime Environment on the client machine before using the Resource Manager Configuration Tool.

Procedure


Step 1 Go to http://cuvcmrm_serverhost:port/cuvcmrm-config.

The first time you access the Resource Manager Configuration Tool, it detects whether or not Java Runtime Environment is installed on the client machine (such as the user's computer).

If Java Runtime Environment is not installed on the client machine, a download message appears.

Step 2 Click Install Java Runtime Environment.

Step 3 Click download on the Java download web page.

The Java Runtime Environment is installed on the client machine (your computer).

To return to the Resource Manager Configuration Tool, in the Java download web page, click previous page.


Launching the Configuration Tool

The Resource Manager Configuration Tool is accessible from any client machine on which the Java Web Start application is installed.

Procedure


Step 1 Go to http://cuvcmrm_serverhost:port/cuvcmrm-config.

The Resource Manager Configuration Tool launch page appears.

Step 2 Click Launch Resource Manager Configuration Tool.

The Resource Manager Configuration Tool checks for the latest version of the Java Web Start application on the client machine, and then starts the Resource Manager Configuration Tool.

Step 3 If a warning message appears stating that the digital signature is invalid and asking if you want to run the application, click Run.

To avoid the appearance of this message upon launch of the Resource Manager Configuration Tool from the same site address, in the message window, click Always trust content from this publisher, and then click Run.

Step 4 Click Launch Resource Manager Configuration Tool on the Resource Manager launch page.

Step 5 Enter the login and password of the Service Provider Administrator or Organization Administrator.

Step 6 Click Login.

The Resource Manager Configuration Tool window opens.


Retrieving an Administrator Password

Procedure


Step 1 In the Resource Manager Configuration Tool login window, click the down arrow to open the lower part of the login window.

Step 2 Enter the administrator login ID in the Send Admin Password for Login ID field.

Step 3 Click Send to send the administrator password to the e-mail address associated with the login ID.


Uninstalling the Resource Manager Configuration Tool

Procedure


Step 1 Go to Start > Settings > Control Panel > Add or Remove Programs on the client machine.

Step 2 Select Resource Manager Configuration Tool, and click Remove.


How to Modify General Settings

Defining E-Mail Server Settings

Defining the Unconnected Endpoint Timeout Period

Defining Table Row Display

Defining the Command Delay

Defining the Parent Zone Authorization Filter

Defining the Log Level

Defining the In-Meeting Control Refresh Rate

Defining the Resource Manager Server Name and Web Port

Defining the Online Help Host URL

Defining E-Mail Server Settings

You can define settings that are used by Resource Manager to send e-mail notifications, such as meeting reservations and meeting updates, to users and administrators.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter the e-mail server IP address or domain name in the Host field.

Step 3 Enter the e-mail server communications port in the Port field.

Step 4 Enter the e-mail server Login ID and password in the relevant fields to enable access to the e-mail server.

Step 5 Select E-mail meeting organizer upon to send an e-mail notification to the meeting organizer in the event of a meeting failure.

Step 6 Select one or more of the following meeting-failure check boxes:

Meeting creation

EP abnormal connection

EP connection

Dial-in considered—This check box is only active if you check EP connection.

If you check Dial-in considered, dial-in connections are considered as endpoints and e-mail notifications are sent in the case of a dial-in connection failure.

Step 7 Click Save.


Defining the Unconnected Endpoint Timeout Period

If an endpoint does not respond within the designated timeout period to a connection request, the system classifies the endpoint as unconnected.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter a value in seconds in the EP Unconnected Time Out field.

Step 3 Click Save.


Defining Table Row Display

You can define the number of rows that are displayed in Resource Manager tables.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter a value in the Number of table rows per page field.

Step 3 Click Save.


Defining the Command Delay

You can define the amount of time that Resource Manager waits between the sending of internal messages to the MCU.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter a value in milliseconds in the Delay between two commands from Resource Manager to MCU field.

Enter 0 for deployments consisting of version 5.x MCUs only.

Enter 100 for deployments containing version 4.x MCUs.

Step 3 Click Save.


Defining the Parent Zone Authorization Filter

The setting is only applicable when working with the Cisco IOS H.323 Gatekeeper. In a hierarchical mode, this setting determines whether or not the parent zone prefix should be added when going from a child gatekeeper to a parent gatekeeper during multi-zone navigation. This is useful for Resource Manager to determine the dial-out string when a terminal is invited.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Select the Enable Parent Zone Authorization Filter field.

Step 3 Click Save.


Defining the Log Level

You can select from three levels of detail for a log file. The more detailed a log file, the larger the log file.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Select one of the following options in the Log Level field:

WARN—This is the standard, recommended setting in most cases.

INFO—This setting includes more detailed information in the log file.

DEBUG—This setting includes issue details in the log file and produces the most detailed log.

Step 3 Click Save.


Defining the In-Meeting Control Refresh Rate

You can define the time interval between refreshes of the In-meeting Control interface.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter the number of seconds that the In-meeting Control interface is displayed before the next refresh in the Refresh In-Meeting Control window every n seconds field.

Step 3 Click Save.


Defining the Resource Manager Server Name and Web Port

You can define the server name and Web port after installation.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter the server name and Web port in the Server URL address for the In-Meeting Control URL link field in the format http://<server_URL:port_number>.

Step 3 Click Save.


Defining the Online Help Host URL

You can point the online help files to a remote URL. We recommend that you do not customize the online help host URL without making a copy of the target online help files.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > General Settings.

Step 2 Enter the remote URL in the Online Help Host URL field.

Step 3 Click Save.


How to Modify Scheduling Settings

Changing Call Authorization Settings

Dynamically Cascading Multiple EMPs for a Single Conference

Modifying Default Meeting Settings

Modifying Default Recurring Meeting Settings

Changing Call Authorization Settings

When Resource Manager and Cisco IOS H.323 Gatekeeper are working in authorization mode, Resource Manager can restrict endpoint-initiated conferences with settings in this section to prevent uncontrolled and unmanaged access in a video conference network.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Scheduling Settings.

Step 2 Unselect Allow Endpoint Initiated Point to Point Calls to prevent endpoint-initiated point-to-point calls.

Step 3 Unselect Allow Endpoint Initiated Multipoint Calls to prevent endpoint-initiated MCU calls.

Step 4 Select Allow Only Endpoint Initiated Virtual Room Meetings to ensure that the endpoint-initiated MCU calls must use a defined virtual room.

The Allow Only Endpoint Initiated Virtual Room Meetings option is enabled only when the Allow Endpoint Initiated Multipoint Calls field is checked.


Note You cannot create random endpoint-initiated conferences when Allow Only Endpoint Initiated Virtual Room Meetings is checked.


Step 5 Select Allow Advanced Virtual Room Management for Meeting Organizer to enable Meeting Organizers to have multiple virtual rooms. When checked, a meeting organizer can have multiple virtual rooms under his or her user profile. The Basic and Invite tabs are also displayed under the Virtual Room Profile screens.

Only Administrators can add a new virtual room for a Meeting Organizer. A Meeting Organizer can only delete or modify his or her existing virtual rooms.

By default, Allow Advanced Virtual Room Management for Meeting Organizer is unchecked. Each Meeting Organizer can have a single virtual room only, and only the virtual room Basic tab is displayed.

Administrators and Meeting Operators can always have multiple virtual rooms and the virtual room Basic and Invite tabs are both displayed by default.


Note If a Meeting Organizer already has more than one virtual room, even if the Allow Advanced Virtual Room Management for Meeting Organizer is unchecked, a full list of the user's virtual rooms is displayed as well as all of the virtual room's configuration tabs.


Step 6 Click Save.


Dynamically Cascading Multiple EMPs for a Single Conference

To allow an existing endpoint-initiated ad hoc meeting to grow beyond the size of a single EMP, you can instruct Resource Manager to dynamically cascade additional EMPs to this meeting when the number of available ports on the EMP reaches the value you define.

On reaching this value, Resource Manager creates a new meeting on another EMP when a new call joins the meeting. Resource Manager then cascades this new meeting to the original meeting.

Dynamic cascading is only available for video meetings using EMPs. An endpoint-initiated ad hoc audio meeting will only grow to the size of a single MCU blade.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Scheduling Settings.

Step 2 Enter a positive number in the Reserve Port on MVP for dynamic cascading field.

We recommend 1 or 2 ports.

Step 3 Click Save.


Modifying Default Meeting Settings

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Scheduling Settings.

Step 2 Select Use MCU Meeting ID to work with the MCU conference ID instead of the Resource Manager conference ID.

This option is meant to work when Resource Manager and Cisco IOS H.323 Gatekeeper are not working in authorization mode, and all meetings dial out to their meeting participants.

Step 3 Enter a value for the number of characters allowed in meeting ID strings in the Meeting ID Length field.

Step 4 Enter a numeric value for the meeting prefix in the Meeting ID Prefix field.

The prefix must be shorter than the number specified in the Meeting ID Length field.

Step 5 Enter a value in minutes in the Duration of Endpoint Initiated Calls field to set the maximum duration of endpoint-initiated calls.

The default value is 30 minutes. Resource Manager uses this value in resource allocation and meeting creation.

Step 6 Select Dial-in or Dial-out from the Default Dialing Mode list.

If you select Dial-in, meeting participants enter a meeting by dialing into the meeting.

If you select Dial-out, the Resource Manager system dials out to meeting participants.

Step 7 Select Remove ad hoc participants when disconnected from conference to enable ad participants not on the original invited list to be kept in the In-Meeting Control screen after they disconnect.

This is useful for endpoint initiated ad-hoc conference where Resource Manager will remove a participant from the conference list when the participant disconnects.

If you unselect this field, and disconnected participants are still kept in the In-Meeting Control participant list, such participants still use MCU ports even though they are no longer connected. This option is useful for managed conferences where a meeting operator can determine which disconnected participants should be removed from the meeting and do so manually.

Step 8 Enter a value in minutes in the Launch Meetings <n> Minutes before scheduled start field to specify the amount of time prior to the scheduled start of a meeting that the meeting actually begins.

If the early start attempt fails, Resource Manager attempts to create this meeting again at the regular scheduled start time.

Step 9 Select Delete meetings older than and enter a value in days up to a maximum of 9999 days to define the length of time a meeting appears in the Cisco Unified Videoconferencing Manager web interface.

Step 10 Enter a value in minutes in the Meeting Auto Extend Length field to define the length of time that a meeting can be extended after the scheduled end of the meeting.

Step 11 Select Waiting Room Timeout and enter a value in the <n> Minutes After The Waiting Room Start field to define the length of time a meeting can remain in Waiting Room mode until the meeting host joins.

If the host does not join within the specified period of time, the meeting ends.

Step 12 Enter a value in the Maximum Length of Meeting Extension field to specify the maximum length of time that you want to allow for extending a meeting.

The maximum values that Resource Manager allows are 10 days, 240 hours and 14400 minutes.

Step 13 Click Save.


Modifying Default Recurring Meeting Settings

You can modify the default number of days in advance that a recurring meeting can be scheduled.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Scheduling Settings.

Step 2 Enter a value in days in the Schedule Recurring Meetings field.

The maximum value is 730 days (2 years).

Step 3 Click Save.


Hiding Resource Manager User Interface Screens

You can simplify the Resource Manager web interface by defining which screens in the following sections of the Resource Manager user interface are hidden from administrators and users.

IP Topology in Admin > Network Management

Gatekeeper Definition > Gatekeeper/SIP server tab in Admin > Resource Management > Gatekeeper/SIP server

Gateway Definition tab in Admin > Resource Management

ISDN Topology tab in Admin > Network Management. The ISDN Topology tab is only displayed when the gateway is enabled

Terminal Definition tab in Admin > Resource Management

All Meetings section accessible via the Admin sidebar menu

User Management section accessible via the Admin sidebar menu

Advanced Settings section accessible via the Admin sidebar menu.

Other Settings tab in the Scheduling a New Meeting and in Meeting Details windows.

Customization Tool button on upper-right of the application window that provides access to the Customization Tool window in which you can customize terminology in the Resource Manager web interface.

Meeting Scheduling and Meeting Templates sections accessible via the User sidebar menu.

My Meetings section accessible via the User sidebar menu.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > UI Settings.

Step 2 Select the screens you wish to show.

Step 3 Unselect the screens you wish to hide.

Step 4 Click Save.


How to Manage Custom Time Zones

Selecting a Time Zone Profile

Viewing a Time Zone Profile

Adding Daylight Saving to a Time Zone Profile

Creating a Customized Time Zone Profile

Removing a Customized Time Zone Profile

Reverting to Default Time Zone Settings

Selecting a Time Zone Profile

Only selected time zones are displayed in the web interface in the user, terminal, and meeting time zone fields. You can define a subset of all available time zones in the Selected Time Zones list. This enables you to expose only the relevant time zones to the end users in the web interface.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Select a time zone in the Available Time Zones list.

Step 3 Click the right-pointing arrow to move the time zone to the Selected Time Zones list.

Step 4 Click Save.


Viewing a Time Zone Profile

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Double-click a time zone in either the Available Time Zones list or the Selected Time Zones list.


Adding Daylight Saving to a Time Zone Profile

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Double-click a time zone in either the Available Time Zones list or the Selected Time Zones list.

Step 3 Select Observer Daylight Saving.

Step 4 Add a daylight saving duration in minutes.

Step 5 Configure daylight saving start and end dates and times.

Step 6 Click Save.


Creating a Customized Time Zone Profile

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Click New below either the Available Time Zones list or the Selected Time Zones list.

Step 3 Enter a name and time difference from GMT for the new time zone.

You cannot change a time zone name you have saved the time zone profile.

If you create a custom time zone profile that has the same name as a default time zone profile, the new custom profile overrides the settings of the default time zone.

Step 4 (Optional) Select Observer Daylight Saving.

Step 5 (Optional) Add a daylight saving duration in minutes.

Step 6 (Optional) Configure daylight saving start and end dates and times.

Step 7 Click Save.


Removing a Customized Time Zone Profile

You can remove a time zone profile that you have added to either the Available Time Zones list or the Selected Time Zones list.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Select a custom defined time zone from either the Available Time Zones list or the Selected Time Zones list.

Step 3 Click Remove below the Available Time Zones list or the Selected Time Zones list.

Step 4 Click Yes.

Step 5 Click Save.


Reverting to Default Time Zone Settings

You can undo your changes if you have not yet clicked Save.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Move, modify or create time zone profiles.

Step 3 Click Reset to undo your changes.


Customizing Product and Vendor Logos

You can change the Resource Manager product logo via Admin > Advanced Settings > Look and Feel.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Enter the name of a file that contains the logo in the Product logo file name field, or click Browse to select the file.

The logo must be a .gif file with a maximum height of 45 pixels and a maximum width of 250 pixels.

Step 3 Enter a URL for the company that provides the branded logo and can authorize its use in the URL field.

Step 4 Select Reset to Default to restore the default vendor logo.

Step 5 Click Save.


Creating a Customized Billing Field

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Customized Settings.

Step 2 Select a display rule for your billing field from the Billing Code Field Property list.

Step 3 Select Customized Field Label and enter a name for your billing field in the text box that becomes active.

Step 4 Enter the maximum number of characters allowed in your billing field in the Field Length field.

Step 5 Select Enforce Full Length to restrict the length of your billing field to the value set in the Field Length field.

Step 6 Select an input type for your billing field from the Field Type list.

Step 7 Enter an identifier for your billing field in the Field Value field.

Step 8 Click Save.


Defining Database Server Settings

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Database Settings.

Step 2 Enter the default database server name in the Server name field.

The port number in use by the database server automatically appears in the Server Port field.

Step 3 Enter the account name used by Resource Manager to connect to the database in the Connection Account field.

"Root" appears by default.

Step 4 Enter a password in the Connection Password field for use by Resource Manager when a connection to the database server is established.

Step 5 Click Test. to verify that the database configuration is correct.

A message window shows the test results.

Step 6 Click Reset to revise your configured database server settings.

Step 7 Click Save.

Step 8 Restart Resource Manager to apply your changes.


How to Define Security Settings

Defining Password Settings

Defining a Login Message

Unlocking a User Account

Defining Password Settings

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Security Settings.

Step 2 (Optional) Select Display password in user profile and Modify password in user profile as required.

Step 3 (Optional) Select Allow only secure passwords if required.

Step 4 (Optional) Define the minimum allowed password length, password validity period, and number of allowed login attempts in the relevant fields.

Step 5 (Optional) Enter the number of previous passwords that are considered when processing a new password in the Cannot be the same as the last <n> password(s) field.

Step 6 Click Save.


Defining a Login Message

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Security Settings.

Step 2 Select Display login message and enter a login message in the text box that becomes active.

Step 3 Click Save.


Unlocking a User Account

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click System Configuration > Security Settings.

Step 2 Enter the login ID of the locked user account in the Please enter the User ID that you want to unlock field.

Step 3 Click Unlock.

Step 4 Click Save.


How to Define Call Data Record (CDR) Settings

Resource Manager creates and stores Call Data Records (CDRs) in XML format. CDRs contain comprehensive records of each call. These records are useful for analyzing and tracking system use, as well as for supporting diagnostics and billing.

Creating CDR Information in XML Format

Defining Required Terminal Connection Duration

Defining a CDR File Prefix

Defining How Often CDRs Are Produced

Enabling Streaming to a Radius Server

Creating CDR Information in XML Format

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click CDR Configuration.

Step 2 Select Enable XML CDR.

Step 3 Enable CDRs for meeting scheduling, rescheduling and/or cancellation.

Step 4 Click Save.


Defining Required Terminal Connection Duration

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click CDR Configuration.

Step 2 Enter a value in seconds in the Minimum connection required to produce CDR field for the minimum length of time a terminal must be connected before an entry for that terminal is created in the Actual Information section of the CDR.

If the terminal is connected to a meeting for the specified minimum time or longer, the CDR records the actual connection time as the total connection time for that terminal.

If a terminal is connected to a meeting for less than the specified minimum time, the CDR records the total connection time for that terminal as zero.

Step 3 Click Save.


Defining a CDR File Prefix

A standard Resource Manager installation creates a directory called Resource Manager in the Program Files directory. For example, C:\Program Files\Cisco Cisco Unified Videoconferencing Manager\Resource Manager.

CDR files are stored in a default sub-directory called cdrdata. For example, C:\Program Files\Cisco Cisco Unified Videoconferencing Manager\Resource Manager\cdrdata\cdrfilename.xml.

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click CDR Configuration.

Step 2 Enter a prefix in the File prefix name field.

The prefix appears at the beginning of the CDR file name.

The default prefix is "cdr".

Step 3 Click Save.


Defining How Often CDRs Are Produced

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click CDR Configuration.

Step 2 Select One file per meeting to create one CDR file for each meeting occurrence.

Step 3 Select One file every day to create a CDR file containing information for every scheduled meeting within a 24-hour period.

This is the default selection.

Step 4 Click Save.

CDR file names are labeled by date, followed by a sequential identifier. Filename suffixes are sequential regardless of how often a CDR is produced, and even if a different CDR production-time option is selected.


Enabling Streaming to a Radius Server

Procedure


Step 1 In the Resource Manager Configuration Tool interface, click CDR Configuration.

Step 2 Select Use RADIUS server.

Step 3 Define the Radius server IP address and port in the relevant fields.

Step 4 Enter a password for the Radius server in the Shared Secret field.

Resource Manager and the Radius server exclusively use the shared secret password as part of the security system.

Step 5 Click Save.

If you do not select Use RADIUS server, the IP Address, Port and Shared Secret fields include read-only information by default.