Rechercher une page de manuel
fcoemon
Langue: en
Version: 175972 (fedora - 06/07/09)
Section: 8 (Commandes administrateur)
Sommaire
NAME
fcoemon - The Fibre Channel over Ethernet (FCoE) administration toolfor monitoring and processing events from DCB daemon.
SYNOPSIS
fcoemon [-h | --help]fcoemon [-v | --version]
fcoemon [-f | --foreground]
fcoemon [-d | --debug]
fcoemon [-e | --exec <path-to-fcoeplumb-script>]
DESCRIPTION
The fcoemon command is a FCoE management tool provided by the Open-FCoE package. fcoemon is the daemon of the fcoe system service. When fcoemon starts, it establishes a socket connection with the DCB daemon. It then sends commands to, and receives responses and event from the DCB daemon. The fcoemon will process the received responses and events and invoke the fcoeplumb script to create and destroy the FCoE interfaces. Since fcoemon depends on the existence of DCB service, there are settings required for DCB before fcoemon can be started. See the DCB Settings section below.Notice that the fcoe system service does not depend on dcbd service. However, the fcoemon daemon will be started by the fcoe service only if any one of the Ethernet port requires DCB service. In this case, fcoe service depends on dcbd service. If none of the Ethernet ports requires DCB service, the fcoemon will not be started and, in this case, the fcoe service does not depend on dcbd service.
OPTIONS
- -h | -v | --version
- Show the version of the fcoemon command.
- -f | --foreground
- Run fcoemon in the foreground.
- -d | --debug
- Enable debugging messages.
- -e | --exec <path-of-fcoeplumb-script>
- Specify the location of the fcoeplumb script.
TERMINOLOGY
- PFC - The DCB Priority Flow Control feature.
- App:FCoE - The DCB Fibre Channel over Ethernet feature.
- LLINK - The DCB Logical Link TLV (or Logical Link) feature.
- multiq - See Documentation/networking/multiqueue.txt of linux kernel 2.6.28 or higher.
- skbedit - See Documentation/networking/multiqueue.txt of linux kernel 2.6.28 or higher.
INSTALLATION REQUIREMENTS
The DCB and FCoE kernel configuration options must be enabled, these were introduced in v2.6.29. Both the linux kernel and iproute2 must support multiq and skbedit. The DCB must be installed with version 0.9.4 and higher.SUPPORTED DCB EVENTS
In response to each supported event from the DCB daemon, the fcoemon collects the current settings from the DCB daemon and decide whether to delete and re-add the multiq queue discipline and skbedit filter. The fcoemon does not destroy, reset, or create FCoE interfaces during the DCB event processing.- FEATURE_APP
- If an event message is received from dcbd and if the feature code in the event message is FEATURE_APP (5), and if the subtype field is APP_FCOE_STYPE (0), we got a mode or configuration change event of the FCoE application. The fcoemon will then issue queries to the DCB daemon to collect the current mode and configuration information.
- FEATURE_PFC
- If an event message is received from dcbd and if the feature code in the event message is FEATURE_PFC (3), we got a mode or configuration change event of the Priority Flow Control (PFC) feature. The fcoemon will then issue queries to the DCB daemon to collect the current mode and configuration information.
- FEATURE_LLINK
- If an event message is received from dcbd and if the feature code in the event message is FEATURE_LLINK (6), and if the subtype field is LLINK_FCOE_STYPE (0), we got a mode or configuration change event of the Logical Link TLV feature. The fcoemon will then issue queries to the DCB daemon to collect the current mode and configuration information.
CRITERIA OF CREATING, RESETTING AND DESTROYING FCOE INTERFACE
In this section the dcbtool is used to describe the conditions of the DCB feture status beccause the meaning is more understandable and precise. Although you may also issue the commands at run-time, the commands are intended only to be used for description purpose.- PFC and App:FCoE
- DCB is configured correctly if
-
- 1) The command dcbtool gc ethX dcb shows DCB State: on
- 2) The command dcbtool gc ethX app:0 shows Enable:true,
- Advertise:true, Willing:true.
- 3) The command dcbtool go ethX app:0 shows OperMode:true.
- 4) The command dcbtool go ethX pfc shows OperMode:true and
- the values of pfcup.
- 5) The command dcbtool go ethX app:0 shows appcfg. The bits
- set to 1 are also set to 1 in pfcup found in (4).
-
- Logical Link TLV
- The Logical Link TLV feature is configured correctly if
-
- 1) The command dcbtool gc ethX ll:0 shows
- Enable:true, Advertise:true, Willing:true.
- 2) The command dcbtool go ethX ll:0 shows OperMode:true.
- 3) The command dbtool gp ethX ll:0 shows Link Status:up.
-
- Criteria to create FCoE interface
- If DCB is required at the Ethernet port, a FCoE interface may be created only if the DCB and the Logical Link TLV feature are configured correctly. If DCB is not required at the Ethernet port, the FCoE interface may be created. FCoE interfaces are normally created by the fcoe system service.
- Criteria to Destroy FCoE Interface
- An FCoE interface will only be destroyed when the fcoe system service is stopped.
- Criteria to reset a FCoE interface
- The fcoe system service does not reset any FCoE interfaces.
- Changing DCB Configuration, Qdisc and Filters
- Changing the DCB configuration, qdisc, and filter are considered to be administrative actions. When the fcoe system service starts up, it sets up the default DCB configuration, qdisc, and filter for reliable FCoE operations. Administrators may alter the configuration while the service is running. Changing the DCB parameters may cause the fcoemon daemon to delete the existing multiq queue discipline, skbedit filter and re-add; but the fcoe service will not touch (e.g. destroy or reset) the FCoE interface. Changing the DCB configuration, qdisc, and filter should be avoided while I/O traffic are in progress.
FILES
The Installation of the Open-FCoE management tools include the following files:- /etc/fcoe/config
- This is the common configuration file for the fcoe system service. This file will be read by the /etc/init.d/fcoe" script, the /etc/fcoe/scripts/fcoeplumb script, and the fcoemon daemon. The default options in this file are: DEBUG="yes" and USE_SYSLOG="yes". The former is used to enable (select yes) or disable (select no) debugging messages of fcoemon, the fcoe service script, and the fcoeplumb script. The latter is to indicate if the log messages of fcoemon, the fcoe service script, and the fcoeplumb script are to be output to the system log. Use editor to set the desired yes/no values.
- /etc/fcoe/cfg-ethX
- There is one of this file for each Ethernet interface ethX found in the output of cat /proc/net/dev at the time of installation. This file will be read by the /etc/init.d/fcoe script and the fcoemon daemon. The default options in this file are: FCOE_ENABLE="no" and DCB_REQUIRED="yes". The former is used to enable (select yes) or disable (select no) the FCoE service at the ethX port. The latter is to indicate if the DCB service is required (select yes) or not required (select no) at the ethX port. If the former is set to no, the latter is ignored. The selection of the settings should match the settings of the FCoE switch port connected to the local Ethernet ethX port. Use editor to set the desired yes/no values for the ethX interfaces.
- /etc/init.d/fcoe
- This is the fcoe system service shell script. This script is invoked by the init process or by the service command.
- /sbin/fcoemon
- This is the fcoemon daemon only invoked by the fcoe system service script.
- /sbin/fcoeadm
- This is the program used by the fcoe system service to create or destroy FCoE interfaces.
- /etc/fcoe/scripts/fcoeplumb
- This is a script only used by the fcoemon daemon.
REPORTING BUGS
If you have identified a defect please either file a bug or engage the development mailing list at <http://www.Open-FCoE.org>.SUPPORT
Open-FCoE is maintained at <http://www.Open-FCoE.org>. There are resources available for both developers and users at that site.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre