Overview
Overview
The SIP Signaling Registration facility enables
to relay SIP The SIP Signaling Registration facility enables to relay SIP endpoint registration information between these endpoints and the Registrar. The SIP Trunk group commands configure the time span allowed for an IAD before requiring re-registration.
...
uses the entire AOR name to search the registration name status wherever the AOR name is present in the statistics table.
supports to search the registration name status based on the part of the AOR and the entries, which are not in the statistics table but registered in the
application using a part of the AOR name or the entire AOR name. The registration ID (RegID) is also used as a search function. In case of unknown registration ID, 0 is specified as a wildcard entry. AOR consists of userPart (user name) and hostname (user name end point IP address), and is expressed in the userPart@hostname format.
Search Method Using AOR and RegID in show Command
To retrieve the entry status that is not in the table but registered in SBC application, provide two parameters (AOR and RegID) in show command. If the RegID is unknown, use 0
as a wildcard to complete the command. Use userPart or the entire AOR name (userPart+hostname) as a first parameter to get the information. For example:
Example 1: In this case, userPart is used as first parameter to get the information.
SIP Active Register Name Status Search Options
The SBC includes the ability to view active register name status details for following scenarios using 'show status/table addressContext sipActiveRegisterNameStatus' command as shown in the examples below.
Anchor |
---|
| View all active register information |
---|
| View all active register information |
---|
|
View all active register information
To view all active register details, use the following CLI syntax:
> show table addressContext <addressContextName> sipActiveRegisterNameStatus
Code Block |
---|
|
admin@SBC>> show statustable addressContext defaultADDR_CONTEXT_1 sipActiveRegisterNameStatus
67891 0
state completed;
contactURI sip:67891@10.54.80.101:7070;
nextHopIpAddress 10.54.80.101;
nextHopPortNum 7070;
registrarIpAddressNEXT
10.54.19.168;
registrarPortNum 7080;
externalExpirationTime 1800;
internalExpirationTime 3600;
creationTime 2016-01-28T06:39:34+00:00;
registrarDomainName NEXT HOP "";
endPointBehindNaptHOP REGISTRAR 0;
natPinholeLearningStatus none;
securityMechanismType EXTERNAL none;
registrationType normal;
e2aeMediaSecurity none;
isRoaming 0;
transportProtocolToEndpoint udp;
transportProtocolToAS udp;
externalExpirationTimeLeft 1602;
internalExpirationTimeLeft 3052;
[ok][2016-01-28 12:12:53]
|
Example 2: In this case, entire AOR name (userPart+hostname) is used as first parameter to get the information.
Code Block |
---|
|
admin@SBC> show status addressContext default sipActiveRegisterNameStatus 67891@10.54.80.101 0
state IP PORT IP completed;
contactURI REGISTRAR EXPIRATION
AOR NAME sip:67891@10.54.80.101:7070;
nextHopIpAddressID STATE 10.54.80.101;
nextHopPortNum CONTACT URI 7070;
registrarIpAddress ADDRESS NUM 10.54.19.168;
registrarPortNum ADDRESS PORT NUM TIME 7080;
externalExpirationTime
----------------------------------------------------------------------------------------------------------------------
xiyu0@10.7.6.40 129024 completed sip:xiyu0@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
xiyu1@10.7.6.40 95488 completed sip:xiyu1@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
xiyu2@10.7.6.40 106496 completed sip:xiyu2@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
xiyu3@10.7.6.40 2560 completed sip:xiyu3@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
xiyu4@10.7.6.40 32000 completed sip:xiyu4@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
...
xiyu2047@10.7.6.40 32170 completed sip:xiyu4@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598 |
Anchor |
---|
| View active register information based on full AOR |
---|
| View active register information based on full AOR |
---|
|
View active register information based on full AOR
To view active register details based on AOR name (full AOR name, including userPart+hostName), append AOR to the end of the command:
> show table addressContext <addressContextName> sipActiveRegisterNameStatus <userPart> <hostName>
Code Block |
---|
|
> show table addressContext ADDR_CONTEXT_1 sipActiveRegisterNameStatus xiyu24@10.7.6.40
NEXT
NEXT HOP HOP REGISTRAR EXTERNAL
IP PORT IP REGISTRAR EXPIRATION
AOR NAME ID STATE CONTACT URI ADDRESS NUM ADDRESS PORT NUM TIME
----------------------------------------------------------------------------------------------------------------------
xiyu24@10.7.6.40 129024 completed sip:xiyu24@10.7.6.40:14283 10.7.6.40 14283 10.7.6.40 14284 3598
|
Anchor |
---|
| View active register information based on AOR/partial AOR and registration |
---|
| View active register information based on AOR/partial AOR and registration |
---|
|
View active register information based on AOR/partial AOR and registration
To view active register details based on an AOR and registration, append AOR (userPart+hostName) or partial AOR (userPart) and regID parameters to the end of the command.
- If the userPart is not unique in the filtered results, the show command only returns the first match.
- If regID is unknown, use the wildcard "0".
In the below example, userPart "xiyu2545" and regID wildcard "0" are appended to the command.
Code Block |
---|
|
> show table addressContext ADDR_CONTEXT_1 sipActiveRegisterNameStatus xiyu2545 0
state completed;
contactURI sip:xiyu2545@10.7.6.40:14283;
nextHopIpAddress 10.7.6.40;
nextHopPortNum 14283;
registrarIpAddress 10.7.6.40;
registrarPortNum 14284;
externalExpirationTime 3598;
internalExpirationTime 3600;
creationTime 1800;
internalExpirationTime 3600;
creationTime 2016-01-28T06:39:34+00:00;
registrarDomainName "";
endPointBehindNapt 0;
natPinholeLearningStatus none2015-09-04T13:36:37+00:00;
securityMechanismTyperegistrarDomainName none"";
registrationTypeendPointBehindNapt normal0;
e2aeMediaSecuritynatPinholeLearningStatus none;
securityMechanismType none;
isRoamingregistrationType normal;
e2aeMediaSecurity 0none;
transportProtocolToEndpoint udpnone;
transportProtocolToAS udp;
externalExpirationTimeLeft 16063178;
internalExpirationTimeLeft 3056;
[ok][2016-01-28 12:12:48]2463; |
Bulk Registration Support
...
Info |
---|
For complete SIP trunk group configuration details, see: |
Registration Establishment
...
Note |
---|
The subscription ratio for UDP and TCP access load connection is 10:1. |
Surrogate Registration Support
...
- Challenge for any message
- Challenge for any message and in-dialog requests
- Challenge for register
The
supports responding to challenges from AS for the following methods:- REGISTER
- INVITE
- PRACK
- UPDATE
- REINVITE
- BYE
Info |
---|
For surrogate registration configuration commands and examples, see the following wiki pages: |
SIP Authentication Using Dedicated User Name
The
supports configuring a case-sensitive “Authentication ID” and password under the IP Peer object associated with an IP Peer which allows user to configure pilot number other than authorization user name. If IP Peer password is not empty, and if surrogate AoR password is empty, IP Peer password is used for credentials for all applicable methods, (e.g. REGISTER, INVITE). supports responding to challenges from AS for the following methods:- REGISTER
- INVITE
- PRACK
- UPDATE
- REINVITE
- BYE
Info |
---|
For surrogate registration configuration commands and examples, see the following wiki pages: |
SIP Authentication Using Dedicated User Name
The In support of Surrogate Registration, when a REGISTER message is (re)sent with an Authorization or Proxy-Authorization header field in response to a challenge for authentication, the
retrieves the supports configuring a case-sensitive “Authentication ID”
from the associated “IP Peer” object.The selected “Authentication ID” is also used among other parameters, e.g., password, nonce, etc., in computing the “response” parameter of the header field per RFC 2617. The From/To/Contact header fields, however, continue to take the existing “User Part” from the associated “IP Peer/Surrogate Registration” entry as the “userinfo” part of the SIP URI.
To maintain backwards compatibility, during an LSWU from a previous release the value of the “Authentication ID” field is automatically filled with the existing “IP Peer/Surrogate Registration/User Part” field used for authorization in the previous release.
Note |
---|
If automatically filling Authentication ID is undesirable, after the LSWU completes, configure the “Authentication ID” with a new value such that its corresponding password in a server-specified protected realm can be located. |
Info |
---|
To configure SIP Authentication, see the following pages: |
Quick Re-registration on Alternate SIP Server When Primary Server is Down
and password under the IP Peer object associated with an IP Peer which allows user to configure pilot number other than authorization user name. If IP Peer password is not empty, and if surrogate AoR password is empty, IP Peer password is used for credentials for all applicable methods, (e.g. REGISTER, INVITE).
In support of Surrogate Registration, when a REGISTER message is (re)sent with an Authorization or Proxy-Authorization header field in response to a challenge for authentication, the
retrieves the “Authentication ID” from the associated “IP Peer” object.The selected “Authentication ID” is also used among other parameters, e.g., password, nonce, etc., in computing the “response” parameter of the header field per RFC 2617. The From/To/Contact header fields, however, continue to take the existing “User Part” from the associated “IP Peer/Surrogate Registration” entry as the “userinfo” part of the SIP URI.
To maintain backwards compatibility, during an LSWU from a previous release the value of the “Authentication ID” field is automatically filled with the existing “IP Peer/Surrogate Registration/User Part” field used for authorization in the previous release.
Note |
---|
If automatically filling Authentication ID is undesirable, after the LSWU completes, configure the “Authentication ID” with a new value such that its corresponding password in a server-specified protected realm can be located. |
Info |
---|
To configure SIP Authentication, see the following pages: |
Quick Re-registration on Alternate SIP Server When Primary Server is Down
In Access scenarios, SIP Registrars on core side are considered as primary-secondary/alternate for a particular user. The users are registered to the Primary Registrar when it is available and registered with the Secondary Registrar only when the Primary is down. After the Primary Registrar goes down, the Secondary Registrar allows any new calls or requests only after the completion of Successful registration. Whenever the Primary is In Access scenarios, SIP Registrars on core side are considered as primary-secondary/alternate for a particular user. The users are registered to the Primary Registrar when it is available and registered with the Secondary Registrar only when the Primary is down. After the Primary Registrar goes down, the Secondary Registrar allows any new calls or requests only after the completion of Successful registration. Whenever the Primary is down,
sends any subsequent refresh registration from the user to the Secondary Registrar to establish the binding at the Secondary Registrar. Similarly when the Primary comes back up, sends the next subsequent refresh registration to the Primary Registrar. Any delay in this scenario causes loss of traffic until the registration is successful. Currently, when the primary SIP server goes down,
does not register the alternate SIP server immediately. sends any subsequent refresh registration from the user to the Secondary Registrar to establish the binding at the Secondary Registrar. Similarly when the Primary comes back up, does not send the refresh REGISTER to the primary SIP server until the internal refresh timer expires (3600 seconds). This results in a long downtime before the refresh REGISTER is passed on to the alternate SIP server for registration.To overcome this issue, sends the next subsequent refresh registration to the Primary Registrar. Any delay in this scenario causes loss of traffic until the registration is successful. Currently, when the primary SIP server goes down, relays the first refresh REGISTER after it detects any status change in the primary SIP Server. This is controlled by introducing new flags in IP Signaling Profile (IPSP). does not register the alternate SIP server immediately. registers does not send the refresh REGISTER to the
alternate primary SIP server
until the internal refresh timer expires (3600 seconds). This results in a long downtime before the refresh REGISTER is passed on to the alternate SIP server for registration.To overcome this issue, immediately when Primary is down and reverts when Primary SIP server is up. The status of the servers is detected through Address Reachability Service (ARS) blacklist. For every switch from primary to secondary/alternate or from secondary/alternate to primary,
queries the ERE/PSX to get the latest routing information and route refresh REGISTERs. relays the first refresh REGISTER after it detects any status change in the primary SIP Server. This is controlled by introducing new flags in IP Signaling Profile (IPSP). also supports a CLI request
command to query PSX on new refresh REGISTERs. Caption |
---|
0 | Figure |
---|
1 | Quick Re-registration on Alternate SIP Server When Primary Server is Down |
---|
|
Image Removed |
Note |
---|
- This feature requires Pathcheck support using OPTIONS Ping and ARS static blacklisting to detect the reachability of a particular IP/FQDN.
- If both request command and IPSP flags are configured, command takes the preference over IPSP flags.
|
IPSP Configuration
Four new flags are added to the registrarRecovery
parameter. These new flags are introduced to the IPSP profile to configure this feature.
registrarRecovery
newRegistrarIndex
overRideInternalExpires
registrarFqdn
registrarIpAddress
Note |
---|
- The
registerToAlternateOnPrimaryDown flag must be enabled to view overrideInternalExpiresTimer and revertToPrimaryOnRecovery flags. - The
revertToPrimaryOnRecovery flag must be enabled to view deRegisterAlternateOnPrimaryRecovery flag. - The IPSP flags can be configured only on Core Trunk Group.
|
For configuring IPSP flags on PSX, refer to PSX Configuration.
request
Command
registers to the alternate SIP server immediately when Primary is down and reverts when Primary SIP server is up. The status of the servers is detected through Address Reachability Service (ARS) blacklist. For every switch from primary to secondary/alternate or from secondary/alternate to primary,
queries the ERE/PSX to get the latest routing information and route refresh REGISTERs. also supports a CLI request
command to query PSX on new refresh REGISTERs. Caption |
---|
0 | Figure |
---|
1 | Quick Re-registration on Alternate SIP Server When Primary Server is Down |
---|
|
Image Added |
Note |
---|
- This feature requires Pathcheck support using OPTIONS Ping and ARS static blacklisting to detect the reachability of a particular IP/FQDN.
- If both request command and IPSP flags are configured, command takes the preference over IPSP flags.
|
Force PSX Query on Refresh Register
The A new CLI request queryPsxOnNextRefreshRegister
command is used to force PSX query on subsequent refresh REGISTER. This enables new routing information configured in PSX to reflect in SBC when registrations are active for a long period of time.
The CLI request
command syntax is :
...
Note |
---|
- The request
queryPsxOnNextRefreshRegister command must be executed only on Ingress Trunk Group. - The request
queryPsxOnNextRefreshRegister command is applied to all the refresh REGISTERs on all active registrations, which are currently handled by SBC. - The request command is configured only on Access side Trunk Group.
|