Show 

Home > Configuring PowerMedia XMS > MSML

MSML

The MSML interface uses SIP INFO messages to send MSML script payloads. The MSML menu is viewable only when logged in as superadmin, and is only available when PowerMedia XMS is in MSML mode. When PowerMedia XMS is in Native mode, the MSML menu is hidden. Refer to the Mode page from the System menu for information about switching modes.

The MSML menu contains tabbed pages, MSML Configuration, MSML Advance Configuration, and MSML CPA Configuration.

MSML Configuration

msml_configuration.png

Proceed as follows to configure the MSML Configuration parameters:

Parameter

Description

Action

MSML Protocol General

MSML Version

Specifies the MSML version used by the media server.

Use the drop-down list to select the value. Valid values are:

  • 1.0

  • 1.1 (default)

Content Type

Specifies the MSML control package content type.

Use the drop-down list to select the value. Valid values are:

  • xml  (default)

  • msml-xml

Encoding

Specifies XML encoding.

Use the drop-down list to select the value. Valid values are:

  • utf_8 (default)

  • us_ascii

Schema Validation

Controls activation of the XML validation of the media control message body. Validation is performed based on the msml.xsd XML schema definition file.

Note: This parameter is MIPs intensive and is recommended during application development and troubleshooting, and not for normal operation.

Click the check box to enable or disable.

Schema Validation is disabled by default.

Media Parameters

HTTP Caching

Controls a caching mechanism to improve performance when servicing network and remote file operations.

Click the check box to enable or disable.

HTTP Caching is disabled by default (does not perform caching; all network requests result in remote access).

Conferencing Parameters

Enable AGC By Default

Enables automatic gain control.

Click the check box to enable or disable AGC by default.

The default value is disable.

Video

Fast Update

Specifies the control method for receiving a video fast update request.

Use the drop-down list to select the value. Valid values are:

  • info (default, request sent in INFO message)

  • disable

Bandwidth Modifier (kbps)

Specifies the bandwidth modifier in kilobits per second.

Use the drop-down list to select the value. Valid values are 48, 64, 128, 256, 400, 512, 800, 1024, 2048, 4096.

The default value is 512 kbps.

Audio

Default AMR Alignment

Specifies the default adaptive multi-rate alignment.

Use the drop-down list to select the value. Valid values are:

  • BANDWIDTH_EFFICIENT

  • OCTET_ALIGNED


Click Apply to save changes.

Note: The system services must be restarted for the changes to take effect.

MSML Advance Configuration

msml_advance_configuration.png

Proceed as follows to configure the MSML Advance Configuration parameters:

  1. In the Adapter Port field, enter the adapter port which is used for communication between the MSML interface layer and the media engine.

  2. To enable Clear Digit Buffer, click the check box.

  3. To enable DTMF Start Timer, click the check box.

  4. In the DTMF Detection Mode field, use the drop-down list to select the value. Valid values are: RFC2833 or IN-BAND.

  5. To enable Advance Digit Pattern, click the check box.

  6. In the DNS Cache Timeout field, enter the number of seconds DNS entry remains in DNS cache. Set it as 0 to disable DNS caching. Set it as -1 to leave entries in DNS cache forever. Default value: 60.

  7. To enable SSL Certificate Validation, click the check box to turn on validation and verify that the HTTP server’s certificate is signed by the certificate authority (CA) identified in the certificate bundle.

  8. To enable SSL Certificate Host Name Validation, click the check box to turn on validation and verify that the host name specified in a play/record URI matches the name in certificate’s "Common Name" or "Subject Alternate Name" fields.

  9. Click Apply to save changes.

Note: The system services must be restarted for the changes to take effect.

Add a CA Certificate to the CA Bundle

To add a CA certificate to the CA bundle, the user has to append the certificate to the following file on the PowerMedia XMS.

/etc/pki/tls/certs/ca-bundle.crt

Note: As of this release, managing CA certificates through the Console is not supported.

MSML CPA Configuration

msml_cpa_configuration.png

Add CPA Configuration

Perform the following steps to add a CPA configuration:

  1. On the MSML CPA Configuration page, click Add. The following dialog box appears:

  2. In the Name field, enter the name of CPA configuration.

  3. In the Continuous No Signal (ms) field, enter the maximum time of silence (no signal) allowed immediately after cadence detection begins. Default value: 40,000 ms.

  4. In the No Answer (ms) field, enter the length of time to wait after first ringback before deciding that the call is not answered. Default value: 30,000 ms.

  5. In the PAMD Fail Time (ms) field, enter the maximum time to wait for positive answering machine detection or positive voice detection after a cadence break. Default value: 4,000 ms.

  6. Click Apply to save changes.

Note: The system services must be restarted for the changes to take effect.

Delete a CPA Configuration

Perform the following steps to delete a CPA configuration:

  1. Click in the check box to the left of the CPA configuration you wish to delete.

  2. Once you select the CPA configuration, click Delete.