createlag Command

Creates a LAG.

Syntax

createlag lagname [–discoverpkey P_Key][–datasl sl][–lacpmode active|passive|static][–distribution MAC-ONLY|IP-ONLY|TCP-IP|Default][–n][connector1 [connector2 [...connectorN]]][–vniclimit 1|4][–h]

where:

• lagname is the identifier of the LAG.

• P_Key is the discovery partition key (1 to 7fff or default).

• sl is the data service level.

  ---

  Note -  Use service level 1 (sl 1) only for low-latency, high-priority, small-message, low-bandwidth traffic. Use other service levels for regular, high-bandwidth traffic.

  ---

• connector1 is the name of the first connector to be added to the LAG (0A-ETH-1 to 0A-ETH-4 and 1A-ETH-1 to 1A-ETH-4).

• connectorN is the name of the last connector to be added to the LAG (0A-ETH-1 to 0A-ETH-4 and 1A-ETH-1 to 1A-ETH-4).

Description

This hardware command creates a LAG for maximizing Ethernet bandwidth. You specify which connectors are to belong to the LAG. The gateway supports a maximum of 16 LAGs.

The createlag command supports the Link Aggregate Control Protocol (LACP) and permits network devices to auto-negotiate link bundling by sending LACP packets to peers which also implement LACP.

The LAG and associated VNICs are discovered by host drivers in the default or other partition that has been configured with the default discovery P_Key. By defining a LAG-specific discovery P_Key, the visibility is restricted to hosts configured with the same discovery P_Key. The gateway must be a full member of the discovery partition, and the hosts must be at least limited members. The discovery P_Key does not need to be the same as the partition used for data traffic, and different VLANs can still be associated with different partitions for data traffic.

You can create a Global Gateway by not specifying any connectors for the LAG.

The createlag command is available from the /SYS/Gateway_Mgmt and /SYS/Fabric_Mgmt Linux shell targets of the Oracle ILOM CLI interface.

Options

This table describes the options to the createlag command and their purposes.

Option Purpose –discoverypkey Specifies a discovery P_Key, other than default, used by the BridgeX manager. Discovery P_Keys limit the visibility of the LAGs. –datasl Specifies the data service level for a Global Gateway when no connectors are specified. Note -  Use service level 1 (sl 1) only for low-latency, high-priority, small-message, low-bandwidth traffic. Use other service levels for regular, high-bandwidth traffic. –distribution Specifies how the packet flows are distributed over the connectors in the LAG: MAC-ONLY – Packet flow distribution is based on the MAC. IP-ONLY – Packet flow distribution is based on IP. TCP-IP – Packet flow distribution is based on TCP-IP. Default – Default packet flow distribution. Note -  For firmware version 2.1, distribution options MAC-ONLY, IP-ONLY, and TCP-IP map to the Default option. –lacpmode Specifies the LACP mode of operation: active – The ports always send out frames to the peers. passive – The ports send out frames only in response to received frames from peers. static – LACP is not used. LAGs are statically configured. This is the default. –n Specifies the LAG to be non-persistent. The LAG does not survive a reboot. –vniclimit Specifies the maximum number of VNICs to external port associations per LAG (1 = 1000 VNICs, 4 = 4000 VNICs). If the limit is set at 4, then all four ports of the connector group are part of the LAG. The connector group (0A-ETH or 1A-ETH) is specified in the createlag command, and not the individual connectors. –h Provides help.

Example

This example shows how to create a LAG with name test using the createlag command.

FabMan@gateway_name->createlag test 0A-ETH-1 0A-ETH-2
Lag created
FabMan@gateway_name->

Related Information

• deletelag Command

• enablelagmode Command

• Linux Shells for Hardware Commands