net rate-shaping drop-policy
net rate-shaping drop-policy(1BIG-IP TMSH Manuanet rate-shaping drop-policy(1)
NAME
drop-policy - Configures a custom drop policy for use in rate shaping.
MODULE
net rate-shaping
SYNTAX
Configure the drop-policy component within the net rate-shaping module
using the syntax in the following sections.
CREATE/MODIFY
create drop-policy [name]
modify drop-policy [name]
options:
app-service [[string] | none]
average-packet-size [integer]
description [string]
fred-max-active [integer]
fred-max-drop [integer]
fred-min-drop [integer]
inverse-weight [integer]
max-probability [integer]
max-threshold [integer]
min-threshold [integer]
red-hard-limit [integer]
type [fred | red | tail]
edit drop-policy [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
DISPLAY
list drop-policy
list drop-policy [ [ [name] | [glob] | [regex] ] ... ]
show running-config drop-policy
show running-config drop-policy [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
DELETE
delete drop-policy [all | [name] ]
DESCRIPTION
A drop policy tells the system when and how to drop packets when the
traffic handling queue is full, if required. The system comes with
three pre-configured drop policies: fred, red, and tail.
You can use the drop-policy component to create a custom drop policy,
and then associate it with a class using the drop-policy option of the
class component. For more information, see net rate-shaping class.
You can also associate a custom drop policy with a shaping policy using
the drop-policy option of the shaping-policy component. For more
information, see net rate-shaping shaping-policy.
EXAMPLES
create drop-policy my_dp
Creates a custom drop policy named my_dp.
list drop-policy all-properties
Displays all of the properties of all of the drop policies.
OPTIONS
app-service
Specifies the name of the application service to which the object
belongs. The default value is none. Note: If the strict-updates
option is enabled on the application service that owns the object,
you cannot modify or delete the object. Only the application
service can modify or delete the object.
average-packet-size
Specifies the average MTU (maximum transmission unit) size in the
range of 0 to 10000 bytes. The default value is 0 (zero).
description
User defined description.
fred-max-active
Specifies the maximum number of flows that can be active for each
queue. The range is 0 to 10000. The default value is 0
(zero),which disables active flow limitation.
fred-max-drop
Specifies a hard drop limit in the range of 0 to 400. The default
value is 0 (zero). Setting this to a small value does not change
the hard drop limit, but a higher number increases the limit.
fred-min-drop
Specifies a hard no drop limit in the range of 0 to 100. The
default value is 0 (zero). Setting this to a large value prevents
packets from being dropped.
glob Displays the items that match the glob expression. See help glob
for a description of glob expression syntax.
inverse-weight
Specifies the weight used to calculate the average queue length.
Valid values are 0, 64, 128, 256, 512, and 1024. The default value
is 0 (zero).
max-probability
Specifies the maximum percentage probability in the range of 0 to
100 according to which packets are dropped when the average queue
length is between the minimum and maximum thresholds. The default
value is 0 (zero).
max-threshold
Specifies the queue length above which the system drops packets.
The default value is 0 (zero).
min-threshold
Specifies the queue length below which the system does not drop
packets. The default value is 0 (zero).
name Specifies a unique name for the component. This option is required
for the commands create, delete, and modify.
red-hard-limit
Specifies the maximum queue size in bytes. Additional packets are
dropped. The default value is 0 (zero).
This option applies only when the value of the type option is red.
regex
Displays the items that match the regular expression. The regular
expression must be preceded by an at sign (@[regular expression])
to indicate that the identifier is a regular expression. See help
regex for a description of regular expression syntax.
type Specifies the type of drop policy. The default value is tail.
The options are:
fred Specifies that the system uses Flow-based Random Early
Detection to decide whether to drop packets based on the
aggressiveness of each flow.
red Specifies that the system uses Random Early Detection to
determine whether to drop packets to maintain the average
queue length within the specified range.
tail Specifies that the system drops all incoming packets when the
queue is full. This is the simplest drop policy.
Note that although you could create a drop policy based on
tail, that is already the default value of the drop-policy
option in both the shaping-policy and class components.
SEE ALSO
create, delete, edit, glob, list, modify, net rate-shaping class, net
rate-shaping queue, net rate-shaping shaping-policy, regex, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying,
recording, or information storage and retrieval systems, for any
purpose other than the purchaser's personal use, without the express
written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008-2010, 2012-2013, 2016. All
rights reserved.
BIG-IP 2016-03-14 net rate-shaping drop-policy(1)