net trunk
net trunk(1) BIG-IP TMSH Manual net trunk(1)
NAME
trunk - Configures a trunk with link aggregation.
MODULE
net
SYNTAX
Modify the trunk component within the net module using the syntax shown
in the following sections.
CREATE/MODIFY
create trunk [name]
modify trunk [name]
options:
app-service [[string] | none]
bandwidth
description [string]
distribution-hash [dst-mac | src-dst-ipport | src-dst-mac]
interfaces
[add | delete | replace-all-with] {
[name ... ]
}
lacp [disabled | enabled]
lacp-mode [active | passive]
lacp-timeout [short | long]
link-select-policy [auto | maximum-bandwidth]
mac-address [MAC address]
stp [disabled | enabled]
stp-reset
qinq-ethertype [string]
edit trunk [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats trunk
reset-stats trunk [ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list trunk
list trunk [ [ [name] | [glob] | [regex] ] ... ]
show running-config trunk
show running-config trunk
[ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
cfg-mbr-count
non-default-properties
one-line
working-mbr-count
show trunk
show trunk [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
detail
field-fmt
DELETE
delete trunk [all | [name]
DESCRIPTION
Link Aggregation allows multiple physical links to be treated as one
logical link. It is also referred to as trunking.
The main objective of link aggregation is to provide increased
bandwidth at a lower cost, without having to upgrade hardware. The
bandwidth of the aggregated trunk is the sum of the capacity of
individual member links. Thus, it provides an option for linearly
incremental bandwidth as opposed to bandwidth options available through
physical layer technology. The traffic management system supports link
aggregation control protocol (LACP).
When a trunk is created, LACP is disabled by default. In this mode, no
control packets are exchanged and the member links carry traffic as
long as the physical layer is operational. In the event of physical
link failure, an LACP member is removed from the aggregation.
Note that both endpoints of the trunk should have identical LACP
configuration to work properly. A mixed configuration where one
endpoint is LACP enabled and the other is LACP disabled, is not valid.
EXAMPLES
create trunk my_trunk interfaces add {1.1 1.2 1.3}
Creates a trunk named my_trunk that includes the interfaces 1.1, 1.2,
and 1.3.
modify trunk my_trunk lacp enabled
Enable LACP on the trunk named my_trunk.
modify trunk my_trunk lacp-mode active
Enable active LACP mode on the trunk my_trunk.
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.
bandwidth
Specifies the operation bandwidth in bytes per second.
cfg-mbr-count
Displays the number of configured members that are associated with
this trunk.
description
User defined description.
distribution-hash
Specifies the basis for the hash that the system uses as the frame
distribution algorithm. The system uses the resulting hash to
determine which interface to use for forwarding traffic.
When frames are transmitted on a trunk, they are distributed
across the working member links. The distribution function ensures
that the frames belonging to a particular conversation are neither
mis-ordered nor duplicated at the receiving end. Distribution is
done by calculating a hash value based on source and destination
addresses carried in the frame and associating the hash value with
a link. All frames with a particular hash value are transmitted on
the same link, thereby maintaining frame order.
The options are:
dst-mac
Uses the destination MAC addresses to calculate the hash
value.
src-dst-mac
Uses the source, destination, and MAC addresses to calculate
the hash value.
src-dst-ipport
Uses the source and destination IP addresses and ports to
calculate the hash value.
glob Displays the items that match the glob expression. See help glob
for a description of glob expression syntax.
id Displays the ID of the trunk.
interfaces
Specifies the interfaces by name separated by spaces that you want
to add to the trunk, delete from the trunk, or with which you want
to replace all existing interfaces associated with the trunk.
lacp Specifies, when enabled, that the system supports the link
aggregation control protocol (LACP), which monitors the trunk by
exchanging control packets over the member links to determine the
health of the links. If LACP detects a failure in a member link,
it removes the link from the link aggregation. LACP is disabled by
default, for backward compatibility.
lacp-mode
Specifies the operation mode for LACP if the lacp option is
enabled for the trunk. The options are:
active
Specifies that the system periodically transmits LACP
packets, regardless of the control value of the peer system.
passive
Specifies that the system periodically transmits LACP
packets, unless the control value of the peer system is
active.
lacp-timeout
Specifies the rate at which the system sends the LACP control
packets. The default value is long.
The options are:
long Specifies that the system exchanges LACP packets every 30
seconds.
short
Specifies that the system exchanges LACP packets every
second.
link-select-policy
Sets the LACP policy that the trunk uses to determine which member
link (interface) can handle new traffic.
Link aggregation is allowed only when all the interfaces are
operating at the same media speed and connected to the same
partner aggregation system. When there is a mismatch among
configured members due to configuration errors or topology changes
(auto-negotiation), link selection policy determines which links
become working members and form the aggregation.
The options are:
auto Specifies that the system chooses the lowest numbered
operational link as the reference link. All the members that
have the same media speed and are connected to the same
partner as that of the reference link are declared as working
members, and they are aggregated. The other configured
members do not carry traffic.
maximum-bandwidth
Specifies that the system adds to the aggregation a subset of
links that gives maximum aggregate bandwidth to the trunk.
mac-address
Specifies the media access control (MAC) address, which is
associated with the trunk, in not case-sensitive hexadecimal colon
notation, for example, 00:0b:09:88:00:9a.
media
Displays the media settings for the trunk.
name Specifies a unique name for the component. This option is required
for the commands create, delete, and modify.
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.
stp Enables or disables spanning tree protocols (STP). The default
value is enabled.
If you disable STP, the system does not transmit or receive STP,
RSTP, or MSTP packets on the trunk, and STP has no control over
forwarding or learning on the trunk.
stp-reset
Resets STP, which forces a migration check.
qinq-ethertype
Specifies the ether-type value used for the packets handled on
this trunk when it is a member in a QinQ vlan. The ether-type can
be set to any string containing a valid hexadecimal 16 bits
number, or any of the well known ether-types: 0x8100, 0x9100,
0x88a8. Default value is set to 0x8100.
working-mbr-count
Displays the number of working members associated with this trunk.
SEE ALSO
create, delete, edit, glob, list, modify, net interface, net vlan,
net vlan-group, regex, reset-stats, 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. All rights
reserved.
BIG-IP 2014-06-04 net trunk(1)