cc/td/doc/product/voice/sipsols
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Configuring the Cisco VoIP Infrastructure Solution for SIP
Configuring the Routers
Configuring the Cisco SIP IP Phones
Configuring the Cisco SIP Proxy Server
Configuring the Cisco uOne Messaging System
Configuring the Cisco Secure PIX Firewall
Configuring the Cisco SS7 Interconnect for VoIP Gateways Solution
Configuration Example

Configuring the Cisco VoIP Infrastructure Solution for SIP


This chapter provides scenario-based examples of how to configure the components of the Cisco VoIP Infrastructure Solution for SIP. It includes the following sections:

Configuring the Routers

Before you can configure your access server or router to use VoIP, you must first complete the following tasks:

Configuring VoIP Support

After you have configured your router or access server for basic IP support, you are ready to configure the device to support VoIP. To configure basic VoIP, perform the following tasks:

Configuring the Cisco SIP Gateway

After you have configured the basic VoIP support, you must configure the router or access server to function as a Cisco SIP gateway. To configure SIP support, perform the following tasks:

Configuring the Cisco SIP IP Phones

The Cisco SIP IP phones obtain their configuration parameters from network devices during their boot-up process. Network parameters can be configured manually or obtained from a DHCP server. SIP parameters can be configured manually or obtained from a TFTP server.

Before you configure the Cisco SIP IP phones, you should obtain the following files from Cisco's Connection Online (CCO) and place them in the root directory of your TFTP server:

File Description

OS79XX.TXT

(Required) Enables the phone to automatically determine and initialize for the VoIP environment in which it is being installed.

After downloading this file, you will need to use an ASCII editor to open it and specify the file name (without the file extension) of the image version that you plan to run on your phones.

SIPDefaultGeneric.cnf

(Optional) File in which to configure SIP parameters intended for all phones.

SIPConfigGeneric.cnf

(Required) File which can be used as a template to configure SIP parameters specific to a phone. When customized for a phone, this file must be renamed to the MAC address of the phone.

RINGLIST.DAT

(Optional) Lists audio files that are the custom ring type options for the phones. The audio files listed in the RINGLIST.DAT file must also be in the root directory of the TFTP server.

P0S3xxyy.bin
(where xx is the version number and yy is the subversion number)

(Required) The Cisco SIP IP phone firmware image.

dialplan.xml

(Optional) North American example dial plan.

syncinfo.xml

(Optional) Controls the image version and associated sync value to be used for remote reboots.


Note   For complete information about configuring the Cisco SIP IP phone, see the Cisco SIP IP Phone 7960 Administration Guide, Version 2.0.

Configuring Startup Network Parameters

Network parameters are the parameters that are required for the phone to connect to the network. They can be configured manually or obtained from a DHCP server. We recommend that you use the DHCP server to distribute network parameters.

If you use DHCP to configure the network parameters, ensure that the following DHCP options have been configured on your DHCP server before you connect your Cisco SIP IP phone:

Configuring SIP Parameters

The SIP parameters are the parameters that the IP phone needs to operate in a SIP environment. The firmware image version that the phone should be running is also defined in the configuration file. Each phone must have its own configuration file.

Upon startup or reboot, Cisco SIP IP phones request their configuration files from the TFTP server. If a configuration file is unavailable on the TFTP server, the phone will use the SIP parameters that were last stored in Flash (as described in the "Configuring the Phone's SIP Settings" section of the Cisco SIP IP Phone 7960 Administration Guide).

There are two types of configuration files:

Using an ASCII text editor, edit the default configuration file and specify the desired parameters. Then, using an ASCII text editor, create a configuration file for each phone that you plan to install. You can define settings for up to six lines.

The SIP phone system parameters (typically defined in the default configuration file) are as follows:

Enter the name of the image version (as released by Cisco). Do not enter the extension. You cannot change the image version by changing the file name because the version is also built into the file header. Trying to change the image version by changing the file name will cause the firmware to fail when it compares the version in the header against the file name.

Default is 5.

Default is 3.

Default is avt.

After a phone has initialized and registered with a proxy server, changing the value of this parameter to 0 will unregister the phone from the proxy server. To re-initiate a registration, change the value of this parameter back to 1.


Note    If you enable registration, and authentication is required, you must specify values for the linex_authname and linex_password parameters (where x is a number 1 through 6) in the phone-specific configuration file.

Default is Auto.

The SIP phone-specific parameters (typically defined in the phone-specific configuration file) are as follows:

This parameter is used for display-only purposes. If a value is not specified for this parameter, the value in the linex_name variable is displayed.


Note    This parameter is best configured in the SIPDefault.dnf file unless configuring a phone to be a "call-out" phone only. When configuring a phone to be a "call-out" phone, define this parameter in the phone-specific configuration file.

Configuring the Cisco SIP Proxy Server

You configure the Cisco SIP Proxy Server by defining directives in a main configuration file. The Cisco SIP Proxy Server main configuration file is sipd.conf. A default sipd.conf configuration file is copied into /usr/local/sip/conf/ when installed on Linux platforms and copied into /opt/sip/conf on Solaris platforms. This default configuration file should be customized to your environment.

Before beginning any of the configuration tasks in this chapter, change to the directory in which the sipd.conf file is located and open the file using vi or any text editor.


Note   For complete information about configuring the Cisco SIP Proxy Server, see the Cisco SIP Proxy Server Administrator Guide.

Similar to the Apache Server, the Cisco SIP Proxy Server directives can be grouped into major categories. The major categories of Cisco SIP Proxy Server directives are:

The term virtual host refers to maintaining more than one server on one machine, as differentiated by their hostname. For example, companies sharing a web server can have their own domains (www.company1.com and www.company2.com) and access to the web server. Virtual hosts are not supported in Cisco SIP Proxy Server Version 1.1.

Configuring Global Directives

The server global directives are generic server directives that define the overall operation of the server. These directives exclude those that configure protocol-specific (HTTP or SIP) details. For example, in the global directive section of the sipd.conf file, you can specify the directory in which the Cisco SIP software resides and how child processes of the Cisco SIP Proxy Server will function.


Note   The directives that configure the Cisco SIP Proxy Server global environment are standard Apache directives. If the default for an Apache directive has been changed for the Cisco SIP Proxy Server usage, the new default is documented. For more detail on Apache directives, see www.apache.org.

To configure the server global directives, define values as necessary for the following directives:


Note    If the server is to be on a NFS or networked mounted filesystem, refer to LockFile documentation at http://www.apache.org/docs/mod/core.html#lockfile.


Note    The maximum and minimum values for the following prefork MPM module directives are dependent on your available platform resources. Modify as required. The prefork module directives are ignored if the ONE_PROCESS environmental variable has been set.

To configure the prefork module, specify values for the following directives:

Configuring the Host-Specific Directives

The server host-specific directives define the basic configuration of the Cisco SIP Proxy Server. The basic configuration consists of values used by the main server which responds to requests that are not handled by a virtual host. The host-specific directives define not only the server access and error logs, but with what frequency logs will be rotated as well.


Note   The directives that define the basic configuration of the Cisco SIP Proxy Server environment are standard Apache directives. If the default for an Apache directive has been changed for the Cisco SIP proxy Server usage, the new default is documented. For more detail on Apache directives, see www.apache.org.

To configure the host-specific directives, define values for the following located in the sipd.conf file:


Note    On SCO (ODT 3), use value "nouser" for User, and use value "nogroup" for Group. On HPUX, if you cannot use "shared memory" as "nobody," create a user "www" and use it. For kernels that refuse to "setgid(Group)" or "semctl(IPC_SET)" when the value of (unsigned)Group is above 60000, do not use Group#-1.

For example, sip-proxy.company.com. This must be a valid DNS name of your host. If this is not available, enter the host IP address. The server will deduce the name from the IP address.

If you want to automatically rotate error/debug log without having to tear down the Cisco SIP Proxy Server (sipd daemon), use the following examples for Linux and Solaris respectively.

ErrorLog "|/usr/local/sip

Default is warn.

For a single logfile with access, agent, and referer information (combined logfile format), use the following directive by uncommenting it:

You can specify a value similar to
/user/local/sip/bin/rotatelogs/usr/local/sip/logs/request_log 86400
in this directive to have access records such as a REGISTER request logged to both the access_log and request_log.0974732040 (number extension is calculated and added based on the current time stamp and the specified rotation frequency). If the CustomLog directive is commented out, access records are logged to the file specified in the TransferLog directive.

Configuring the Cisco SIP Module Core Directives

The Cisco SIP Proxy Server core module implements an RFC 2543-compliant SIP server that can function as a redirect, registrar, or proxy server. If configured to be a proxy, the Cisco SIP Proxy Server can be configured to function as a transaction stateful or stateless server.

To define the Cisco SIP Proxy Server core configuration, define values for the following directives in the Cisco SIP Proxy Server Core module (mod_sip):

When configured to function as a stateful server, on receiving a SIP request, the Cisco SIP Proxy Server creates a TCB in which it maintains a transaction state.

As a stateful proxy server, from the time a SIP request is received until the final response is one transaction. Stateful proxy servers do not originate any SIP requests except for the SIP CANCEL request or an ACK for a non-200 OK final response. When configured to function as stateless proxy server, the Cisco SIP Proxy Server forwards every request downstream and every response upstream.

As a stateful redirect server, the Cisco SIP Proxy server looks up its registry database on receiving a SIP request and returns a 302 response upstream. As a stateless redirect server, the Cisco SIP Proxy Server returns a final response on receiving any request and does not forward any response or request.

Valid values are On and Off. Default is On.

Valid values are:

Default is E164_IP.

Class 1 Class 2 Class 3 Class 4

Low drop

0x28

0x48

0x68

0x88

Medium drop

0x30

0x50

0x70

0x90

High drop

0x38

0x58

0x78

0x98

Some networks may alternatively recognize the Tyoe of Service (RFC1349, RVD1812) bitmasks as follows:


Note    This directive only marks IP packets to a specified value. Marked packets receive special treatment only if the network's IP routers and switches are configured to do so.

Configuring Cisco SIP Module Standard Directives

The Cisco SIP Proxy Server contains eight additional modules that can be used to configure a variety of inerfaces and additional features. The following describes the interfaces and services that you can configure on your Cisco SIP Proxy Server via modules.

Configuring MySQL Database Subscriber Table Interface

The Cisco SIP Proxy Server MySQL module (mod_sip_db_mysql) allows you to configure an interface to a MySQL-database subscriber table to maintain subscriber records for user authentication, authorization, and accounting purposes.

If a MySQL-database subscriber table exists in your network, you can use directives in the MySQL module to map the field names used by the Cisco SIP Proxy Server to those used in the MySQL database subscriber table. If a MySQL subscriber table does not already exist in your network, you must create one useing the "install_mysql_db" script or cut and paste the subscriber.sql into an existing MySQL database, then start the Csico SIP Proxy Server with the MySQL interface enabled.


Note   For terminating features such as the Call Forwarding features, the "user" portion of the Request-URI is the key to query the MySQL database. For originating features such as Authentication, the UserName from the Authorization, Proxy-Authorization header, or From header is the key. In either case, the key may be expanded to a fully expanded E164 number before the MySQL query, depending on the relative configuration directives.

To configure the interface to the MySQL-database subscriber table and map field names used by the Cisco SIP Proxy Server to an existing MySQL-subscriber table, specify values for the following directives in the mod_sip_db_mysql module:


Note    Adjust this value according to the server's traffic load. If the timeout value is too large, more child processes can be blocked.


Note    For information on working with MySQL databases, see www.mysql.com.

<NumberPlan mycompany.com>
NumExp 2.... +1919555....
    NumExp    6....    +1408554....
    NumExp    7....    +1408553....
    NumExp    4....    +1978555....
    NumExp    3....    408556
</NumberPlan>
<StaticRegistry 10.1>
Static_Registry_User_Type           IP
Static_Registry_User                jdoe
Static_Registry_Contact             0015155551212@mycompany.com
Static_Registry_Contact_User_Type   PHONE
Static_Registry_ContactPort         5060
Static_Registry_TransportProtocol   UDP
Static_Registry_ContactAge          Permanent
Static_Registry_Delete_or_Add       ADD
</StaticRegistry>
<StaticRoute 1>
Static_Route_Destination Pattern          001555666
Static_Route_Type                         PHONE
Static_Route_NextHop                      sip_gw1.mycompany.com
Static_Route_NextHopPort                  5060
Static_Route_TransportProtocol            UDP
Static_Route_Priority                     0
Static_Route_Delete_or_Add                Add
</StaticRoute>
<Number_Services 1>
Number_Services_Contact                          911
Number_Services_Priority                         EMERGENCY
<Number_Services_Route 10>
Static_Number_Services_Route_Target              proxyserver@company.com
Static_Number_Services_Route_OriginationPattern  515555
Static_Number_Services_TransportPortocol         UDP
Static_Number_Services_ContactPort               5060
</Number_Services_Route>
</Number_Services>

Note   For complete information about creating and modifying the sipd.conf file, see the Cisco SIP Proxy Server Administration Guide.

Configuring the Cisco uOne Messaging System

There are multiple components that make up the uOne Messaging System. Configuration of the system requires configuration of each of its components.

When implementing the uOne SIP system, be aware of the following:

To configure the uOne system, perform the following tasks:

Task References
Step 1 

Run the Quick Config tool to perform the initial uOne configuration tasks on the gateserver:

  • Configure the uOne system for calls
  • Setup the uOne Subscriber Administration tool
  • Setup the uOne Manager and/or the uOne database

Installing and Configuring uOne 4.2(2)s, SIP Edition

uOne Gateserver Installation and Configuration Manual, Release 4.2(2)s

Step 2 

Make any configuration changes on the gateserver necessary for your operating environment.

Installing and Configuring uOne 4.2(2)s, SIP Edition

SIP Compliance and Call Flows for uOne 4.2(2)s

uOne Gateserver Installation and Configuration Manual, Release 4.2(2)s

uOne Administration Manual, Release 4.2(2)s

Step 3 

Configure the directory server for uOne.

uOne Back End Servers Reference Manual, Release 4.2(2)s

Step 4 

Configure the messaging server for uOne.

Step 5 

Configure the paging server for uOne.

Step 6 

If desired, set up communities of interest.

uOne Administration Manual, Release 4.2(2)s

uOne Back End Servers Reference Manual, Release 4.2(2)s

Step 7 

Set up classes of service.

Step 8 

Provision subscribers.

Step 9 

Create broadcast lists

Step 10 

If necessary, set up additional greeting and/or fax administrators.

Configuring the Cisco Secure PIX Firewall

To configure the Cisco Secure PIX Firewall, perform the following tasks:

Task References
Step 1 

Obtain a console terminal, download the most current software, and configure network routing.

Configuration Guide for the Cisco Secure PIX Firewall Version 6.0

Step 2 

Start the PIX Firewall configuration mode.

Step 3 

Identify each interface.

Step 4 

Create a default route outside.

Step 5 

Permit ping access.

Step 6 

Store image in Flash memory and reboot.

In addition, perform the following tasks:

Configuring the Cisco SS7 Interconnect for VoIP Gateways Solution

There are numerous components that make up the Cisco SS7 Interconnect for VoIP Gateways Solution. The configuration tasks for each component in the solution are briefly described in the following sections:

Configuring the Signaling Controller

Configuring the signaling controller software consists of three tasks:


Caution   Always use the Cisco signaling controller CMM tool or MML commands to create, modify, manage, and deploy your configuration files on the signaling controller. We do not recommend modifying the configuration files directly on the signaling controller.

Configuring the Signaling Controller

To configure the signaling controller, perform the following tasks:

Task Reference
Step 1 

Prepare the following:

  • Bearer routes to other switches
  • Signaling point links (the connection between an MGC and a SIP server)
  • Network access server control links
  • Trunks, trunk groups, and routes (for incoming SIP calls)
  • Dial plans

Cisco Media Gateway Controller Software Release 9 Provisioning Guide

Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide

Step 2 

Configure the SS7 signaling routes to external switches by completing the following tasks:

  • Add the OPC in your network.
  • Add the DPC to identify the destination switch.
  • Add the APCs to identify the STPs with which the signaling controller communicates signaling information.
  • Add linksets to connect the Cisco SLTs to the STPs.
  • Add the SS7 subsystem to identify the mated STPs.
  • Add the SS7 routes for each signaling path from the signaling controller to the destination switch.
  • Add the SS7 signaling service from the signaling controller to the destination switch.

Cisco SS7 Interconnect for Access Servers and Voice Gateways Solutions Provisioning Guide

Step 3 

Provision the signaling links by completing the following tasks:

  • Add the Ethernet adapters (cards) in the SC host that carry signaling to and from the Cisco SLTs.
  • Add Ethernet interfaces for the cards in the host.
  • Add C7 IP links for each SS7 link from the signaling controller to the SS7network (through the Cisco SLT).

Cisco SS7 Interconnect for Access Servers and Voice Gateways Solutions Provisioning Guide

Step 4 

Configure the access gateway control links by completing the following tasks:

  • Add external nodes for the access gateways in your network.
  • Add NAS signaling services for each access gateway.
  • Add IP links for each access gateway to each Ethernet card in the SC host.

Cisco SS7 Interconnect for Access Servers and Voice Gateways Solutions Provisioning Guide

Step 5 

Configure trunks, trunk groups, and routes.

Cisco SS7 Interconnect for Access Servers and Voice Gateways Solutions Provisioning Guide

 

Step 6 

Provision black and white trunk screening.

Step 7 

Build and deploy the configuration.

Configuring the Cisco SLT

To configure the Cisco SLTs, perform the following tasks:

Task Reference
Step 1 

Identify the serial WAN interface card on your Cisco SLT and connect cable to card.

Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide

Step 1 

Install the Cisco SLT image software.

Step 2 

Configure the basic parameters and SS7 links for the Cisco SLT.

Step 3 

Configure Session Manager and RUDP.

Step 4 

Save the new configuration as the startup configuration, and then reload the Cisco SLT.

Configuring the LAN Switch (Optional)

This section describes the task of configuring LAN switches (Cisco Catalyst Switch family) for your solution. The LAN