.. _configure_locations: .. rst-class:: chapter-with-expand Configure Locations -------------------- This procedure adds locations. Locations are used to implement call admission control in a centralized call-processing system. Call admission control enables you to regulate audio quality and video availability by limiting the amount of bandwidth that is available for audio and video calls over links between the locations. .. Important:: Locations are different to sites. Locations are used by Cisco Unified CM to manage call admission control. Sites are used by VOSS Automate to logically group resources. **Perform these steps**: 1. Log in as provider, reseller, or customer administrator. 2. Set the hierarchy path to a customer or site level. 3. If prompted, select the NDL that contains the Cisco Unified CM on which you are configuring the location. 4. Navigate to Locations: * If you're logged in a provider or reseller administrator, choose **Device Management > CUCM > Locations**. * If you're logged in as customer administrator, choose **Device Management > Advanced > Locations**. 5. Click **Add**. 6. On the **Location Information** tab, enter the **Name** of the Location. This field is mandatory. 7. Click the **Intra-Location** tab, and complete at minimum, the mandatory :ref:`intra_location_fields`. 8. Click the **Between Locations** tab, and complete at minimum, the mandatory :ref:`between_locations_fields`. 9. Click the **RSVP Settings** tab, and complete at minimum, the mandatory :ref:`rsvp_settings_fields`. 10. Click **Save**. .. _intra_location_fields: Intra-Location Fields ..................... .. tabularcolumns:: |p{3.5cm}|p{12cm}| +-----------------+--------------------------------------------------+ | Field | Description | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of audio bandwidth (in | | | kb/s) that is available for all audio calls on | | | the link between this location and other | | | locations. For audio calls, the audio bandwidth | | Audio | includes overhead. Valid values are 0 to | | Bandwidth | 2147483647, where 0 means unlimited bandwidth. | | | This field is mandatory. | | | | | | Note: To improve audio quality, lower the | | | bandwidth setting, so fewer active calls are | | | allowed on this link. | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of video bandwidth (in | | | kb/s) that is available for all video calls on | | | the link between this location and other | | | locations. For video calls, the video bandwidth | | Video | does not include overhead. Valid values are 1 | | Bandwidth | | | | Valid values are 1 through 2147483647, where | | | 0 means unlimited bandwidth and 1 means no | | | bandwidth. Setting the value to 1 means you | | | cannot make video calls within this location. | | | This field is mandatory. | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of immersive video | | | bandwidth (in kb/s) that is available for all | | | immersive video calls on the link within this | | | location. For video calls, the immersive video | | Immersive Video | bandwidth does not include overhead. | | Bandwidth | | | | Valid values are 1 through 2147483647, where 0 | | | means unlimited bandwidth and 1 means no | | | bandwidth. Setting the value to 1 means you | | | cannot make immersive video calls within this | | | location. This field is mandatory. | +-----------------+--------------------------------------------------+ .. _between_locations_fields: Between Locations Fields ........................ .. tabularcolumns:: |p{3.5cm}|p{12cm}| +-----------------+--------------------------------------------------+ | Field | Description | +-----------------+--------------------------------------------------+ | Location | Select a location from the list. This field is | | | mandatory. | +-----------------+--------------------------------------------------+ | | Enter the relative priority of this link in | | | forming the Effective Path between any pair of | | Weight | Locations. The Effective Path has the least | | | cumulative Weight of all possible paths. Valid | | | values are 0-100. This field is mandatory. | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of audio bandwidth (in | | | kb/s) that is available for all audio calls on | | | the link between this location and other | | Audio Bandwidth | locations. For audio calls, the audio bandwidth | | | includes overhead. | | | | | | Valid values are 0 to 2147483647, where 0 means | | | unlimited bandwidth. You can also select | | | Unlimited Bandwidth. This field is mandatory. | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of video bandwidth (in | | | kb/s) that is available for all video calls on | | | the link between this location and other | | | locations. For video calls, the video bandwidth | | | does not include overhead. | | Video Bandwidth | | | | Valid values are 1 through 2147483647, where 0 | | | means unlimited bandwidth and 1 means no | | | bandwidth. You can also select Unlimited | | | Bandwidth or None. Setting the value to **None** | | | means you cannot make video calls between this | | | location and other locations. This field is | | | mandatory. | +-----------------+--------------------------------------------------+ | | Enter the maximum amount of immersive video | | | bandwidth (in kb/s) that is available for all | | | immersive video calls on the link between this | | | location and other locations. For video calls, | | | the immersive video bandwidth does not include | | Immersive Video | overhead. | | Bandwidth | | | | Valid values are 1 through 2147483647, where 0 | | | means unlimited bandwidth and 1 means no | | | bandwidth. You can also select **Unlimited | | | Bandwidth** or **None**. Setting the value to | | | **None** means you cannot make immersive video | | | calls between this location and other locations. | | | This field is mandatory. | +-----------------+--------------------------------------------------+ .. _rsvp_settings_fields: RSVP Settings Fields .................... .. tabularcolumns:: |p{3.5cm}|p{12cm}| +--------------+---------------------------------------------------------+ | Field | Description | +--------------+---------------------------------------------------------+ | | To change the RSVP policy setting between the | | Location | current location and a location that displays in | | | this pane, choose a location in this pane. This | | | field is mandatory. | +--------------+---------------------------------------------------------+ | | To choose an RSVP policy setting between the | | | current location and the location that is chosen in | | | the Location pane at left, choose an RSVP setting | | | from the drop-down list. This field is mandatory. | | | | | | Choose from the following available settings: | | | | | | * **Use System Default** - The RSVP policy for the | | | location pair matches the clusterwide RSVP | | | policy. See topics related to clusterwide | | | default RSVP policy in the Cisco Unified | | | Communications Manager System Guide for details: | | | | | | * **No Reservation** - No RSVP reservations can get | | RSVP Setting | made between any two locations. | | | * **Optional (Video Desired)** - A call can proceed | | | as a best-effort audio-only call if failure to | | | obtain reservations for both audio and video | | | streams occurs. RSVP Agent continues to attempt | | | RSVP reservation and informs Cisco Unified | | | Communications Manager if reservation succeeds. | | | * **Mandatory** - Cisco Unified Communications | | | Manager does not ring the terminating device | | | until RSVP reservation succeeds for the audio | | | stream and, if the call is a video call, for | | | the video stream too. | | | * **Mandatory (Video Desired)** - A video call can | | | proceed as an audio-only call if a reservation | | | for the video stream cannot be reserved. | +--------------+---------------------------------------------------------+