|
|
This section documents new commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference documents. The following new commands are used to configure and monitor VoIP for the Cisco AS5300:
best-effort | Indicates that Resource Reservation Protocol (RSVP) makes no bandwidth reservation. |
controlled-load | Indicates that RSVP guarantees a single level of preferential service, presumed to correlate to a delay boundary. The controlled load service uses admission (or capacity) control to ensure that preferential service is received even when the bandwidth is overloaded. |
guaranteed-delay | Indicates that RSVP reserves bandwidth and guarantees a minimum bit rate and preferential queueing if the bandwidth reserved is not exceeded. |
Best effort. Using the no form of this command is the same as the default.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the acc-qos dial peer command to generate an SNMP event when the quality of service for a specified dial peer drops below the specified level. When a dial peer is used, the Cisco IOS software reserves a certain amount of bandwidth so that the selected quality of service can be provided. Cisco IOS software uses RSVP to request quality of service guarantees from the network.
To select the most appropriate value for this command, you need to be familiar with the amount of traffic this connection supports and what kind of impact you are willing to have on it. The Cisco IOS software generates a trap message when the bandwidth required to provide the selected quality of service is not available.
This command applies only to VoIP peers.
The following example selects guaranteed-delay as the specified level below which an SNMP trap message will be generated:
dial-peer voice 10 voip acc-qos guaranteed-delay
req-qos
+ | (Optional) Plus sign (+), which can be used as the first digit to indicate an E.164 standard number. |
string | Series of digits that specify the E.164 or private dialing plan telephone number. Valid entries are as follows: · Digits 0 through 9, letters A through D, pound sign (#), and asterisk (*), which represent specific digits that can be entered. · Comma (,), which inserts a pause between digits. · Period (.), which matches any entered digit. |
The default value is for this command is answer-address enabled using a null string for the E.164 telephone number.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the answer-address command to identify the origin (or dial peer) of incoming calls from the IP network---meaning, the calling number. Cisco IOS software identifies the dial peers of a call in one of two ways: by identifying the interface through which the call is received or through the telephone number configured with the answer-address command. In the absence of a configured telephone number, the destination pattern of the dial peer configured for the interface will be associated with the incoming call.
For calls coming in from a POTS interface, the answer-address command is not used to select an incoming dial peer. The incoming POTS dial peer is selected on the basis of the port configured for that dial peer.
This command applies to both VoIP and POTS dial peers.
The following example configures the E.164 telephone number, "379-9626," as the dial peer of an incoming call:
dial-peer voice 10 pots answer-address 3799626
destination-pattern
port
prefix
filename | Identifies the CODEC file stored in VFC Flash memory. |
slot-number | Identifies the slot where the VFC is installed. Valid values are 0, 1, and 2. |
Global configuration
This command first appeared in Cisco IOS Release 11.3 NA.
When VCWare is unbundled, it automatically adds DSPWare to Flash memory, creates both the capability and default file lists, and populates these lists with the default files for that version of VCWare. The capability list defines the available voice CODECs for H.323 capability negotiation. Use the cap-list vfc command to add the indicated voice CODEC overlay file (defined by file-name) to the capability file list in Flash memory.
The following example adds the following CODEC to the list included in Flash memory:
config terminal cap-list cdc-g711-1.0.14.0.bin vfc 0
default-file vfc
To customize E1 R2 signalling parameters for a particular E1 channel group on a channelized E1 line, use the cas-custom controller configuration command. To disable the signalling customization, use the no form of this command.
cas-custom channel
channel | Specifies a single channel group number, which can be from 0 to 30. This channel group number must match the channel number specified in the cas-group command. |
No customized signalling parameters are set. If you do not specify a country name using the country name command, which is described in Table 5, ITU is the selected default signal.
Controller configuration
This command first appeared in Cisco IOS Release 11.2 P.
The customization parameters set by the cas-custom channel command are applied to the same channel group number used in the cas-group channel timeslots range type signal command. These channel group numbers must match. Otherwise, the customized features specified by the cas-custom command will not be applied to the cas-group command's configuration. The signalling customization will not take effect.
However, you will not need to configure or set more than one channel group number per E1 line in most cases. It is possible to split a single E1 (timeslots 1 to 31) into two groups (for example, 1 to 15 on group 1 and timeslots 17 to 31 in group 2), although this practice is rarely used.
Cisco strongly recommends that you use the use-defaults option when specifying a particular country type. See the country name command in Table 5. This additional keyword ensures that all the local country settings are correctly enabled. For example, enter the country greece use-defaults command. If the use-defaults option is not specified, generic ITU will be the default setting for all countries.
You can configure the system to deviate from a country's default settings as defined by Cisco. To configure the system to deviate from a country's default setting, choose from the following list of commands described in Table 5: ani-digits min number max number, answer-signal {group-a | group-b} number, caller-digits number, category number, dnis-digits min number max number, invert-abcd, ka number, kd number, metering, nc-congestion, and unused-abcd value. To revert to a country's country-specific default settings, enter the country name use-defaults command. To revert to a country's ITU standard setting, enter the default country name use-defaults command.
Table 5 shows a list of command options in cas-custom mode, which is used to customize R2 signalling settings. Some switches require you to fine tune your R2 settings. Do not tamper with these commands unless you understand exactly how your switch will be affected.
| Command | Purpose |
|---|---|
ani-digits min number max number | Requested number of ANI digits for each call. All calls that do not match the minimum and maximum settings that you specify will be dropped. The minimum number of collected digits is set by min number. Replace the number variable with a value from 0 to 64. The maximum number of collected digits is set by max number. Replace the number variable with a value from 5 to 64. By default, ANI digits are not collected, which is the ITU standard. |
answer-signal {group-a | group-b} number | Answer signal to be used. You can specify the group A signal or the group B signal. Replace the number variable with a value from 1 to 15. Default is group-b 6, which is the ITU default. |
caller-digits number | Specifies the number of digits the access server needs to collect before it requests ANI or caller ID information. Replace the number variable with a value from 1 to 10. Default is 1, which is the ITU default. |
category number | Specifies the category type of the incoming call, which is mapped to a group signal number. Replace the number variable with a value from 1 to 15. Default is 1, which is the ITU default. |
country name use-defaults | Specifies the local, region, country, and some corporation settings for R2 signalling. Replace the name variable with one of the following supported country names. Cisco strongly recommends that you include the use-defaults option, which enables the default settings for a specific country. Default country setting is ITU.
|
|
|
|
|
default | Sets a command to its default setting. |
dnis-digits min number max number | Requested number of DNIS digits for each call. All calls that do not match the minimum and maximum settings that you specify will be dropped. The minimum number of collected digits is set by min number. Replace the number variable with a value from 0 to 64. The maximum number of collected digits is set by max number. Replace the number variable with a value from 5 to 64. By default, DNIS digits are not collected, which is the ITU standard. |
invert-abcd | Inverts the ABCD bits before tx and after rx. This feature is disabled by default, which is the ITU default. |
ka number | Specifies the KA signal code. Replace the number variable with a value from 1 to 15. Default is 0, which is the ITU default. |
kd number | Specifies the KD signal code. Replace the number variable with a value from 1 to 15. Default is 0, which is the ITU default. |
metering | Specifies sending a metering pulse when the access server is making an outgoing call. Metering is turned off by default, which is the ITU default. |
nc-congestion | Specifies the noncompelled congestion signal. This signal is sent to the central office when the access server is congested and cannot accept the call. The default is B4, which is the ITU default. |
no | Negates a command or sets its defaults. |
request-category | DNIS digits to be collected before requesting a category. A category specifies different priority levels for different calls within R2, such as data calls versus voice calls. This information is primarily used for the switches that forward the calls to the network access server. |
unused-abcd value | Specifies unused ABCD bit values, which can have a 0 or 1 bit value. This feature is disabled by default, which is the ITU default. |
The following example displays the available signalling parameters after you enter cas-custom mode. Notice that the same channel group 1 is specified in the cas-group command and the cas-custom command.
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z router(config)# controller e1 1 router(config-controller) cas-group 1 timeslots 1-31 type r2-digital r2-compelled router(config-controller) cas-custom 1 router(config-ctrl-cas)# ? CAS custom commands: ani-digits Expected number of ANI digits answer-signal Answer signal to be used caller-digits Digits to be collected before requesting CallerID category Category signal country Country Name default Set a command to its defaults dnis-digits Expected number of DNIS digits exit Exit from cas custom mode invert-abcd invert the ABCD bits before tx and after rx ka KA Signal kd KD Signal metering R2 network is sending metering signal nc-congestion Non Compelled Congestion signal no Negate a command or set its defaults request-category DNIS digits to be collected before requesting category unused-abcd Unused ABCD bit values
You can localize your R2 configuration for a specific country. Remember to include the use-defaults option as described in Table 5. For example, use the country argentina use-defaults command for an R2 scenario in Argentina.
router(config-ctrl-cas)# country ? argentina Argentina australia Australia brazil Brazil china China columbia Columbia costarica Costa Rica easteurope East Europe ecuador-itu Ecuador ITU ecuador-lme Ecuador LME greece Greece guatemala Guatemala hongkong-china Hong Kong (China variant) indonesia Indonesia israel Israel itu ITU korea Korea malaysia Malaysia newzealand New Zealand paraguay Paraguay peru Peru philippines Philippines saudiarabia Saudi Arabia singapore Singapore southafrica-panaftel South Africa Panaftel telmex Telmex telnor Telnor thailand Thailand uruguay Uruguay venezuela Venezuela vietnam Vietnam router(config-ctrl-cas)# country argentina ? use-defaults Use Country defaults <cr> router(config-ctrl-cas)# country argentina use-defaults
The following example customizes the signalling for channel group 1. The configuration collects three digits before it requests ANI information for analog calls received on a Cisco AS5300 in Argentina.
router(config-controller)# cas-custom 1 router(config-ctrl-cas)# country argentina use-defaults router(config-ctrl-cas)# caller-digits 3 router(config-controller)# ^z router(config)#
Because cas-custom mode gives you the flexibility to customize R2 parameters, the margin for user error increases. Therefore, the Cisco IOS software enables you to return a country to its default R2 settings using the use-defaults option. The following example begins by bringing up Argentina's default settings, changes a few customization parameters, and then returns the Argentina R2 setting to its original state.
router(config-ctrl-cas)# country argentina use-defaults router(config-ctrl-cas)# caller-digits 3 router(config-ctrl-cas)# unused-abcd 1 router(config-ctrl-cas)# metering router(config-ctrl-cas)# country argentina use-defaults
cas-group (controller E1)
To configure channel-associated signalling on an E1 controller, use the cas-group controller configuration command. To disable channel-associated signalling for one or more timeslots, use the no form of this command.
cas-group channel timeslots range type signal
No channel-associated signalling is configured on the controller. All R2 signalling types have DNIS turned on by default.
Controller configuration
This command first appeared in Cisco IOS Release 11.2 P.
Use this command to configure support for incoming and outgoing call signals (such as on-hook and off-hook) on each E1 controller.
If you specify the timeslot range 1-31, the system software automatically uses the 16th timeslot to transmit the channel-associated signalling.
The signalling you configure on the access server must match the signalling used by the central office. For example if the central office switch is forwarding R2 analog signalling to a Cisco AS5300, then the access server's E1 controller must also be configured for R2 analog signalling (r2-analog).
All R2 signalling options have DNIS support turned on by default. If you enable the ani option, the collection of DNIS information is still performed. Specifying the ani option does not disable DNIS. DNIS is the number being called. ANI is the caller's number. For example, if you are configuring router A to call router B, then the DNIS number is router B; the ANI number is router A. ANI is very similar to caller ID.
To customize the R2 signalling parameters, refer to the cas-custom controller configuration command. When you enable the cas-group command, the cas-custom command is automatically set up to be polled for configuration information. However, unless you enable or turn on specific features with the cas-custom command, the cas-custom feature has an empty set of signalling parameters.
DNIS is automatically collected for modem pools and R2 tone signalling. You need not specify the collection of DNIS information with the cas-group command. However, if you are using non-R2 tone signalling, the system must be manually configured to collect DNIS information. For non-R2 CAS signalling, DNIS collection is done only for E&M-fgb.
In most cases, you will configure the same channel-associated signalling on each E1 controller. The following examples configure signalling and customized parameters on controller E1 2 using the cas-group and cas-custom controller configuration commands.
The actual channel-associated signalling is configured on the 16th timeslot, which is the reason why this timeslot does not come up in the following output.
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# controller e1 2 router(config-controller)# cas-group 1 timeslots 1-31 type r2-digital r2-compelled ani router(config-controller)# %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 1 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 2 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 3 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 4 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 5 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 6 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 7 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 8 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 9 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 10 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 11 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 12 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 13 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 14 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 15 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 17 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 18 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 19 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 20 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 21 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 22 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 23 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 24 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 25 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 26 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 27 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 28 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 29 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 30 is up %DSX0-5-RBSLINEUP: RBS of controller 0 timeslot 31 is up
The following example shows all the supported E1 signalling types on a Cisco AS5300:
router(config-controller)# cas-group 1 timeslots 1-31 type ? e&m-fgb E & M Type II FGB e&m-fgd E & M Type II FGD e&m-immediate-start E & M Immediate Start fxs-ground-start FXS Ground Start fxs-loop-start FXS Loop Start p7 P7 Switch r2-analog R2 ITU Q411 r2-digital R2 ITU Q421 r2-pulse R2 ITU Supplement 7 sas-ground-start SAS Ground Start sas-loop-start SAS Loop Start router(config-controller)# cas-group 1 timeslots 1-31 type r2-analog ? dtmf DTMF tone signalling r2-compelled R2 Compelled Register Signalling r2-non-compelled R2 Non Compelled Register Signalling r2-semi-compelled R2 Semi Compelled Register Signalling <cr>
R2 signalling parameters can be customized with the cas-custom controller configuration command:
router(config-controller)# cas-custom 1 router(config-ctrl-cas)# ? CAS custom commands: caller-digits Digits to be collected before requesting CallerID category Category signal country Country Name default Set a command to its defaults exit Exit from cas custom mode invert-abcd invert the ABCD bits before tx and after rx metering R2 network is sending metering signal nc-congestion Non Compelled Congestion signal no Negate a command or set its defaults
cas-custom
To configure channel-associated signalling on a T1 controller, use the cas-group controller configuration command. To disable channel-associated signalling for one or more timeslots, use the no form of this command .
cas-group channel timeslots range type signal [[tone {dtmf | mf}] [service {voice | data}]]
channel | Specifies a single channel group number, which can be from 0 to 23. |
timeslots range | Specifies a timeslot range of values from 1 to 24. |
type signal | Specifies the type of robbed-bit signalling. Choose one of the following signal types to configure: · e&m-fgb dtmf [dnis] · e&m-fgd dtmf [dnis] · e&m-immediate-start---Specifies ear and mouth channel signalling with Immediate Start support. · fxs-loop-start--- Specifies Foreign Exchange Station Loop Start signalling support. · fxs-ground-start---Specifies Foreign Exchange Station Ground Start signalling support. · sas-loop-start---Specifies Special Access Station loopstart signalling support. · sas-ground-start---Specifies Special Access Station ground start signalling support. |
tone | Specifies the type of tone used. There are two available type of tones:
|
service | Specifies the type of service used. There are two available types of service:
|
cas-group 0 timeslots 1-24 type e&m-fgb dtmf
Controller configuration
This command first appeared in Cisco IOS Release 11.2.
Use this command to enable an integrated modem to receive and transmit incoming and outgoing call signalling (such as on-hook and off-hook) through each T1 controller.
By configuring DNIS as part of the cas-group command, the system can collect DNIS digits for incoming calls that can be directed as VoIP calls, or alternately can be redirected to specific modem pools set up for different customers or users. To support modems you must be running MICA modems in the system and have at least 10 percent of your total modems in the default modem pool.
Two new service types have been added to this command. The service types are:
For e&m-fgb and e&m fgd, the following tone types have been added:
For these two CAS signalling types, the tone types mf and dnis are always required. They can be used for both voice and data calls.
The following example configures the required signalling to support modem pooling and the DNIS over channelized T1 lines on a Cisco AS5300.
router# configure terminal Enter configuration commands, one per line. End with CNTL/Z. router(config)# controller t1 0 router(config-controller)# cas-group 0 timeslots 1-24 type e&m-fgb dtmf dnis router(config-controller)# exit router(config)# router(config)# modem-pool accounts1 router(config-modem-pool)# pool-range 30-50 router(config-modem-pool)# called-number 2000 max-conn 21 router(config-modem-pool)# exit router(config)#
slot/port | (Optional) Identifies the location (and thereby the identity) of a specific modem. |
modem-group-number | (Optional) Designates a defined modem group. |
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
Use the clear csm-statistics modem command to clear CSM statistics for a particular modem or group of modems. If the slot/port is specified, the CSM call statistics for calls using the identified modem will be cleared. If a modem group number is specified, then the CSM call statistics for calls using the modems associated with that group will be cleared. If no argument is specified, all CSM call statistics for all modems will be cleared.
The following example clears CSM call statistics for calls coming in on modems associated with modem group 2:
config terminal clear csm-statistics modem 2
clear csm-statistics voice
slot/dspm/dsp/dsp-channel | (Optional) Identifies the location of a particular DSP channel. |
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
Use the clear csm-statistics voice command to clear CSM statistics for a particular DSP channel. If the slot/dspm/dsp/dsp-channel is specified, the CSM call statistics for calls using the identified DSP channel will be cleared. If no argument is specified, all CSM call statistics for all DSP channels will be cleared.
The following example clears CSM call statistics for calls coming in on all DSP channels:
config terminal clear csm-statistics voice
clear csm-statistics modem
g711alaw | G.711 A-Law 64,000 bits per second (bps). |
g711ulaw | G.711 U-Law 64,000 bps. |
g729r8 | G.729 8000 bps. |
The default value for this command is g729r8.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the codec command to define a specific voice coder rate of speech for a dial peer.
For toll quality, use g711alaw or g711ulaw. These values provide high-quality voice transmission but use a significant amount of bandwidth. For almost toll quality (and a significant savings in bandwidth), use the g729r8 value.
If codec values for the VoIP peers of a connection do not match, the call will fail.
This command applies only to VoIP peers.
The following example configures a voice coder rate that provides toll quality and uses a relatively high amount of bandwidth:
dial-peer voice 10 voip codec g711alaw
comfort-noise
no comfort-noise
This command has no arguments or keywords.
The default value for this command is enabled.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the comfort-noise command to generate background noise to fill silent gaps during calls if voice activity detection (VAD) is activated. If comfort noise is not enabled, and VAD is enabled at the remote end of the connection, the user will hear dead silence when the remote party is not speaking.
The configuration of comfort-noise only affects the silence generated at the local interface; it does not affect the use of VAD on either end of the connection, or the silence generated at the remote end of the connection.
The following example enables background noise:
voice-port 0:D comfort-noise
vad
plar | (Optional) Specifies a private line auto ringdown (PLAR) connection. PLAR is handled by associating a peer directly with an interface; when an interface goes off-hook, the peer is used to set up the second call leg and conference them together without the caller needing to dial any digits. |
string | Specifies the destination telephone number. Valid entries are any series of digits that specify the E.164 telephone number. |
The default value for this command is no connection.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the connection command to specify a connection mode for a specific interface. Use the connection plar command to specify a PLAR interface. The string you configure for this command is used as the called number for all calls coming in over this voice port. The destination dial peer is determined on the basis of this called number.
If the connection command is not configured, the standard session application outputs a dial tone when the interface goes off-hook until enough digits are collected to match a dial peer and complete the call.
The following example selects PLAR as the connection mode, with a destination telephone number of 379-9262:
voice-port 0:D connection plar 3799262
session-protocol
slot-number | Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2. |
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
Use the copy flash vfc command to use the standard copy user interface to copy a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory. The VFC is a plug-in feature card for the Cisco AS5300 and has its own Flash memory storage for embedded firmware. For more information about VFCs, refer to Installing Voice over IP Feature Cards in Cisco AS5300 Universal Access Servers.
Once the VCWare file has been copied, use the unbundle vfc command to uncompress and install VCWare.
The following example copies a new version of VCWare from the Cisco AS5300 motherboard to VFC Flash memory:
copy flash vfc 0
copy tftp vfc
unbundle vfc
slot-number | Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2. |
Privileged EXEC
This command fist appeared in Cisco IOS Release 11.3 NA.
Use the copy tftp vfc command to copy a new version of VCWare from a TFTP server to VFC Flash memory. The VFC is a plug-in feature card for the Cisco AS5300 and has its own Flash storage for embedded firmware. For more information about VFCs, refer to Installing Voice Over IP Feature Cards in Cisco AS5300 Universal Access Servers.
Once the VCWare file has been copied, use the unbundle vfc command to uncompress and install VCWare.
The following example copies a file from the TFTP server to VFC Flash memory:
copy tftp vfc 0
copy flash vfc
unbundle vfc
australia | Specifies an analog voice interface-related default tone, ring, and cadence setting for Australia. |
brazil | Specifies an analog voice interface-related default tone, ring, and cadence setting for Brazil. |
china | Specifies an analog voice interface-related default tone, ring, and cadence setting for China. |
finland | Specifies an analog voice interface-related default tone, ring, and cadence setting for Finland. |
france | Specifies an analog voice interface-related default tone, ring, and cadence setting for France. |
germany | Specifies an analog voice interface-related default tone, ring, and cadence setting for Germany. |
japan | Specifies an analog voice interface-related default tone, ring, and cadence setting for Japan. |
northamerica | Specifies an analog voice interface-related default tone, ring, and cadence setting for North America. |
sweden | Specifies an analog voice interface-related default tone, ring, and cadence setting for Sweden. |
unitedkingdom | Specifies an analog voice interface-related default tone, ring, and cadence setting for the United Kingdom. |
The following syntax descriptions apply to E1 R2 signalling:
locale | Keyword specifying an analog voice interface-related default tone, ring, and cadence settings for a specified country. Valid entries are listed in Table 6. |
| Cptone Command Entry | Country |
|---|---|
ar | Argentina |
au | Australia |
at | Austria |
be | Belgium |
br | Brazil |
ca | Canada |
cn | China |
co | Colombia |
cz | Czech Republic |
dk | Denmark |
fi | Finland |
fr | France |
de | Germany |
gb | Great Britain |
gr | Greece |
hk | Hong Kong |
hu | Hungary |
is | Iceland |
in | India |
id | Indonesia |
ie | Ireland |
il | Israel |
it | Italy |
jp | Japan |
kr | Korea Republic |
lu | Luxembourg |
my | Malaysia |
mx | Mexico |
nl | Netherlands |
nz | New Zealand |
no | Norway |
pe | Peru |
ph | Philippines |
pl | Poland |
pt | Portugal |
ru | Russian Federation |
sg | Singapore |
sk | Slovakia |
si | Slovenia |
za | South Africa |
es | Spain |
se | Sweden |
ch | Switzerland |
tw | Taiwan |
th | Thailand |
tr | Turkey |
us | United States |
ve | Venezuela |
The default values for this command are northamerica (for ISDN PRI) and us for (E1 R2 signalling).
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the cptone command to specify a regional analog voice interface-related default tone, ring, and cadence setting for a specified voice port. This command only affects the tones generated at the local interface. It does not affect any information passed to the remote end of a connection, or any tones generated at the remote end of a connection.
If your device is configured to support E1 R2 signalling, the E1 R2 signalling type (whether ITU, ITU variant, or local variant as defined by the cas-custom command) needs to match the appropriate PCM encoding type as defined by the cptone command. For countries for which a cptone value has not yet been defined, you can try the following:
The following example configures Japan as the call progress tone locale:
voice-port 0:D cptone japan
The following example configures Brazil as the call progress tone locale on the Cisco AS5300:
voice-port 1:0 cptone BR description Brasil Tone
filename | Indicates the file to be retrieved from VFC Flash memory and used (as the default file) to boot up the system. |
slot | Indicates the slot on the Cisco AS5300 where the VFC is installed. Valid entries are from 0 to 2. |
Global configuration
This command first appeared in Cisco IOS Release 11.3 NA.
When VCWare is unbundled, it automatically adds DSPWare to Flash memory, creates both the capability and default file lists, and populates these lists with the default files for that version of VCWare. The default file list includes the files that will be used to boot up the system.
Use the default-file vfc command to add a specified file to the default file list, replacing the existing default for that extension type.
The following example specifies that the "bas-vfc-1.0.14.0.bin" file, which is stored in VFC Flash memory, be added to the default file list:
config term default-file bas-vfc-1.0.14.0.bin vfc 0
cap-list vfc
delete vfc
To delete a file from VFC Flash memory, use the delete vfc privileged EXEC command.
delete filename vfc slot
filename | Specifies the file in VFC Flash memory to be deleted. |
slot | Specifies the slot on the Cisco AS5300 where the specified VFC resides. Valid entries are from 0 to 2. |
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
Use the delete vfc command to delete a specific file from VFC Flash memory, and to remove the file from the default list or capability list if the specified file is included on those lists.
The following example deletes the "bas-vfc-1.0.14.0.bin" file, which is stored in VFC Flash memory of the VFC located in slot 0:
delete bas-vfc-1.0.14.0.bin vfc 0
default-file vfc
show vfc directory
erase vfc
string | Character string from 1 to 255 characters. |
The default for this command is description enabled using a null string for the description.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the description command to include descriptive text about this voice-port connection. This information is displayed when you issue a show command and does not affect the operation of the interface in any way.
The following example identifies this voice port as being connected to the purchasing department:
voice-port 0:D description purchasing_dept
+ | (Optional) Plus sign (+), which can be used as the first digit to indicate an E.164 standard number. |
string | Series of digits that specify the E.164 or private dialing plan telephone number. Valid entries are: · Digits 0 through 9, letters A through D, pound sign (#), and asterisk (*), which represent specific digits that can be entered. · Comma (,), which inserts a pause between digits. · Period (.), which matches any entered digit. |
The default value for this command is destination-pattern enabled using a null string.
Dial-peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the destination-pattern command to define the E.164 telephone number for this dial peer---meaning the called number.
This pattern is used to match dialed digits to a dial peer. The dial peer is then used to complete the call. When a router receives voice data, it compares the called number (the full E.164 telephone number) in the packet header with the number configured as the destination pattern for the POTS peer. The router then strips out the explicit left-justified numbers corresponding to the destination pattern. If you have configured a prefix, the prefix is appended to the front of the remaining numbers, creating a dial string, which the router then dials. If all numbers in the destination pattern are stripped out, the user receives a dial tone.
There are certain areas in the world (for example, in certain European countries) where valid telephone numbers can vary in length. Use the optional control character t to indicate that a particular destination-pattern value is a variable-length dial string. If you use t, the system will not match the dialed numbers until the interdigit timeout value has expired.
This command is applicable to both VoIP and POTS dial peers.
The following example configures the E.164 telephone number, "479-7922," for a dial peer:
dial-peer voice 10 pots destination-pattern 4797922
answer-address
prefix
max-size number | Specifies the maximum size of the call history table. Valid entries are from 0 to 500 table entries. A value of 0 will prevent any history from being retained. |
retain-timer number | Specifies the length of time, in minutes, for entries in the call history table. Valid entries are from 0 to 2147483647 minutes. A value of 0 will prevent any history from being retained. |
The default call history table length is 50 table entries. The default retain timer is 15 minutes.
Global configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
The following example configures the call history table to hold 400 entries, with each entry remaining in the table for 10 minutes:
configure terminal dial-control-mib max-size 400 dial-control-mib retain-timer 10
number | Digit(s) defining a particular dial peer. Valid entries are from 1 to 2147483647. |
voip | Indicates that this is a VoIP peer using voice encapsulation on the POTS network. |
pots | Indicates that this is a POTS peer using VoIP encapsulation on the IP backbone. |
Global configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the dial-peer voice global configuration command to switch to the dial peer configuration mode from the global configuration mode. Use the exit command to exit the dial peer configuration mode and return to the global configuration mode.
The following example accesses the dial peer configuration mode and configures a POTS peer identified as dial peer 10:
configure terminal dial-peer voice 10 pots
voice-port
This command has no arguments or keywords.
The default value for this command is disabled.
Dial-peer configuration
This command first appeared in Cisco IOS Release 11.3 NA.
Use the direct-inward-dial command to enable the DID call treatment for the incoming called numbers. When this feature is enabled, the incoming call is treated as if the digits are received from the DID trunk. The called number is used to select the outgoing dial peer. No dial tone will be presented to the caller.
Use the no form of this command to DID. When disabled, the called number is used to select the outgoing dial peer. The caller will be prompted for a called number via dial tone.
This command applies only to POTS peers.
The following example enables DID call treatment for incoming called numbers:
dial peer voice 10 pots direct-inward-dial
session-protocol
value | Number of milliseconds the echo canceller will cover on a given signal. Valid values are 16, 24, and 32. |
The default value for this command is 16.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the echo-cancel coverage command to adjust the coverage size of the echo canceller. This command enables cancellation of voice that is sent out the interface and received back on the same interface within the configured amount of time. If the local loop (the distance from the analog interface to the connected equipment producing the echo) is longer, the configured value of this command should be extended.
If you configure a longer value for this command, it will take the echo canceller longer to converge; in this case, the user might hear slight echo when the connection is initially set up. If the configured value for this command is too short, the user might hear some echo for the duration of the call because the echo canceller is not cancelling the longer delay echoes.
There is no echo or echo cancellation on the IP side of the connection.
The following example adjusts the size of the echo canceller to 16 milliseconds:
voice-port 0:D echo-cancel enable echo-cancel coverage 16
echo-cancel enable
This command has no arguments or keywords.
The default value for this command is enabled for all interface types.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the echo-cancel enable command to enable cancellation of voice that is sent out the interface and is received back on the same interface. Disabling echo cancellation might cause the remote side of a connection to hear an echo. Because echo cancellation is an invasive process that can minimally degrade voice quality, this command should be disabled if it is not needed.
The echo-cancel enable command does not affect the echo heard by the user on the analog side of the connection.
There is no echo path for a 4-wire E&M interface. The echo canceller should be disabled for that interface type.
The following example enables the echo cancel feature for 16-millisecond echo coverage:
voice-port 0:D echo-cancel enable echo-cancel coverage 16
echo-cancel coverage
non-linear
To erase the Flash memory of a specified VFC, use the erase vfc privileged EXEC command.
erase vfc slot
slot | Specifies the slot on the Cisco AS5300 where the specified VFC resides. Valid entries are from 0 to 2. |
Privileged EXEC
This command first appeared in Cisco IOS Release 11.3 NA.
Use the erase vfc command to erase the contents of the Flash memory (thereby freeing space in VFC Flash memory) for a specified VFC, including the default file list and the capability file list.
The following example erases the Flash memory on the VFC located in slot 0:
erase vfc 0
delete vfc
value | Integer(s) that represent the ITU specification for quality of voice as described in G.113. Valid entries are from 0 to 20, with 0 representing toll quality. |
The default value for this command is 10.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Voice over IP monitors the quality of voice received over the network. Use the expect-factor command to specify when the router will generate an SNMP trap to the network manager.
This command applies only to VoIP peers.
The following example configures toll quality of voice when connecting to a dial peer:
dial-peer voice 10 voip expect-factor 0
2400 | Specifies a fax transmission speed of 2400 bits per second (bps). |
4800 | Specifies a fax transmission speed of 4800 bps. |
7200 | Specifies a fax transmission speed of 7200 bps. |
9600 | Specifies a fax transmission speed of 9600 bps. |
14400 | Specifies a fax transmission speed of 14,400 bps. |
disable | Disables fax relay transmission capability. |
voice | Specifies the highest possible transmission speed allowed by voice rate. |
The default value for this command is voice.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
The values for this command apply only to the fax transmission speed and do not affect the quality of the fax itself. The higher values provide a faster transmission speed but monopolize a significantly larger portion of the available bandwidth. Slower transmission speeds use less bandwidth.
If the fax-rate command is set above the CODEC rate in the same dial peer, the data sent over the network for fax transmission will be above the bandwidth reserved for RSVP. Because more network bandwidth will be monopolized by the fax transmission, Cisco does not recommend setting the fax-rate value higher than the codec value. If the fax-rate value is set lower than the codec value, faxes will take longer to transmit but will use less bandwidth.
This command applies only to VoIP peers.
The following example configures a facsimile rate of 9600 bps for faxes sent to a dial peer:
dial-peer voice 10 voip fax-rate 9600
codec
number | Integer, expressed in equipment impairment factor units, specifying the ICPIF value. Valid entries are from 0 to 55. |
The default value for this command is 30.
Dial-peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the icpif command to specify the maximum acceptable impairment factor for the voice calls sent by the selected dial peer.
This command is applicable only to VoIP peers.
The following example disables the icpif command:
dial-peer voice 10 voip icpif 0
string | Specifies the destination telephone number. Valid entries are any series of digits that specify the E.164 telephone number. |
The default value for this command is no associated called number.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3 NA.
When the AS5300 is handling both modem and voice calls, it needs to be able to identify the service type of the call---meaning whether the incoming call to the server is a modem or a voice call. When the access server handles only modem calls, the service type identification is handled through modem pools. Modem pools associate calls with modem resources based on the called number (DNIS). In a mixed environment, where the server receives both modem and voice calls, you need to identify the service type of a call by using the incoming called-number command.
If you do not use the incoming called-number command, the server attempts to resolve whether an incoming call is a modem or voice call based on the interface over which the call comes. If the call comes in over an interface associated with a modem pool, the call is assumed to be a modem call; if a call comes in over a voice port associated with a dial peer, the call is assumed to be a voice call.
By default, there is no called number associated with the dial peer, which means that incoming calls will be associated with dial peers based on matching calling number with answer address, call number with destination pattern, or calling interface with configured interface.
This command applies to both VoIP and POTS dial peers.
The following example configures calls coming in to the server with a called number of "3799262" as being voice calls:
dial peer voice 10 pots incoming called-number 3799262
value | Specifies, in decibels, the amount of gain to be inserted at the receiver side of the interface. Acceptable values are from -6 to 14. |
The default value for T1 and E1 ports is 0.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
A system-wide loss plan must be implemented using both input gain and output attenuation commands. Other equipment (including PBXs) in the system must be taken into account when creating a loss plan. This default value for this command assumes that a standard transmission loss plan is in effect, meaning that normally, there must be -6 dB attenuation between phones. Connections are implemented to provide -6 dB of attenuation when the input gain and output attenuation commands are configured with the default value of 0.
Please note that you cannot increase the gain of a signal going out into the PSTN, but you can decrease it. Therefore, if the voice level is too high, you can decrease the volume by either decreasing the input gain value or by increasing the output attenuation.
You can increase the gain of a signal coming in to the router. If the voice level is too low, you can increase the input gain.
The following example configures a 3-decibel gain to be inserted at the receiver side of the interface:
input gain 3
output attenuation
number | Integer specifying the IP Precedence value. Valid entries are from 0 to 7. A value of 0 means that no precedence (priority) has been set. |
The default value for this command is 0.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3 NA.
Use the ip precedence command to configure the value set in the IP Precedence field when voice data packets are sent over the IP network. This command should be used if the IP link utilization is high and the quality of service for voice packets needs to have a higher priority than other IP packets. The ip precedence command should also be used if RSVP is not enabled and the user would like to give voice packets a higher priority over other IP data traffic.
This command applies to VoIP peers.
The following example sets the IP Precedence to 5:
dial-peer voice 10 voip ip precedence 5
This command has no arguments or keywords.
The default value for this command is disabled.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the ip udp checksum command to enable UDP checksum calculation for each of the outbound voice packets. This command is disabled by default to speed up the transmission of the voice packets. If you suspect that the connection has a high error rate, you should enable ip udp checksum to prevent corrupted voice packets forwarded to the DSP.
This command applies to VoIP peers.
The following example calculates the UDP checksum for voice packets transmitted by this dial peer:
dial-peer voice 10 voip ip udp checksum
data [56 |64] | Specifies that this call should be handled as a data call. If this keyword is selected, the user has the option to specify a B-channel bandwidth of either 56 or 64. |
voice | Specifies that this call should be handled as a voice call. |
The default value for this command is isdn incoming-voice data 64.
Interface configuration
This command first appeared in Cisco IOS Release 11.3 NA.
Use the isdn incoming-voice command to specify whether incoming ISDN voice calls should be treated as voice or data calls. If you use the data keyword, the incoming ISDN voice call will be treated as a data call, and you will have the option of selecting either 56 or 64 for the B-channel bandwidth.
If you use the voice keyword, incoming ISDN voice calls will be treated as voice calls and handled by either a modem or a voice DSP as directed by CSM.
If the default value is configured and the bearer capability of the incoming call is voice, the call will be rejected.
The following example designates incoming ISDN voice calls to be treated as voice calls:
interface 10 isdn incoming-voice voice
number | Integer specifying the maximum connections value. Valid values range from 1 to 2147483647. |
The default value for this command is no connection limit configured.
Dial peer configuration
This command first appeared in Cisco IOS Release 11.3 NA.
This command applies to both VoIP and POTS dial peers.
The following example specifies the maximum connection to and from VoIP dial peer 10 to be 3:
dial-peer voice 10 voip maximum connections 3
number | Integer specifying the on-hold music threshold in decibels. Valid entries are from -70 to -30. |
The default value for this command is -38.
Voice-port configuration
This command first appeared in Cisco IOS Release 11.3(1)T.
Use the music-threshold command to specify the decibel level of music played when calls are put on hold. This command tells the firmware to pass steady data above the specified level. It only affects the operation of voice activity detection (VAD) when receiving voice.
If the value for this command is set too high, VAD will interpret music-on-hold as silence, and the remote end will not hear the music. If the value for this command is set too low, VAD will compress and pass silence when the background is noisy, creating unnecessary voice traffic.
The following sets the decibel threshold for the music played when calls are put on hold to -35:
voice port 0:D music-threshold -35
Posted: Wed Jun 23 18:14:20 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.