Real-Time Communications (rtcomm)

Defines the configuration that is related to the Rtcomm feature and all its related components. All the real-time capabilities associated with the Rtcomm feature are configured under this single entity.

Attribute name Data type Default value Description
alternateEndpointRoutingEnabled boolean false Enables the alternate endpoint routing option. Administrators that want to control endpoint routing must enable this option.
messageServerHost string localhost The host of the MQTT broker. The specified host can be an IP address or domain name server (DNS) hostname.
messageServerPort int 1883 The port the MQTT broker listens on. The port is any valid port number.
rtcommTopicPath string /rtcomm/ The MQTT topic path that is associated with this feature. All Rtcomm topic names configured within Rtcomm Options are prepended with this path. To create a unique name space for this Rtcomm instance within a message broker, modify this path to be unique.
sharedSubscriptionPath string   Specifies the shared subscription path that is prepended to the topic path. This path is required by message brokers when using shared subscriptions.
sslEnabled boolean false Uses SSL between the Rtcomm feature and the MQTT broker.
sslRef A reference to top level ssl element (string).   ID of the SSL configuration to be used to connect to the SSL-enabled MQTT broker.
callQueue
Description: Defines a single instance of a call queue. This instance fully encapsulates all the configuration related to a single queue.
Required: false
Data type:
Attribute name Data type Default value Description
callQueueID string callQueueID The name that is associated with the call queue topic. This is the destination endpoint ID that a caller uses to call into a specific queue.
description string   Specifies the description of this call queue instance. This description is returned in service query responses and can be used to better inform the client about the queue.
id string   A unique configuration ID.
timeout A period of time with second precision 600s The number of seconds to wait before terminating a call that is waiting in this queue. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), or seconds (s). For example, specify 30 seconds as 30s. You can include multiple values in a single entry. For example, 1m30s is equivalent to 90 seconds.
gateway
Description: A WebRTC gateway that provides connectivity from Rtcomm to SIP networks
Required: false
Data type:
Attribute name Data type Default value Description
allowFromSipEndpointRef List of references to top level sipEndpoint elements (comma-separated string). defaultSipUAEndpoint List of SIP endpoints for this connector.
externalPR string   Host:port address of a SIP Proxy/Registrar. If assigned, all outgoing SIP messages are forwarded to this address
sipContainer boolean false Outgoing SIP messages are routed to SIP applications installed locally
gateway > allowFromSipEndpoint
Description: List of SIP endpoints for this connector.
Required: false
Data type:
Attribute name Data type Default value Description
bindRetries int 60 The number of retries that are attempted when port binding is unsuccessful.
bindRetryDelay A period of time with millisecond precision 5000ms The delay between retries in milliseconds. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
host string localhost The IP of the endpoint host
id string   A unique configuration ID.
sipTCPPort int 5060 The TCP port number
sipTLSPort int 5061 The TLS port number
sipUDPPort int 5060 The UDP port number
sslOptionsRef A reference to top level sslOptions element (string).   Defines SSL protocol settings
tcpOptionsRef A reference to top level tcpOptions element (string). defaultTCPOptions Defines TCP protocol settings
gateway > allowFromSipEndpoint > sslOptions
Description: Defines SSL protocol settings
Required: false
Data type:
Attribute name Data type Default value Description
sessionTimeout A period of time with second precision 1d Amount of time to wait for a read or write request to complete on a socket. This value is overridden by protocol-specific timeouts. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), or seconds (s). For example, specify 30 seconds as 30s. You can include multiple values in a single entry. For example, 1m30s is equivalent to 90 seconds.
sslRef A reference to top level ssl element (string).   The default SSL configuration repertoire. The default value is defaultSSLSettings.
sslSessionTimeout A period of time with millisecond precision 8640ms The timeout limit for an SSL session that is established by the SSL Channel. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
suppressHandshakeErrors boolean false Disable logging of SSL handshake errors. SSL handshake errors can occur during normal operation, however these messages can be useful when SSL is behaving unexpectedly.
gateway > allowFromSipEndpoint > tcpOptions
Description: Defines TCP protocol settings
Required: false
Data type:
Attribute name Data type Default value Description
inactivityTimeout A period of time with millisecond precision 60s Amount of time to wait for a read or write request to complete on a socket. This value is overridden by protocol-specific timeouts. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
soReuseAddr boolean true Enables immediate rebind to a port with no active listener.
iceServerURL
Description: Specifies the Interactive Connectivity Establishment (ICE) Server URL(s) available for client use. The client can request the list of ICE Server URL(s) for use with WebRTC by using an Rtcomm service query. This following is an example format for an ICE Server URL: - stun:hostname:port.
Required: false
Data type: string

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_config_rtcomm
File name: rwlp_config_rtcomm.html