close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

request fibre-channel proxy load-rebalance

date_range 19-Nov-23

arrow_backward

arrow_forward

Syntax

content_copy zoom_out_map
request fibre-channel proxy load-rebalance 
<dry-run>
fabric <fabric-name>
<brief | detail>

Description

Rebalance the link load on one or more FCoE-FC gateway proxy fabrics (local Fibre Channel fabrics on the gateway) on demand. Load rebalancing is a disruptive action that forces some or all sessions (depending on the configured load-balancing algorithm) to log out and then log in again. When sessions log in again, they are placed on NP_Port interfaces so that the link loads are balanced.

Link load rebalancing occurs 10 seconds after you run the rebalancing command, unless another rebalancing trigger occurs before the 10 seconds elapse. If another rebalancing event occurs before the 10-second timer elapses, the timer is extended. Rebalancing occurs a maximum of 30 seconds after you run the rebalancing command, regardless of whether more rebalancing events occur.

You can also perform a dry run to see a list of sessions that might be affected (logged out) if you request a load rebalance. A dry run does not rebalance the link loads; it only lists the sessions that might be affected if you rebalance.

Options

dry-run	(Optional) Simulates performing link load rebalancing and displays a list of sessions that might be affected if you rebalance the link loads.
fabric `fabric-name`	Name of the fabric on which you want to rebalance the link loads. If you do not specify a fabric name with the fabric keyword, all fabrics on the FCoE-FC gateway rebalance their link loads.
brief \| detail	(Optional) Display the specified level of output.

Additional Information

Requesting link load rebalancing is a one-time, on-demand operation. You must explicitly request load rebalancing every time you want to rebalance the link loads. Alternatively, you can configure automated load rebalancing if you want the NP_Port links to be rebalanced automatically whenever a load-rebalancing trigger occurs.

Required Privilege Level

maintenance

Output Fields

Table 1 lists the output fields for the request fibre-channel proxy load-rebalance dry-run command. Output fields are listed in the approximate order in which they appear.

Table 1: request fibre-channel proxy load-rebalance dry-run Output Fields
Field Name	Field Description
Fabric	Name of the fabric.
Fabric-id	Fabric ID number.
F-Port	FCoE VLAN interface (VF_Port interface to the FCoE network).
FCID	VN_Port Fibre Channel identifier provided by the Fibre Channel over Ethernet Forwarder (FCoE forwarder) or the Fibre Channel switch.
Port-WWN	Unique worldwide name (WWN) of the VN_Port.
NP-Port	Name of the native Fibre Channel interface.

Sample Output