|
|
This chapter describes the function and displays the syntax of each dial-on-demand routing (DDR) command. For more information about defaults and usage guidelines, see the corresponding chapter of the Wide-Area Networking Command Reference.
To define how much time should elapse before a secondary line status changes after a primary line status has changed, use the backup delay interface configuration command. To return to the default, so that as soon as the primary fails, the secondary is immediately brought up without delay, use the no form of this command.
backup delay {enable-delay | never} {disable-delay | never}| enable-delay | Number of seconds that elapse after the primary line goes down before the Cisco IOS software activates the secondary line. |
| disable-delay | Number of seconds that elapse after the primary line goes up before the Cisco IOS software deactivates the secondary line. |
| never | Prevents the secondary line from being activated or deactivated. |
To configure an interface as a secondary or dial backup, use the backup interface interface configuration command. To disable this feature, use the no form of this command.
backup interface type number| type number | Interface type and port number to use as the backup interface. |
| slot | Slot number of the ATM Interface Processor (AIP) interface. |
| port | Port number. |
To set a traffic load threshold for dial backup service, use the backup load interface configuration command. To return to the default value, use the no form of this command.
backup load {enable-threshold | never} {disable-load | never}| enable-threshold | Percentage of the primary line's available bandwidth that the traffic load must exceed to enable dial backup. |
| disable-load | Percentage of the primary line's available bandwidth that the traffic load must be less than to disable dial backup. |
| never | Sets the secondary line to never be activated due to traffic load. |
To create a script that will place a call over a modem, use the chat-script global configuration command. To disable the specified chat script, use the no form of this command.
chat-script script-name expect-send| script-name | Name of the chat script. |
| expect-send | Content of the chat script. |
To clear the values of dialer statistics for one or more serial interfaces or Basic Rate Interfaces (BRIs) configured for DDR, use the clear dialer privileged EXEC command.
clear dialer [interface type number]| interface | (Optional) Indicates that one interface will be specified. |
| type | (Optional) Interface type, either async, serial, or bri. |
| number | (Optional) Interface number. |
| slot/port | (Optional) On the Cisco 7000 series, specifies the slot and port numbers. |
To end the quiet period on a client router within two minutes, use the clear snapshot quiet-time EXEC command.
clear snapshot quiet-time interface| interface | Interface type and number. |
To configure caller ID screening, use the dialer caller interface configuration command. To disable this feature, use the no form of this command.
dialer caller number| number | Telephone number for which to screen. Specify an x to represent a single "don't-care" character. The maximum length of each number is 25 characters. |
To enable DDR on an interface and specify that the serial line is connected by non-V.25bis modems using Electronic Industries Association (EIA) signaling only--the data terminal ready (DTR) signal--use the dialer dtr interface configuration command. To disable dial-on-demand routing (DDR) for the interface, use the no form of this command.
dialer dtrTo set the length of time an interface stays down after a call has completed or failed and before it is available to dial again, use the dialer enable-timeout interface configuration command. To return to the default value, use the no form of this command.
dialer enable-timeout seconds| seconds | Time in seconds that the Cisco IOS software waits before the next call can occur on the specific interface. Acceptable values are positive, nonzero integers.
This value must be greater than the serial pulse interval for this interface, set via the pulse-time command. |
To specify the amount of time that a line for which there is contention will stay idle before it is disconnected and the competing call is placed, use the dialer fast-idle interface configuration command. To return to the default value, use the no form of this command.
dialer fast-idle seconds| seconds | Idle time, in seconds, that must occur on an interface before the line is disconnected. Acceptable values are positive, nonzero integers. |
To specify the fast idle timer value to use when placing a call to any telephone number associated with a specified class, use the dialer fast-idle map-class dialer configuration command. To reset the dialer fast-idle timer to the default, use the no form of this command.
dialer fast-idle seconds| seconds | Number of seconds to wait before placing a different call. Default is the fast idle timer value set for the interface. |
To control access by configuring an interface to belong to a specific dialing group, use the dialer-group interface configuration command. To remove an interface from the specified dialer access group, use the no form of this command.
dialer-group group-number| group-number | Number of the dialer access group to which the specific interface belongs. This access group is defined with the dialer-list command. Acceptable values are nonzero, positive integers between 1 and 10. |
To allow interesting outgoing packets to be queued until a modem connection is established, use the dialer hold-queue interface configuration command. To disable the hold queue, use the no form of this command.
dialer hold-queue packets| packets | Number of packets, in the range 0 to 100 packets, to hold in the queue. This argument is optional with the no form of the command. |
To specify the idle time before the line is disconnected, use the dialer idle-timeout interface configuration command. To reset the idle timeout to the default, use the no form of this command.
dialer idle-timeout seconds| seconds | Idle time, in seconds, that must occur on the interface before the line is disconnected. Acceptable values are positive, nonzero integers. Default is 120 seconds. |
To specify the idle time before the calls in this map class are disconnected, use the dialer idle-timeout map-class dialer configuration command. To reset the idle timeout to the default, use the no form of this command.
dialer idle-timeout seconds| seconds | Idle time, in seconds, that must occur on an interface associated with a map class before calls are disconnected. Acceptable values are positive, nonzero integers. Defaults to the value set for the interface. |
To specify that dial-on-demand routing (DDR) is to be supported, use the dialer in-band interface configuration command. To disable DDR for the interface, use the no form of this command.
dialer in-band [no-parity | odd-parity]| no-parity | (Optional) Indicates that no parity is to be applied to the dialer string that is sent out to the modem on synchronous interfaces. |
| odd-parity | (Optional) Indicates that the dialed number has odd parity (7-bit ASCII characters with the eighth bit as the parity bit) on synchronous interfaces. |
To specify the bit rate used on the B channel associated with a specified map class and to specify whether to set up semipermanent connections for this map-class, use the dialer isdn map-class configuration command.
dialer isdn [speed speed] [spc]| speed speed | (Optional) Bit rate, in kilobytes per second (Kbps), used on the ISDN B channel. Values are 56 and 64. Default is 64. |
| spc | (Optional) Specifies that an ISDN semipermanent connection is to be used for calls associated with this map class. |
To apply an access list to a specified dialer group (and thus to specify which packets can initiate a dialed call), use the dialer-list list global configuration command. To remove a prior association between an access list and the dialer group, use the no form of this command.
dialer-list dialer-group list access-list-number| dialer-group | Number of a dialer access group identified in any dialer-group interface configuration command. |
| access-list-number | Access list number specified in any IP or Novell IPX access lists including Novell IPX extended, service access point (SAP) access lists and bridging types. |
To define a DDR dialer list to control dialing by protocol or by a combination of protocol and access list, use the dialer-list protocol global configuration command. To delete a dialer list, use the no form of this command.
dialer-list dialer-group protocol protocol-name {permit | deny | list access-list-number || dialer-group | Number of a dialer access group identified in any dialer-group interface configuration command. |
| protocol-name | One of the following protocol keywords: appletalk, bridge, clns, clns_es, clns_is, decnet, decnet_router-L1, decnet_router-L2, decnet_node, ip, ipx, vines, or xns. |
| permit | Permits access to an entire protocol. |
| deny | Denies access to an entire protocol. |
| list | Specifies that an access list will be used for defining a granularity finer than an entire protocol. |
| access-list-number | Access list numbers specified in any DECnet, Banyan VINES, IP, Novell IPX, or XNS standard or extended access lists, including Novell IPX extended service access point (SAP) access lists and bridging types. |
| access-group | Filter list name used in the clns filter-set and clns access-group commands. |
To configure bandwidth on demand by setting the maximum load before the dialer places another call to a destination, use the dialer load-threshold interface command. To disable the setting, use the no form of this command.
dialer load-threshold load [outbound | inbound | either]| load | Interface load beyond which the dialer will initiate another call to the destination. This argument is a number between 1 and 255 and is required. |
| outbound | (Optional) Calculates the actual load using outbound data only. |
| inbound | (Optional) Calculates the actual load using inbound data only. |
| either | (Optional) Sets the maximum calculated load as the larger of the outbound and inbound loads. |
To configure a serial interface or Integrated Services Digital Network (ISDN) interface to call one or multiple sites, use a form of the dialer map interface configuration command; all options are shown in the first form of the command. To delete a particular dialer map entry, use a no form of this command.
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | 64] [broadcast]To configure a serial interface or ISDN interface to place a call to multiple sites and to authenticate calls from multiple sites, use the second form of the dialer map command:
dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | 64] [broadcast]To configure a serial interface or ISDN interface to support bridging, use the third form of the command:
dialer map bridge [name hostname] [spc] [broadcast] [dial-string[:isdn-subaddress]]To configure an asynchronous interface to place a call to a single site that has no modem script assigned or that requires a system script, or to multiple sites on a single line, on multiple lines, or on a dialer rotary group, use the fourth form of the dialer map command:
dialer map protocol next-hop-address [name hostname] [broadcast] [modem-script
| protocol | Protocol keywords; one of the following: appletalk, bridge, clns, decnet, ip, ipx, novell, snapshot, vines, and xns. |
| next-hop-address | Protocol address used to match against addresses to which packets are destined. This argument is not used with the bridge protocol keyword. |
| name | (Optional) Indicates the remote system with which the local router or access server communicates. |
| hostname | (Optional) Case-sensitive name or ID of the remote device (usually the host name). For routers with ISDN interfaces, if calling line identification--sometimes called CLI, but also known as caller ID and automatic number identification (ANI)--is provided, the hostname field can contain the number that the calling line ID provides. |
| spc | (Optional) Specifies a semipermanent connection between customer equipment and the exchange; used only in Germany to configure connections between an ISDN BRI and a 1TR6 ISDN switch type. |
| speed 56 | 64 | (Optional) Keyword and value indicating the line speed in kilobits per second to use. Used for ISDN only. The default speed is 64 kbps. |
| broadcast | (Optional) Indicates that broadcasts should be forwarded to this protocol address. |
| modem-script | (Optional) Indicates the modem script to be used for the connection (for asynchronous interfaces). |
| modem-regexp | (Optional) Regular expression to which a modem script will be matched (for asynchronous interfaces). |
| system-script | (Optional) Indicates the system script to be used for the connection (for asynchronous interfaces). |
| system-regexp | (Optional) Regular expression to which a system script will be matched (for asynchronous interfaces). |
| dial-string | (Optional) Telephone number sent to the dialing device when it recognizes packets with the specified next hop address that matches the access lists defined. The dial string and ISDN subaddress, if used, must be the last item in the command line. |
| :isdn-subaddress | (Optional) Subaddress number used for ISDN multipoint connections. |
To define a dialer map for Cisco's snapshot routing protocol on a client router connected to a DDR interface, use the dialer map snapshot interface configuration command. To delete one or more previously defined snapshot routing dialer maps, use the no form of this command.
dialer map snapshot sequence-number dial-string| sequence-number | A number in the range from 1 to 254, inclusive, that uniquely identifies a dialer map. |
| dial-string | Telephone number of a remote snapshot server to be called during an active period. |
To specify, for a dialer profile, the maximum number of links to a remote destination that can be up at any one time, use the dialer max-link interface configuration command.
dialer max-link number| number | Maximum number of links, in the range 1 through 255. Default is 255 links. |
To specify, for a dialer interface, which dialing pool to use to connect to a specific destination subnetwork, use the dialer pool interface configuration command.
dialer pool number| number | Dialing pool number, in the range 1 through 255. |
To configure a physical interface to be a member of a dialing pool, use the dialer pool-member interface configuration command.
dialer pool-member number [priority priority] [min-link minimum] [max-link maximum]| number | Dialing pool number, in the range 1 through 255. |
| priority priority | (Optional) Priority of this interface within the dialing pool, in the range 0 (lowest) to 255 (highest). Interfaces with the highest priority are selected first when dialing out. Default is 0. |
| min-link minimum | (Optional) Minimum number of B channels on this interface that are reserved for this dialing pool, in the range 0 to 255. Default is 0. A reserved channel is inactive until the specified interface uses it to place calls. Applies to ISDN interfaces only. |
| max-link maximum | (Optional) Maximum number of B channels on this interface that can be used by this dialing pool, in the range 0 to 255. Default is 255. Applies to ISDN interfaces only. |
To set the priority of an interface in a dialer rotary group, use the dialer priority interface configuration command. Use the no form of the command to revert to the default setting.
dialer priority number| number | Priority of an interface in a dialer rotary group; the highest number indicates the highest priority. This is a number from 0 through 255. The default value is 0, the lowest priority. |
To specify, for a dialer interface, the authentication name of the remote router on the destination subnetwork, use the dialer remote-name interface configuration command.
dialer remote-name username| username | Case-sensitive character string identifying the remote device; maximum length is 255 characters. |
To include a specified interface in a dialer rotary group, use the dialer rotary-group interface configuration command.
dialer rotary-group number| number | Number of the previously defined dialer interface in whose rotary group this interface is to be included. This is a number from 0 to 255. The dialer interface is defined by the interface dialer command. |
To specify the method for identifying the outbound line to be used for ISDN or asynchronous DDR calls, use the dialer rotor interface configuration command.
dialer rotor {priority | best}| priority | Selects the first outbound line with the highest priority; this is the selection criterion that was previously used. |
| best | Selects the outbound line with the most recent success. If that line also has the most recent failure, then it will try the line with the least recent failure. If that line also has the most recent failure, it will then try an as-of-yet untried outbound line. |
To specify the string (telephone number) to be used when placing a call from an interface, use the dialer string interface configuration command. To delete the telephone number specified for the interface, use the no form of this command.
dialer string dial-string [class class-name]| dial-string | Telephone number to be sent to a DCE device. |
| class class-name | (Optional) Dialer map class associated with this telephone number. |
To specify the string (telephone number) to be called for interfaces calling a single site, use the dialer string interface configuration command. To delete the dialer string specified for the interface, use the no form of this command.
dialer string dial-string[:isdn-subaddress]| dial-string | String of characters to be sent to a DCE device. |
| :isdn-subaddress | (Optional) ISDN subaddress. |
To specify the length of time the interface waits for a carrier, use the dialer wait-for-carrier-time interface configuration command. To reset the carrier wait time value to the default, use the no form of this command.
dialer wait-for-carrier-time seconds| seconds | Number of seconds that the interface waits for the carrier to come up when a call is placed. Acceptable values are positive, nonzero integers. Default is 30 seconds. |
To specify the length of time to wait for a carrier when dialing out to the dial string associated with a specified map class, use the dialer wait-for-carrier-time map-class dialer configuration command. To reset the carrier wait time value to the default, use the no form of this command.
dialer wait-for-carrier-time seconds| seconds | Number of seconds that the interface waits for the carrier to come up when a call is placed. Acceptable values are positive, nonzero integers. Default is 30 seconds. |
To define a dialer rotary group, use the interface dialer global configuration command.
interface dialer number| number | Number of the dialer rotary group. It can be number in the range 0 through 255. |
To define a class of shared configuration parameters associated with the dialer map command, use the map-class dialer global configuration command.
map-class dialer classname| classname | Unique class identifier. |
To specify a default modem chat script, use the script dialer line configuration command. Use the no form of this command to disable this feature.
script dialer regexp| regexp | Specifies the set of modem scripts that might be executed. The first script that matches the argument regexp will be used. |
To display general diagnostic information for interfaces configured for DDR, use the show dialer EXEC command.
show dialer [interface type number]| interface | (Optional) Displays information for the interface specified by the arguments type and number. |
| type | (Optional) Interface type. |
| number | (Optional) Interface number. |
To display snapshot routing parameters associated with an interface, use the show snapshot EXEC command.
show snapshot [type number]| type number | (Optional) Interface type and number. |
To configure a client router for snapshot routing, use the snapshot client interface configuration command. To disable a client router, use the no form of this command.
snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]| active-time | Amount of time, in minutes, that routing updates are regularly exchanged between the client and server routers. This can be an integer in the range 5 to 100. There is no default value. A typical value is 5 minutes. |
| quiet-time | Amount of time, in minutes, that routing entries are frozen and remain unchanged between active periods. Routes are not aged during the quiet period, so they remain in the routing table as if they were static entries. This argument can be an integer from 8 to 100000. There is no default value. The minimum quiet time is generally the active time plus 3. |
| suppress-statechange-updates | (Optional) Disables the exchange of routing updates each time the line protocol goes from "down" to "up" or from "dialer spoofing" to "fully up." |
| dialer | (Optional) Used if the client router has to dial up the remote router in the absence of regular traffic. |
To configure a server router for snapshot routing, use the snapshot server interface configuration command. To disable a server router, use the no form of this command.
snapshot server active-time [dialer]| active-time | Amount of time, in minutes, that routing updates are regularly exchanged between the client and server routers. This can be an integer in the range 5 to 100. There is no default value. A typical value is 5 minutes. |
| dialer | (Optional) Allows the client router to dial up the remote router in the absence of regular traffic. |
|
|