fipvlan(8) [centos man page]
FIPVLAN(8) Open-FCoE Tools FIPVLAN(8) NAME
fipvlan - Fibre Channel over Ethernet VLAN Discovery SYNOPSIS
fipvlan [-c|--create] [-s|--start] [-m|--mode fabric|vn2vn] interfaces fipvlan -a|--auto [-c|--create] [-d|--debug] [-s|--start] [-m|--mode fabric|vn2vn] [-l|--link-retry count] fipvlan -h|--help fipvlan -v|--version DESCRIPTION
The fipvlan command performs Fibre Channel over Ethernet (FCoE) Initialization Protocol (FIP) VLAN Discovery over Ethernet interfaces. fipvlan can be used as a diagnostic tool to determine which VLANs have FCoE services available on a network, prior to configuring VLAN interfaces and the Open-FCoE initiator. fipvlan can also be used to create VLAN interfaces as they are discovered, and to start the Open-FCoE initiator. The --create and --start options are primarily intended to be used as part of an Open-FCoE boot solution. FCoE instances started in this way cannot be destroyed or reset by fcoeadm. fipvlan takes a list of network interface names to run the VLAN discovery protocol over, or the --auto option to use all available Ethernet interfaces. fipvlan will enable any interface which is found disabled. If no response is received on that interface it will be shutdown again when fipvlan terminates. OPTIONS
-a, --auto Use all Ethernet interfaces currently available -c, --create Create network interfaces for discovered FCoE VLANs. If a VLAN device already exists for a discovered VLAN, a new VLAN device will not be created. -d, --debug Enable debugging output -s, --start Start the Open-FCoE initiator on discovered FCoE VLANs -m, --mode fabric|vn2vn Specify whether VLAN discovery is performed in the default fabric mode, or in VN2VN mode. -f, --suffix suffix Append the specified string suffix to VLAN interface names. -l, --link-retry count Retry check for link up to count times. The link state is checked every 500 ms. The default number of retries is 20. -h, --help Display a help message with basic usage instructions -v, --version Display the fipvlan version string VLAN NAMING CONVENTIONS
If a new VLAN device is created, it will have the name dev.vlan; where dev is the name of the Ethernet parent device and vlan is the discovered VLAN ID number. An optional suffix may be appended to this with the the -f command line option. EXAMPLES
Display all discoverable VLANs with FCoE services fipvlan --auto Discover FCoE VLANs on interface eth2, create VLAN devices and start the Open-FCoE initiator fipvlan --create --start eth2 In this example if FCoE services were available on VLAN 101 of network interface eth2, then a VLAN interface eth2.101 would be created and used as the parent device for the initiator. SEE ALSO
fcoeadm(8) fcoemon(8) SUPPORT
fipvlan is part of the fcoe-utils package, maintained through the Open-FCoE project. Resources for both developers and users can be found at the Open-FCoE website http://open-fcoe.org/ Open-FCoE 03/18/2013 FIPVLAN(8)
Check Out this Related Man Page
FCOEADM(8) Open-FCoE Tools FCOEADM(8) NAME
fcoeadm - The Open-FCoE Administration Tool SYNOPSIS
fcoeadm -c|--create ethX fcoeadm -d|--destroy ethX fcoeadm -r|--reset ethX fcoeadm -i|--interface [ethX] fcoeadm -S|--Scan [ethX] fcoeadm -t|--target [ethX] fcoeadm -l|--lun [ethX] fcoeadm -s|--stats ethX [interval] fcoeadm -h|--help fcoeadm -v|--version DESCRIPTION
The fcoeadm utility is the Fibre Channel over Ethernet (FCoE) management tool for the Open-FCoE project. fcoeadm may be used to create, destroy, and reset an FCoE instance on a given network interface. For these operations fcoeadm sends a command to a running fcoemon process, via a socket interface. fcoemon will then perform the requested operation. fcoeadm also provides options to query information about FCoE instances, including interface information, target information, LUN information, and port statistics. For much of this information, fcoeadm relies on the libhbalinux implementation of the HBA API. OPTIONS
-c, --create ethX Creates an FCoE instance based on the specified network interface. Note that if there is not an fcoemon configuration file for the interface (/etc/fcoe/cfg-ethX, see fcoemon), then the created FCoE instance will not require DCB. -d, --destroy ethX Destroys the FCoE instance on the specified network interface. This will not destroy FCoE instances created by fipvlan. -r, --reset ethX Resets the FCoE instance on the specified network interface. This will not reset FCoE instances created by fipvlan. -i, --interface [ethX] Show information about the FCoE instance on the specified network interface, or all FCoE instances if no network interface is specified. -S, --Scan ethX Rescan for new targets and LUNs on the provided instance. This command will not rescan any NPIV instances created on the same port. This will not rescan any FCoE instance created by fipvlan. -t, --target [ethX] Show information about the discovered targets associated with the FCoE instance on the specified network interface. If no network interface is specified, information about discovered targets from all FCoE instances will be shown. -l, --lun [ethX] Show detailed information about the discovered SCSI LUNs associated with the FCoE instance on the specified network interface. If no network interface is specified, information about SCSI LUNs from all FCoE instances will be shown. -s, --stats ethX [interval] Show the statistics (including FC4 statistics) of the FCoE interface on the specified network interface. The information will be display in one line on the screen per given time interval. interval should be specified in whole integers greater than 0. It specifies the time interval in the unit of seconds. If interval is not specified, the default interval is one second. -h, --help Displays the usage message of the fcoeadm command. -v, --version Displays the version of the fcoeadm command. EXAMPLES
Creates an FCoE instance on eth2.101 fcoeadm -c eth2.101 Destroys the FCoE instance on eth2.101 fcoeadm -d eth2.101 Resets the FCoE instance on eth2.101 fcoeadm -r eth2.101 Show the information of all the adapters and their ports having FCoE instances created fcoeadm -i Show the information of all FCoE instances on interface eth3. fcoeadm -i eth3 Show the information of all the discovered targets from all the ports having FCoE instances created (they may be on different adapter cards). A brief listing of discovered LUNs are listed after the target they are associated with, if any fcoeadm -t Show the information of all the discovered targets from a given port (eth3) having FCoE instance created. A brief listing of discovered LUNs are listed after each target they are associated with, if any fcoeadm -t eth3 Show the detailed information of all the LUNs discovered on all FCoE connections fcoeadm -l Show the detailed information of all the LUNs associated with a specific interface fcoeadm -l eth3.101 Show the statistics information of a specific port eth3 having FCoE instances created. The statistics are displayed one line per time interval. The default interval is one second if an interval is not specified fcoeadm -s eth3 fcoeadm -s eth3 3 SEE ALSO
fcoemon(8) SUPPORT
fcoeadm is part of the fcoe-utils package, maintained through the Open-FCoE project. Resources for both developers and users can be found at the Open-FCoE website http://open-fcoe.org/ Open-FCoE 10/18/2011 FCOEADM(8)