Ipv4RouteGenParams Object

HOME | TECHNOLOGIES | TEST CONFIGURATION | SEQUENCER COMMANDS | GUI COMMAND NAMES | ALL COMMANDS | RESULT | PDU | ALL | OBJECT TREE

Description:

Route/topology generator parameters for IPv4 routes.

Parents: BgpRouteGenParams, IsisLspGenParams, Ospfv2LsaGenParams, Ospfv3LsaGenParams, RipRouteGenParams

Children: BgpRouteGenRouteAttrParams, IsisLspGenRouteAttrParams, Ospfv2LsaGenRouteAttrParams, Ospfv3LsaGenRouteAttrParams, RipRouteGenRouteAttrParams

Ipv4RouteGenParams Writable Attributes

Attribute Description
Common Writable Attributes Active, Name
Count

Total number of routes to generate for this Ipv4RouteGenParams instance.

Type: u32

Default: 0
CreateMultipleRouteBlocks

Create multiple route block with specified number of routes per route block.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Create multiple route blocks.
FALSE

Do not create multiple route blocks.
DisableRouteAggregation

Enable this option to prevent route aggregation by distributing routes to the ports non-sequentially. Prevent aggregation to stress the SUT's routing table capacity and processing power each time a packet arrives.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Routes assigned to any given port will be incremented by 2 in order to prevent aggregation.
FALSE

Routes assigned to any given port will be incremented by 1, which allows for aggregation.
DuplicationPercentage

Percentage of routes that will be duplicated to another port. The duplicate routes are assigned the secondary category.

Type: double

Default: 0

Range: 0 - 100
EmulatedRouters

Type of emulated router locations where routes will be added.

Type: enum

Default: NONE

Possible Values:

Value Description
NONE

Do not add routes to any emulated routers.
ALL

Add routes to all emulated routers.
EnableIpAddrOverride

Whether to use IpAddrStart/IpAddrEnd values or the default start/end IP addresses.

Type: bool

Default: TRUE

Possible Values:

Value Description
TRUE

Use the IpAddrStart and IpAddrEnd values.
FALSE

Use the default start and end IP addresses.
IpAddrEnd

Ending IP address to use for generating the routes. If there are not enough addresses between the start and end IP address to generate the specified number of routes, the route generator will generate as many routes as possible. This attribute is valid only when the EnableIpAddrOverride attribute is set to true.

Type: ip

Default: 223.255.255.255
IpAddrIncrement

IP address increment.

Type: u32

Default: 1
IpAddrStart

Starting IP address to use for generating the routes. If multiple Ipv4RouteGenParams are used, the route generator will skip addresses it has already used, but will generate the specified number of routes, if possible. This attribute is valid only when the EnableIpAddrOverride attribute is set to true.

Type: ip

Default: 1.0.0.0
PrefixLengthDist

Percentage of routes to create for each prefix length. This attribute is valid when PrefixLengthDistType is CUSTOM.

Type: double

Default: 0

Range: 0 - 100
PrefixLengthDistRouteCount

PrefixLength Distribution array for Route count

Type: u32

Default: 0
PrefixLengthDistType

Type of prefix length distribution to use to generate the routes. The prefix length distribution determines how many routes are created for each prefix length.

Type: enum

Default: FIXED

Possible Values:

Value Description
FIXED

All routes are generated with the prefix length specified by PrefixLengthStart.
LINEAR

Routes are distributed equally across prefix lengths from PrefixLengthStart to PrefixLengthEnd. If the number of routes cannot be divided equally over the specified prefix range, remaining routes are distributed on prefix 24.
EXPONENTIAL

Routes are distributed across prefix lengths using an exponential algorithm. The algorithm starts by placing half the total number of routes you enter on the specified ending prefix length, and then taking half the remaining routes and placing those on the next prefix length up, and so on. This exponentially distributes routes up toward the starting prefix length in a ratio of 1:2:4:8, etc. Remaining routes are distributed on the ending prefix length.

For example, if the total number of routes is 20 with prefix lengths starting at 24 and ending at 32, there would be 20/2 = 10 of 32-prefix routes, 20/4 = 5 of 31-prefix routes, 20/8 = 2 of 30-prefix routes, and 20/16 = 1 of 29-prefix routes. The remaining 2 routes will be added to the ending prefix lengths; thus, there would be 10 + 2 = 12 of 32-prefix routes.
INTERNET

Routes are distributed across prefix lengths in a manner typical of the Internet's default-free router prefix distribution.
CUSTOM

Custom prefix length distribution allows you to define the percentage of routes for each prefix length.
ROUTECOUNT

Route distribution based on number of routes only for BGP
PrefixLengthEnd

Maximum prefix length for the generated routes. This attribute is valid when the PrefixLengthDistType is FIXED, LINEAR, or EXPONENTIAL.

Type: u8

Default: 24

Range: 1 - 32
PrefixLengthStart

Minimum prefix length for the generated routes. This attribute is valid when the PrefixLengthDistType is FIXED, LINEAR, or EXPONENTIAL.

Type: u8

Default: 24

Range: 1 - 32
RoutesPerBlock

Number of routes per route block.

Type: u32

Default: 0

Range: 0 - 2147483647
SimulatedRouters

Type of simulated router locations where routes will be added. The SimulatedRouters option is available only for protocols that are capable of advertising topologies (OSPF, ISIS) and when topology generation parameters are specified.

Type: enum

Default: ALL

Possible Values:

Value Description
NONE

Do not add routes to any simulated routers.
ALL

Add routes to all simulated routers.
EDGE

Add routes to all simulated routers at the edge of the generated topology. This option is available only for tree topologies.
UseIpAddrIncrement

Whether to use IP address increment.

Type: bool

Default: FALSE

Possible Values:

Value Description
TRUE

Use IP address increment.
FALSE

Do not use IP address increment.
WeightRouteAssignment

How the total number of routes will be distributed.

Type: enum

Default: BYROUTERS

Possible Values:

Value Description
BYPORTS

Equal number of routes is assigned to each port.
BYSPEED

Number of routes assigned to each port is proportional to the speed (line rate) of the port. For example, a port with a speed of 100 Mbps will receive 10 times more routes than a port with a speed of 10 Mbps.
BYROUTERS

Equal number of routes is assigned to each router.

Ipv4RouteGenParams Read-Only Attributes

There are no read-only attributes.