Versions Compared

Old Version 7

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version Current

changes.mady.by.user Ribbon Communications

Saved on

Key

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

In this section:

Table of Contents
maxLevel2

Info
iconfalse

Related articles:

Children Display

 

 

 The request addressContext command is available from both system-level and configure modes, and includes the following objects:

  •  cmds – Incorporates SIP options ping feature.
  •  dnsGroup – DNS Server Groups in this address context.
  •  dynamicBlackList – The collection of DBL policers.
  •  ipsec – Ipsec configuration, security policy database, ike peer table.
  •  sipRegCountReset – Resets the SIP registration count.
  •  sipRegistrationAdaptiveNatLearning – reset/disable adaptive nat pinhole learning process.
  •  sipRegistrationDeleteById – Delete a SIP registration by ID.
  •  sipRegistrationDeleteByIp – Delete a SIP registration by IP address.
  •  sipSubCountReset – Reset the SIP subscription count.
  •  sipSubscriptionDelete – Delete a SIP subscription.
  •  zone – Signaling, media, and control for a zone in the address context.

cmds optionsPing

Command syntax to ping another system from

Spacevars
0product
: 

Code Block
languagenone
> request addressContext <addressContext name> cmds optionsPing
	peerFQDN <string>
	peerIpAddress <peer ip address>
	peerPort <SIP port number>
	sigPort <signaling port>
	transport <tcp | tls | udp>
Caption
0Table
1optionsPing Parameters

Parameter

Description

cmds optionsPing

The commands object used to ping a SIP peer using SIP OPTIONS method.

  • peerFQDN <string> – Use this parameter to activate a single options ping request to a particular FQDN peer (this command will be successful on the first responded OPTIONS request). The SBC sends the OPTIONS request to the highest priority FQDN-resolved IP. If required, the SBC retransmits the request eight additional times. If there is no response to any of these requests, SBC sends the OPTIONS request to the next FQDN resolved IP. 
  • peerIpAddress – The IPv4 or IPv6 Peer SIP Address to ping.
  • peerPort – The Peer SIP Port Number to ping. (Default = 5060)
  • sigPort – The Signaling Port number to use for the ping.
  • transport – The Transport protocol. Select any one of the following transport types:
    • tcp
    • tls
    • udp (default)

 

dnsGroup

Use this command to perform manual actions against a specific DNS group.

Command Syntax

Command syntax to initiate action on DNS group object:

Code Block
languagenone
> request addressContext <addressContext name> dnsGroup <dnsGroup name> 
	clearCache
		domainName <domain name>
		recordType <a | aaaa | default | naptr | ns | srv>
	dnsServerReset
	query
		dnsServer <server name>
		fqdn <FQDN>
		recordType <a | aaaa | naptr | ns | srv>
	updateTtl
		fqdn <FQDN>
		recordType <a | aaaa | naptr | ns | srv>
		ttl <vaLue>

Command Parameters

Caption
0Table
1dnsGroup request Parameters

Parameter

Description

clearCache

Clear the cache of the matching record.

  • domainName <domain name> – Enter the name of the domain from which to clear the cache.
  • recordType – Choose the DNS record type. 
    • a
    • aaaa
    • default
    • naptr
    • ns
    • srv
dnsServerResetReset all DNS server statistics.
query

Perform a DNS query to the server, with following additional configurations.

  • dnsServer <server name> – DNS server to use to perform lookup.
  • fqdn <FQDN> – Domain to use for lookup.
  • recordType – Specify whether to use the DNS server for just A-record lookups, or for full NAPTR/SRV/A lookup as specified in RFC3263. 
    • a
    • aaaa
    • naptr
    • ns
    • srv
updateTtl

Updates the cache of the matching record with the new TTL value.

  • fqdn <FQDN> – FQDN to be updated from the Cache.
  • recordType – Specifies whether to use the DNS server for just A-record lookups, or for full NAPTR/SRV/A lookup as specified in RFC3263.
    • a
    • aaaa
    • naptr
    • ns
    • srv
  • ttl <value> – Enter the Time To Live (TTL) duration, in seconds, to cache a particular record.

Command Examples

To send the manual DNS query with server:

Code Block
languagenone
> request addressContext <addressContextName> dnsGroup <dnsGroupName> query dnsServer <dnsServerName> fqdn <fqdnValue> recordType <a | aaaa | srv | ns | naptr>

To send the manual DNS query without DNS server:

Code Block
languagenone
> request addressContext <addressContextName> dnsGroup <dnsGroupName> query fqdn <fqdnValue> recordType <a | aaaa | srv | ns | naptr>

To clear the particular DNS group cache (under Address Context):

Code Block
languagenone
> request addressContext <addressContextName> dnsGroup <dnsGroupName> clearCache

 To clear a particular Domain Name/FQDN under a DNS Group (under Address Context):

Code Block
languagenone
> request addressContext <addressContextName> dnsGroup <dnsGroupName> clearCache domainName <domainName>

To clear a particular record under Address Context:

Code Block
languagenone
> request addressContext <addressContextName> dnsGroup <dnsGroupName> clearCache domainName <domainName> recordType <a | aaaa | srv |naptr>

To clear the full DNS Cache, use the command:

Code Block
languagenone
> request global dnsClearCache

  

dynamicBlackList

This object allows you to remove Dynamic Blacklist (DBL) entries for the specified IP address.

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> dynamicBlackList removeEntry sourceIpAddress <ip address>

Command Parameters

Caption
0Table
1dynamicBlackList request Parameters

Parameter

Description

dynamicBlackList

Collection of DBL policers.

removeEntryParameter to remove any DBL entries for specified IP address.

Example

The following command removes all DBL entries from IP address 10.10.123.8:

Code Block
languagenone
> request addressContext default dynamicBlackList removeEntry sourceIpAddress 10.10.128.8 
 
When prompted, enter 'y' to continue: 
This command will remove any DBL entry with a matching source IP address. Do you want to proceed (yes/no) y

 

ipsec

Command Syntax

Command syntax to initiate action on IPsec object:

Code Block
languagenone
> request addressContext <addressContext name> ipsec <ipsec parameter to delete>

Command Parameters

Caption
0Table
1ipsec request Parameters

Parameter

Description

ipsec

IP Security configuration, including security policy database and IKE peer table.

ikeSaDelete

Name of a specific IKE SA to be deleted by its IKE handle identifier.

  • saIndex <unsignedInt> – index number of IKE SA to delete.
ikeSaDeleteAllGlobally deletes all IKE SAs. When prompted to delete all, enter Yes.
ipsecSaDelete

Delete the IPsec SA pair with a given local tunnel IP address (LOCAL TUNNEL IP ADDRESS) and a given incoming Security Parameter Index value (LOCAL SPI).

  • localSPI <sonusHexBinary value> – Local SPI (Security Parameter Index) of the SA to delete.

Example

 The following command deletes all entries from the IKE SA list for local SPI 13:

Code Block
languagenone
> request addressContext default ipsec ikeSaDelete saIndex 13
 
When prompted, enter 'y' to continue: 
This command will delete entry from the IKE SA list. Do you want to continue (yes/no) y

 

sipRegCountReset

 This object resets the SIP registration count.

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> sipRegCountReset

Example

The following example resets SIP registration count for address context “default”: 

Code Block
languagenone
> request addressContext default sipRegCountReset result success reason Registration Count is Reset

 

sipRegistrationAdaptiveNatLearning

This object provides flexibility to disable/reset adaptive NAT pinhole learning process for a specific user already registered with SBC.

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> 
   sipRegistrationAdaptiveNatLearning
   action <disable|reset>
   id <registration id nbr>

Command Parameters

Caption
0Table
1sipRegistrationAdaptiveNatLearning request Parameters

Parameter

Description

sipRegistrationAdaptiveNatLearning

Reset/disable adaptive NAT pinhole learning process.

id

Registration ID of user. <id number>

action

Action to perform. Arguments include:

  • disable
  • reset

Example

The following example disables the NAT pinhole learning process for registered user with an ID of 13:

Code Block
languagenone
> request addressContext default sipRegistrationAdaptiveNatLearning id 13 action disable

 

sipRegistrationDeleteById

This object allows you to delete a SIP registration by the user’s ID number.

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> sipRegistrationDeleteById id <registration id>

Command Parameters

Caption
0Table
1sipRegistrationDeleteById request Parameters

Parameter

Description

sipRegistrationDeleteById

Delete SIP registration for the specified ID.

id

Registration ID of user. <id number>

Note
The surrogate registration is not deleted by the following command.

Example

Code Block
languagenone
> request addressContext default sipRegistrationDeleteById id 13
result success

 

sipRegistrationDeleteByIp

This object allows you to delete a SIP registration by the IP address using the Registrar’s IP address (found in sipActiveGroupRegStatus table).

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> sipRegistrationDeleteByIp ipAddress <ip address>

Command Parameters

Caption
0Table
1sipRegistrationDeleteByIp request Parameters

Parameter

Description

sipRegistrationDeleteByIp

Delete SIP registration associated with the specified IP address.

ipAddress

IP address of the Registrar. <ip address>

Note
The surrogate registration is not deleted by the following command.

Example

Code Block
languagenone
> request addressContext default sipRegistrationDeleteByIp ipAddress 10.20.128.13 
result success

 

sipSubCountReset

This object resets the SIP subscription count.

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> sipSubCountReset

Command Parameters

Caption
0Table
1sipSubCountReset request Parameters

Parameter

Description

sipSubCountReset

Reset SIP subscription count.

Example

Code Block
languagenone
> request addressContext default sipSubCountReset result success reason Subscription Count is Reset

 

sipSubscriptionDelete

Command Syntax

Code Block
languagenone
> request addressContext <addressContext name> sipSubscriptionDelete <subcription id>

Command Parameters

Caption
0Table
1sipSubscriptionDelete request Parameters

Parameter

Description

sipSubscriptionDelete

<id> Delete a SIP subscription.

Example

Code Block
languagenone
> request addressContext default sipSubscriptionDelete id 13

 

zone

See Request Address Context - Zone - CLI for details.

. Choose a link in the TOC above for specific command details.


Pagebreak