|
Packit Service |
bca4e3 |
'\" t
|
|
Packit Service |
bca4e3 |
.\" Title: fcoemon
|
|
Packit Service |
bca4e3 |
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
|
|
Packit Service |
bca4e3 |
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
|
Packit Service |
bca4e3 |
.\" Date: 09/30/2015
|
|
Packit Service |
bca4e3 |
.\" Manual: Open-FCoE Tools
|
|
Packit Service |
bca4e3 |
.\" Source: Open-FCoE
|
|
Packit Service |
bca4e3 |
.\" Language: English
|
|
Packit Service |
bca4e3 |
.\"
|
|
Packit Service |
bca4e3 |
.TH "FCOEMON" "8" "09/30/2015" "Open\-FCoE" "Open\-FCoE Tools"
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.\" * Define some portability stuff
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Packit Service |
bca4e3 |
.\" http://bugs.debian.org/507673
|
|
Packit Service |
bca4e3 |
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
Packit Service |
bca4e3 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Packit Service |
bca4e3 |
.ie \n(.g .ds Aq \(aq
|
|
Packit Service |
bca4e3 |
.el .ds Aq '
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.\" * set default formatting
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.\" disable hyphenation
|
|
Packit Service |
bca4e3 |
.nh
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.\" * MAIN CONTENT STARTS HERE *
|
|
Packit Service |
bca4e3 |
.\" -----------------------------------------------------------------
|
|
Packit Service |
bca4e3 |
.SH "NAME"
|
|
Packit Service |
bca4e3 |
fcoemon \- Open\-FCoE service daemon
|
|
Packit Service |
bca4e3 |
.SH "SYNOPSIS"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR [\-f|\-\-foreground] [\-l|\-\-legacy] [\-d|\-\-debug] [\-s|\-\-syslog]
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR \-h|\-\-help
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR \-v|\-\-version
|
|
Packit Service |
bca4e3 |
.SH "DESCRIPTION"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
The \fBfcoemon\fR daemon is the core component of the \fIOpen\-FCoE\fR management service\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
The primary function of \fBfcoemon\fR is to control FCoE instances\&. \fBfcoemon\fR will create, destroy, reset, enable and disable FCoE instances based on system configuration, administrative commands, and runtime events\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
On startup, \fBfcoemon\fR will create FCoE instances defined by the configuration files (see \fIFILES\fR section below)\&. Since FCoE typically relies on the Data Center Bridging (DCB) capabilities of an Ethernet interface, \fBfcoemon\fR establishes a connection with the LLDP daemon \fBlldpad\fR to query the status of the DCB features on relevant Ethernet interfaces and receive DCB configuration change events\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
During runtime, \fBfcoemon\fR will monitor network and \fBlldpad\fR events for the relevant Ethernet interfaces and perform appropriate actions (create, destroy, enable, disable) on the FCoE instances\&. \fBfcoemon\fR also provides a client interface via which the \fBfcoeadm\fR utility is able to issue commands\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Installation of the \fIfcoe\-utils\fR package will set up an \fIfcoe\fR service which will control the execution of the \fBfcoemon\fR daemon\&.
|
|
Packit Service |
bca4e3 |
.SH "OPTIONS"
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-f\fR, \fB\-\-foreground\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Run
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR
|
|
Packit Service |
bca4e3 |
in the foreground\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-d\fR, \fB\-\-debug\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Enable debugging messages\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-l\fR, \fB\-\-legacy\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Force fcoemon to use the legacy /sys/module/libfcoe/parameters/ interface\&. The default is to use the newer /sys/bus/fcoe/ interfaces if they are available\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-s\fR, \fB\-\-syslog\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Use syslogd for logging\&. The default behavior is to log to stdout and stderr\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-h\fR, \fB\-\-help\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Show help message with basic usage instructions
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fB\-v\fR, \fB\-\-version\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Show the version of the
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR
|
|
Packit Service |
bca4e3 |
command\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.SH "TERMINOLOGY"
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIDCB\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Data Center Bridging A set of Ethernet enhancement standards developed by the IEEE 802\&.1 Working Group\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\ \&
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
See
|
|
Packit Service |
bca4e3 |
http://www\&.ieee802\&.org/1/pages/dcbridges\&.html
|
|
Packit Service |
bca4e3 |
for more information\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIDCBX\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
DCB Capabilities Exchange Protocol, implemented by the DCB module of
|
|
Packit Service |
bca4e3 |
\fBlldpad\fR\&. DCBX exchanges DCB capabilities and configuration with a link partner as a series of values transferred using the Link Layer Discovery Protocol (LLDP)\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIPFC\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
Priority\-based Flow Control, a
|
|
Packit Service |
bca4e3 |
\fIDCB\fR
|
|
Packit Service |
bca4e3 |
feature\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIApp:FCoE\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
The FCoE instance of application specific parameters in DCBX\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.SH "CRITERIA USED FOR CONTROLLING THE FCOE INSTANCE"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR uses two information sources for determining when to create an FCoE instance: the state of the network interface, which may be a VLAN interface, and, if required for the FCoE instance, the state of the DCB configuration on the physical Ethernet interface\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
First of all, the network interface must be "up" for the FCoE instance to be created\&. Secondly, if the FCoE configuration indicates that DCB is required, then the following criteria must be satisfied before the FCoE interface is created:
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
DCB is enabled on the Ethernet interface\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The PFC DCB feature is enabled and operational\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The App:FCoE DCB feature is enabled and operational\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The priority indicated by the App:FCoE feature is also enabled for PFC\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Once the FCoE instance is created by \fBfcoemon\fR, it will only be destroyed under the following conditions:
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The driver for the Ethernet interface is unloaded\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
A user administratively destroys the FCoE instance using
|
|
Packit Service |
bca4e3 |
\fBfcoeadm\fR\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR
|
|
Packit Service |
bca4e3 |
daemon is terminated\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
If DCB is required for the FCoE instance, and the DCB settings change after the interface is created, the following criteria are used to disable the FCoE instance:
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
DCB is disabled on the Ethernet interface\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The App:FCoE DCB feature is not enabled\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The App:FCoE and PFC features are operational AND the priority indicated by App:FCoE is not enabled for PFC\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Otherwise, the FCoE instance will always remain enabled\&.
|
|
Packit Service |
bca4e3 |
.SH "CONFIGURATION"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Once the \fIfcoe\-utils\fR and \fBlldpad\fR packages have been installed and the corresponding services are running, there are a few simple configuration steps required to get an FCoE instance up and running\&. The following assumes that DCB will be required for the interface\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
Ensure that the configuration on the peer device (e\&.g\&. FCoE capable switch) has the necessary configurations (VLANs, DCB, DCBX)\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
Configure any needed VLAN interfaces on the local system\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
Create and configure
|
|
Packit Service |
bca4e3 |
\fI/etc/fcoe/cfg\-<ifname>\fR
|
|
Packit Service |
bca4e3 |
files for the network interfaces over which FCoE instances need to be created\&. See the
|
|
Packit Service |
bca4e3 |
\fIFILES\fR
|
|
Packit Service |
bca4e3 |
sections for details\&. Note that
|
|
Packit Service |
bca4e3 |
\fIifname\fR
|
|
Packit Service |
bca4e3 |
may be for a VLAN interface\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
Restart the
|
|
Packit Service |
bca4e3 |
\fBfcoe\fR
|
|
Packit Service |
bca4e3 |
service (i\&.e\&.
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR)\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.ie n \{\
|
|
Packit Service |
bca4e3 |
\h'-04'\(bu\h'+03'\c
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.el \{\
|
|
Packit Service |
bca4e3 |
.sp -1
|
|
Packit Service |
bca4e3 |
.IP \(bu 2.3
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
The default DCB configuration of an Ethernet interface managed by
|
|
Packit Service |
bca4e3 |
\fBlldpad\fR
|
|
Packit Service |
bca4e3 |
requires the following configuration using
|
|
Packit Service |
bca4e3 |
\fBdcbtool\fR\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
.if n \{\
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.nf
|
|
Packit Service |
bca4e3 |
dcbtool sc ethX dcb on <\-\- enable DCB on the interface
|
|
Packit Service |
bca4e3 |
dcbtool sc ethX app:fcoe e:1 <\-\- enable App:FCoE on the interface
|
|
Packit Service |
bca4e3 |
.fi
|
|
Packit Service |
bca4e3 |
.if n \{\
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.\}
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
These steps only need to be done one time\&. Note that if other DCB configuration changes have been made with \fBdcbtool\fR, then additional changes may need to be made in order to satisfy the DCB criteria for creating an FCoE instance\&. Consult \fBdcbtool\fR for details\&.
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Once these configuration steps have been performed, use \fBfcoeadm\fR to query the status of the FCoE instances\&.
|
|
Packit Service |
bca4e3 |
.SH "FILES"
|
|
Packit Service |
bca4e3 |
.SS "/etc/fcoe/config"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
This is the primary configuration file for the \fBfcoe\fR system service\&. The default options in this file are: \fBDEBUG="no"\fR and \fBUSE_SYSLOG="yes"\fR\&. The former is used to enable debugging messages from the fcoe service script and \fBfcoemon\fR (via the \fB\-\-debug\fR option)\&. The latter is to indicate if the log messages are to be output to the system log (via the \fB\-\-syslog\fR option)\&. \fBSUPPORTED_DRIVERS\fR is the list of drivers to automatically load during fcoe service start\&. Any changes to this file will require a restart of the \fBfcoe\fR service\&.
|
|
Packit Service |
bca4e3 |
.SS "/etc/sysconfig/fcoe"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
On systemd\-enabled systems, this is the primary configuration file used for the \fBfcoe\fR system service\&. Add \fB\-\-debug\fR to \fBFCOEMON_OPTS\fR to enable debug log messages\&. Any changes to this file will require a restart of the \fBfcoe\fR service\&.
|
|
Packit Service |
bca4e3 |
.SS "/etc/fcoe/cfg\-<ifname>"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
These files are read by \fBfcoemon\fR on initialization\&. They are used to indicate which Ethernet or VLAN interfaces should have FCoE instances created\&. The option values in this file normally are: \fBFCOE_ENABLE="yes"\fR, \fBDCB_REQUIRED="yes"\fR, and \fBAUTO_VLAN="yes"\fR, though if the variable values are omitted, they default to "no"\&.
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIFCOE_ENABLE\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
is used to enable/disable creation of the FCoE instance\&. If FCoE_ENABLE is set to "no", then the other configuration values have no effect\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIDCB_REQUIRED\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
indicates if the DCB service is required on the Ethernet interface\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIAUTO_VLAN\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
indicates if VLAN discovery should be performed\&. If AUTO_VLAN is set to "yes", then once the link configuration has been validated,
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR
|
|
Packit Service |
bca4e3 |
will run run the FIP VLAN discovery protocol on the Ethernet interface\&. Network interfaces for any discovered FCoE VLANs will be automatically created, if they are not already configured, and FCoE instances will be created on the VLAN interfaces\&. If the network interface specified by the filename is already a VLAN interface, the AUTO_VLAN setting is ignored\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIMODE\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
indicates whether operation will be in fabric or vn2vn mode\&. The default is fabric\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.PP
|
|
Packit Service |
bca4e3 |
\fIFIP_RESP\fR
|
|
Packit Service |
bca4e3 |
.RS 4
|
|
Packit Service |
bca4e3 |
indicates whether a FIP responder should be activated on this device to support VLAN discovery in a vn2vn environment\&. The default is "no"\&. Often this will be used on a vn2vn node also serving as a target\&. When using this option, the AUTO_VLAN should not be set and the supported VLANs should have configuration files supplied, constituting a static VLAN configuration that provides the information for the FIP responder to return\&. This should be set on a base device, which should probably have FCOE_ENABLE set to "no" since presumably FCoE operation will be on the configured VLANs\&.
|
|
Packit Service |
bca4e3 |
.RE
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
Note that the attached Ethernet peer device (e\&.g\&. FCoE capable switch port) must have compatible settings For DCB and FCoE to function properly\&.
|
|
Packit Service |
bca4e3 |
.SS "/etc/init\&.d/fcoe"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
This is the \fBfcoe\fR system service script\&. This script is invoked by the init process or by the service command to start and stop the \fBfcoemon\fR\&. On systemd\-enabled systems, \fBfcoemon\fR is controlled via the \fBfcoe\&.service\fR unit\&.
|
|
Packit Service |
bca4e3 |
.SH "VLAN NAMING CONVENTIONS"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
If a new VLAN device is created (see the description of the \fIAUTO_VLAN\fR setting above), it will have the name \fIdev\fR\&.\fIvlan\fR\-fcoe; where \fIdev\fR is the name of the Ethernet parent device and \fIvlan\fR is the discovered VLAN ID number\&.
|
|
Packit Service |
bca4e3 |
.SH "SEE ALSO"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoeadm\fR(8) \fBlldpad\fR(8) \fBlldptool\fR(8) \fBdcbtool\fR(8)
|
|
Packit Service |
bca4e3 |
.SH "SUPPORT"
|
|
Packit Service |
bca4e3 |
.sp
|
|
Packit Service |
bca4e3 |
\fBfcoemon\fR is part of the \fIfcoe\-utils\fR package, maintained through the \fIOpen\-FCoE\fR project\&. Resources for both developers and users can be found at the \fIOpen\-FCoE\fR website http://open\-fcoe\&.org/
|