|
|
This chapter describes the function and displays the syntax of each dial-on-demand routing command. For more information about defaults and usage guidelines, see the corresponding chapter of the Wide-Area Networking Command Reference.
[no] backup delay {enable-delay | never} {disable-delay | never}
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.
| 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. |
[no] backup interface serial number
[no] backup interface slot/port (For the Cisco 7000series)
To configure an interface as a secondary or dial backup line, use the backup interface interface configuration command. To disable this feature, use the no form of this command.
| number | Port to be set as the secondary line. |
| slot | Slot number of the ATM Interface Processor (AIP) interface. |
| port | Port number. |
[no] backup load {enable-threshold | never} {disable-load | never}
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.
| enable-threshold | Percentage of the primary line's available bandwidth. |
| disable-load | Percentage of the primary line's available bandwidth. |
| never | Sets the secondary line to never be activated due to traffic load. |
[no] chat-script script-name expect-send
To create ain script thaint 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.
| script-name | Name of the chat script. |
| expect-send | Content of the chat script. |
clear dialer [interface type number]
clear dialer [interface serial slot/port] (Cisco 7000 series only)
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.
| interface | (Optional) Indicates that one interface will be specified. |
| type | Interface type, either serial or bri. |
| number | Interface number. |
| slot/port | On the Cisco 7000 series, specifies the slot and port numbers. |
clear snapshot quiet-time interface
To end the quiet period on a client router within two minutes, use the clear snapshot quiet-time EXEC command.
| interface | Interface type and number. |
To enable callback security, use the dialer callback-secure interface configuration command.
dialer callback-server [username | dialstring]
To enable an interface to make return calls when callback is successfully negotiated, use the dialer-callback server interface configuration command.
| username | (Optional) Identifies the return call by looking up the authenticated host name in a dialer map command. This is the default. |
| dialstring | (Optional) Identifies the return call during callback negotiation. |
To configure caller ID screening, use the dialer caller interface configuration command. To disable this feature, use the no form of this command.
| 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 enable-timeout seconds
no dialer enable-timeout
To 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.
| 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. |
dialer fast-idle seconds
no dialer fast-idle
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.
| seconds | Idle time, in seconds, that must occur on an interface before the line is disconnected. Acceptable values are positive, nonzero integers. |
dialer-group group-number
no dialer-group
To control access, use the dialer-group interface configuration command. To remove an interface from the specified dialer access group, use the no form of this command.
| 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. |
dialer hold-queue packets
no dialer hold-queue [packets]
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.
| 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. |
dialer idle-timeout seconds
no dialer idle-timeout
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.
| seconds | Idle time, in seconds, that must occur on an interface before the line is disconnected. Acceptable values are positive, nonzero integers. |
dialer in-band [no-parity | odd-parity]
no dialer in-band
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.
| 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. |
[no] dialer-list dialer-group list access-list-number
To group access lists, use the dialer-list list global configuration command. To disable automatic dialing, use the no form of this command.
| 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. See dialer-list list in the Wide-Area Networking Command Reference for a list of supported access list types and numbers. |
dialer-list dialer-group protocol protocol-name {permit | deny | list access-list-number | access-group}
no dialer-list dialer-group [protocol protocol-name [list access-list-number | access-group]]
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-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. SeeSee dialer-list protocol in the Wide-Area Networking Command Reference for a list of supported access list types and numbers. |
| access-group | Filter list name used in the clns filter-set and clns access-group commands. |
dialer load-threshold load [outbound | inbound | either]
no dialer load-threshold
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.
| 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) Indicates calculate the actual load using outbound data only. |
| inbound | (Optional) Indicates calculate the actual load using inbound data only. |
| either | (Optional) Indicates the calcualted load is the maximum of the outbound and inbound loads. |
[no] dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | 64] [broadcast]
[modem-script modem-regexp] [system-script system-regexp] [dial-string[:isdn-subaddress]]
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. To delete a particular dialer map entry, use a no form of this command.
[no] dialer map protocol next-hop-address [name hostname] [spc] [speed 56 | 64] [broadcast]
[dial-string[:isdn-subaddress]]
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.
[no] dialer map bridge [name hostname] [spc] [broadcast] [dial-string[:isdn-subaddress]]
To configure a serial interface or ISDN interface to support bridging, use the third form of the dialer map command.
[no] dialer map protocol next-hop-address [name hostname] [broadcast] [modem-script modem-regexp]
[system-script system-regexp] [dial-string]
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.
| protocol | Protocol keyword. See this command in the Wide-Area Networking Command Reference for a list of supported protocols and their keywords. |
| 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 (CLI/ANI/caller ID) 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. |
| 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 together with the ISDN subaddress, if used, must be the last item in the command line. |
| :isdn-subaddress | (Optional) Subaddress number used for ISDN multipoint connections. |
dialer map snapshot sequence-number dial-string
no dialer map snapshot [sequence-number]
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.
| 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. |
dialer priority number
no dialer priority
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.
| 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. |
To include an interface in a dialer rotary group, use the dialer rotary-group interface configuration command.
| 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. |
dialer string dial-string[:isdn-subaddress]
no dialer string
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.
| dial-string | String of characters to be sent to a DCE device. |
| :isdn-subaddress | (Optional) ISDN subaddress. |
dialer wait-for-carrier-time seconds
no dialer wait-for-carrier-time
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.
| 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. |
To define a dialer rotary group, use the interface dialer global configuration command.
| number | Number of the dialer rotary group. It can be number in the range 0 through 255. |
ip address-pool {dhcp-proxy-client | local}
no ip address-pool
To enable the global default address-pooling mechanism used to supply IP addresses on dial-in asynchronous, synchronous, or ISDN point-to-point interfaces, use the ip address-pool global configuration command. To disable IP address pooling globally on all interfaces with the default configuration, use the no form of the command.
| dhcp-proxy-client | Uses the router as the proxy client between a third-party Dynamic Host Configuration Protocol (DHCP) server and peers connecting to the router. |
| local | Uses the local address pool named default. |
ip local pool {default | poolname} low-ip-address [high-ip-address]
no ip local pool {default | poolname}
To configure a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface, use the ip local pool global configuration command. To delete an address pool, use the no form of this command.
| default | Default local address pool that is used if no other pool is named. |
| poolname | Name of a specific local address pool. |
| low-ip-address | Lowest IP address in the pool. |
| high-ip-address | (Optional) Highest IP address in the pool. If this value is omitted, only the low-ip-address IP address is included in the local pool. The maximum number of IP addresses per pool is 256. |
To define a class of shared configuration parameters associated with the dialer map command, use the map-class global configuration command.
| classname | Unique class identifier. |
[no] member number interface-command
To alter the configuration of an asynchronous interface that is a member of a group, use the member interface configuration command. Use the no form of the command to restore defaults set at the group master interface.
| number | Number of the asynchronous interface to be altered. |
| interface-command | One or more commands entered for this specific interface. Valid commands are the following:
· peer default ip address · description |
peer default ip address {ip-address | dhcp | pool [poolname]}
no peer default ip address
Use the peer default ip address command to specify an IP address, select local address pooling or select DHCP proxy-client pooling for this interface. Use the no form of the command to disable peer IP address pooling for this interface.
| ip address | Specific IP address to be assigned to a remote peer dialing in to this interface. To prevent the assignment of duplicate IP addresses on two or more interfaces, this form of the command cannot be applied to a dialer rotary group nor to an ISDN interface. |
| dhcp | Retrieves an IP address from the DHCP server. |
| pool | Uses the global default mechanism as defined by the ip address-pool command unless the optional pool name is supplied. |
| poolname | (Optional) Name of a local address pool created with the ip local pool command. Retrieves an address from this pool regardless of the global default mechanism setting. |
ppp callback {accept | request}
To enable a non-DTR dialer interface to function either as a callback client that requests callback or as a callback server that accepts callback requests, use the ppp callback interface configuration command.
| accept | Enables this interface to accept PPP callback requests (and function as the PPP callback server). |
| request | Enables this interface to request PPP callback (and function as the PPP callback client). |
To enable multilink PPP on ISDN interfaces, use the ppp multilink interface configuration command. To disable PPP multilink on ISDN interfaces, use the no form of this command.
script dialer regexp
no script dialer
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.
| regexp | Specifies the set of modem scripts that might be executed. The first script that matches the argument regexp will be used. |
show dialer [interface type number]
To obtain a general diagnostic display for serial interfaces configured for DDR, use the show dialer EXEC command.
| 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.
| interface | (Optional) Interface type and number. |
[no] snapshot client active-time quiet-time [suppress-statechange-updates] [dialer]
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.
| 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. |
[no] snapshot server active-time [dialer]
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.
| 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. |
To specify the password to be used in Challenge Handshake Authentication Protocol (CHAP) caller identification and Password Authentication Protocol (PAP), use the username global configuration command.
| name | Host name, server name, user ID, or command name. |
| password | An encrypted password for this username. |
| secret | For CHAP authentication: specifies the secret password for the local router or access server or the remote device. The secret is encrypted when it is stored on the local router or access server. This prevents the secret from being stolen. The secret can consist of any string of up to 11 printable ASCII characters. There is no limit to the number of username-password combinations that can be specified, allowing any number of remote devices to be authenticated. |
|
|