set port lacp

Use this command to set link aggregation parameters for one or more ports.

Syntax

set port lacp port port-string {[aadminkey aadminkey] [aportpri aportpri] [aadminstate {lacpactive | lacptimeout | lacpagg | lacpsync | lacpcollect | lacpdist | lacpdef | lacpexpire}] [padminsyspri padminsyspri] [padminsysid padminsysid] [padminkey padminkey] [padminportpri padminportpri] [padminport padminport] [padminstate {lacpactive | lacptimeout | lacpagg | lacpsync | lacpcollect | lacpdist | lacpdef | lacpexpire}] [enable | [disable]}

Parameters

port port-string Specifies the physical port(s) on which to configure LACP.
aadminkey aadminkey Sets the port‘s actor admin key. LACP will use this value to form an oper key and will determine which underlying physical ports are capable of aggregating by comparing oper keys. Aggregator ports allow only underlying ports with oper keys matching theirs to join their LAG. Valid values are 1 - 65535.
aportpri aportpri Sets the port‘s actor port priority. Valid values are 0 - 65535, with lower values designating higher priority.
aadminstate lacpactive | lacptimeout | lacpagg | lacpsync | lacpcollect | lacpdist | lacpdef | lacpexpire Sets the port‘s actor LACP administrative state to allow for:
  • lacpactive - Transmitting LACP PDUs.
  • lacptimeout - Transmitting LACP PDUs every 1 sec. vs 30 sec. (default).
  • lacpagg - Aggregation on this port.
  • lacpsync - Transition to synchronization state.
  • lacpcollect - Transition to collection state.
  • lacpdist - Transition to distribution state.
  • lacpdef - Transition to defaulted state.
  • lacpexpire - Transition to expired state.
padminsyspri padminsyspri Sets a default value to use as the port‘s partner priority. Valid values are 0 - 65535, with lower values given higher priority.
padminsysid padminsysid Sets a default value to use as the port‘s partner system ID. This is a MAC address.
padminkey padminkey Sets a default value to use as the port‘s partner admin key. Only ports with matching admin keys are allowed to aggregate. Valid values are 1 - 65535.
padminportpri padminportpri Sets a default value to use as the port‘s partner port priority. Valid values are 0 - 65535, with lower values given higher priority.
padminport padminport Sets a default value to use as the port‘s partner admin value. Valid values are 1 - 65535.
padminstate lacpactive | lacptimeout | lacpagg | lacpsync | lacpcollect | lacpdist | lacpdef | lacpexpire Sets a port‘s partner LACP administrative state. See aadminstate for valid options.
enable (Optional) Enables LACPDU processing on this port.
disable (Optional) Disables LACPDU processing on this port. Disabled by default.

Defaults

  • At least one parameter must be entered per port-string.
  • If enable or disable are not specified, port(s) will be disabled with the LACP parameters entered.

Mode

All command modes.

Usage

These settings will determine the specified underlying physical ports‘ ability to join a LAG, and their administrative state once aggregated.

LACP commands and parameters beginning with an “a” (such as aadminkey) set actor values. Corresponding commands and parameters beginning with a “p” (such as padminkey) set corresponding partner values. Actor refers to the local device participating in LACP negotiation, while partner refers to its remote device partner at the other end of the negotiation. Actors and partners maintain current status of the other via LACPDUs containing information about their ports‘ LACP status and operational state.

Example

This example shows how to set the actor admin key to 3555 for port ge.3.16:

System(rw)->set port lacp port ge.3.16 aadminkey 3555