In this section:
Use the Cns Group commands to configure call notification server (Cns) groups and clusters as part of the SBC's call notification feature. Refer to Sending Unsolicited Call Notifications to Application Servers for more information on the call notification feature.
Use the cnsGroupProfile
object to specify information on a group of up to 8 servers to receive call notifications. The profile also specifies how to distribute the notifications among the servers.
% set global servers cnsGroupProfile <profile name> cnsGroupData <sequence: 0 - 7> callNotifyTGId remoteAddress remotePort transport description loadDistribution <roundRobin | sequence> uri
cnsGroupProfile Parameters
Parameter | Length/Range | Description |
---|---|---|
| up to 23 characters | Specifies a name for the cns group profile. The profile can specify up to 8 servers as potential recipients of call notifications. |
| 0-7 | Specifies a sequence number for a server within the group. If the loadDistribution type is sequence , the SBC attempts to send call notifications to the servers in their specified sequence. |
| up to 23 characters | Specifies the trunk group through which the SBC sends call notifications. |
| up to 63 characters | Specifies an IP address or FQDN for the server to receive call notifications. |
| 0-65535 | Specifies the number of a port to send call notifications on the server. The range is 0 - 65535. The default is 5060. |
|
| Specifies the transport type to use for sending notifications to this server. Currently the only type is UDP. |
| up to 199 characters | Specifies an optional description of this cns group profile. |
|
| Specifies how to distribute call notifications among the servers in this group. The options are:
|
| up to 140 characters | Specifies the URI to use in the Request-URI of NOTIFY messages for this group of servers. |
Use the cnsGroupCluster
object as a container for cnsGroupProfiles
. The configuration of each individual callNotificationCriteria
object specifies a cnsGroupCluster
to specify which server or servers are the recipient of notifications when a call matches that particular set of criteria. Currently a cnsGroupCluster
can contain only one cnsGroupProfile
.
% set global servers cnsGroupCluster <cluster ID> cnsGroupClusterData <sequence: 0> cnsGroupId <CNS group profile name> description
cnsGroupCluster Parameters
Parameter | Length/Range | Description |
---|---|---|
| up to 23 characters | Specifies a name for the Cns group cluster. A Cns group cluster is included in call notification criteria to indicate the server(s) that should receive notifications when a call matches the criteria. |
| currently set to 0 | Specifies a sequence number for a Cns group profile in the cluster. Currently a Cns group cluster can include only one Cns group profile and the sequence is set to 0 by default. |
| up to 23 characters | Specifies the name of the Cns group profile to include in the cluster. |
| up to 199 characters | Specifies an optional description for the Cns group cluster. |
For command examples, refer to Configuring the SBC to Send Unsolicited Call Notifications to Application Servers.