In this section:
Use the SIP ARS Profile window to work with SIP Address Reachability Service (ARS) profiles used in determining when to blacklist a peer.
To achieve efficient device failover to a backup/secondary Application Server, the SBC uses ARS to determine if a server is reachable, providing the ability to temporarily "blacklist" a server IP address when specified criteria ar met. The ARS profile defines when to blacklist a peer and the recovery algorithm that defines when to remove blacklisting, restoring the peer into service. An ARS profile can be assigned to the services section of a SIP trunk group to trigger the blacklisting and recovery of any SIP peer(s) associated with the trunk group. Refer to Address Reachability Service for more information on using ARS and ARS profiles.
To View SIP ARS Profiles
On the SBC main screen, go to Configuration > Profile Management > Category: Service Profiles > SIP ARS Profile
or
All > Profiles > Services > SIP ARS Profile
The SIP ARS Profile window is displayed.
Figure 1: SIP ARS Profile Window
To Create a SIP ARS Profile
To create a new SIP ARS Profile:
Click New SIP ARS Profile. The Create New SIP ARS Profile window opens.
- Use the following table to configure the attributes for the new SIP ARS Profile and then click Save.
Table 1: SIP ARS Profile Parameters
Parameter | Description |
---|---|
| Specifies the name of the SIP ARS Profile. |
Failure Response Codes | Use this parameter to define one or more response codes to treat as failure responses. Include one or more of the following values, separating each entry with a comma: - 400-699 - list codes individually - all – include all response codes from 400-699 - all4xx – include all 4xx response codes - all5xx – include all 5xx response codes - all6xx – include all 6xx response. Note: Ensure Failure Response Codes values for a Path Check Profile and a SIP ARS Profile within the same zone/trunk group use similar values to avoid unexpected behavior. For example, it is not advisable to set the Path Check Profile Failure Response Codes to "all" and the SIP ARS Profile Failure Response Codes to "all4xx Note: In the EMA UI, Failure Response Codes are configured as comma separated values. In the CLI, the values of the Failure Response Code are separated by spaces. |
Blk List | Specifies the blacklisting algorithm to use for the ARS Profile. Any combination of algorithms can be specified for a profile. The options are:
|
Blk List Alg | Specifies the message type to use in conjunction with the timeouts blacklisting algorithm: |
Blk List Alg Rety After Methods. | Use this parameter to specify the SIP request types to retry after blacklist algorithm. The options include:
|
Blk List Alg | Specifies the number of timeout events that must occur before blacklisting the address. Must be 1-3600; default value is 1. |
Blk List Alg No Retry After Num503 | Specifies the number of SIP 503 responses without a Retry After header events sent by a peer to trigger blacklisting of that peer endpoint. The default is 1. The range allowed is 1 to 3600. |
Blk List Alg No Retry After Duration | Specifies the duration, in seconds, in which the SIP 503 responses without a Retry After header events must occur to trigger blacklisting of the peer sending the responses. The default is 1. The range allowed is 1 to 3600. |
Blk List Alg Timeouts Duration | Specifies the duration (in seconds) in which the specified number of timeouts should occur. Must be 1-3600. SIP-INVITE timeout is the only event that is currently supported. |
Blk List Alg Retry After Type | Specifies the SIP status code which has a Retry After value: |
Mid Dialog ARS Screen Level | Use this parameter to control when to apply ARS screening to a mid-dialog request.
|
Recovery | Specifies the type of recovery algorithm used after an IP address has been blacklisted: |
Recovery Alg | Specifies the duration (in seconds), for which the IP address will remain blacklisted when Timer is the recovery algorithm. Must be 1-3600. |
Recovery Alg | Specifies the Probe recovery algorithm (ping) method for blacklist recovery: |
Recovery Alg | Specifies the probe Probe recovery algorithm interval (in seconds) for blacklist recovery. Must be 1 - 600 (default is 1). |
Recovery Alg Probe Num Responses | Specifies the number of consecutive responses that must occur before removing an entry from the blacklist when Probe is the recovery algorithm. Must be 1 - 32 (default is 1). |
Recovery Alg | Specifies the Probe recovery algorithm duration (in seconds) during which the specified number of probe responses should occur. Must be 1-3600 (default is 1). |
Recovery Alg for Timeouts | Specifies the type of recovery algorithm for the endpoints blacklisted with timeouts algorithm.
Note: When the flag is set to |
Recovery Alg for No Retry After | Specifies the type of recovery algorithm for the endpoints blacklisted with 503 noRetryAfter algorithm.
Note: When the flag is set to |
Ribbon recommends to not configure Path Check Profile and SIP ARS Profile on the same peer to avoid unexpected results. As a general rule, the Path Check Profile is configured on the access leg where there is less traffic, and the ARS Profile is configured on the peer leg where there is continuous traffic.
To Edit a SIP ARS Profile
To edit a SIP ARS Profile:
- Click the radio button next to the name of the SIP ARS Profile you want to edit. The Edit Selected SIP ARS Profile window opens.
Make the required changes and click Save.
To Copy a SIP ARS Profile
To copy a SIP ARS Profile and make changes to the copy:
Click the radio button next to the name of the SIP ARS Profile you want to copy.
- Click Copy SIP ARS Profile. The Copy Selected SIP ARS Profile window opens.
- Make the required changes and click Save.
To Delete a SIP ARS Profile
To delete a SIP ARS Profile:
- Click the radio button next to the name of the SIP ARS Profile you want to delete.
- Click the delete icon (X) at the end of the row.
- Confirm the deletion when prompted.
- use to trigger blacklisting when a peer endpoint sends SIP 503 responses without a Retry After header at a rate that exceeds a number defined by Blk List Alg No Retry After Num503 within the time interval defined by Blk List Alg No Retry After Duration.