Cisco Unified CallManager Administration Guide, Release 5.0(2)
Region Configuration
Downloads: This chapterpdf (PDF - 225.0KB) The complete bookPDF (PDF - 6.7MB) | Feedback

Region Configuration

Table Of Contents

Region Configuration

Finding a Region

Configuring a Region

Region Configuration Settings

Deleting a Region

Related Topics


Region Configuration


Use regions to specify the bandwidth that is used for audio and video calls within a region and between existing regions.

The audio codec determines the type of compression and the maximum amount of bandwidth that is used per audio call.

The video call bandwidth comprises the sum of the audio bandwidth and video bandwidth but does not include overhead.


Note The default audio codec for all calls through Cisco Unified CallManager specifies G.711. If you do not plan to use any other audio codec, you do not need to use regions. See the "Related Topics" section for more information.



Note Cisco Unified CallManager allows addition of a maximum of 500 regions.


Use the following procedures to add, update, or delete regions:

Finding a Region

Configuring a Region

Related Topics

Deleting a Region

Refer to the "Regions" section in the Cisco Unified CallManager System Guide for more information about configuring regions and selecting audio codecs.

Finding a Region

Because you may have several regions in your network, Cisco Unified CallManager Administration lets you locate specific regions on the basis of specific criteria. Use the following procedure to locate regions.


Note During your work in a browser session, your find/list search preferences are stored in the cookies on the client machine. If you navigate to other menu items and return to this menu item, or if you close the browser and then reopen a new browser window, your Cisco Unified CallManager search preferences are retained until you modify your search.


Procedure


Step 1 Choose System > Region.

The Find and List Regions window displays. Use the drop-down list box to search for a region by Name.

Step 2 From the Find Regions window drop-down list box, choose one of the following criteria:

begins with

contains

is exactly

ends with

is empty

is not empty

Step 3 Specify the appropriate search text, if applicable, and click Find.


Tip To find all regions that are registered in the database, click Find without entering any search text.


A list of discovered regions displays by Name.

From the Find and List Regions window, you can also specify how many items per page to display.


Note You can delete multiple regions from the Find and List Regions window by checking the check boxes next to the appropriate regions and clicking Delete Selected. You can delete all regions in the window by checking the check box in the Matching records title bar and clicking Delete Selected.


Step 4 From the list of records, click the region name that matches your search criteria.

The window displays the region that you chose.


Additional Information

See the "Related Topics" section.

Configuring a Region

Use the following procedure to add or update a Region.

Before You Begin

For every region, an association exists with that region in other regions; therefore, the addition of regions occurs in a matrixlike fashion. For example, if you add regions A, B, and C, a matrix with region A, region B, and region C as both columns and rows results, as shown in the following matrix:

 

Region A

Region B

Region C

Region A

     

Region B

     

Region C

     

If you assign 20 regions, the database adds 400 entries (20 x 20). Some performance limitations exist when large numbers of regions are assigned.


Note Cisco Unified CallManager allows addition of a maximum of 500 regions.


Configuring Default Values

Region entries contain two values—audio codec and video call bandwidth.

Audio Codec—You define audio codec values to be used within the same region, and you also define audio codec values to be used between regions.

Video Call Bandwidth—You define video call bandwidth values to be used within the same region, and you also define video call bandwidth values to be used between regions.


Tip If you set both the audio codec values and the video call bandwidth values to use the default, the system optimizes its performance by making more efficient use of resources.



Note Regions have default values for use within a region (the recommended default value specifies G.711) and regions have default values for use between regions (the recommended default value specifies G.729).


You configure the default values for regions in the Cisco Unified CallManager Administration Service Parameters Configuration window (System > Service Parameters).

1. Choose System > Service Parameters.

2. From the drop-down Server list box, choose the Cisco Unified CallManager server that you want to configure.

3. From the drop-down Service list box, choose Cisco CallManager (Active) as the service.

4. The Cisco CallManager Service Parameters Configuration window displays.

5. Scroll down to Clusterwide Parameters (System - Location and Region) and configure the parameters in this section.

6. Click the Save icon that displays in the tool bar in the upper, left corner of the window (or click the Save button that displays at the bottom of the window).

Use the following procedure to add or update a region.

Procedure


Step 1 Choose System > Region.

The Region Configuration window displays.

Step 2 Perform one of the following tasks:

To add a new region, click the Add New button and continue with Step 3.

To update an existing region, locate the appropriate region as described in the "Finding a Region" section and continue with Step 3.


Note Cisco Unified CallManager recommends that you reset devices after changing a region name.


Step 3 In the Region Name field, enter the name that you want to assign to the region.

Step 4 To save the new region in the database, click the Save icon that displays in the tool bar in the upper, left corner of the window (or click the Save button that displays at the bottom of the window).

Step 5 To configure the default codecs to use within this region, click the region name to highlight it in the Regions window pane.

a. From the Audio Codec drop-down list box, choose a default audio codec value to use within this region.

The audio codec determines the type of compression and the maximum amount of bandwidth that is allocated for these calls. See Table 7-2 for a summary of the available codec types and bandwidth usage.

b. In the Video Call Bandwidth column, click the appropriate radio button to configure the default value to specify the video bandwidth to use for video calls within this region.

If you specify None, the system does not allow video calls.


Note For enhanced scalability, Cisco recommends that you properly set the default values in the Cisco Unified CallManager Administration Service Parameters Configuration window for both the audio codec and the video call bandwidth values and then choose the Default settings in the Cisco Unified CallManager Administration Region Configuration window.


Step 6 To configure the default codecs to use between this region and other regions, click another region name (other than this region) to highlight it in the Regions window pane.

a. From the Audio Codec drop-down list box, choose a default audio codec value to use between this region and the region that you highlighted.

The audio codec determines the type of compression and the maximum amount of bandwidth that is allocated for these calls. See Table 7-2 for a summary of the available codec types and bandwidth usage.

b. In the Video Call Bandwidth column, click the appropriate radio button to configure the default value to specify the video bandwidth to use for video calls between this region and the region that you highlighted.

If you specify None, the system does not allow video calls between this region and the specified region.


Note For enhanced scalability, Cisco recommends that you properly set the default values in the Cisco Unified CallManager Administration Service Parameters Configuration window for both the audio codec and the video call bandwidth values and then choose the Default settings in the Cisco Unified CallManager Administration Region Configuration window.


Step 7 To save the new region in the database, click the Save icon that displays in the tool bar in the upper, left corner of the window (or click the Save button that displays at the bottom of the window).



Tip The Region Configuration window displays an Items per page drop-down list box that allows you to list 25, 50, 100, 150, 200, or 250 configured regions. If you choose to display 100 or more regions, Cisco Unified CallManager may experience performance degradation.


Next Step

After adding a new region to the database, you can use it to configure device pools. Devices acquire a region setting from the device pool to which they are assigned. See the "Configuring a Device Pool" section for information on configuring device pools.

Additional Information

See the "Related Topics" section.

Region Configuration Settings

Table 7-1 summarizes the audio codec and video call bandwidth settings that can be specified for regions. For related procedures, see the "Related Topics" section.

Table 7-1 Region Configuration Settings 

Field
Description
Region Information

Name

Enter a unique name for this region. This name can comprise up to 30 characters. Valid characters include letters, numbers, dashes, dots (periods), blanks, and underscores.


Note Cisco Unified CallManager recommends that you reset devices after changing a region name.


Region Relationships
Modify Relationship to Other Regions

Regions

The entries in this column specify all existing regions, including the Default region, the region that you are configuring, and all other regions.

Audio Codec

For each region that is specified in the Regions window pane, choose the corresponding value from the drop-down list box in this column to set the audio codec to use for calls within this region and between this region and the specified region. To choose the default setting, click the Defaults radio button.

Cisco recommends that you choose the Default settings that you configured in the Cisco Unified CallManager Administration Service Parameters Configuration window. See the "Configuring Default Values" section.

Because of bandwidth constraints at most remote-site deployments, use G.729 as the recommended default codec setting between a new region and existing regions.

Video Call Bandwidth

For each region that is specified in the Regions window pane, click one radio button in this column as specified:

Use System Default—Click this button to use the default value. The default value normally specifies 384 kbps, unless the default value has been set to a different value in the Service Parameters Configuration window.

None—Click this radio button if no video call bandwidth is allotted between this region and the specified region.

kbps—Click this button to allot video call bandwidth between this region and the specified region. Enter the bandwidth that is available for each video call between these two regions. Valid values range from 1 to 8128.


The total bandwidth that is used per call stream depends on the audio codec type as well as factors such as data packet size and overhead (packet header size). The bandwidth figures shown in Table 7-2 apply for 30-ms data packets and include IP headers. Each call comprises two call streams.


Note The codecs specified in Table 7-2 correlate to an approximate bandwidth usage per call. For information on bandwidth usage for each codec, refer to Cisco Unified Communications Solution Reference Network Design (SRND) for the current release of Cisco Unified CallManager.


Table 7-2 Bandwidth That Audio Codecs Use 

Audio Codec
Bandwidth Used Per Call (Including IP Headers) With 30-ms Data Packets
Description

G.711

80 kbps

This codec represents the default codec for all Cisco Unified CallManager calls.

G.722

80 kbps

Video endpoints typically prefer this codec.

G.723

24 kbps

The system supports this low-bit-rate codec for use with older Cisco IP Phone model 12 SP Series and Cisco IP Phone model 30 VIP.

G.728

16 kbps

Video endpoints support this low-bit-rate codec.

G.729

24 kbps

The system supports this low bit-rate codec for Cisco Unified IP Phone 7900 models.

Wideband

272 kbps

The system supports this high-quality, high-bandwidth audio codec for IP-phone to IP-phone calls that the Cisco Unified IP Phone 7900 models support.

GSM

29 kbps

The Global System for Mobile Communications (GSM) codec enables the MNET system for GSM wireless handsets to interoperate with Cisco Unified CallManager.


Deleting a Region

This section describes how to delete a region from the Cisco Unified CallManager database.

Before You Begin


Note You cannot delete a region that any device pools are using.


To find out which device pools use the region, choose Dependency Records from the Related Links drop-down list box on the Region Configuration window and click Go.

If the dependency records feature is not enabled for the system, the dependency records summary window displays a message that shows the action that you can take to enable the dependency records; the message also displays information about high CPU consumption that is related to the dependency records feature. For more information about dependency records, see the "Accessing Dependency Records" section on page A-2.

If you attempt to delete a region that is in use, Cisco Unified CallManager displays an error message. Before deleting a region that is currently in use, you must perform either or both of the following tasks:

Update the device pools to use a different region. See the "Configuring a Device Pool" section.

Delete the device pools that use the region that you want to delete. See the "Deleting a Device Pool" section.

Procedure


Step 1 Find the region by using the procedure in the "Finding a Region" section.

Step 2 From the list of matching records, choose the region that you want to delete.

Step 3 Click the Delete Selected Item icon that displays in the tool bar in the upper, left corner of the window (or click the Delete Selected button that displays at the bottom of the window) to delete the region.



Tip The Region Configuration window displays an Items per page drop-down list box that allows you to list 25, 50, 100, 150, 200, or 250 configured regions. If you choose to display 100 or more regions, Cisco Unified CallManager may experience performance degradation.


Additional Information

See the "Related Topics" section.

Related Topics

Region Configuration

Finding a Region

Configuring a Region

Region Configuration Settings

Deleting a Region