Dell Intel PRO Family of Adapters - Manual (Page 34)

Back to Contents Page
Intel® Ethernet FCoE Linux Management Tools Installation
Guide: Intel® FCoE/DCB User Guide
Requirements
fcoeadm
fcoemon
The Intel® Ethernet FCoE Linux Management Tools included in this package are:
fcoeadm - program to create, reset, destroy, and display FCoE interfaces
fcoemon - program to monitor the events from the DCB daemon
Requirements
The user is not required to download and build from source if you are using a distribution (SLES).
If building from source, the HBAAPI library and the HBAAPI vendor library source must be built and installed before you can
build the management tools. The HBAAPI vendor library, libhbalinux, may be downloaded from www.Open-FCoE.org . The
instructions in the package describe how to download and build the libraries. See the man pages for other requirements.
fcoeadm
The fcoeadm command is intended to be the FCoE management tool for the Linux systems. The -c, -d, and -r options are used
to create, destroy, and reset an FCoE instance on a given network interface. The other options are used to query the
information of the FCoE instance which includes the interface information, target information, LUN information, and port
statistics. The fcoeadm command invokes the HBAAPI library routines to obtain this information. The HBAAPI library routines
invoke the vendor\-specific library, libhbalinux, to grab the information from the /sys file system. In other words, the fcoeadm
command requires having libHBAAPI and libhbalinux installed on the system to work.
The libhbalinux is maintained at http://www.Open-FCoE.org . The installation instructions of libhbalinux also instruct how to
download the HBAAPI source code, build and install with the libhbalinux. The last option -h is used to show a brief usage
message of the supported command syntax.
Options
-c -create
<ethX>
Creates an FCoE instance based on the given <ethX>.
-d, -destroy
<ethX>
Destroys an FCoE instance based on the given <ethX>.
-r, -reset <ethX> Resets the fc_host associated with the FCoE interface given by <ethX>.
-i, -interface
<ethX>
Shows the information of the FCoE instances created at <ethX>. If <ethX> is not specified the
command will show the information of all the FCoE instances created on the system.
-t, -target
<ethX>
Shows the information of all the discovered targets from the FCoE instances created at <ethX>. If
<ethX> is not specified the command will show the information of all the discovered targets from all the
FCoE instances created.
-l, -lun
<target_port_id>
<lun_id>
Shows the detailed information of a specific LUN with <lun_id> at the target with port id
<target_port_id>. Port id is also known as FC\-ID. If <lun_id> is not specified, all the LUNs associated
with the target will be shown.
-s, -stats <ethX>
-n <interval>
Show the statistics (including FC4 statistics) of the FCoE instances created at <ethX>. The information
will be displayed 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 second. If <interval> is not