Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

Noprint
Panel
borderColorgreen
bgColortransparent
borderWidth2

Back to Table of Contents

Back to SIP Services

Back to SIP Signaling

Section
Column
Panel

In this section:

Table of Contents
maxLevel3

Overview

Column
width40%
Info
iconfalse

Related articles:

Overview

The SIP Signaling Registration facility enables

Spacevars
0product
to relay SIP The SIP Signaling Registration facility enables
Spacevars
0product
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.

...

Spacevars
0product
uses the entire AOR name to search the registration name status wherever the AOR name is present in the statistics table. 
Spacevars
0product
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
Spacevars
0product
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.

Noprint

Back to Top

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
languagenone
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
languagenone
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   
Noprint

Back to Top

 

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
languagenone
> 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        
Noprint

Back to Top


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
languagenone
> 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;
Noprint

Back to Top

Bulk Registration Support

...

Info

For complete SIP trunk group configuration details, see:

Noprint

Back to Top

Registration Establishment

...

Note
The subscription ratio for UDP and TCP access load connection is 10:1.
Noprint

Back to Top

Surrogate Registration Support

...

  • Challenge for any message
  • Challenge for any message and in-dialog requests
  • Challenge for register 

The 

Spacevars
0product
supports responding to challenges from AS for the following methods:

  1. REGISTER
  2. INVITE
  3. PRACK
  4. UPDATE
  5. REINVITE
  6. BYE

 

Info

For surrogate registration configuration commands and examples, see the following wiki pages:

SIP Authentication Using Dedicated User Name

The

Spacevars
0product
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:

  1. REGISTER
  2. INVITE
  3. PRACK
  4. UPDATE
  5. REINVITE
  6. BYE

 

Info

For surrogate registration configuration commands and examples, see the following wiki pages:

Noprint

Back to Top

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

Spacevars
0product
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

Spacevars
0product
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:

Noprint

Back to Top

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,

Spacevars
0product
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,
Spacevars
0product
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,
Spacevars
0product
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,
Spacevars
0product
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,
Spacevars
0product
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. 
Spacevars
0product
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,

Spacevars
0product
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). 
Spacevars
0product
also supports a CLI request command to query PSX on new refresh REGISTERs.

Caption
0Figure
1Quick 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,

Spacevars
0product
queries the ERE/PSX to get the latest routing information and route refresh REGISTERs.

Spacevars
0product
also supports a CLI request command to query PSX on new refresh REGISTERs.

Caption
0Figure
1Quick 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.
Noprint

Back to Top

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.
Noprint

Back to Top

Pagebreak