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)