- Using Cisco Unified SIP Proxy Software
- Cisco Unified SIP Proxy Module EXEC Commands
- Cisco Unified SIP Proxy EXEC Commands
- Cisco Unified SIP Proxy Configuration Commands
- Cisco Unified SIP Proxy SIP Commands
- Cisco Unified SIP Proxy SIP Server Commands
- Cisco Unified SIP Proxy Radius Server Commands
- Cisco Unified SIP Proxy Trigger Commands
- Cisco Unified SIP Proxy Route Commands
- Cisco Unified SIP Proxy Policy Commands
- Cisco Unified SIP Proxy Accounting Commands
- Cisco Unified SIP Proxy Security Commands
- Module Commands for Cisco Unified SIP Proxy
Cisco Unified SIP Proxy Configuration Commands
call-rate-limit
To set the maximum call rate that the Cisco Unified SIP Proxy can handle, use the call-rate-limit command in Cisco Unified SIP Proxy configuration mode. To set the limit back to the default for standard or Lite Mode, use the no form of this command.
Syntax Description
Command Default
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
Use this command to set the maximum call rate. The system drops all calls that exceed this limit.
Examples
The following example sets the maximum call rate to 50 calls per second:
The following example returns the limit back to the default:
clear
To clear out the outstanding committable configuration commands in the candidate configuration, use the clear command in Cisco Unified SIP Proxy configuration mode. There is not a no form of this command.
Syntax Description
Command Default
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
After using this command, the candidate configuration is the same as the active configuration.
Examples
The following example clears the candidate configuration:
Related Commands
|
|
|
|---|---|
Displays the running configuration of the Cisco Unified SIP Proxy if the uncommitted configuration command values were to be committed. |
commit
To enable Cisco Unified SIP Proxy policy, SIP server group, route group, route table, and other committable configuration changes to take effect, use the commit command in Cisco Unified SIP Proxy configuration mode.
Syntax Description
Command Default
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
Unlike typical Cisco IOS software commands, many of the Cisco Unified SIP Proxy commands require that you use the commit command for the configuration changes to take effect. The Cisco Unified SIP Proxy uses the concept of the candidate configuration and the active configuration. Before the commit command is entered, the configuration changes are included in the candidate configuration. After the commit command is entered, the configuration changes become part of the active configuration.
The commands in the following configuration modes require that you issue the commit command for the configuration changes to take effect:
- Policy lookup
- Policy normalization
- Policy time
- Route group
- Route table
- Server group sip (selected commands only)
Note
Any configuration changes you enter before the commit command do not appear if you enter the show configuration active command, however they will appear if you enter the show configuration candidate command. When you use the commit command, then any configuration changes made since the last time you used the commit command appear in the show configuration active command output.
Commands in the following configuration modes do not require that you use the commit command for the commands to take effect:
These commands are only a subset of the commands that do not need to be committed. Noncommittable commands are verified and immediately applied to the active configuration. The commit command has no effect on these commands.
When exiting Cisco Unified SIP Proxy configuration mode, the system will prompt you to commit the configuration changes if you have not done so already. You can commit the changes before exiting Cisco Unified SIP Proxy configuration mode, or you can simply exit the configuration mode without committing the changes. All committable commands that have not been committed are discarded.
Examples
The following example configures a time policy and issues the commit command so the configuration changes can take effect:
Related Commands
|
|
|
|---|---|
Displays the candidate Cisco Unified SIP Proxy configuration. |
end
To exit out of a Cisco Unified SIP Proxy configuration or EXEC mode and return to module EXEC mode, use the end command.
Syntax Description
Command Default
Command Modes
All Cisco Unified SIP Proxy configuration submodes
Command History
|
|
|
|---|---|
Usage Guidelines
When exiting from Cisco Unified SIP Proxy configuration mode, the system prompts you for confirmation on whether to commit the existing active configuration if there are any outstanding uncommitted commands. If you exit without committing the commands, any outstanding committable commands will be cleared.
Examples
The following example exits Cisco Unified SIP Proxy EXEC mode and enters module EXEC mode:
The following example exits Cisco Unified SIP Proxy configuration mode, commits the uncommitted commands, and enters Cisco Unified SIP Proxy EXEC mode:
Related Commands
|
|
|
|---|---|
Exits out of a Cisco Unified SIP Proxy configuration or EXEC mode and returns to the higher mode. |
exit
To exit out of a Cisco Unified SIP Proxy configuration or EXEC mode and return to the higher mode, use the exit command.
Syntax Description
Command Default
Command Modes
All Cisco Unified SIP Proxy configuration submodes
Command History
|
|
|
|---|---|
Usage Guidelines
When exiting from Cisco Unified SIP Proxy configuration mode, the system prompts you to confirm whether to commit the existing active configuration if there are any outstanding uncommitted commands. If you exit without committing the commands, any outstanding committable commands are cleared.
Examples
The following example exits Cisco Unified SIP Proxy EXEC mode and enters module EXEC mode:
The following example exits Cisco Unified SIP Proxy configuration mode, commits the uncommitted commands, and enters Cisco Unified SIP Proxy EXEC mode:
Related Commands
|
|
|
|---|---|
Exits out of a Cisco Unified SIP Proxy configuration or EXEC mode and returns to EXEC mode. |
fd count
To set the file descriptor value, use the following syntax of the fd count command in Cisco Unified SIP Proxy configuration mode.
Syntax Description
Command Default
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
File descriptors are the internal representations of open files. If you change the default file descriptor value from 1024 to 2048, then the system must be rebooted and vice versa.
Examples
The following example displays the file descriptor value set to 2048:
lite-mode
To delete the record-route configurations and to change the license limits, use the lite-mode command.
Syntax Description
Command Default
Command Modes
All Cisco Unified SIP Proxy configuration submodes
Command History
|
|
|
|---|---|
Usage Guidelines
Examples
The following example describes how to turn on lite mode:
load
To load sample template configuration files to the Cisco Unified SIP Proxy, use the load command in Cisco Unified SIP Proxy EXEC configuration mode. There is not a no form of this command.
load { sftp-url | pfs-url | tftp-url }
Syntax Description
Command Default
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Command History
|
|
|
|---|---|
Usage Guidelines
The default configuration gets automatically loaded during the initialization process. You can load sample template configuration files after the system is initialized, after the default configurations are loaded onto the system.
Note
This command loads the configuration commands listed in the specified file. If an noncommittable command in the file is dependent on a set of committable commands in the file, the file must also list the commit command before the noncommittable command.
Examples
The following example loads a sample template configuration file named XXXXX:
Related Commands
|
|
|
|---|---|
show configuration active
To display the active Cisco Unified SIP Proxy configuration, except for route tables and routes, use the show configuration active command in Cisco Unified SIP Proxy EXEC mode and Cisco Unified SIP Proxy configuration mode.
Command with optional keywords for showing specific configuration contexts:
show configuration active accounting
show configuration active policy
show configuration active policy lookup
show configuration active policy normalization
show configuration active policy time
show configuration active route group
show configuration active route table
show configuration active server-group radius
show configuration active server-group sip
show configuration active server-group sip group
show configuration active server-group sip ping-options
show configuration active sip ip-address queue
show configuration active sip listen
show configuration active sip network
show configuration active sip record-route
show configuration active sip tls
show configuration active trigger
show configuration active trigger pre-normalization
show configuration active trigger post-normalization
show configuration active trigger routing
show configuration active verbose
Syntax Description
(Optional) You can enter a keyword representing a specific configuration context to display just the active configuration for that context. |
|
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
Use this command to display all committable commands that were committed and all noncommittable commands. You can display the complete active configuration or just display the active configuration for a specific configuration context.
Unless you add the verbose argument, the system does not display the route tables or routes.
Examples
The following example displays the full Cisco Unified SIP Proxy active configuration:
The following example displays the active configuration for the RADIUS accounting context only:
The following example displays the active configuration for the SIP listen network context only:
The following example displays the active configuration for the SIP network context only:
The following example displays the active configuration for the trigger condition context only:
The following example displays the active configuration for the trigger condition prenormalization context only:
The following example displays the active configuration for the server group SIP group context only:
The following example displays the active configuration for the policy normalization context only:
The following example displays the active configuration for the policy lookup context only:
Related Commands
|
|
|
|---|---|
Displays the running configuration of the Cisco Unified SIP Proxy if the uncommitted configuration command values were to be committed. |
|
show configuration candidate
To display the running configuration of the Cisco Unified SIP Proxy if the uncommitted configuration command values are committed, use the show configuration candidate command in Cisco Unified SIP Proxy manager mode or Cisco Unified SIP Proxy configuration mode.
Command with optional keywords for showing specific configuration contexts:
show configuration candidate accounting
show configuration candidate policy lookup
show configuration candidate policy normalization
show configuration candidate policy time
show configuration candidate route group
show configuration candidate route table
show configuration candidate server-group radius
show configuration candidate server-group sip
show configuration candidate server-group sip group
show configuration candidate server-group sip ping-options
show configuration candidate sip listen
show configuration candidate sip network
show configuration candidate sip record-route
show configuration candidate trigger condition
show configuration candidate trigger pre-normalization
show configuration candidate trigger post-normalization
show configuration candidate trigger routing
show configuration candidate verbose
Syntax Description
(Optional) You can enter a keyword representing a specific configuration context to display just the uncommitted configuration for that context. |
|
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
|
|
|
|---|---|
Usage Guidelines
Use this command to show what the active configuration is if you enter the commit command. This display shows the active configuration plus all the changes since the last time the commit command was entered.
Unless you add the verbose argument, the system does not display the route tables or routes.
Examples
The following example displays what the full Cisco Unified SIP Proxy running configuration is if the commit command was entered:
The following example displays the uncommitted configuration for the RADIUS accounting context only:
Related Commands
|
|
|
|---|---|
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
|
show configuration factory-default
To display the factory default configuration, use the show configuration factory-default command in Cisco Unified SIP Proxy EXEC mode.
show configuration factory-default
Syntax Description
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Command History
|
|
|
|---|---|
Usage Guidelines
Use this command to display the Cisco Unified SIP Proxy factory default configuration. If the system is reset to the factory default, this is the configuration that is stored on the system.
Examples
The following example displays the factory default configuration:
Related Commands
|
|
|
|---|---|
Displays the running configuration of the Cisco Unified SIP Proxy if the uncommitted configuration command values are committed. |
show sip
To display SIP log files, use the show sip command in Cisco Unified SIP Proxy EXEC mode.
show sip { message | peg-counting log [ tail | options ] | tcp | tls [ connections { summary | detail [ dumptofile ] }}
Syntax Description
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Command History
|
|
|
|---|---|
Usage Guidelines
The SIP message log file rotates every 10 MB or every night and is located at pfs://cusp/log/sipmsg. The SIP peg-counting log file rotates every 10 MB or every night also and is located at pfs://cusp/log/pegcount.
You can use the dumptofile option to get details on the production systems. However, use the summary option to get the current information of the SIP TCP or TLS connections.
Note The show sip tcp connections detail and show sip tls connections detail commands filter options will not work as expected for the Cisco Unified SIP Proxy Release 9.1.4.
Examples
The following example shows sample output from the show sip message log command:
The following example shows sample output from the show sip peg-counting log command:
The following example shows sample output from the show sip tcp connections detail command:
The following example shows sample output from the show sip tls connections detail command:
Feedback