Portdecom - Brocade Communications Systems Brocade 8/12c Command Reference Manual

portDecom

Decommissions and disables an E_Port without frame loss.
SYNOPSIS
portdecom
portdecom [slot/]port
portdecom --help
DESCRIPTION
Use this command to disable an E_Port without frame loss. The E_Port can either be a single redundant
E_Port or an E_Port which is part of a trunk group. The port must be an operational E_Port with at least
one other redundant E_Port available to reach all domains that the E_Port can reach. Or the port must
be an operational E_Port which is part of a trunk group with at least one other member in the trunk. The
last member of the trunk group may also be decommissioned, if there are other available redundant
E_Ports.
Upon successful completion of the command all traffic flows on the port will have been moved to other
redundant paths and the port will be placed in a persistently disabled state. To bring the port back online
use the portCfgPersistentEnable command.
NOTES
Port decommissioning is not supported on links configured for encryption or compression.
The execution of this command requires that the lossless feature is enabled on both the local switch and
the remote switch on the other end of the E_Port. This command will fail for online ports, if the port is not
a fully operational E_Port or trunk port, lossless is not enabled on the local or remote switch, or no
alternate redundant path is available to route the traffic. A redundant path must be an E_Port connection
between the same pair of switches as the E_Port that is being decommissioned. Use the topologyShow
command to verify that alternate paths are available to reach all domains.
When decommissioning the member of a trunk group, all members must have an equal link cost. If a
member does not have an equal cost, the cost of the trunk as a whole may change after
decommissioning the port and cause routes to be changed. Refer to the linkCost command for more
information.
The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
OPERANDS
This command has the following operands:
slot
port
EXAMPLES
To decommission a port
SEE ALSO
dlsSet, dlsShow, linkCost, portCfgPersistentEnable,
Fabric OS Command Reference
53-1001764-01
For bladed systems only, specifies the slot number of the ports to be disabled,
followed by a slash (/).
Specifies the E_Port to be decommissioned.
switch:user> portdecom 2/5
The port has been decommissioned and persistently disabled.
portDecom
topologyShow
22
711