.. _configure-locations: Locations ----------- .. tip:: :ref:`use-action-search-to-navigate-automate` Overview ............ 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 CUCM to manage call admission control. Sites are used by VOSS Automate to logically group resources. Add locations on CUCM ........................ This procedure adds CUCM locations. 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 CUCM on which you are configuring the location. 4. Choose an option: * Logged in as Provider or Reseller admin? Go to (CUCM) **Locations**. * Logged in as Customer admin? Go to (Advanced) **Locations**. 5. Click the Plus icon (+) to add a new record. 6. On the **Location Information** tab, fill out the name of the location. 7. Select the **Intra-Location** tab, and complete at minimum, the mandatory :ref:`intra-location-fields`. 8. Select the **Between Locations** tab, and complete at minimum, the mandatory :ref:`between-locations-fields`. 9. Select the **RSVP Settings** tab, and complete at minimum, the mandatory :ref:`rsvp-settings-fields`. 10. Click **Save**. .. _intra-location-fields: Intra-Location settings '''''''''''''''''''''''''' .. 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 settings '''''''''''''''''''''''''''' .. 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 '''''''''''''''' .. 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. | +--------------+---------------------------------------------------------+