SBC Configuration Syntax

This configuration contains the settings for Session Border Controller (SBC) monitoring.

Avaya SBC-E

The ADD ASBCE and DEFINE SNMP_NODE_PROFILE statements are used for each Avaya SBC-E device being monitored.

SUBSYS SBC

ADD ASBCE (<sbc-name>, ip=<ip-address>[, customer=<name>, site=<name>])
DEFINE SNMP_NODE_PROFILE (ip-address>, port=<snmp-port>, version={2c | 3}, authentication={YES | NO}, authProtocol={MD5 | SHA}, encryption={YES | NO}, encryptionProtocol={DES | 3DES | AES | AES128 | AES192 | AES256})

Syntax Elements

ADD ASBCE

<sbc-name>

Name of the Avaya SBC-E device.

ip=<ip-address>

IP address of the Avaya SBC-E device.

customer=<name>

(Optional) A customer name to associate with the SBC.

site=<name>

(Optional) A site name to associate with the SBC.

DEFINE SNMP_NODE_PROFILE

<ip-address>

The IP address of the Audiocodes SBC.

port=<snmp-port>

The port number used by SNMP. The default should be 161.

version={2c | 3}

The version of SNMP to run.

authentication={YES | NO}

Indicates if SNMP authentication is required, Yes or No (default is No).

authProtocol={MD5 | SHA}

SNMP authentication protocol to be used when authentication is required

encryption={YES | NO}

Indicates if SNMP encryption is required, Yes or No (default is No). Encryption is not possible without authentication.

encryptionProtocol= {DES | 3DES | AES | AES128 | AES192 | AES256}SNMP encryption protocol to be used when encryption is required. Please note that this parameter is case sensitive and the protocol needs to be added in 'UPPER CASE".

The SNMP password details are added through the PASSWORDS Configuration for Avaya SBC-E.

Audiocodes SBC

ADD AUDIOCODES and DEFINE SNMP_NODE_PROFILE statements are added for each Audiocodes SBC to be monitored.

SUBSYS SBC

ADD AUDIOCODES(<sbc-name>, ip=<ip-address>[, type=<sbc-type>, customer=<name>, site=<name>])
DEFINE CLI_PROFILE (sbc-name>, mode={ssh | telnet}, port=<n>)
DEFINE SNMP_NODE_PROFILE (<ip-address>, port=<snmp-port>, version={2c | 3}, authentication={YES | NO}, authProtocol={MD5 | SHA}, encryption={YES | NO}, encryptionProtocol={DES | 3DES | AES | AES128 | AES192 | AES256})

Syntax Elements

ADD AUDIOCODES

<sbc-name>

Name of the AudioCodes SBC.

ip=<ip-address>

IP address of the AudioCodes SBC.

type=<sbc-type>

(Optional) An AudioCodes SBC model number/type.

customer=<name>

(Optional) A customer name to associate with the SBC.

site=<name>

(Optional) A site name to associate with the SBC.

DEFINE CLI_PROFILE 

<sbc-name>Name of the AudioCodes SBC device.
mode={ssh | telnet}CLI communication method, either SSH or telnet. The default is SSH.
port=<n>

CLI port number. When a port number is not explicitly specified, it will default to 22 if the mode is SSH and will default to 23 if the mode is telnet.

DEFINE SNMP_NODE_PROFILE

<ip-address>

The IP address of the Audiocodes SBC.

port=<snmp-port>

The port number used by SNMP. The default should be 161.

version={2c | 3}

The version of SNMP to run.

authentication={YES | NO}

Indicates if SNMP authentication is required, Yes or No (default is No).

authProtocol={MD5 | SHA}

SNMP authentication protocol to be used when authentication is required

encryption={YES | NO}

Indicates if SNMP encryption is required, Yes or No (default is No). Encryption is not possible without authentication.

encryptionProtocol= {DES | 3DES | AES | AES128 | AES192 | AES256}SNMP encryption protocol to be used when encryption is required. Please note that this parameter is case sensitive and the protocol needs to be added in 'UPPER CASE".
The SNMP password details are added through the PASSWORDS Configuration for AudioCodes SBC.

Cisco Unified Border Element (CUBE)

ADD CUBE and DEFINE CLI_PROFILE statements are added for each CUBE device to be monitored.

SUBSYS SBC

ADD CUBE (<sbc-name>, ip=<ip-address>, customer=<name>, site=<name>)
DEFINE CLI_PROFILE (sbc-name>, mode={ssh | telnet}, port=<n>)
DEFINE SNMP_NODE_PROFILE (<ip-address>, port=<snmp-port>, version={2c | 3}, authentication={YES | NO}, authProtocol={MD5 | SHA}, encryption={YES | NO}, encryptionProtocol={DES | 3DES | AES | AES128 | AES192 | AES256})
ADD RADIUS_LISTENER (<sbc-name>:<ip-address>:<port>)
DEFINE RADIUS_PROFILE(<sbc-name>, localhost=<private-ip-address>[,port=<radius-port>])

Syntax Elements

ADD CUBE

<sbc-name>

Name of the Cisco Unified Border Element device.

ip=<ip-address>

The IP address of the signaling server.

customer=<name>

A customer name to associate with the SBC.

site=<name>

A site name to associate with the SBC.

DEFINE CLI_PROFILE

<sbc-name>

Name of the Cisco Unified Border Element device.

mode={ssh | telnet}

CLI communication method, either SSH or telnet. The default is SSH.

port=<n>

CLI port number. When a port number is not explicitly specified, it will default to 22 if the mode is SSH and will default to 23 if the mode is telnet.

DEFINE SNMP_NODE_PROFILE

<ip-address>

The IP address of the Cisco Unified Border Element.

port=<snmp-port>

The port number used by SNMP. The default should be 161.

version={2c | 3}

The version of SNMP to run.

authentication={YES | NO}

Indicates if SNMP authentication is required, Yes or No (default is No).

authProtocol={MD5 | SHA}

SNMP authentication protocol to be used when authentication is required

encryption={YES | NO}

Indicates if SNMP encryption is required, Yes or No (default is No). Encryption is not possible without authentication.

encryptionProtocol= {DES | 3DES | AES | AES128 | AES192 | AES256}SNMP encryption protocol to be used when encryption is required. Please note that this parameter is case sensitive and the protocol needs to be added in 'UPPER CASE".

ADD RADIUS_LISTENER

If any RADIUS Listeners are being used, then an additional ADD RADIUS_LISTENER statement is included for each Listener:

<sbc-name>

Name of the Cisco CUBE SBC.

ip=<ip-address>:<port>

IP address and port number of the RADIUS Listener. Default port: 1813.

DEFINE RADIUS_PROFILE

Use the RADIUS_PROFILE statement to define the local IP address to access the SBC when they are located behind a NAT environment.

<sbc-name>

Name of the Cisco Unified Border Element device.

localhost=<private-ip-address>

NAT private IP address of the RADIUS server.

port=<radius-port>

Port number of the RADIUS Listener (default port number is 1646)

The SNMP password details are added through the PASSWORDS Configuration for Cisco UBE.

Example:

The following example illustrates the configuration statement when a non-default telnet port is being used (992).

SUBSYS SBC

ADD CUBE (CUBE1, ip=10.1.1.20, customer=Acme, site=Sydney)
DEFINE CLI_PROFILE (CUBE1, mode=telnet, port=23)
ADD RADIUS_LISTENER (CUBE1:10.1.1.2:1813)
ADD RADIUS_LISTENER (CUBE1:10.1.1.6:1813)
DEFINE RADIUS_PROFILE (CUBE1, localhost=10.2.1.20, port:1646)

Oracle SBC

ADD ACME and DEFINE CDR_PROFILE statements are added for each Oracle SBC to be monitored.

SUBSYS SBC

ADD ACME (<sbc-name>, ip=<ip-address>, type=<type> [, customer=<customer>][, site=<site>])
DEFINE CDR_PROFILE (<sbc-name>, "Dir=<path>", IncFilter=<filter>, ProcessedAction={Delete | None})
DEFINE SNMP_NODE_PROFILE (<ip-address>, port=<snmp-port>, version={2c | 3}, authentication={YES | NO}, authProtocol={MD5 | SHA}, encryption={YES | NO}, encryptionProtocol={DES | 3DES | AES | AES128 | AES192 | AES256})

Syntax Elements

ADD ACME

<sbc-name>

Name of the Oracle SBC.

<ip-address>

The IP address of the signaling server.

<type>

Supported Oracle SBC type, see Supported Oracle SBC's for a valid list of SBC series types to choose from.

<customer>

A customer name to associate with the SBC.

<site>

A site name to associate with the SBC.

DEFINE CDR_PROFILE

<sbc-name>

Name of the SBC.

<path>

The local directory where CDR files are written.

<filter>

The inclusive filter pattern e.g. cdr.*. All filenames matching this regular expression will be a candidate for processing. Leave empty to include all files.

{delete | none}

The action to take once the CDR files are processed.

delete = remove files from the directory after processing (default).
none = leave files in the directory after processing.

DEFINE SNMP_NODE_PROFILE

<ip-address>

The IP address of the Oracle SBC.

<snmp-port>

The port number used by SNMP. The default should be 161.

version={2c | 3}

The version of SNMP to run.

authentication={YES | NO}

Indicates if SNMP authentication is required, Yes or No (default is No).

authProtocol={MD5 | SHA}

SNMP authentication protocol to be used when authentication is required

encryption={YES | NO}

Indicates if SNMP encryption is required, Yes or No (default is No). Encryption is not possible without authentication.

encryptionProtocol= {DES | 3DES | AES | AES128 | AES192 | AES256}SNMP encryption protocol to be used when encryption is required. Please note that this parameter is case sensitive and the protocol needs to be added in 'UPPER CASE".
The SNMP password details are added through the PASSWORDS Configuration for Oracle SBC.

Ribbon SBC

An ADD SONUS statement is added for each Ribbon SBC to be monitored.

SUBSYS SBC

ADD SONUS (<sbc-name>, ip=<ip-address>, type=<type>, customer=<name>, site=<name>)
DEFINE SNMP_NODE_PROFILE (<ip-address>, port=<snmp-port>, version={2c | 3}, authentication={YES | NO}, authProtocol={MD5 | SHA}, encryption={YES | NO}, encryptionProtocol={DES | 3DES | AES | AES128 | AES192 | AES256})
ADD RADIUS_LISTENER (<sbc-name>:<ip-address>:<port>)

Syntax Elements

ADD SONUS

<sbc-name>

Name of the Ribbon SBC.

ip=<ip-address>

The IP address of the Ribbon server.

type=<type>

Ribbon model type, enter either

  • 1000
  • 2000
  • 5000
  • 5400
  • 7000
  • swe

customer=<name>

A customer name to associate with the SBC.

site=<name>

A site name to associate with the SBC.

DEFINE SNMP_NODE_PROFILE

<ip-address>

The IP address of the Ribbon SBC.

<snmp-port>

The port number used by SNMP. The default should be 161.

version={2c | 3}

The version of SNMP to run.

authentication={YES | NO}

Indicates if SNMP authentication is required, Yes or No (default is No).

authProtocol={MD5 | SHA}

SNMP authentication protocol to be used when authentication is required

encryption={YES | NO}

Indicates if SNMP encryption is required, Yes or No (default is No). Encryption is not possible without authentication.

encryptionProtocol= {DES | 3DES | AES | AES128 | AES192 | AES256}SNMP encryption protocol to be used when encryption is required. Please note that this parameter is case sensitive and the protocol needs to be added in 'UPPER CASE".

ADD RADIUS_LISTENER

If any RADIUS Listeners are being used, then an additional ADD RADIUS_LISTENER statement is included for each Listener:

An ADD RADIUS_LISTENER statement is added for each Ribbon SBC to be monitored by using RADIUS.

<sbc-name>

Name of the Ribbon SBC.

ip=<ip-address>:<port>

IP address and port number of the RADIUS Listener. Default port: 1813.

The SNMP password details are added through the PASSWORDS Configuration for Ribbon SBC.

Example:

SUBSYS SBC

ADD SONUS (Ribbon_SBC, ip=10.116.103.100, customer=Acme, site=Sydney)
ADD RADIUS_LISTENER (Ribbon_SBC:10.1.1.2:1813)
ADD RADIUS_LISTENER (Ribbon_SBC:10.1.1.6:1813)

Voice Quality

The following Voice Quality statements contain default settings for how the Voice Quality results will be shown in the Displays for all SBC vendor types. These can be adjusted if the default settings are not suitable.

SUBSYS SBC
...

!voice quality profile
DEFINE VQ_PROFILE(mosthreshold, Poor=3.0, Fair=3.6, Good=4.0)
DEFINE VQ_PROFILE(jitterthreshold, Poor=30, Fair=20, Good=10)
DEFINE VQ_PROFILE(packetlossthreshold, Poor=10, Fair=5, Good=1)
DEFINE VQ_PROFILE(latencythreshold, Poor=300, Fair=200, Good=100)

Syntax Elements

DEFINE VQ_PROFILE

Poor=<n>

MOS Scores, Jitter, Latency and Packet loss values above this will display as 'poor'.

Fair=<n>

MOS Scores, Jitter, Latency and Packet loss values above this will display as 'fair'.

Good=<n>

MOS Scores, Jitter, Latency and Packet loss values above this will display as 'good'.

Provide feedback on this article