-
Cisco CallManager Administration Guide, Release 3.0(5)
-
Index
-
Preface
-
System Description
-
Introduction
-
Understanding Distributed Call Processing
-
Understanding Redundancy
-
Understanding Auto-Registration
-
Understanding Call Admission Control
-
Understanding Route Plans
-
Understanding Device Support
-
Understanding Cisco WebAttendant
-
Understanding the LDAP Directory
-
Understanding Service Parameters
-
System Configuration
-
Server
-
Configuring Cisco CallManager
-
Configuring Cisco CallManager Groups
-
Configuring Date/Time Groups
-
Setting Device Defaults
-
Configuring Regions
-
Configuring Device Pools
-
Understanding Enterprise Parameters
-
Configuring Locations
-
Starting and Stopping Cisco CallManager
-
Route Configuration
-
Configuring Partitions
-
Configuring Calling Search Spaces
-
Configuring Route Filters
-
Configuring Route Groups
-
Configuring Route Lists
-
Configuring Route Patterns
-
Configuring Translation Patterns
-
Using the External Route Plan Wizard
-
Using Route Plan Report
-
Service Configuration
-
Cisco Messaging Interface
-
Configuring Cisco TFTP
-
Configuring Cisco WebAttendants
-
Configuring Conference Bridges
-
Configuring Media Termination Point
-
Configuring Service Parameters
-
Configuring Trace
-
Configuring Transcoder
-
Starting and Stopping Services Using the Control Center
-
Feature Configuration
-
Configuring Call Park
-
Configuring Call Pickup
-
Configuring Cisco IP Phone Services
-
Configuring Devices in Cisco CallManager
-
Configuring CTI Route Points
-
Configuring Cisco uOne Voice Messaging
-
Configuring a Gatekeeper
-
Configuring Gateways
-
Configuring Cisco IP Phones in Cisco CallManager
-
Configuring Phone Button Templates
-
User Configuration
-
Adding a New User
-
Searching the Global Directory
-
Appendices
-
Cisco TAPI Service Provider Installation and Configuration
-
Cisco JTAPI Installation and Configuration
-
Creating Custom Cisco IP Phone Rings
-
Feedback
Table Of Contents
Understanding Service Parameters
Cisco CallManager Service Parameters
Cisco Messaging Interface Service Parameters
Cisco IP Voice Media Streaming Service Parameters
Cisco Database Layer Service Parameters
Cisco Telephony Call Dispatcher Service Parameters
Understanding Service Parameters
The Service Parameters configuration pages for Cisco CallManager (release 3.0 and later) allow you to configure several different services on selected servers. With the Service Parameters application, you can insert, modify, and delete service parameters for those services.
CautionYou will never need to add or delete service parameters unless directed by the Cisco Technical Assistance Center (TAC). Some changes to service parameters may cause system failure.
Related Topics
•
•
•
•
•
•
Cisco CallManager Service Parameters
Caution
Note
Table 10-1 contains service parameters configured for Cisco CallManager.
Table 10-1 Cisco CallManager Service Parameters
AbleToEstablishMF
Default: T
Used for certification testing. We recommend you do not change the default value. Valid values are T or F. Sends the SABME at startup instead of waiting for the distance end to do it.
AdHocConferenceMixerType
Default: 2
Specifies the mixer type to be used for AdHoc conferences. If the mixer type is set to Unicast Bridge, when a user presses the Conference button on the phone, the conference supplementary service allocates a Unicast Bridge resource to handle the conference.
AnalogAccessUse729
Default: F
Not supported for Cisco CallManager Release 3.0.
AutoSelectHeldCallFlag
Default: F
Determines whether to automatically select the call on hold when the phone goes off hook if that call was the last signal sent to the phone.
CallDiagnosticsEnabled
Default: F
Determines whether call diagnostic records are generated. Valid values are:
F = not generated
T = generated
CallParkReversionTimeout
Default: 60
The number of seconds to wait before reverting a parked party to the call parker. Valid value is any numeric value.
CallWaitingEnable
Default: T
Enables or disables call waiting for the entire system.
CdrEnabled
Default: F
Determines whether Call Detail Records (CDRs) are generated. Valid values are:
T = Cdrs are generated
F = Cdrs are not generated
CdrLogCallsWithZeroDuration Flag
Default: F
Enables logging of CDR records for calls which were never connected, or which lasted less than one second.
ClearCallsWhenDatalinkGoes Down
Default: T
If the D-channel (datalink) terminates, this setting determines if calls to the phones will be terminated. Valid values are 0 = Do not clear calls when datalink goes down; 1 = Clear calls when datalink goes down.
ConnectDisconnectTimer
Default: 7
Used for debugging purposes only. We strongly recommend you do not change the default value. The maximum time allowed for a response from a connect or disconnect request. Valid value is any numeric value.
DbNoActivityTimeout
Default: 30
The amount of time to wait before closing the file after no database requests have been received. Valid value is any numeric value.
DeviceStatusPollInterval_msec
Denotes the time interval between two change of port status messages. You should not modify the default value.
DigitAnalysisTimer
Default: 6
Used for debugging purposes only. We strongly recommend you do not change the default value. The maximum time allowed for a response from a digit analysis requests. Valid value is any numeric value.
DisplayIEDeliveryFlag
Default: F
This flag (when set to T) enables the delivery of the display IE in SETUP and CONNECT messages for the calling and called party name delivery service.
EnableSNMP
Default: T
This parameter enables the collection of SNMP data from the Cisco CallManager.
ForwardMaximumHopCount
Default: 12
Maximum number of attempts to extend a forwarded call. Valid values are:
(Value >=1)
ForwardNoAnswerTimeout
Default: 12
The number of seconds to wait before forwarding on No Answer Condition. Valid values are:
(Value >=1)
GatekeeperControlRegistration Type
Default: F
H.323 Gatekeeper Control Registration Type. We strongly recommend not changing this parameter unless you have a complete understanding of RAS registration.
GatekeeperRefresh
Default: 60 seconds
The number of seconds between gatekeeper refresh messages.
GatewayKeepAliveTimeout
Default: 25
The number of seconds between Gateway Status messages.
GatewayPollTimeout
Default: 10
The number of seconds to wait for a response from a GatewayOpenReq. Valid value is any numeric value.
H225ConnectTime
Default: 0
H.225ConnectTime determines, on an outgoing H.323/H.225 call, whether processing the open logical channel (when audio is transmitted) on the call proceeding, call alerting, or call connecting.
HoldType
Default: F
Original Hold Type requires the user to press the hold button to retrieve a call from hold. The new hold allows the user to press the line button on which the held call is stored to retrieve it.
InterfaceIdentifierPresentFlag
Default: F
This flag only applies to the DMS100 protocol for the digital access gateway in the Channel Identification IE of the SETUP, CALL PROCEEDING, ALERTING, and CONNECT messages. The purpose of this parameter is to interoperate with Nortel PBX when the PBX is configured to use the DMS100 protocol.
IpPrecedence
Default: 0x000000B0
Used by anyone who configures streaming, phones, media applications, etc. We strongly recommend that this parameter never be changed.
L2RetriesN200
Default: 3
The number of retries before declaring the datalink down. Valid value is any numeric value.
LineStateUpdateEnabled
Default: T
Determines whether Line State Server (used by Cisco WebAttendant) can track the active/inactive states of each line/directory number.
LowPriorityQueueThrottling Flag
Default: F
When low priority TCP queue gets too large, the system starts throwing away new call attempts.
LowPriorityQueueThrottling MaxCount
Default: 1000
The maximum number of outstanding low priority stimulus messages in the queue before new call attempts are discarded. Use this value to adjust call response time. Valid value is any numeric value.
MGCPConnectTime
Default: 30 seconds
All the responses sent by Media Gateway are kept in memory for a certain duration. This duration is set to 30 seconds by default. You should not change this value.
MGCPTimeout
Default: 5 seconds
The number of seconds to wait before Cisco CallManager retries its request.
MatchingCgpnWithAttendant Flag
Default: F
On an outbound analog access gateway call, compare if the calling party number matches one of the associated analog access ports. If so, then select that port, otherwise make it so all ports with an attendant number assigned to them are not usable for the life of the current call. This forces selection of another analog access device if another analog access gateway has been configured in RoutePoint/RouteGroup. If another analog access gateway has not been configured, the user hears a fast busy signal.
MaxAdHocConference
Default: 4
Min: 3
Max: maximum size of largest conference bridge in system
Specifies the maximum number of parties that can be added to a Unicast Ad-Hoc conference.
MaxErrorsToReport
Default: 1
The number of errors to report per datalink establishment. Valid value is any numeric value.
MaxMeetMeConferenceUnicast
Default: 10
Min: 3
Max: maximum size of largest conference bridge in system
Specifies the maximum number of participants that can join a Unicast Meet-Me conference.
MaxNumberOfReceivedIFrames BeforeAcking
Default: 0
Receive 5 I-Frames before responding with a receiver ready (RR) for an acknowledgement (ACK). Valid value is any numeric value.
MaxNumberOfStationsIniting
Default: 50
The maximum number of stations trying to initialize without completing all database requests. Under a heavy load, it is possible to overwhelm the system to the point where no calls can be completed. Set these values to restore usability if the system becomes overwhelmed. Decreasing the LowPriorityQueueThrottlingMaxCount provides faster dial tone, but also increases the chances for calls being rejected. Valid value is any numeric value.
MediaExchangeInterfaceCaps Timeout
Default: 8
The number of seconds for a device to send capabilities for a media connection. Valid value is any numeric value.
MediaExchangeTimeout
Default: 5
The number of seconds for a media connection to be made. Valid value is any numeric value.
OutOfBandwidthText
Default: Not Enough Bandwidth
The text to be displayed when the call cannot be placed because there is not enough bandwidth.
OutStandingIFramesK
Default: 7
The maximum number of outstanding I-Frames which are not acknowledged. Valid value is any numeric value.
OverlapReceivingForPriFlag
Default: F
We strongly recommend using the default setting for this parameter.
PreferredG711Millisecond PacketSize
Default: 20
This is the preferred amount of time set for delivering packets. Value for this parameter should never be set below 20, as this will add latency.
PreferredG723Millisecond PacketSize
Default: 30
This is the preferred amount of time set for delivering packets. This parameter should never be set below 20, as this will add latency.
PreferredG729Millisecond PacketSize
Default: 20
This is the preferred amount of time set for delivering packets. This parameter should never be set below 20, as this will add latency.
RASMulticastFlag
Default: F
Allows for multicast registration of RAS. Caution: Do not set this parameter unless you want all RAS devices to register to Cisco CallManager.
RedirectingNumIEDeliveryFlag
Default: F
This flag applies to the SETUP message only on all protocols for the digital access gateway. When the flag is set to True, the RedirectingNumberIE is included in the SETUP message to indicate the first redirecting number and the redirecting reason of the call when Call Forward happens.
SdlListeningPort
Default: 8002
You should not change this value.
SdlMaxUnHandledExceptions
Default: 5
The maximum number of Cisco CallManager exceptions before Cisco CallManager stops running.
SdlTraceDataSize
Default: 100
This parameter is used in the SDL layer. It tells SDL trace processing how many bytes of raw data to dump from each signal that it traces.
SdlTraceFilePath
Default: c:\ProgramFile\Cisco\Trace\SDL\
The absolute path where SDL trace files are located.
SdlTraceFlag
Default: T
The flag to indicate whether SDL traces should be turned on or off. It is set to true by default, meaning that SDL traces are collected by default.
SdlTraceMaxLines
Default: 10000
The maximum number of lines in each file before starting the next file. Valid value is any numeric value.
SdlTraceTotalNumFiles
Default: 100
The maximum number of files before restarting file count and overwriting old files.
SilenceSuppressionSystemWide
Default: T
Determines whether silence suppression is disabled for all devices on a system-wide basis.
SilenceSuppressionWith Gateways
Default: T
Determines whether silence suppression is disabled for all devices on gateways.
StableIn4Flag
Default: F
Used for certification testing. We recommend you do not change the default value.
Station2ndKeepaliveInterval
Default: 60
The Keepalive Interval for backup server.
StationKeepaliveInterval
Default: 30
The number of seconds between keepalive messages sent to Cisco IP Phones (stations). Use any numeric value starting at 30. We recommend you do not use the 0 value.
StatisticsEnabled
Default: T
Determines whether system statistics are generated. Valid values are:
F = not generated
T = generated
StatusEnqPollFlag
Default: F
Sends status enquiries to H.323 devices to check for out of range status. If the device is determined to be out-of-range, the call is terminated. If the device is within range, sending these status enquiries does not disrupt call connection.
StripPoundCalledPartyFlag
Default: T
This flag (when set to T) enables the stripping of # sign digits from the called party IE, of the inbound and outbound Q.931 and H.225 SETUP message.
SuppressOutOfChansEvents
Default: T
Used for debugging purposes only. We strongly recommend you do not change the default value. Determines whether out of channels responses will be sent to event processing.
TimerSendProgress_msec
Default: 3000
Sometimes the other end does not get back fast enough with the Alert, Progress or Connect while in Call_initiated state.
TimerT1Frame_msec
Default: 2000
Valid value is any numeric value in 1/8 second ticks.
TimerT200_msec
Default: 1000
Layer 2 Retransmission time. This is the only timer value which is in 1/40 second ticks, all other values are in 1/8 second ticks. The increased granularity was needed because of certification testing and requirements which were +/-5% on timers. Valid value is any numeric value in 1/40 second ticks.
TimerT203_msec
Default: 10000
Layer 2 Keepalive. Valid value is any numeric value in 1/8 second ticks.
TimerT301_msec
Default: 180000
User-(Call Delivered) ALERTING Received, Network-(Call Received) ALERTING Received. Valid value is any numeric value in 1/8 second ticks.
TimerT302_msec
Default: 10000
Interdigit Timeout. User-(Overlap Receiving) SETUP ACK sent, Network-(Overlap Sending) SETUP ACK sent. Valid value is any numeric value in 1/8 second ticks.
TimerT303_msec
Default: 4000
User-(Call Initiated) SETUP sent, Network-(Call Present) SETUP sent. Valid value is any numeric value in 1/8 second ticks.
TimerT304_msec
Default: 20000
User-(Overlap Sending) SETUP ACK received, Network-(Overlap Receiving) SETUP ACK received. Valid value is any numeric value in 1/8 second ticks.
TimerT305_msec
Default: 30000
User-(Disconnect Request) DISCONNECT sent, Network-(Disconnect Indication) DISCONNECT without progress ind sent. Valid value is any numeric value in 1/8 second ticks.
TimerT306_msec
Default: 30000
Network-(Disconnect Indication) DISCONNECT with progress ind sent. Valid value is any numeric value in 1/8 second ticks.
TimerT307_msec
Default: 180000
Network-(Null) SUSPEND ACK sent. Valid value is any numeric value in 1/8 second ticks.
TimerT308_msec
Default: 4000
User-(Release Request) RELEASE sent, Network-(Release Request) RELEASE sent. Valid value is any numeric value in 1/8 second ticks.
TimerT309_msec
Default: 90000
User/Network-(Any stable State) Datalink lost. Valid value is any numeric value in 1/8 second ticks.
TimerT310_msec
Default: 10000
User-(Outgoing Call Proceed) CALL PROCEED received, Network-(Incoming Call Proceed) CALL PROCEED received. Valid value is any numeric value in 1/8 second ticks.
TimerT313_msec
Default: 4000
User-(Connect Request) CONNECT sent. Valid value is any numeric value in 1/8 second ticks.
TimerT316_msec
Default: 120000
(Restart Request) RESTART sent. Valid value is any numeric value in 1/8 second ticks.
TimerT317_msec
Default: 300000
Valid value is any numeric value in 1/8 second ticks.
TimerT321_msec
Default: 30000
(Any state) D-Channel failure. Valid value is any numeric value in 1/8 second ticks.
TimerT322_msec
Default: 4000
(Any state) STATUS ENQUIRY sent. Valid value is any numeric value in 1/8 second ticks.
TimerTStatusEnqPoll_msec
Default: 10000
(Any state) Timer initially used to send a StatusEnq. This is done to check to see if Symbol H.323 phone is still attached. Valid value is any numeric value in 1/8 second ticks.
TimeToDelayBeforeSendingAn Ack_msec
Default: 0
The time to wait to send a receiver ready (RR) acknowledgement on a given Non poll I-Frame. Valid value is any numeric value in 25 millisecond ticks. 0 = send immediately.
ToneOnCallForward
Flag to set tone on call forward on, or off.
ToneOnHoldTime
Default: 10
Min: 5
Max: 99999
The number of seconds to play some type of tone when a call is on hold (minimum of five seconds).
TypeOfCalledNumberForH225Devices
Default: 0
Denotes the type of number (TON) for H225 devices. The default value is 0, which denotes the value sent by call control. A value of 1 indicates an unknown number. A value of 2 denotes a national number and 3, an international number.
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
UnknownCallerId
The directory number to be displayed. Valid value is any numeric value representing a general number for your system (if you wish to provide caller ID functionality to called parties). Valid value is any valid telephone number.
UnknownCallerIdFlag
Default: T
This parameter is related to the Unknown CallerId field. We strongly recommend using the default setting since this can now be configured using Cisco CallManager Administration.
UnknownCallerIdText
Default: Unknown
The text to be displayed to called parties who have caller ID capability. The first line is 20 characters and the second line is 14 characters. Use a character setup that can be broken into two lines, each of which has the specified number of characters per line.
UserUserIEStatus
Default: F
If the user-to-user information element (UUIE) is passed in the system, enabling UUIE status allows ISDN PRI messages to include them on outbound PRI calls.
Related Topics
•
Cisco TFTP Service Parameters
Caution
Note
Table 10-2 contains service parameters configured for Cisco TFTP.
Table 10-2 Cisco TFTP Service Parameters
AnalogTcpPort
Default: 2002
Not used under normal circumstances.
CallManagerIp
Default: 127.0.0.1
Not used under normal circumstances.
CallManagerIpTrack
Default: T
Not used under normal circumstances.
ChangeUDPPort
Default: 3000
Do not change this parameter.
DigitalTcpPort
Default: 2001
Not used under normal circumstances.
FileDelete
Default: T
Flag that enables configuration file deletion. This is necessary to ensure deleted devices do not still get configuration files.
FileLocation
Default: c:\Program Files\Cisco\TFTPpath
String that represents the primary path for building and serving files.
PhoneTcpPort
Default: 2000
Not used under normal circumstances.
ServerIpTrack
Default: T
True means use default local IP address. Do not change this parameter.
TFTPIp
Default: 127.0.0.1
String that represents the IP address of the TFTP server if ServerIpTrack is false.
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
UseDb
Default: T
Do not change this parameter.
Related Topics
•
•
Cisco Messaging Interface Service Parameters
Caution
Note
Table 10-3 contains service parameters configured for Cisco Messaging Interface (CMI).
Table 10-3 Cisco Messaging Interface (CMI) Service Parameters
BackupCallManagerName
This parameter is used to define the names of the Cisco CallManagers that are going to be used for the CMI backup. You can use either the name of a Cisco CallManager or its IP address.
BaudRate
Recommended default: 9600
This parameter defines the RS-232 connection that Cisco CallManager uses to connect to the voice mail system.
Note
CallManagerName
If the default is left blank, CMI will choose the Cisco CallManager, if existing on a local machine.
This parameter is used to define the names of the Cisco CallManagers that are going to be used for the primary CMI. You can use either the name of a Cisco CallManager or its IP address.
DataBits
Default: 7
This parameter defines the RS-232 connection that Cisco CallManager uses to connect to the voice mail system..
DialingPlan
This parameter is one of four that are required by CMI to register an intercept for the voice mail system with which CMI is going to work.
Note
InputDnSignificantDigits
Default: 10
This parameter is designed to accommodate the differences between voice mailbox numbers and directory numbers (DNs). If a legacy voice mail system has mailbox numbers that are no longer than the DNs on the system, this parameter can be used to strip the most significant digits. The numeric value of this parameter indicates how many digits should be used.
KeepAliveDn
None
This is a string parameter. For most voice mail systems a value of F is acceptable. However, some Octel systems periodically send an invalid DN specifically for the purpose of verifying that the attached Cisco CallManager is functioning properly. In this case, you can turn off ValidateDns if you know the DN that the Octel system will use as a keep-alive. By programming that DN into the KeepAliveDn parameter, you will ensure that the invalid DN message is returned to the voice mail system when needed.
MwiSearchSpace
The search space to use when determining the device to be affected by the MWI lamp.
OutputDnFormat
Default: %010s
This parameter is used to format the DNs sent to the voice mail system. Most numbers passed to the voice mail system are formatted using this parameter.
OutputExternalFormat
Default: %010s
This parameter is also used to format the DNs sent to the voice mail system. Most numbers passed to the voice mail system are formatted using this parameter.
Parity
Default: Even
This parameter defines the RS-232 connection that CMI uses to connect to the voice mail system.
Note
RouteFilter
This parameter is one of four that are required by CMI to register an intercept for the voice mail system with which CMI is going to work.
Note
SerialPort
Default: COM1
This parameter defines the RS-232 connection that CMI uses to connect to the voice mail system.
Note
SsapiKeepAliveInterval
Default: 30
This is a numeric parameter. During normal operations, CMI is attached to a Cisco CallManager. When this is the case, CMI sends a keep-alive message to the Cisco CallManager at the rate (in seconds) specified by this parameter.
Note
StopBits
Default: 1
This parameter defines the RS-232 connection that CMI uses to connect to the voice mail system.
ValidateDns
Default: T
When CMI receives incoming lamp commands from the voice mail system, it normally validates the associated DN against the NumPlan table. This is an attempt to verify that the DN matches an existing DN known to Cisco CallManager. If the DN is not found in NumPlan, an invalid DN message is sent to the voice mailbox.
Note
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
VoiceMailDn
This parameter represents the voice mail access number.
VoiceMailPartition
This parameter is one of four that are required by CMI to register an intercept for the voice mail system with which CMI is going to work. It is the partition in which the voice mail DN resides.
Related Topics
•
•
•
Cisco IP Voice Media Streaming Service Parameters
Caution
Table 10-4 contains service parameters configured for Cisco IP Voice Media Streaming.
Table 10-4 Cisco IP Voice Media Streaming Service Parameters
CFB:OrphanStreamTimeout
Default: 300
Time set (number of seconds) for orphaned CFB calls to stay up when a Cisco CallManager goes down.
ChangeUDPPort
Default: 3000
Do not change this parameter.
MTP:OrphanStreamTimeout
Default: 300
Time set (number of seconds) for orphaned calls or conferences to stay up when a Cisco CallManager goes down.
MTP:RunFlag
Default: F
This flag (when set) enables MTP.
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
Related Topics
•
•
•
•
Cisco Database Layer Service Parameters
Caution
Table 10-5 contains service parameters configured for the Database Layer.
Table 10-5 Cisco Database Layer Service Parameters
MaxCdrRecords
A service-wide parameter that specifies the maximum number of CDR records to keep. If the CDR tables get too full (the number of records reaches this maximum number) then the oldest records are deleted and a message is sent to the Event log. This check occurs once a day.
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
Related Topics
•
•
•
•
Cisco Telephony Call Dispatcher Service Parameters
Caution
Table 10-6 contains service parameters configured for Cisco Telephony Call Dispatcher.
Table 10-6
CCN Line State Port
Default: 3223
This is the port number of the TCP/IP port in Cisco CallManager that is used by the line state server to register and receive line and device information.
LSS Access Password
Default: private
This is the default password used at registration to authenticate line state server.
LSS Listen Port
Default: 3221
This is the TCP port where WA clients register with TcdSrv for Line and Device state information.
TCDServ Listen Port
Default: 4321
This is the TCP port where WA clients register with TcdSrv for Call Control.
Refer to the "Configuring Trace" section for descriptive and configuration information on all trace parameters.
Cisco Telephony Call Dispatcher
Related Topics
•
