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)