MCU 5310
connect to the company website
Search/Print  Help contents
You are here:

Configuring H.323 endpoints

You can configure H.323 endpoints to work with the MCU by choosing Endpoints > Add H.323. This makes it easier to add endpoints to conferences because you can select names from a list rather than adding network addresses.

A Cisco TelePresence IP VCR can be configured as an H.323 endpoint and added as a participant in a conference. If the IP VCR is configured to do so, it will start recording as soon as the conference starts. You can also configure a folder's Recording ID as an endpoint and in this way, when a conference starts, the IP VCR can start recording directly into a specific folder. For more information about using the IP VCR in this way, refer to the IP VCR's online help.

Recordings on an IP VCR can be configured as H.323 endpoints. In this way, an audio-only participant can contribute an IP VCR recording as his video stream (using the associated endpoint function, see Adding and updating users). This function is also useful where you have a recording that you might like to view within a conference.

Refer to the table below for tips on adding an H.323 endpoint to the MCU. After entering the settings, click Add endpoint.

Display parameters

Field Field description Usage tips
Name

The name of the endpoint.

 

Call-out parameters

Field Field description Usage tips
Address

The IP address, host name, or an E.164 address (phone number).

Redial behavior

Defines whether and how the MCU will redial this endpoint if the connection fails:

  • <use box-wide setting>
    This preconfigured participant inherits the redial behavior setting that the MCU uses by default for all preconfigured participants. This option is not available when you are configuring ad hoc participants.
  • Never redial
    The MCU never attempts to redial a failed connection to this participant.
  • Redial until connected
    The MCU redials this participant if it fails unexpectedly when first establishing a connection; the MCU never retries the connection if it fails after being established.
  • Redial on unexpected disconnection
    The MCU redials this participant on any unexpected disconnection, whether it occurs while first being established or at any point thereafter. It does not attempt to redial if the participant deliberately ends the connection.

    Note: A deliberate disconnection, if it is not correctly signaled by the endpoint, may be interpreted as unexpected. If you experience this, reduce the call persistence behavior for the affected endpoint.

  • Redial on any disconnection
    The MCU redials this preconfigured participant when the connection closes, irrespective of whether the call fails or is deliberately ended by the participant.

This setting defines redial behavior for an individual participant, which overrides the box-wide setting.

Redial limit Enables or disables the redial limit for this endpoint, and overrides the corresponding box-wide setting.

The redial limit allows the MCU to stop trying to reconnect a failed call. When the limit is enabled, the MCU will attempt to reconnect up to ten times: once immediately after the connection failure; four times at one minute intervals thereafter, and once every five minutes for a further five attempts.

When the redial limit is disabled, the MCU continues retrying - once every five minutes - after those first ten attempts. It will do this until the connection is made. If the connection is never made, the MCU continues retrying until either the conference or the participant is destroyed.

The redial pattern has an initial delay when the redial behavior is set to Redial on any disconnection. With that setting, the MCU does not immediately redial after a deliberate disconnection - it waits 30 seconds.

DTMF sequence

The DTMF sequence to send to an endpoint after it answers the call.

The sequence may be up to 127 characters long and may include digits 0-9 and the following characters: * (star), # (pound/hash), and , (comma). The comma represents a two second pause.

There is always a two second pause after the call connects, after which the MCU will send the DTMF tones at a rate of two per second. You can insert as many two second pauses as you need by inserting commas into the DTMF sequence. Leading and trailing commas are supported.

This sequence enables the MCU to navigate through an audio menu. This is useful where a conference on the MCU dials out to an audio-only conference on an audio bridge.

You can configure the audio bridge as a pre-configured endpoint (either H.323 or SIP) and specify the DTMF sequence which will than be used whenever the bridge is added to any conference. Alternatively, you can add the audio bridge as an ad hoc participant to an individual conference.

For example, assume you want the MCU to dial out to a PIN-protected audio conference on an audio bridge. The conference ID is 555 and the PIN is 888. The audio bridge requires that you press # after entering the ID and after entering the PIN. In this example the DTMF sequence could be: 555#,,888#. The two commas represent a four second pause which allows the audio bridge's automated menu system time to process the ID and request the PIN.

Suppress audio during DTMF

Suppresses the audio stream while initial DTMF connection sequence is being sent, so that other conference participants do not hear the audio of this participant or interactive voice responders reacting to the tones.

Outgoing only suppresses the audio to the endpoint while DTMF tones are sent to the endpoint.

All also suppresses both incoming and outgoing audio for the participant while the initial DTMF sequence is being sent to the endpoint.

This setting is independent of other audio muting mechanisms. Audio suppression is active for the duration of the DTMF tone sequence, including any deliberate pauses (commas in the DTMF sequence).

Call-in match parameters

Field Field description Usage tips
Name

This must be the name that the endpoint sends to the MCU

The endpoint is recognized if all filled-in fields in this section are matched. Fields left blank are not considered in the match.

When you configure Call-in match parameters, an endpoint will be recognized as this pre-configured endpoint and the Conferencing parameters will be applied to a call from this endpoint.

Note: call-in matching is not supported for the H.323 ID.

IP address
  • The IP address of the endpoint
  • E.164 The E.164 number with which the endpoint is registered with the gatekeeper

    Conferencing parameters

    Display name override

    The name that is displayed in a conference as a label on the video from this endpoint. It is also the name of the endpoint as it appears on the MCU's web interface.

    The display name override is used in place of any identifier that appears on the endpoint's video or in the MCU's web interface. The endpoint could otherwise be identified by its H.323 id, its E.164 number, or its IP address.

    If you use only non-printing characters, such as spaces, as a display name override, the MCU respects this 'blank' name as a label for video from this endpoint. In this case, the MCU does not show the non-printing override value when listing the endpoint in the web interface; it shows one of the endpoint's other identifiers instead.

    Note that once an endpoint has connected, you cannot change the display name via the web interface.

    Motion / sharpness trade off

    Choose whether to use the MCU-wide setting for motion/sharpness trade off, or configure an individual setting for this endpoint. Select from:

    • Use box-wide setting: this is the default value. In this case, the endpoint will use the motion/sharpness tradeoff setting from the Settings > Conferences page
    • Favor motion: the MCU favors motion over sharpness; that is, it will try and use a high frame rate at the cost of lower resolution. The MCU will choose a resolution that allows for a framerate of 25 frames per second or higher.
    • Favor sharpness: the MCU favors sharpness over motion; it will use the highest resolution that is being sent in (by any endpoint), and adjust downwards, to their highest advertised resolution, for other endpoints if necessary.
    • Balanced: the MCU will select settings that balance resolution and frame rate (where the frame rate will not be less than 12 frames per second)

    The settings for motion (frames per second) and sharpness (frame size or resolution) are negotiated between the endpoint and the MCU. This setting controls how the MCU will negotiate the settings to be used with this endpoint.

    Transmitted video resolutions

    Choose the setting for transmitted video resolutions from the MCU to this endpoint. This setting overrides the MCU-wide setting on the Settings > Conferences page.

    Retain the default setting (use box-wide setting) unless you are experiencing problems with the display of certain resolutions by this endpoint.

    Endpoints advertise the resolutions that they are able to display. The MCU then chooses from those advertised resolutions, the resolution that it will use to transmit video. However, some endpoints do not display widescreen resolutions optimally. Therefore, you might want to use this setting to restrict the resolutions available to the MCU for transmissions to this endpoint.

    Content contribution

    Whether this endpoint is permitted to contribute the conference content channel. Select from:

    <use conference default>: this endpoint will use the Content contribution from endpoints setting from the per-conference configuration.

    Enabled: This endpoint is allowed to contribute the content channel, even if content contribution from endpoints is disabled in the per-conference configuration.

    Disabled: This endpoint is not allowed to contribute the conference channel, even if content contribution from endpoints is enabled in the per-conference configuration.

    This setting is provided to allow you to individually configure whether or not an endpoint is allowed to contribute content to a conference.

    To use the content channel, the Content status must be enabled at the MCU-wide level (on the Settings > Content page) and, for any given conference, Content mode must not be Disabled in the conference settings.

    Content receive

    Whether this endpoint is allowed to receive a separate content stream when in a conference.

    This setting is provided to allow you to individually configure whether or not an endpoint is allowed to receive content from a conference.

    To use the content channel, the Content status must be enabled at the MCU-wide level (on the Settings > Content page) and for any given conference Content channel video must also be enabled in the per-conference configuration.

    View border size

    Select a border size for video transmitted to this endpoint.

    This sets a border thickness to display around the video image. This is useful where the image is displaying off the edges of the participant's screen; use a border to force the image to display properly.

    Applying a border size here means that this border size will always be used for this endpoint's transmitted video. Note that you can also apply a border to a participant in a conference by going to Conferences and clicking on the name of the conference and then altering this participant's settings.

    Default view family

    Sets the layout family to be used when calling out to this endpoint.

    If this is set to Use box-wide setting then the default view family that has been configured via the Conference settings page will be used.

    Preferred bandwidth from MCU

    Identifies the network capacity (measured in bits per second) used by the media channels established by the MCU to a single participant.

    These settings take priority over the Default bandwidth from MCU setting configured in the global conference settings.

    Preferred bandwidth to MCU

    The maximum combined media bandwidth advertised by the MCU to endpoints.

    These settings take priority over the Default bandwidth to MCU setting configured in the global Conference settings (see Conference settings).

    Layout control via FECC / DTMF Whether this endpoint is able to change their view layout via far-end camera control (FECC) or DTMF tones. Choose from:
    • use conference configuration: the setting for Layout control via FECC / DTMF will be determined by the configuration of the conference
    • Disabled: the participant using this endpoint will not be allowed to change their view layout using either FECC or DTMF. This option also prevents the user from changing layout with the in call menu.
    • FECC only: the participant using this endpoint will be allowed to change their view layout using FECC
    • DTMF only: the participant using this endpoint will be allowed to change their view layout using DTMF
    • FECC with DTMF fallback: the participant using this endpoint will be allowed to change their view layout using FECC. If FECC is not available, this participant will be able to use DTMF
    • FECC and DTMF: the participant using this endpoint will be allowed to change their view layout using either either FECC or DTMF, rather than only using DTMF as a fallback.

    This setting takes precedence over the per-conference layout control setting for conferences into which the endpoint is invited.

    This layout control setting does not govern layout control using the in call menu. The setting governs layout control using the endpoint's DTMF or FECC controls while the user is not using the menu.

    Send camera control to other participants

    Specifies whether FECC or DTMF from this participant may control a far end camera. This setting combines with layout control via FECC/DTMF to control the camera of the far end and the layouts of the conference. This setting overrides the global conference setting for this endpoint.

    • Disabled: This participant will not be allowed to control a far end camera using either FECC or DTMF.
    • FECC only: This participant will be only be allowed to control a far end camera using FECC.
    • DTMF only: This participant will be only be allowed to control a far end camera using DTMF.
    • FECC with DTMF fallback: This participant will be allowed to control a far end camera using FECC. If FECC is not available, this participant will be able to use DTMF for camera control.
    • FECC and DTMF: This participant will be allowed to control a far end camera using either FECC or DTMF.

    There are two control mechanisms, FECC and DTMF, either (or both) of which can be used for camera control or layout control. If one mechanism is allowed for camera control but not for layout control, then that mechanism only controls the far end camera and does not affect the layout. Similarly, if one mechanism is allowed for layout control but not for camera control, then it is not possible to control the camera with that mechanism. In these cases, the endpoint can use FECC or DTMF controls directly to change the layout or adjust the far end camera.

    When one control mechanism can control either the layout or the far end camera, then that mechanism will always control the layout until "Zoom in" (FECC mechanism) or �1� (DTMF mechanism) is pressed. The control mechanism then switches over to control the camera.

    Far-end camera control always applies to the camera of the participant shown in the largest or top left pane (when panes are the same size). If you have no way to control the layout, then you cannot focus on a participant to allow you to adjust a particular camera.

    Mute in-band DTMF

    Use this option to mute in-band DTMF from this endpoint. Choose from:

    • use conference configuration: the setting for Mute in-band DTMF will be determined by the configuration of the conference
    • Never: the in-band DTMF from this endpoint will never be muted. Any DTMF tones sent from this endpoint will be audible to conference participants
    • Always: the in-band DTMF from this endpoint will always be muted. Any DTMF tones sent from this endpoint will not be audible to conference participants
    • When used for MCU control: if a participant is using in-band DTMF to control conference layout and for other in-conference features, the tones will be muted and will not be audible to conference participants. The MCU will only expect a participant to use DTMF for MCU control if Layout control via FECC / DTMF or Send camera control to participants is set to DTMF only, FECC and DTMF, or FECC with DTMF fallback and FECC has not been established, or if the participant is able to use the in call menu.

    In some scenarios, where a conference is cascaded onto an audio bridge, it might be useful for one of the participants in that conference to be able to send in-band DTMF to the MCU. This is for the purposes of sending the conference ID or PIN to the audio conferencing bridge. In this case, the Mute in-band DTMF setting for the endpoint of that participant needs to be Never. However, you can instead send DTMF tones to the audio conferencing bridge directly from the MCU; for more information refer to Sending DTMF to an audio bridge.

    Unless you need to configure a particular setting for this endpoint, set this to use conference configuration and ensure you have the Mute in-band DTMF setting as required in the conference configuration (see Adding and updating conferences).

    This setting takes precedence over the per-conference Mute in-band DTMF setting for conferences into which the endpoint is invited.

    Appear as a recording device

    When this setting is enabled, the red recording indicator dot is visible to other conference participants.

    This participant is labeled as a recorder on the conference participants page.

    Video to use by default

    Allows you to replace this participant's video with that of another participant. Select <self> (default value) to display this participant's own video by default.

    If you select another preconfigured endpoint from the dropdown, the MCU will no longer use this participant's own video by default: instead, it will use the video stream from the selected endpoint in most circumstances, for example when this participant becomes the active speaker.

    If the selected Video to use by default is not available, the MCU will use this participant's own video if possible.

    If the selected Video to use by default is available, you can still show this participant's own video if you need to by explicitly choosing it in specific layout pane selections.

    Dial out as

    Determines whether this participant is a chair or a guest when in automatic lecture mode.

     

    Initial audio to MCU

    Select Active or Muted to define whether audio from this endpoint should be muted whenever it first joins a conference.

    If this is Muted, then the MCU will mute the stream whenever it successfully invites the endpoint or recognizes the endpoint when it calls in.

    Audio from preconfigured endpoints can also be muted by the conference's Mute on join configuration, but only when they call in. In that case, if either the conference's Mute on join checkbox for Audio is checked, or the endpoint's Initial audio to MCU is Muted (or both) then the audio from the endpoint is muted when it joins the conference.

    Initial video to MCU

    Select Active or Stopped to define whether video from this endpoint should be stopped whenever it first joins a conference.

    If this is Stopped, then the MCU will stop the stream whenever it successfully invites the endpoint or recognizes the endpoint when it calls in.

    Video from preconfigured endpoints can also be muted by the conference's Mute on join configuration, but only when they call in. In that case, if either the conference's Mute on join checkbox for Video is checked, or the endpoint's Initial video to MCU is Muted (or both) then the video from the endpoint is stopped when it joins the conference.

    Initial audio from MCU

    Select Active or Muted to define whether audio to this endpoint is muted whenever it first joins a conference.

    Note: The endpoint may not always detect DTMF tones from the MCU after you mute the audio from the MCU.

    Initial video from MCU

    Select Active or Stopped to define whether video to this endpoint is stopped whenever it first joins a conference.

    Initial Adaptive Gain Control Defines whether or not the endpoint uses Adaptive Gain Control (AGC) when it first joins the conference. Select <use conference configuration> to inherit the setting from the conference. Otherwise, you can select Enabled or Disabled to override the conference-wide AGC setting.

    Any manual changes to the participant volume will turn AGC off for that participant. You can also manually enable or disable AGC for a participant that is already in the conference, on the Conference > Participants > <Name> > Audio page.

    Automatic disconnection

    When a participant disconnects from a conference and only endpoints set to Automatic disconnection are left, all those participants are disconnected.

    Set to enabled if you want this endpoint to be automatically disconnected from conferences when only endpoints set to Automatic disconnection remain in a conference when any other participant has disconnected.

    Note that this setting is useful where you have configured an IP VCR as an endpoint so that the IP VCR can be automatically called into a conference to record the session. In this case, the IP VCR will stop recording when the conference ends (that is, when everyone has left the conference). For more information about using the IP VCR in this way, refer to the IP VCR online help.

    Advanced interoperability parameters

    Field Field description Usage tips
    Content negotiation

    This field allows the MCU to be configured so that content can be exchanged with third party MCUs in multi-level cascaded conferences over H.323. Choose from:

    • As master: The MCU only acts as master in H.239 token negotiation.
    • As slave: The MCU acts as the slave in H.239 token negotiation and can send content to a master unit if it accepts the token request.
    • Mimic slave: The MCU mimics a slave during H.239 token negotiation, but does not actually act as a slave. The MCU still tries to send content to all other endpoints/units even if the third party MCU rejects the token request.

    When exchanging content with an endpoint in a H.323 call, the MCU acts as a master unit and the endpoint as a slave unit for the purpose of H.239 token negotiation. However, in order for the MCU to exchange content with a cascaded third party MCU, the MCU must appear to the third party MCU to be a slave unit. The MCU can be configured as a true slave, in which case content will only be sent if the third party MCU master accepts the token request, or to mimic a slave (content is sent to all other connected endpoints even if the third party MCU rejects the token request).

    Note: MCU to MCU SIP cascading is not supported. When doing SIP to SIP cascading, the MCU's BFCP negotiation fails and the content appears in the main video instead of a separate channel.

    Custom codec selection

    Can be used to ensure only specific codecs are permitted on calls to (and received from) this endpoint.

    If Enabled, you can select which codecs are allowed to be used when communicating with this endpoint. This setting overrides the MCU-wide codec selection on the Settings > Conference page.

    Related topics