C613-50186-01 Rev B
Command Reference for AR2050V
1423
AlliedWare Plus™ Operating System - Version 5.4.7-1.x
P
OLICY
-
BASED
R
OUTING
C
OMMANDS
IP
POLICY
-
ROUTE
ip policy-route
Overview
Use this command to configure IP policy routes. These routes specify how the
device will route traffic from specified applications and entities. You can specify
the route’s next-hop by specifying the egress interface, or by specifying the
next-hop device’s IP address (except on dynamic interfaces such as PPPoE). You
can also list alternative next-hops to use if your first choice is down.
Use the
no
variant of this command to remove a policy route.
Syntax
ip policy-route [
<1-128>
] [match
<application-name>
] [from
<source-entity>
] [to
<destination-entity>
] nexthop
{
<interface-list>
|
<ip-add-list>
}
no ip policy-route
<1-128
>
Default
No policy routes
Mode
Policy-based-routing
Usage
You must specify at least one of the
match
,
from
or
to
parameters. Packets will be
routed to the specified next-hop if they match the application, come from the
source entity, and are destined for the destination entity.
Parameter
Description
<1-128>
The policy route ID number.
If you do not specify an ID number, the device assigns
the new policy route the next available number, in
multiples of 10. For example, if the highest numbered
policy route is 81, the next policy route would be given
an ID of 90.
Policy routes are checked in order of ID number, starting
with the lowest ID number. The device applies the policy
route as soon as it finds a matching route; it does not
check the remaining policy routes.
<application-name>
An application name.
<source-entity>
A source entity name.
<destination-entity>
A destination entity name.
<interface-list>
The name of the egress interface or interfaces. You can
list up to 8 interfaces per policy route; the device sends
the traffic out the first interface in the list that is up.
<ip-add-list>
The IP address of the next-hop. You can list up to 8
next-hop addresses per policy route; the device sends
the traffic to the first address in the list that is reachable.
Do not use this when the next-hop is on a dynamic
interface (e.g. PPPoE); specify the interface name
instead.