Alcatel reserves the right to revise this documentation and to make changes in content from time to time without obligation to provide
notification of such changes.
Alcatel provides this documentation without warranty, express, implied, statutory, or otherwise, and specifically disclaims any warranty of
merchantability, or fitness for a particular purpose. Alcatel may make improvements or changes in the product(s) and/or the program(s)
described in this documentation at any time.
Trad em arks
Alcatel and the Alcatel corporate logo are trademarks of Alcatel All other trademarks appearing in this guide are the exclusive property of their
respective owners.
Software Notice
Alcatel assumes no responsibility for product reliability, performance, or both if the user modifies the .CFG file. Full responsibility for any
performance issues resulting from modifications made to the .CFG file, by the user, is assumed by the user.
Hardware Notice
The Lithium battery on the motherboard of this product is a non-volatile device that will retain data over 10 years in the absence of power.
Documentation Feedback
The mission of the Technical Publications group at Alcatel is to provide users with quality documentation that enhances their experience with
Alcatel products. We are constantly improving our guides and have a genuine interest in ensuring that they are easy to use and enable users to
quickly find information they need. We invite you to be part of this process; please email your comments regarding Alcatel product
documentation and web content to:
Command Help .............................................................................................................................................................................. 10
BGP4 SHOW COMMANDS ........................................................................................................................87
AS PATH REGULAR EXPRESSIONS ........................................................................................................105
Matching AS Paths ......................................................................................................................................................................105
Router User Guide
Page 4
AS Path Regular Expressions (regex) .......................................................................................................................................... 105
AS Path Terms .............................................................................................................................................................................106
Protocol Independent Multicast - Source Specific Multicast (PIM-SSM) .................................................................................. 220
Internet Group Management Protocol (IGMP)............................................................................................................................ 220
Traceroute Facility for IP Multicast.............................................................................................................................................222
Standard Warranty ....................................................................................................................................................................... 237
7 Example Conventions ....................................................................................................................................................... 8
10 Status and Origin Codes ................................................................................................................................................... 91
11 Status and Origin Codes ................................................................................................................................................... 94
12 Other BGP show Descriptions ..........................................................................................................................................94
14 Status and Origin Codes ................................................................................................................................................... 95
16 Status and Origin Codes ................................................................................................................................................... 98
2 Help Screen ................................................................................................................................................................... 10
3 Alcatel CLI Command Tree .......................................................................................................................................... 11
4 ? Help Screen................................................................................................................................................................. 12
5 Global Show Command ................................................................................................................................................ 13
Router User Guide
Page 8
Page 9
Organization
A
BOUT
This guide describes Alcatel’s implementation and command usage of BGP4, OSPF, RIP, and
multicast routing protocols. It is designed for network managers and administrators who are
responsible for the operation of LAN and WAN equipment and are familiar with networks and
routing protocols.
The following table describes the organization and content of this guide.
T
HIS
G
UIDE
1
Documentation
Table 1 Guide Organization: Major Sections
About This GuideDefines the user audience, describes the document’s organization, introduces special notices,
Protocols OverviewProvides high-level information about the routing protocols supported by Alcatel.
Command Line
Interface
CommandsDescribes the individual CLI commands. Commands are organized by protocol and are in
The following list includes other available and related documentation.
Release Notes
Printed release notes provide the latest information. If release notes are provided with your
product, follow the instructions contained within them in addition to those provided in other
documentation.
Quick Start Guides
These guides are designed for advanced users who need minimal installation, configuration, and
operation information.
Installation Guides
These detailed guides are designed for network managers and technicians who are responsible
for the installation of networking equipment in Telco and service provider network
environments.
and provides information about other Alcatel user guides.
Describes the command line interface (CLI) and how to access navigation and help features.
A review of Alcatel configuration standards is included.
alphabetical order. Each entry provides a command description and syntax and usage
examples.
Command Reference Guide
This detailed guide provides a complete alphabetical listing of all non-routing commands
including descriptions, syntax, examples, and applicable systems.
Router User Guide
Page 10
2 Chapter : About This Guide
Configuration Guide
This guide provides examples of how features are used.
Guides and release notes are available in PDF format on the
Alcatel website: www.alcatel.com.
To view PDF files, Adobe Acrobat® Reader® 4.0 (or later) must be installed on your PC. If you do
not have the Adobe Acrobat Reader installed on your system, you can obtain it free from the Adobe
website:
www.adobe.com.
Router User Guide
Page 11
BGP4
P
ROTOCOLS
Border Gateway Protocol Version 4 (also referred to as simply BGP) is an exterior routing protocol
used for the global Internet.
Once configured, BGP peers first exchange complete copies of their routing tables (including BGP
version, router ID, and keep alive hold time), which are usually very large. Thereafter, only
incremental updates (deltas) are sent as changes occur to the routing tables. BGP keeps a current
version of the routing table for all peers, keep alive packets are sent to ensure that the connection
between BGP peers, and notification packets are sent in response to problems and irregularities. This
enables longer running BGP sessions to be more efficient than shorter sessions.
BGP's basic unit of routing information is the BGP path, a route to a certain set of classless
interdomain routing prefixes. Paths are tagged with various path attributes, including an autonomous
systems (AS) path and next-hop. In fact, one of BGP's most important functions is loop detection at
the AS level, using the AS path attribute, which is a list of autonomous systems used for data
transport.
The syntax of this attribute is made more complex by its need to support path aggregation when
multiple paths are collapsed into one in order to simplify further route advertisements. A more
simplified view of an AS path is that it is a list of autonomous systems that a route goes through to
reach its destination. Loops are detected and avoided by checking for your own AS number in the AS
path's received from neighboring autonomous systems. Every time a BGP path advertisement
crosses an AS boundary, the next-hop attribute is changed on the boundary router. Conversely, as a
BGP path advertisement is passed among BGP speakers in the same AS, the next-hop attribute is left
untouched. Consequently, BGP's next-hop is always the IP address of the first router in the next
autonomous system, even though this may actually be several hops away. The AS's interior routing
protocol is responsible for computing an interior route to reach the BGP next-hop.
This leads to the distinction between internal BGP (IBGP) sessions (between routers in the same AS)
and external BGP (EBGP) sessions (between routers in different AS's). Next-hops are only changed
across EBGP sessions, but left intact across IBGP sessions. The two most important consequences of
this design are the need for interior routing protocols to reach one hop beyond the AS boundary, and
for BGP sessions to be fully meshed within an AS.
Since the next-hop contains the IP address of a router interface in the next AS, and this IP address is
used to perform routing, the interior routing protocol must be able to route to this address. This
means that interior routing tables must include entries one hop beyond the AS boundary.
Furthermore, since BGP does not relay routing traffic from one interior BGP session to another (only
from an exterior BGP session to an IBGP session or another EBGP session), BGP speakers must be
fully meshed.
O
VERVIEW
3
RFC ComplianceThe following table provides Alcatel’s BGP RFC compliance information.
Router User Guide
Page 12
4 Chapter : Protocols Overview
OSPF
Table 2 BGP RFC Compliance
RFCDescription
2385Protection of BGP sessions via the TCP MD5 signature option
1998An application of the BGP community attribute in multi-home routing
1997 BGP communities attribute
1775BGP OSPF interaction
1771Border Gateway Protocol 4 (BGP-4)
Open Shortest Path First (OSPF), a link-state routing protocol, is used for routing IP packets. OSPF
offers the following advantages:
Scalability
OSPF is designed to operate with larger networks. It does not impose a hop-count restriction and
permits its domain to be split into areas for easier management.
Full subnetting support
OSPF can fully support subnetting, including Variable Length Subnet Mask (VLSM).
Tagged routes
Routes can be tagged with arbitrary values. This eases interoperation with Exterior Gateway
Protocols
Meshed networks
(EGPs), which can tag OSPF routes with AS numbers.
OSPF provides the ability to support complex meshed networks.
The following features are incorporated in
Intra- and inter-area routing
Broadcast and point-to-poPnt
Type 1 & Type 2 AS external routes
Stub areas
NSSA – Not-So-Stubby-Area
Route re-distribution
Authentication – simple & MD5
RFC 1583 backwards compatibility
Equal cost multipath
Configurable routing interface parameters
Non-intrusive reconfiguration
Alcatel’ implementation of OSPF.
Router User Guide
Page 13
Chapter : Protocols Overview5
RFC ComplianceThe following table provides Alcatel’s OSPF RFC compliance information.
Table 3 OSPF RFC Compliance
RFCDescription
2328OSPF version 2
1587OSPF NSSA option
1850OSPF Version 2 Management Information Base
RIP
Routing Information Protocol (RIP) is an interior gateway protocol (IGP), i.e., it routes traffic within
a single autonomous system (AS). RIP uses a distance-vector algorithm with hop count as the metric
to determine the best route to a destination.
Update messages are sent at configured intervals and when changes occur in the network topology.
These messages are used by routers to update their routing tables to maintain currency with the state
of the network. When a router updates its routing table, it transmits update messages to other routers
in the network to enable them to update their routing tables.
The following list identifies architectural characteristics of RIP:
The network path is limited to 15 hops. A destination with a greater number of hops is
considered unreachable.
The time required to determine a next hop and bandwidth could be substantial in a large network.
A fixed metric is used to select routes. Only the best route with the lowest metric is maintained
for a specific destination.
The following features are incorporated into
RIP v1, v2, and v1 compatibility modes
Configurable timers
VLSM
Split-horizon and split-horizon with poison reverse
Clear text and MD5 authentication
Redistribution of connected, static, and OSPF routes
Inbound and outbound filtering policies
Alcatel’ implementation of RIP:
RFC ComplianceThe following table provides Alcatel’s RIP RFC compliance information.
Table 4 RIP RFC Compliance
RFCDescription
1058Routing Information Protocol
2453/STD0056RIP Version 2
1724RIP Version 2 MIB extension
2082RIP-II MD5 Authentication
Router User Guide
Page 14
Multicasting
Traditional multicast routing mechanisms such as Distance Vector Multicast Routing Protocol
(DVMRP) and Multicast Open Shortest Path First (MOSPF) were intended for use within regions
where groups are densely populated or bandwidth is universally plentiful. When groups, and senders
to these groups, are distributed sparsely across a wide area, these “dense mode” schemes do not
perform efficiently.
Protocol Independent
Multicast (PIM)
Protocol Independent Multicast (PIM) protocols route multicast packets to multicast groups. PIM is
protocol independent because it can leverage whichever unicast routing protocol is used to populate
unicast routing table. There are two modes of PIM protocol – Dense mode (DM) and Sparse mode
(SM). Alcatel supports SM only in version 8.0 and higher.
PIM-DM floods multicast traffic throughout the network initially and then generates prune messages
as required. PIM-SM attempts to send multicast data only to networks which have active receivers.
This is achieved by having a common Rendezvous Point (RP) known to the senders and receivers
and by forming shared trees from the RP to the receivers.
PIM-SM is described in RFC 2362.
Securing Remote Access Using IPSec VPN
The features in version 8.0 and higher allow administrators to form a security tunnel to join two
private networks over the Internet. The following examples show how to set up an end-to-end tunnel
with a single proposal and pre-shared key authentication, with multiple proposals and pre-shared key
authentication, and with an SA Bundle, and pre-shared key authentication.
The corporate network no longer has a clearly defined perimeter inside secure building and locked
equipment closets. Increasingly, companies have a need to provide remote access to their corporate
resources for the employees on the move.
Traditionally, remote users could access the corporate LAN through dial-up and ISDN lines which
were terminated in the corporate remote access servers. However, these point-to-point connection
technologies do not scale well to the growing number of remote users and the corresponding increase
in the infrastructure investments and maintenance costs.
A solution to meeting the needs of increasing numbers of remote users and for controlling access
costs is to provide remote access through the Internet using firewalls and a Virtual Private Network
(VPN). Internet Protocol Security (IPSec) keeps the connection safe from unauthorized users.
In a typical IPSec remote access scenario, the mobile user has connectivity to Internet and an IPSec
VPN client loaded on their PC. The remote user connects to the Internet through their Internet
service provider and then initiates a VPN connection to the IPSec security gateway (the VPN server)
of the corporate office, which is typically an always-on Internet connection.
One of the main limitations in providing remote access is the typical remote user connects with a
dynamically assigned IP address provided by the ISP. IPSec uses the IP address of users as an index
to apply the Internet Key Exchange (IKE) and IPSec policies to be used for negotiation with each
peer. When the VPN client has a dynamic IP address, the VPN server cannot access the policies
based on the IP address of the client. Instead, the VPN server uses the identity of the VPN client to
access the policies.
Page 15
Command Types
C
OMMAND
This chapter introduces the Command Line Interface (CLI) hierarchy and the conventions used to
describe it. It also introduces the CLI navigation keys and methods, as well as the available help
screens.
This guide contains two types of commands: transition, or mode change, commands and standard
commands.
Transition commands do not affect the system configuration, they are used to gain access to loweror next-level commands in the CLI hierarchy. Following each transition command is a brief
description, a syntax and usage example, a list of next-level commands, and a list of systems for
which the command is applicable.
L
INE INTERFACE
7
Context-Sensitive
Commands
NOTE: In certain instances, transition commands will select an interface for configuration and access
next-level commands. For example, the configure interface bundle dallas command accesses the
configure interface bundle mode and selects or creates the bundle dallas.
Standard commands are used to configure the system. Following each standard command is a brief
description, a list of parameters and definitions, a syntax and usage example, a list of related
commands, and a list of systems for which the command is applicable.
Some commands are context-sensitive. Once a module, bundle, or Ethernet port has been selected for
configuration, all further configuration applies only to the selected interface. Table 5 shows a
context-sensitive command string for a host system. In this example, T1 link 1 remains selected for
configuration until you exit from the
Table 5 Context-Sensitive Command Sequence
Context-Sensitive Command StringExample
1 Go into the configuration mode.Alcatel-host> configure terminal
2 Specify the type of interface (T1).
3 Choose the specific interface (T1 link 1).
4 From now on, all configuration commands are for T1
link 1 until you exit from module configuration or
choose another T1 link.
NOTE: Command strings that require identification of a specific interface are context-sensitive.
Alcatel-host/configure/module/t1> prompt.
host/configure> module t1
Alcatel-
Alcatel-host/configure> module t1 1
Alcatel-host/configure/module/t1 1>
Router User Guide
Page 16
8 Chapter : Command Line Interface
Command Conventions
Each command is briefly described and then followed by the complete syntax, which is essentially a
map of the command that shows mandatory and optional parameters.
The following tables provide details of the conventions used for syntaxes and examples.
Table 6 Syntax Conventions
For SyntaxesWhat it means
normal type
[ a | b | c ]
< >
[ ]
Within syntaxes, “normal type” represents required words that must be
entered by the user — except when followed by a parameter setting that is
enclosed in angled brackets. In that case, only enter the parameter setting
enclosed in the angled brackets.
Example 1: Normal type only.
In this example, the user enters the word or argument (module) appearing in
the syntax in “normal type.”
Syntax:
module
Command execution:
module
Example 2: Normal type word or argument that is followed by a second
normal type word or argument, which is followed by a parameter setting
enclosed in angled brackets.
In this example, the user enters the first word or argument “connections,”
appearing in normal type, and then only enters the value “4” of the second
word or argument.
Syntax:
connections connections < n >
Command execution:
connections 4
In other words, the first occurence of “connections” must be entered because
it is not followed by a setting enclosed in angled brackets. The second
occurence of the word “connections” must NOT be entered because it is
followed by a setting enclosed in angled brackets. This value of the setting
must be entered to execute the command.
Normal brackets “[ ]” indicate optional keywords or arguments.
A vertical bar “ | “ separates individual settings.
Example:
In this example, the user enters the word “timeout;” must specify either for
“tcp” or “udp” for a protocol type; and optionally enters a timeout value “n.”
Angled brackets. All parameter settings are enclosed in angled brackets. The
user is directed to choose an appropriate setting. In some cases, the parameter
name accompanies the required setting.
Optional parameter settings in each syntax are indicated by normal brackets.
Router User Guide
Table 7 Example Conventions
For ExamplesWhat it means
Page 17
Chapter : Command Line Interface9
Abbreviated
Commands
normal type
bold type
Prompts and commands that are part of the main prompt are shown in normal
type.
Examples:
Alcatel-host>
Alcatel-host/show>
All character strings that a user must enter to execute a command are in bold
type.
Example:
Alcatel-host> configure term
You may enter commands by typing the first few characters of each word in a command string. The
Alcatel system recognizes the unique abbreviated entry and executes the command exactly as if you
had entered it fully.
For example, to view the currently running system configuration, you may type show configuration running at the prompt. You may also type discon run to get the same result. Similarly, you may
abbreviate the optional parameter names required by some commands.
For example, a typical entry may be as follows:
mlppp mrru 1600 sequence short seg_threshold 1000 differential_delay 100 discriminator
10.1.100.22
To save time, you may type the following equivalent abbreviated string:
mlppp m 1600 seq short seg 1000 diff 100 dis 10.1.100.22
CLI Navigation
The Ta b, Esc, and Ctrl keyboard keys may be used to:
nMove backwards or forwards in the CLI
nEdit entered command strings
nOr accelerate the command entry process
Navigation KeysYou may use the Tab key to quickly enter each word of a command without typing its full name. For
example, to enter the configure command, you may type its first two letters and then press Ta b to
complete the entire word. Then, you may specify an item to configure by pressing the Spacebar and
then pressing Ta b repeatedly until the desired sub-command appears. Repeat this sequence for each
successive sub-command string until the entire command string appears.
You may also use the other keystrokes shown in Figure 1 during command entry. For example, to
back up the cursor without deleting any characters, type Ctrl-B. To repeat the last command that you
entered, type Ctrl-P. To go back several commands, type Ctrl-P repeatedly until the desired
previous command appears. Or, you may go directly back to the main CLI> prompt from anywhere
in the command hierarchy by typing Ctrl-Z.
Router User Guide
Page 18
10 Chapter : Command Line Interface
Figure 1 Navigation Keys
> help edit
key stroke -- action
---------- -- ----- TAB -- command completion
Esc-B -- go back one word
Esc-F -- forward one word
Esc-DEL -- delete one word left to cursor
BackSpace -- go back and delete one char
Ctrl-A -- start of line
Ctrl-B / <- -- go back one char
Ctrl-D / DEL -- delete a char
-- go up one level if empty command
Ctrl-E -- end of line
Ctrl-F / -> -- forward one char
Ctrl-K -- delete line ahead of cursor
Ctrl-L -- refresh line
Ctrl-N / DN ARROW -- next command in history
Ctrl-P / UP ARROW -- previous command in history
Ctrl-U -- delete entire line
Ctrl-W -- delete one word left to cursor
>
Command Help
Command help is available for navigating the CLI command hierarchy and for assistance with
specific commands. You may obtain help by using any of the three commands described below.
HelpType help at the main CLI prompt to see the basic Alcatel system help information. Or, type help
followed by a command name to view information about that command. Figure 2 shows the help
screen.
Figure 2 Help Screen
> help
? -- display commands under this tree
exit [level] -- exit (level nos ) from the current tree
-- 'exit' from "top level" terminates CLI
Ctrl-Z -- exit to top level
tree -- display tree under current node
type 'help edit' to see editing features
type 'help <cmd>' to get help for that command
>
TreeYou may view a tree that shows all CLI commands, or a tree that shows only the commands
associated with the current command mode (or the routing mode for example). Figure 3 shows two
command tree examples. If you type tree at the main (
list of system commands appears. If you type tree within a command mode, such as
Alcatel-6000/clear> tree, the commands associated with this command mode are displayed.
To view help information for a command category, specific command, or a parameter, type the
associated word followed by a space and a question mark (?). For example, if you type a question
mark at the main command prompt, the system command categories appear. Figure 4 shows a
display of these top-level commands.
Router User Guide
Page 20
12 Chapter : Command Line Interface
Figure 4 ? Help Screen
> ?
NAME
xcli -- This is root and not a command
SYNTAX
COMMANDS <cr>
DESCRIPTION
COMMANDS -- Any of the following commands can be used
clear -- access clear commands
configure -- configure from ( flash / network / terminal )
debug -- accesses debug commands
dir -- directory of files in flash
erase -- access erase filesystem commands
file -- access file commands
password -- Change the user password
ping -- invoke ping
reboot -- reboot the system
reload -- reboot the system
save -- save configuration to ( local / network )
show -- access show commands
tclsh -- To invoke TCL shell
telnet -- open a telnet connection
test -- access test commands
trace -- trace route to destination address or host name
write -- write to terminal/network/flash
>
The default parameters for specific commands appear in parenthesis.
NOTE:
Global CommandsAll show, ping, and save commands are available from any level of the CLI. For example, the global
show commandsallow the user to view current configuration settings, alarms, or tests without
exiting the configure mode. In (Figure 5), a user has displayed a bundle summary while configuring
a new bundle.
Similarly, the ping and save commands are available at any level of the CLI command. The ping
command verifies connectivity between the
save commands from anywhere in the CLI ensures that your configurations may be saved
periodically.
Alcatel system and other network hosts; access to the
Router User Guide
Page 21
Chapter : Command Line Interface13
Figure 5 Global Show Command
> show configuration
: Select type of 'configuration' ( Hit Tab )
> dir
The tab completion feature is not currently available for global commands.
Router User Guide
Page 22
14 Chapter : Command Line Interface
Router User Guide
Page 23
P
OLICY
This chapter provides information about routing policy commands that are supported by Alcatel.
C
OMMANDS
15
Router User Guide
Page 24
16 Chapter : Policy Commands
configure policy
This command provides access to the next-level commands.
next-level commands
configure policy as_path
configure policy community_list
configure policy ip_access_list
configure policy route_map
Router User Guide
Page 25
Chapter : Policy Commands17
configure policy as_path
This command configures the autonomous system path filter for BGP.
AS path access lists are used for matching the AS path attribute in a BGP route. An AS path access
list succeeds if any “permit” line in the list matches, or fails if any “deny” line matches. Matching
proceeds sequentially and stops at the first match.
The regular expression parameter is an as path regular expression. (For regular expression syntax,
see “AS Path Regular Expressions” on page 105.) Note that the regular expression must be enclosed
in quotation marks. The AS number is the smallest element of a
integer ranging from 0 to 65536; the
Alcatel regular expression matcher is AS number-based.
Any number of AS path access list lines may be declared. They are evaluated in the order declared. If
neither permit nor deny is specified, the default is “permit.”
parameter definition
access_listAccess list number
Range is 1 - 199.
numberSequence to insert or delete from an existing AS path entry.
Range is 0 - 65535.
action
deny
permit
regular_expressionRegular expression to match the AS paths.
Deny AS path.
Permit AS path.
Enter a quoted string.
Refer to AS Path Regular Expressions on page 105 for more information about regular
expressions.
Alcatel regular expression. It is an
syntax:
[ no ] policy as_path access_list < n > number < n > action < deny | permit > regular_expression <
“string” >
This command accesses next-level commands for adding extended or standard community lists.
Community lists are used for matching the “community” attribute in a BGP route. A community list
succeeds if any “permit” line in the list matches, or fails if any “deny” line matches. Matching
proceeds sequentially and stops at the first match. A line in a community list is normally said to
match if the route being tested contains at least all of the communities listed in the line. That is, it
may contain additional communities as well. If the exact-match keyword is used, then it must
contai8n exactly the same communities as listed.
The communities parameter can be:
local_as
no_advertise
no_export
aa_nn (an integer between 0 and 65,535)
community (an integer between 1 and 4294967295
Note that “exact_match” is supported in the community_list as well as at the route_map level. If
neither permit nor deny is specified, the default is permit. If no community is specified, any route
will be matched, regardless of what communities are present. The route will even be matched if the
community path attribute is not present. Any number of community list lines may be declared. They
are evaluated in the order declared.
This command configures a standard community list as part of the routing policy.
parameter definition
community_listExtended community list number
The range is 100 - 199.
community_indexCommunity index number
The range is 0 - 65535.
action
deny
permit
communityA list of community numbers
generate_local_as
local_as
aa_nnCommunity number in aa_nn format
generate_no_advertise
no_advertise
generate_no_export
no_export
Specify a community to reject.
Specify a community to permit.
The range is 1 - 4294967295.
This list can contain a maximum of 32 numbers.
Do not send out local AS.
This list can contain a maximum of 32 numbers.
Do not advertise to any neighbor.
Do not send to next AS
Router User Guide
syntax:
[ no ] policy community_list standard_community community_list < n > community_index < n >
action < deny | permit > [ community < n > ] [ generate_local_as < local_as > ]
[ aa_nn < n > ] [ generate_no_advertise <no_advertise > ] [ generate_no_export
< no_export > ]
example:
Alcatel-host/configure> policy community_list standard_community 90 150 permit community
40 45 local_as aa_nn 655:232592 no_advertise
example:
Alcatel-host/configure/policy> community_list standard_community 90 150 permit community
42949672 no_advertise
applicable systems:
All models.
Page 29
Chapter : Policy Commands21
configure policy ip_access_list
This command configures the IP access list for routes.
Ip access lists are used for matching any type of route prefix. An IP access list is said to succeed if
any “permit” line in the list matches, or fails, if any “deny” line matches. Matching proceeds
sequentially and stops at the first match. A line in an IP access list is said to match according to the
rules listed below.
network netmask
Matches addresses as follows: The bits in the address part of the route being masked that are not
covered by “one” bits in net mask must be equal to the corresponding bits in networkt. The “one”
bits in net mask are sometimes referred to as “don’t care” bits, because the policy engine does not
care what their values are.
network netmask mask maskmask
Matches addresses as follows: The first pair of parameters (network, maskmask) match the
address part of the route just as in the previous (network netmask) form. The second pair of
parameters (mask, jaskmask) are used to match against the mask part of the route being matched
in a similar fashion. That is, the route is matched if the address part matches and the bits in the
mask that are not covered by “one” bits in net mask are equal to the corresponding bits in mask.
If neither permit nor deny is specified, the default is permit. All kinds of access_list entries may be
mixed freely within a list, and there are no restrictions on what the access_list number may be. Any
number of IP access list lines may be declared. They are evaluated in the order declared.
parameter definition
access_listAccess list number
The range is 1 - 99
numberSequence to insert to or delete from an existing access list entry.
The range is 0 - 65535.
action
deny
permit
networkNetwork route (IP address in dotted notation)
netmaskNetwork mask as wildcard bits (IP address in dotted notation)
maskNetwork route’s mask (IP address in dotted notation)
maskmaskWildcard mask for network route’s mask ( in dotted notation)
syntax:
Route map deny set operation.
Route map permit set operation.
[ no ] policy ip_access_list access_list < n > number < n > action < deny | permit > [ network < IP address > ] [ netmask < IP address > ] [ mask < IP address > ] [ maskmask < IP address > ]
This example restricts the prefixes to 10.0.0.0/8 only.
applicable systems:
All models.
Router User Guide
Page 31
Chapter : Policy Commands23
configure policy route_map
This command configures the policy for router route maps.
Route maps are used for general-purpose matching of routes and setting of route attributes. Each
route_map is comprised of one or more route_map clauses, of the form shown below.
route_map name number [ permit | deny ]
match statements
set statements
A route_map clause is said to match if each of its match statements matches, according to the rules
given below. A route_map is said to succeed if one of its permit clauses clauses matches, and fails if
one of its deny clauses matches. Matching proceeds sequentially and stops at the first match. If the
route_map succeeds, the actions specified by the set statements in the matched clause are performed.
If neither permit nor deny is specified, the default is permit.
Match statements can be:
match as_path
match community
match ip ip_address
Set statements can be:
set as_path
set community
set local_preference
set metric
set origin
set distance
set metric_type
parameter definition
nameRoute map name
numberA sequence to insert to or delete from exiting route map.
The range is 0 - 65535.
action
deny
permit
Deny the route map.
This is the default value.
Permit the route map.
syntax:
[ no ] policy route_map name number [ action < deny | permit > ]
This command accesses next-level commands for configuring the policy for matching parameters of
the routes.
next-level commands
configure policy route_map match as_path
configure policy route_map match community
configure policy route_map match ip
Router User Guide
Page 34
26 Chapter : Policy Commands
configure policy route_map match as_path
This command matches any of the specified BGP AS path access lists.
parameter definition
path_listAS path access list
syntax:
[ no ] policy match as_path path_list < n >
example:
Alcatel-host/configure/policy/route_map Block100 1> match as_path 1
next-level commands
configure policy route_map match ip
configure policy route_map match community
The range is 1 - 199; the maximum list size is 32.
applicable systems:
All models.
Router User Guide
Page 35
Chapter : Policy Commands27
configure policy route_map match community
This command matches any of the specified BGP community lists.
syntax:
[ no ] policy match community
example:
Alcatel-host/configure/policy/route_map Block100 1> match community
next-level commands
configure policy route_map match as_path
configure policy route_map match ip
applicable systems:
All models.
Router User Guide
Page 36
28 Chapter : Policy Commands
configure policy route_map match ip ip_address
This command distributes routes matching the prefix against any of the specified IP access lists.
parameter definition
ip_listIp access list number(s)
syntax:
[ no ] match ip ip_address ip_list < n >
example:
Alcatel-host/configure/policy/route_map Block100 1> match ip ip_address 20
applicable systems:
All models.
Enter a list of numbers.
The range is 1 - 199.
A maximum of 32 numbers can be in the list.
Router User Guide
Page 37
Chapter : Policy Commands29
configure policy route_map set
This command provides access to next-level commands to set parameters for the routes.
next-level commands
configure policy route_map set as_path
configure policy route_map set community
configure policy route_map set distance
configure policy route_map set local_preference
configure policy route_map set metric
configure policy route_map set metric_type
configure policy route_map set origin
Router User Guide
Page 38
30 Chapter : Policy Commands
configure policy route_map set as_path
This command configures a character string for a BGP AS-path attribute.
parameter definition
prependAS path access list
tagSet tag as an AS path attribute.
syntax:
[ no ] set as_path [ prepend < n > ] [ tag < n > ]
example:
Alcatel-host/configure/policy/route_map Block100 1> set as_path prepend 100 250 tag 0
Enter a list of numbers.
The range is 1 - 65535; the maximum list size is 32.
Enter a number.
related commands
configure policy route_map set community
configure policy route_map set distance
configure policy route_map set local_preference
configure policy route_map set metric
configure policy route_map set metric_type
configure policy route_map set origin
applicable systems:
All models.
Router User Guide
Page 39
Chapter : Policy Commands31
configure policy route_map set community
This command configures the policy for community attributes.
Set the community attribute to the given value or list of values. If the additive keyword is specified,
the list of values augments any communities already present. If the additive keyword is not specified,
the list of values overwrites any communities already present.
parameter definition generate_
numberCommunity number (unsigned)
The range is 1 - 4294967294
The maximum numbers in the list is 32.
aa_nnCommunity number in aa_nn format
Enter a number or a list of numbers separated by spaces.
The maximum numbers in the list is 32
generate_additive
additive
generate_local_as
local_as
generate_no_advertise
no_advertise
generate_no_export
no_export
Add to the existing community.
Do not send outside local AS.
Do not advertise to any neighbor.
Do not send to next AS
syntax:
[ no ] set community number [ < n > ] [aa_nn < n > ] [ generate_additive < additive > ]
[ generate_local_as < local_as > ] [ generate_no_advertise < no_advertise > ]
[ generate_no_export < no_export > ]
example:
Alcatel-host/configure/policy/route_map Block100 1> set community aa_nn 500:60
related commands
configure policy route_map set as_path
configure policy route_map set distance
configure policy route_map set local_preference
configure policy route_map set metric
configure policy route_map set metric_type
configure policy route_map set origin
applicable systems:
All models.
Router User Guide
Page 40
32 Chapter : Policy Commands
configure policy route_map set distance
This command sets the BGP protocol preference for the path attribute.
parameter definition
distanceDefault preference value
syntax:
[ no ] set distance distance < n >
example:
Alcatel-host/configure/policy/route_map Block100 1> set distance 20
related commands
configure policy route_map set as_path
configure policy route_map set community
configure policy route_map set local_preference
configure policy route_map set metric
configure policy route_map set metric_type
configure policy route_map set origin
The range is 0 - 255.
applicable systems:
All models.
Router User Guide
Page 41
Chapter : Policy Commands33
configure policy route_map set local_preference
This command configures the BGP local preference path attribute.
parameter definition
local_preferencePreference value
The range is 1 - 4292967294.
syntax:
[ no ] set local_preference local_preference < n >
example:
Alcatel-hostconfigure/policy/route_map Block100 1> set local_preference 50
related commands
configure policy route_map set as_path
configure policy route_map set community
configure policy route_map set distance
configure policy route_map set metric
configure policy route_map set metric_type
configure policy route_map set origin
applicable systems:
All models.
Router User Guide
Page 42
34 Chapter : Policy Commands
configure policy route_map set metric
This command configures the metric value for the destination routing protocol.
parameter definition
metricMetric value
syntax:
[ no ] set metric metric < n >
example:
Alcatel-host/configure/policy/route_map Block100 1> set metric 120
related commands
configure policy route_map set as_path
configure policy route_map set community
configure policy route_map set distance
configure policy route_map set local_preference
configure policy route_map set metric_type
configure policy route_map set origin
The range is 1 - 4294967294.
applicable systems:
All models.
Router User Guide
Page 43
Chapter : Policy Commands35
configure policy route_map set metric_type
This command configures the metric type for a route.
parameter definition
typeInternal
internal
syntax:
[ no ] set metric_type type < internal >
example:
Alcatel-host/configure/policy/route_map Block100 1> set metric_type internal
related commands
configure policy route_map set as_path
configure policy route_map set community
configure policy route_map set distance
configure policy route_map set local_preference
configure policy route_map set metric
configure policy route_map set origin
Use the IGP metric as the MED for BGP.
applicable systems:
All models.
Router User Guide
Page 44
36 Chapter : Policy Commands
configure policy route_map set origin
This command configures the origin value for the BGP route.
parameter definition
origin
egp
igp
incomplete
syntax:
[ no ] set origin origin < egp | igp | incomplete >
example:
Alcatel-host/configure/policy/route_map Block100 1> set origin igp
EGP protocol
IGP protocol
Unknown protocol type
next-level commands
configure policy route_map set origin egp
configure policy route_map set origin igp
configure policy route_map set origin incomplete
applicable systems:
All models.
Router User Guide
Page 45
G
ENERIC
This chapter contains routing commands that are not protocol specific. These commands can be used
interchangeably with the three routing protocols supported by
R
OUTING
C
OMMANDS
Alcatel.
37
Router User Guide
Page 46
38 Chapter : Generic Routing Commands
configure router
This command provides access to next-level commands.
next-level commands
configure router routerid
Router User Guide
Page 47
Chapter : Generic Routing Commands39
configure router routerid
This command configures a router for routing operation.
DistanceThe administrative distance for the route.
MetricThe metric for the route.
By default, information is displayed for all routes in the routing table. To display only specific route
information, specify the appropriate protocol or the network mask.
Router User Guide
Page 49
Chapter : Generic Routing Commands41
example:
To display all routes, issue the show ip routes command.
example:
To display the route for a specific network and subnet, issue the show ip routes network 123.1.2.0
mask 255.255.255.0 command.
example:
To display the connected ip routes, issue the show ip routes connected command.
example:
To display static routes, issue the show ip routes static command.
example:
To display RIP routes, issue the show ip routes rip command.
example:
To display ospf routes, issue the show ip routes ospf command.
example:
Alcatel-host/show> ip routesbgp
The following screen display example is a typical display showing the destination IP address, metric,
netmask and gateway, status, Ethernet interface, and type of route.
applicable systems:
All models.
Router User Guide
Page 50
42 Chapter : Generic Routing Commands
Router User Guide
Page 51
43
BGP4 C
Use BGP clear commands to clear bgp configuration settings.
LEAR
C
OMMANDS
Router User Guide
Page 52
44 Chapter : BGP4 Clear Commands
clear ip bgp
This command provides access to the following next-level commands.
syntax:
clear ip bgp
next-level commands
clear ip bgp all
clear ip bgp group
clear ip bgp neighbor
example:
Alcatel-host> clear ip bgp
applicable systems:
All models.
Router User Guide
Page 53
Chapter : BGP4 Clear Commands45
clear ip bgp all
This command removes all BGP neighbor connections.
syntax:
clear ip bgp all
example:
Alcatel-host> clear ip bgp all
related commands
clear ip bgp group
clear ip bgp neighbor
applicable systems:
All models.
Router User Guide
Page 54
46 Chapter : BGP4 Clear Commands
clear ip bgp group
This command removes all connections for a BGP group.
parameter definition
group_nameName of the group
syntax:
clear ip bgp group group_name < name >
example:
Alcatel-host> clear ip bgp group north
In this example, all BGP connections that belong to neighbor group north will be cleared.
related commands
clear ip bgp all
clear ip bgp neighbor
applicable systems:
All models.
Router User Guide
Page 55
Chapter : BGP4 Clear Commands47
clear ip bgp neighbor
This command removes a specified BGP neighbor connection.
parameter definition
ip_addressThe IP address of the neighbor
Enter an IP address (in dotted notation) to be cleared.
remote_asThe AS number of the remote neighbor to be cleared.
The range is from 1 - 65535.
syntax:
clear ip bgp neighbor ip_address < IP address > remote_as < n >
example:
Alcatel-host> clear ip bgp neighbor 10.1.1.1 200
related commands
clear ip bgp all
clear ip bgp group
applicable systems:
All models.
Router User Guide
Page 56
Page 57
49
BGP4 C
Use BGP configure commands to configure all BGP4 parameters.
ONFIGURE
C
OMMANDS
Router User Guide
Page 58
50 Chapter : BGP4 Configure Commands
configure router bgp
This command configures BGP routing protocol on a router and provides access to the next-level
commands listed below.
parameter definition
as_numberThe number of an autonomous system.
syntax:
[ no ] router bgp as_number < n >
example:
Alcatel-host/configure> router bgp 10
next-level commands
configure router bgp aggregate_address
configure router bgp always_compare_med
configure router bgp distance
configure router bgp default_metric
configure router bgp group
configure router bgp neighbor
configure router bgp redistribute
The range is 1 - 65535.
Router User Guide
applicable systems:
All models.
Page 59
Chapter : BGP4 Configure Commands51
configure router bgp aggregate_address
This command is used to aggregate routes.
parameter definition
networkNetwork IP address in dotted notation
maskNetwork subnet mask address in dotted notation
generate_as_set
as_set
generate_summary_only
summary_only
suppress_mapName of the route map to suppress
advertise_mapName of route map to control attribute advertisement
attribute_mapName of route map for setting attributes
Generates AS path information
Form a verbose aggregate, whose AS path contains a leading AS sequence
representing the common leading sequence of all contributing routes, and whose AS
path contains a trailing AS set representing all ASes in all contributing paths that could
not be included in the AS sequence. By default, this feature is off, and the AS path is
truncated when the aggregate is formed.
Filters more specific routes from updates
Suppresses transmission of any contributing routes if an aggregate exists. Note that the
contributing route will not be sent even if an outgoing route_map blocks the sending
of the aggregate itself. This cannot be combined with the suppress_map parameter.
Uses the named route_map to suppress the transmission of selected contributing
routes. Contributing routes that do not match the route_map will not be suppressed.
This cannot be combined with the summary_only parameter.
Selects the routes that contribute to the aggregate. The aggregate will only be formed
if matching routes exist. Only the matching routes will be suppressed if summary_only
or suppress_map are configured.
Specifies attributes to be set on the aggregate when it is transmitted.
syntax:
[ no ] aggregate_address network < IP address > mask < subnet mask > [ generate_as_set
< as_set > ] [ generate_summary_only < summary_only > ] [ suppress_map < name > ]
[advertise_map < name > ] [ attribute_map < name > ]
This command configures a router to allow the comparison of the multi-exit discriminator for paths
from neighbors in different autonomous systems.
Normally, MED comparison is done on paths within the same autonomous system. This command
allows the comparison to be made for paths received from other autonomous systems.
Generated or aggregate130Applicable to BGP only, and is not configurable.
OSPF AS external routes150configure router ospf distance ospf external
BGP170configure router bgp distance
Preference
Command to Modify Default Preference
related commands
configure router bgp aggregate_address
configure router bgp always_compare_med
configure router bgp default_metric
configure router bgp group
configure router bgp neighbor
configure router bgp redistribute
applicable systems:
All models.
Router User Guide
Page 64
56 Chapter : BGP4 Configure Commands
configure router bgp group
This command configures BGP groups.
Neighbors with the same update policies are more easily managed when they are in groups. Group
organization simplifies configuration and streamlines the update process. Neighbor group members
inherit all configuration options of a group. The BGP group sub commands are similar to those found
under the neighbor tree, but they are applied to all neighbors in the group.
parameter definition
nameGroup name to be configured
group_type
external
external_rt
internal
External routing group
Default group name = AlcatelBgpExternal
External routing group
Default group name = AlcatelBgpExternalRt
Internal routing group
Default group name = AlcatelBgpInternal
syntax:
[ no ] group name < name > group_type < external | external_rt | internal |
internal_ rt >
example:
Alcatel-host/configure/router/bgp 10> group toronto internal
next-level commands
configure router bgp group distribute_list
configure router bgp group filter_list
configure router bgp group next_hop_self
configure router bgp group password
configure router bgp group remove_private_AS
configure router bgp group route_map
applicable systems:
All models.
Router User Guide
Page 65
Chapter : BGP4 Configure Commands57
configure router bgp group distribute_list
This command configures filter updates to this group.
parameter definition
access_listIP access list number
The range is 1-199.
filter_option
out
syntax:
[ no ] distribute_list access_list < n > filter_option < out >
example:
Alcatel-host/configure/router/bgp 10/group toronto internal> distribute_list 101 out
related commands
configure router bgp group filter_list
configure router bgp group next_hop_self
configure router bgp group password
configure router bgp group remove_private_AS
configure router bgp group route_map
Outbound direction
applicable systems:
All models.
Router User Guide
Page 66
58 Chapter : BGP4 Configure Commands
configure router bgp group filter_list
This command configures BGP filters for a specified group.
parameter definition
access listAS path access list
filter_option
out
syntax:
[ no ] filter_list access list < n > filter_option < out >
example:
Alcatel-host/configure/router/bgp 10/group toronto internal> filter_list 103 out
related commands
configure router bgp group distribute_list
configure router bgp group next_hop_self
configure router bgp group password
configure router bgp group remove_private_AS
configure router bgp group route_map
The range is 1-199.
Outbound direction
Router User Guide
applicable systems:
All models.
Page 67
Chapter : BGP4 Configure Commands59
configure router bgp group next_hop_self
This command disables the next hop calculation for all peers in the group.
syntax:
next_hop_self
example:
Alcatel-host/configure/router/bgp 10/group blue external> next_hop_self
related commands
configure router bgp group distribute_list
configure router bgp group filter_list
configure router bgp group password
configure router bgp group remove_private_AS
configure router bgp group route_map
applicable systems:
All models.
Router User Guide
Page 68
60 Chapter : BGP4 Configure Commands
configure router bgp group password
This command configures the TCP MD5 password to enable MD5 authentication for a BGP group.
parameter definition
md5_passwordTCP MD5 password (string) for the group
syntax:
[ no ] password md5_password < string >
example:
Alcatel-host/configure/router/bgp 10/group toronto internal> password rt56htd
related commands
configure router bgp group distribute_list
configure router bgp group filter_list
configure router bgp group next_hop_self
configure router bgp group remove_private_AS
configure router bgp group route_map
Enter a word.
applicable systems:
All models.
Router User Guide
Page 69
Chapter : BGP4 Configure Commands61
configure router bgp group remove_private_AS
This command removes the private AS number from updates that are sent out.
syntax:
[ no ] remove_private_AS
example:
Alcatel-host/configure/router/bgp 10/group toronto internal> remove_private_AS
related commands
configure router bgp group distribute_list
configure router bgp group filter_list
configure router bgp group next_hop_self
configure router bgp group password
configure router bgp group route_map
applicable systems:
All models.
Router User Guide
Page 70
62 Chapter : BGP4 Configure Commands
configure router bgp group route_map
This command configures a route map to a BGP group.
This command can only be applied in the outbound direction.
parameter definition
route_mapRoute map name
route_map_options
out
syntax:
[ no ] route_map route_map < name > route_map_options < out >
example:
Alcatel-host/configure/router bgp 10/group toronto internal> route_map foo out
related commands
configure router bgp group distribute_list
configure router bgp group filter_list
configure router bgp group next_hop_self
configure router bgp group password
configure router bgp group remove_private_AS
Outbound direction
Router User Guide
applicable systems:
All models.
Page 71
Chapter : BGP4 Configure Commands63
configure router bgp neighbor
This command configures a BGP neighbor.
parameter definition
IP addressThe IP address of the neighbor in dotted notation
remote_asThe AS number
The range is 1 - 65535.
syntax:
[ no ] neighbor IP address < IP address > remote_as < n >
This command configures the source of BGP TCP connections for a specified neighbor as the IP
address specified, instead of the IP address of a physical interface.
This address will be used as the source address for routing updates.
This command provides access to the following next-level commands.
Redistribution causes routes from other protocols to be exported via the current protocol. Routes
from the current protocol are always exported, some protocols may provide additional policy
features that allow the suppression of protocol routes.
next-level commands
configure router bgp redistribute connected
configure router bgp redistribute ospf
configure router bgp redistribute rip
configure router bgp redistribute static
related commands
configure router bgp aggregate_address
configure router bgp always_compare_med
configure router bgp distance
configure router bgp default_metric
configure router bgp group
configure router bgp neighbor
Router User Guide
Page 90
82 Chapter : BGP4 Configure Commands
configure router bgp redistribute connected
This command redistributes interface routes.
parameter definition
metricDefault metric
route_mapName of the route map to use
syntax:
[ no ] redistribute connected [ metric < n > ] [ route_map < name > ]