|
Packit Service |
db8df9 |
#
|
|
Packit Service |
db8df9 |
# Intel(R) Enclosure LED Utilities
|
|
Packit Service |
db8df9 |
# Copyright (C) 2009-2017 Intel Corporation.
|
|
Packit Service |
db8df9 |
#
|
|
Packit Service |
db8df9 |
# This program is free software; you can redistribute it and/or modify it
|
|
Packit Service |
db8df9 |
# under the terms and conditions of the GNU General Public License,
|
|
Packit Service |
db8df9 |
# version 2, as published by the Free Software Foundation.
|
|
Packit Service |
db8df9 |
#
|
|
Packit Service |
db8df9 |
# This program is distributed in the hope it will be useful, but WITHOUT
|
|
Packit Service |
db8df9 |
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
Packit Service |
db8df9 |
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
Packit Service |
db8df9 |
# more details.
|
|
Packit Service |
db8df9 |
#
|
|
Packit Service |
db8df9 |
# You should have received a copy of the GNU General Public License along with
|
|
Packit Service |
db8df9 |
# this program; if not, write to the Free Software Foundation, Inc.,
|
|
Packit Service |
db8df9 |
# 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
|
|
Packit Service |
db8df9 |
#
|
|
Packit Service |
db8df9 |
=head1 NAME
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
ledmon.conf - Configuration file for Intel(R) Enclosure LED Utilities.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head1 DESCRIPTION
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
The ledmon configuration file allows you to use advanced settings and functions
|
|
Packit Service |
db8df9 |
of Intel(R) Enclosure LED Utilities. The global location of the configuration
|
|
Packit Service |
db8df9 |
file is F</etc/ledmon.conf>. Instead of a global configuration file, you can
|
|
Packit Service |
db8df9 |
specify a local config file using the I<-c> option when running ledmon.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head2 SYNTAX
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
One line should keep exactly one option and value in the configuration file in
|
|
Packit Service |
db8df9 |
format: OPTION=VALUE. Any word that begins with a hash sign (B<#>) starts a
|
|
Packit Service |
db8df9 |
comment and that word together with the remainder of the line is ignored. Empty
|
|
Packit Service |
db8df9 |
lines are allowed. Either single quotes (B<'>) or double quotes (B<">) should
|
|
Packit Service |
db8df9 |
not be used.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
Values are considered as truth: enabled, true, yes, 1.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
Values are considered as false: disabled, false, no, 0.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
See also the examples section.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head2 List of configurable options:
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<BLACKLIST> - Ledmon will exclude scanning controllers listed on blacklist.
|
|
Packit Service |
db8df9 |
When whitelist is also set in config file, the blacklist will be ignored.
|
|
Packit Service |
db8df9 |
The controllers should be separated by comma (B<,>) character.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<BLINK_ON_INIT> - Related with RAID Initialization (resync), Verify (check)
|
|
Packit Service |
db8df9 |
and Verify and Fix (repair) processes. If value is set to true - status LEDs of
|
|
Packit Service |
db8df9 |
all member drives will blink with proper pattern if RAID volume is under sync
|
|
Packit Service |
db8df9 |
process. If value is set to false, processes like init or verifications will not
|
|
Packit Service |
db8df9 |
be reported by LEDs. The default value is true.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<BLINK_ON_MIGR> - RAID can be migrated between some levels or strip sizes and
|
|
Packit Service |
db8df9 |
the flag is related with this processes. Also RAID Grow operation will be
|
|
Packit Service |
db8df9 |
reported along with this flag. If value is set to true - status LEDs of all
|
|
Packit Service |
db8df9 |
member drives will blink with proper pattern if RAID volume is under reshape.
|
|
Packit Service |
db8df9 |
If value is set to false, listed actions will not be reported by LEDs. The
|
|
Packit Service |
db8df9 |
default value is true.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<INTERVAL> - The value is given in seconds. Defines time interval between
|
|
Packit Service |
db8df9 |
ledmon sysfs scan. The minimum is 5 seconds the maximum is not specified. The
|
|
Packit Service |
db8df9 |
default value is 10 seconds.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<LOG_LEVEL> - Corresponds with I<--log-level> flag from ledmon. Log level QUIET
|
|
Packit Service |
db8df9 |
means no logging at all and ALL means to log everything. The default log level
|
|
Packit Service |
db8df9 |
is WARNING. Acceptable values are: quiet, error, warning, info, debug, all.
|
|
Packit Service |
db8df9 |
Value also can be set by integer number - 0 means 'quiet' and 5 means 'all'.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<LOG_PATH> - Sets a path to local log file. If this option is specified the
|
|
Packit Service |
db8df9 |
global log file F is not used.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<RAID_MEMBERS_ONLY> - If flag is set to true ledmon will limit monitoring only
|
|
Packit Service |
db8df9 |
to drives that are RAID members. The default value is false.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<REBUILD_BLINK_ON_ALL> - Flag is related with RAID rebuild process. When value
|
|
Packit Service |
db8df9 |
is set to false - only the drive that the RAID is rebuilding to will be marked
|
|
Packit Service |
db8df9 |
with appropriate LED pattern. If value is set to true all drives from RAID
|
|
Packit Service |
db8df9 |
that is during rebuild will blink during this operation.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
B<WHITELIST> - Ledmon will limit changing LED state to controllers listed on
|
|
Packit Service |
db8df9 |
whitelist. If any whitelist is set, only devices from list will be scanned by
|
|
Packit Service |
db8df9 |
ledmon. The controllers should be separated by comma (B<,>) character.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head1 EXAMPLES
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head2 Excluding one controller from ledmon scans, changing log level and scans
|
|
Packit Service |
db8df9 |
interval:
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
LOG_LEVEL=all
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
INTERVAL=5
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
#Exclude disks from SATA controller
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
BLACKLIST=/sys/devices/pci0000:00/0000:00:17.0
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head2 Blink only on RAID members, blink on all disks during rebuild and ignore
|
|
Packit Service |
db8df9 |
init phase:
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
RAID_MEMBERS_ONLY=true
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
BLINK_ON_INIT=false
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
REBUILD_BLINK_ON_ALL=true
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head1 LICENSE
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
Copyright (c) 2009-2017 Intel Corporation.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
This program is distributed under the terms of the GNU General Public License
|
|
Packit Service |
db8df9 |
as published by the Free Software Foundation. See the built-in help for details
|
|
Packit Service |
db8df9 |
on the License and the lack of warranty.
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head1 SEE ALSO
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
ledmon(8), ledctl(8)
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
=head1 AUTHOR
|
|
Packit Service |
db8df9 |
|
|
Packit Service |
db8df9 |
This manual page was written by Michal Zylowski <michal.zylowski@intel.com>. It
|
|
Packit Service |
db8df9 |
may be used by others.
|