Release Notes for Cisco Unified SIP Proxy Release 9.1.x
Available Languages
Table of Contents
Release Notes for Cisco Unified SIP Proxy Release 9.1.x
Determining the Software Version
Caveats Resolved in Release 9.1.1
Caveats Resolved in Release 9.1.2
Caveats Resolved in Release 9.1.3
Caveats Resolved in Release 9.1.4
Caveats Resolved in Release 9.1.5
Caveats Resolved in Release 9.1.6
Caveats Resolved in Release 9.1.7
Caveats Resolved in Release 9.1.8
Caveats Resolved in Release 9.1.9
Commands and Notes: Release 9.1.4
Commands and Notes: Release 9.1.5
Commands and Notes: Release 9.1.6
show license smart agent-version
Migration to Cisco Unified SIP Proxy 9.1.x
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco Unified SIP Proxy Release 9.1.x
First Published: September 21, 2015
Last Revised: December 14, 2020
This document describes the new features, system requirements, licensing information, and caveats for Cisco Unified SIP Proxy Release 9.1.x. Use this document in conjunction with the caveats listed in Caveats for the respective releases.
Introduction
Cisco Unified SIP Proxy is a high-performance, highly available Session Initiation Protocol (SIP) server for centralized routing and SIP signaling normalization. By forwarding requests to call-control domains, Cisco Unified SIP Proxy provides the means for routing sessions within enterprise and service provider networks. Cisco Unified SIP Proxy provides multiple features, including SIP trunk aggregation, name resolution, routing, load balancing, scalability, and high availability.
Cisco Unified SIP Proxy 9.1.x is delivered as an Open Virtual Appliance (OVA) and can be installed as a virtual machine on Cisco UCS platform. Cisco Unified SIP Proxy Release 9.1.x supports CISCO-USP-MIB through SNMP.
System Requirements
Determining the Software Version
To determine the software version and the license used, perform the following steps.
Step 1
Enter the following command to display the Cisco Unified SIP Proxy software version:
Step 2 Enter the following command to display the Cisco Unified SIP Proxy software license:
Release 9.1.1
The following package is available for Cisco Unified SIP Proxy Release 9.1.1:
The CISCO-USP-MIB and CISCO-PROCESS-MIB is available for download at the Cisco site:
New Features and Enhancements
- Release 9.1.1
- Release 9.1.2
- Release 9.1.3
- Release 9.1.4
- Release 9.1.5
- Release 9.1.6
- Release 9.1.7
- Release 9.1.9
Release 9.1.4
- The default value of the file descriptor count was enhanced from 1024 to 25000.
- Introduced show fd statistics command that provides information on the maximum file descriptor count and the current open file descriptor count. See show fd statistics.
- Added tcp and tls options to the show sip command that displays the active Transmission Control Protocol (TCP) and Transport Layer Security (TLS) connections at the Cisco Unified SIP Proxy application level. See show sip.
- Introduced show tcp connections command that displays the status of Transmission Control Protocol (TCP) connections at the operating system level. See show tcp connections.
Note CLI Command Reference for Cisco Unified SIP Proxy Release 9.1.x is not updated with the CLI updates for Cisco Unified SIP Proxy Release 9.1.4.
Release 9.1.5
- Introduced server-group sip ping-503 command that checks whether the SIP application service in the remote server element is up or down by monitoring the response. Cisco Unified SIP Proxy GUI is also enhanced to include the “Ping 503" parameter in the Server Groups settings.
- Introduced Packet Capture check box in the Cisco Unified SIP Proxy GUI to capture the network traffic on Cisco Unified SIP Proxy interfaces. Each packet capture request is limited to 40 MB.
- Cisco Unified SIP Proxy Release 9.1.5 adds support for Cisco Smart Software Manager satellite version 3.0.0.
- In Smart Licensing, if the Smart Agent Client is disabled via GUI or CLI, none of the calls are processed. Cisco Unified SIP Proxy should have another successful authorization with Cisco Smart Manager to process calls in the AuthorizedPeriodExpired or EvalExpired mode.
Limitations and Restrictions
Note Cisco Unified SIP Proxy Release 9.1.x does not support installation of VMware Tools or any third-party tools in a Linux environment.
In a rare scenario, the configuration file may become read only and prevent you from saving the configuration changes using Command Line Interface (CLI) and Graphical User Interface (GUI). The impact is momentary and the file system tries to recover itself in most of such cases. In more persistent scenarios, reload the Cisco Unified SIP Proxy to recover the configuration file, edit, and save the configuration.
Release 9.1.1
Cisco Unified SIP Proxy Release 9.1.1 has the following restrictions:
- No Support for SNMP Version 3 (SNMPv3).
- Certain MIB objects in the Cisco Unified SIP Proxy MIB tree are not supported. For list of MIB objects that are not supported, see CLI Configuration Guide for Cisco Unified SIP Proxy Release 9.1.
Caveats
Caveats describe unexpected behavior in Cisco Unified SIP Proxy Release 9.1.x. To see the caveats associated with Cisco Unified SIP Proxy Release 9.1.x, use the Bug Search Tool at: https://tools.cisco.com/bugsearch/search.
- Caveats Resolved in Release 9.1.1
- Caveats Resolved in Release 9.1.2
- Caveats Resolved in Release 9.1.3
- Caveats Resolved in Release 9.1.4
- Caveats Resolved in Release 9.1.5
- Caveats Resolved in Release 9.1.6
- Caveats Resolved in Release 9.1.7
- Caveats Resolved in Release 9.1.8
- Caveats Resolved in Release 9.1.9
Caveats Resolved in Release 9.1.1
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.1.
Caveats Resolved in Release 9.1.2
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.2.
Note Though JVM level caching is removed as part of the caveat CSCuv79510, a non-configurable DNS look up caching of approximately 15 minutes is maintained at the OS level. For DNS cache look up at OS level, you can clear the cache using the command clear ip dns cache.
Caveats Resolved in Release 9.1.3
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.3.
Caveats Resolved in Release 9.1.4
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.4.
Caveats Resolved in Release 9.1.5
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.5.
Caveats Resolved in Release 9.1.6
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.6.
Caveats Resolved in Release 9.1.7
The following issues were resolved in Cisco Unified SIP Proxy Release 9.1.7.
Commands and Notes: Release 9.1.4
To see the new and modified commands associated with Cisco Unified SIP Proxy Release 9.1.4, see:
Command Modes
Cisco Unified SIP Proxy EXEC (cusp)
Usage Guidelines
Use the show fd statistics command to display the maximum number of file descriptor counts and open file descriptor counts.
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)
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 will not have the filter options available for the Cisco Unified SIP Proxy Release 9.1.4. For example, you cannot use “pipe - |” to filter the various connection details.
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:
show tcp connections
To display the status of Transmission Control Protocol (TCP) connections, use the show tcp connections command in module EXEC mode.
Usage Guidelines
The show tcp connections command displays detailed connection information at the operating system level. To obtain information at the application level, use the show sip tcp connections detail command.
Examples
The following example shows the current active tcp connections available on the operating system:
se-10-64-86-198# show tcp connections
Active Internet connections (servers and established)
Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name
tcp 0 0 127.0.0.1:389 0.0.0.0:* LISTEN 1634/slapd
tcp 0 0 0.0.0.0:911 0.0.0.0:* LISTEN 1106/tclsh
tcp 0 0 0.0.0.0:21 0.0.0.0:* LISTEN 2637/vsftpd
tcp 0 0 0.0.0.0:22 0.0.0.0:* LISTEN 1108/sshd
tcp 0 0 127.0.0.1:5432 0.0.0.0:* LISTEN 1824/postmaster
tcp 0 96 10.64.86.198:22 10.196.106.64:62609 ESTABLISHED 2693/sshd: cuspdt [
tcp 0 0 127.0.0.1:389 127.0.0.1:49865 ESTABLISHED 1634/slapd
tcp 0 0 127.0.0.1:58065 127.0.0.1:12345 ESTABLISHED 2751/cli_xconn
tcp 0 0 127.0.0.1:5432 127.0.0.1:45198 ESTABLISHED 2782/postgres: post
tcp 0 0 127.0.0.1:5432 127.0.0.1:56925 ESTABLISHED 2286/postgres: post
tcp 0 0 127.0.0.1:58064 127.0.0.1:12345 ESTABLISHED 2687/cli_xconn
tcp 0 0 10.64.86.198:22 10.196.106.64:62608 ESTABLISHED 2306/sshd: cuspdt [
Commands and Notes: Release 9.1.5
To see the new and modified commands associated with Cisco Unified SIP Proxy Release 9.1.5, see:
server-group sip ping-503
To enable the use of ping-503 option to check whether the SIP application service in the remote server element is running or not, use the server-group sip ping-503 command in Cisco Unified SIP Proxy configuration mode. Cisco Unified SIP Proxy can identify the type of response from the remote server element and decrement the retry count if the response is 503. To restore the SIP ping 503 option to the default value, use the no form of this command.
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Usage Guidelines
Use this command to identify whether the sip element is down or not. If the server-group sip ping-503 command is not configured, the 503 response is treated as successful response. If this command is configured, Cisco Unified SIP Proxy considers the 503 response as remote element down. Ping 503 mode must first exist before you can use the no command.
Commands and Notes: Release 9.1.6
To see the new and modified commands associated with Cisco Unified SIP Proxy Release 9.1.6, see:
Migration to Cisco Unified SIP Proxy 9.1.x
You can migrate from existing Cisco Unified SIP Proxy 8.x releases to Cisco Unified SIP Proxy Release 9.1.x. However, the following are the limitations during the migration:
- Cisco Unified SIP Proxy Release 9.1.x cannot be installed on SRE Module. You require a virtual machine on VMWare ESXi platform to install Cisco Unified SIP Proxy Release 9.1.x.
- Existing Cisco Unified SIP Proxy 8.x SWIFT licenses cannot be migrated to Cisco Unified SIP Proxy 9.1.x. Contact Cisco sales to enquire about the purchase of current Cisco Unified SIP Proxy licenses.
- The backup configuration files from Cisco Unified SIP Proxy 8.x release does not have network related configuration as Cisco SRE module gets the relevant information through RBCP protocol from the host router when it powers up. Cisco Unified SIP Proxy 9.1.x does not support RBCP communication. So, if a backup configuration from Cisco Unified SIP Proxy 8.5.x release is restored in Cisco Unified SIP Proxy 9.1.x, you must manually enter and configure the IP address, subnet mask, and gateway details during reload.
- Cisco Unified SIP Proxy 8.x release configuration has multiple sub-interfaces. The sub-interface format in Cisco Unified SIP Proxy Release 9.1.x is different from that in Cisco Unified SIP Proxy Release 8.x. You must configure these interfaces manually after the reload is complete.
- Listen points are not restored if the IP address of the Cisco Unified SIP Proxy on SRE module and Cisco Unified SIP Proxy 9.1.x are different. You must manually configure the listen points.
To migrate from any of the existing Cisco Unified SIP Proxy Releases to Cisco Unified SIP Proxy Release 9.1.x, follow the below steps:
1. Take a backup of the existing Cisco Unified SIP Proxy 8.x configuration. Refer to Cisco Unified SIP Proxy CLI Configuration Guide for more information.
2. Deploy the Cisco Unified SIP Proxy Release 9.1.x OVA on a virtual machine. Refer to the Installation Guide for Cisco Unified SIP Proxy Release 9.1.x for more information.
3. Restore the configuration backup of Cisco Unified SIP Proxy 8.x in Cisco Unified SIP Proxy 9.1.x. Refer to CLI Configuration Guide for Cisco Unified SIP Proxy Release 9.1.x for more information.
4. Configure the Smart licenses. Refer to GUI Configuration Guide for Cisco Unified SIP Proxy Release 9.1. x and CLI Configuration Guide for Cisco Unified SIP Proxy Release 9.1.x for more information.
Note Smart licensing details are reset if smart licensing is configured before restore of configuration. It is always recommended to restore the configuration before enabling smart licensing.
Note After configuration restore, you must manually create a user with administrator privileges for accessing SSH.
Note When you migrate from Cisco Unified SIP Proxy Release 8.x to Cisco Unified SIP Proxy Release 9.1.x, if there are no Sub-Interfaces or VLANs defined on the Virtual Machine, remove the VLAN 0 tag from packets at the ESXi switch side or network side. If not, packets with VLAN 0 tag are dropped.
Related Documentation
Table 1-1 lists the documentation available for Cisco Unified SIP Proxy Release 9.1.x:
Installation Guide for Cisco Unified SIP Proxy Release 9.1.x |
Describes how to install the Cisco Unified SIP Proxy software, including licenses. Also includes information about moving from Release 1.x to Release 9.1.x. http://www.cisco.com/en/US/products/ps10475/prod_installation_guides_list.html |
CLI Configuration Guide for Cisco Unified SIP Proxy Release 9.1.x |
Contains administrator information, such as maintenance and troubleshooting, for tasks that are performed from the CLI. http://www.cisco.com/en/US/products/ps10475/products_installation_and_configuration_guides_list.html |
CLI Command Reference for Cisco Unified SIP Proxy Release 9.1.x |
Contains descriptions of all the Cisco Unified SIP Proxy Release 9.1.x-specific CLI commands. http://www.cisco.com/en/US/products/ps10475/prod_command_reference_list.html |
GUI Configuration Guide for Cisco Unified SIP Proxy Release 9.1.x |
Contains administrator information, such as maintenance and troubleshooting, for tasks that are performed from the GUI. Includes online help. http://www.cisco.com/en/US/products/ps10475/products_installation_and_configuration_guides_list.html |
Commercial Open Source Information for Cisco Unified SIP Proxy Release 9.1.x |
Lists all the open source software used in this project. http://www.cisco.com/en/US/products/ps10475/products_licensing_information_listing.html |
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
Feedback