Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

4.3. Paramètres par défaut dans le fichier de configuration

Le fichier de configuration /etc/multipath.conf comprend une section defaults qui configure le paramètre user_friendly_names à yes, comme ci-dessous. 
defaults {
        user_friendly_names yes
}
Cela remplace la valeur par défaut du paramètre user_friendly_names.
Le fichier de configuration inclut un modèle pour les valeurs par défaut de configuration. Cette section est commentée ainsi : 
#defaults {
#       udev_dir                /dev
#       polling_interval        5
#       path_selector           "round-robin 0"
#       path_grouping_policy    failover
#       getuid_callout          "/lib/dev/scsi_id --whitelisted --device=/dev/%n"
#	prio			const
#	path_checker		directio
#	rr_min_io		1000
#	rr_weight		uniform
#	failback		manual
#	no_path_retry		fail
#	user_friendly_names	no
#}
Pour remplacer la valeur par défaut de n'importe quel paramètre de configuration, vous pouvez copier la ligne correspondante dans ce modèle dans la section defaults et la dé-commenter. Par exemple, pour remplacer le paramètre path_grouping_policy pour qu'il devienne multibus plutôt que la valeur par défaut de failover, copier la ligne du fichier modèle qui convient dans la section initiale defaults du fichier de configuration, et dé-commentez-la ainsi : 
defaults {
        user_friendly_names     yes
        path_grouping_policy    multibus
}
Tableau 4.1, « Valeurs par défaut pour la configuration multipath » décrit les attributs qui figurent dans la section defaults du fichier de configuration multipath.conf. Ces valeurs sont utilisées par DM-Multipath à moins qu'elles ne soient remplacées par les attributs spécifiés dans les sections devices (périphériques) et multipaths (multipath) du fichier multipath.conf.

Note

Depuis Red Hat Enterprise Linux 6.0, les paramètres mode, uid et gid ont été dépréciés. Les permissions pour les périphériques mappeurs de périphériques (« device-mapper ») (y compris les mappages « multipath ») sont définies par le biais des règles udev. Il y a un fichier modèle dans /usr/share/doc/device-mapper-version nommé 12-dm-permissions.rules, vous pouvez l'utiliser et le placer dans le répertoire /etc/udev/rules.d afin qu'il prenne effet.

Tableau 4.1. Valeurs par défaut pour la configuration multipath

Attribut Description
polling_interval Spécifie l'intervalle entre deux vérifications de chemin en secondes. Pour des chemins fonctionnant correctement, l'intervalle entre les vérifications augmentera graduellement jusqu'à (4 * polling_interval). La valeur par défaut est 5.
udev_dir Précise le répertoire dans lequel les nœuds de périphériques udev sont créés. La valeur par défaut est /dev.
multipath_dir Précise le répertoire dans lequel les objets partagés dynamiques sont stockés. La valeur par défaut est dépendante du système, communément /lib/multipath.
find_multipaths
Définit le mode pour paramétrer des périphériques multipath. Si ce paramètre est réglé sur yes, alors multipath n'essayera pas de créer un périphérique pour chaque chemin ne faisant pas partie d'une liste noire. Au contraire, multipath créera uniquement un périphérique si l'une de ces trois conditions est remplie :
- Au moins deux chemins avec le même WWID ne font pas partie de la liste noire.
- L'utilisateur force manuellement la création du périphérique en spécifiant un périphérique avec la commande multipath.
- Un chemin possède le même WWID qu'un périphérique multipath créé auparavant. Lorsqu'un périphérique multipath est créé avec l'ensemble find_multipaths, multipath se rappelle du WWID du périphérique, il créera ainsi le périphérique à nouveau dès qu'il verra un chemin avec ce WWID. Ceci vous permet de faire en sorte que multipath puisse choisir automatiquement les chemins corrects à utiliser pour des périphériques multipath, sans avoir à modifier la liste noire multipath. Pour obtenir des instructions sur la procédure à suivre si vous avez précédemment créé des périphériques multipath lorsque le paramètre find_multipaths n'était pas défini, reportez-vous à la Section 4.2, « Liste noire du fichier de configuration ».
La valeur par défaut est no.
verbosity Verbosité par défaut. Des valeurs plus importantes augmentent le niveau de verbosité. Les niveaux valides se trouvent entre 0 et 6. La valeur par défaut est 2.
path_selector
Indique l'algorithme par défaut à utiliser pour déterminer quel chemin utiliser pour la prochaine opération d'E/S. Les valeurs possibles incluent :
round-robin 0 : Boucle passant par chaque chemin dans le groupe de chemins, envoyant la même quantité d'E/S à chacun.
queue-length 0 : envoie le prochain groupe d'E/S sur le chemin avec le nombre le moins élevé de requêtes d'E/S en suspens.
service-time 0 : Envoie le prochain groupe d'E/S sur le chemin possédant le temps de service estimé le plus court, qui est déterminé en divisant la taille totale des E/S en suspens de chaque chemin par son débit relatif.
La valeur par défaut est round-robin 0.
path_grouping_policy
Précise la politique de groupement de chemin par défaut pour les parcours non spécifiés. Les valeurs possibles sont :
failover : 1 chemin par groupe de priorité.
multibus : tous les chemins valides dans le groupe de priorité 1.
group_by_serial : groupe de priorité 1 par numéro de série détecté.
group_by_prio : groupe de priorité 1 par valeur de priorité de chemin. Les priorités sont déeterminées par des programmes d'invocation spécifiés en tant qu'options globales, par contrôleur, ou par multipath.
group_by_node_name : groupe de priorité 1 par nom de nœud cible. Les noms de nœuds cibles peuvent récupérés dans /sys/class/fc_transport/target*/node_name.
La valeur par défaut est failover.
getuid_callout
Indique le programme par défaut et les arguments qu'il faut invoquer pour obtenir un identifiant de chemin d'accès unique. Un chemin absolu est requis.
La valeur par défaut est /lib/udev/scsi_id --whitelisted --device=/dev/%n.
prio
Précise la fonction par défaut à appeler pour obtenir une valeur de priorité de chemin. Par exemple, les bits ALUA de SPC-3 fournissent une valeur prio exploitable. Les valeurs possibles incluent :
const : définit une priorité de 1 pour tous les chemins.
emc : génère la priorité de chemin pour les matrices (arrays) EMC.
alua : génère la priorité de chemin en se basant sur les paramètres ALUA SCSI-3.
tpg_pref : génère la priorité de chemin en se basant sur les paramètres ALUA SCSI-3, à l'aide du bit de port préféré.
ontap : génère la priorité de chemin pour les matrices (arrays) NetApp.
rdac : génère la priorité de chemin pour contrôleur RDAC LSI/Engenio.
hp_sw : génère la priorité de chemin pour contrôleur Compaq/HP en mode active/standby.
hds: génère la priorité de chemin pour les matrices de stockage Hitachi HDS Modular.
La valeur par défaut est const.
features Fonctionnalités supplémentaires par défaut des périphériques multipath. L'unique fonctionnalité est queue_if_no_path, qui est la même chose que définir no_path_retry sur queue. Pour obtenir des informations sur des problèmes pouvant survenir lors de l'utilisation de cette fonctionnalité, voir la Section 5.6, « Problèmes avec la fonctionnalité queue_if_no_path ».
path_checker
Précise la méthode par défaut utilisée pour déterminer l'état des chemins. Les valeurs possibles sont :
readsector0 : lire le premier secteur du périphérique.
tur : délivre une commande TEST UNIT READY au périphérique.
emc_clariion : demande au 0xC0 de page EVPD spécifique au EMC Clariion de déterminer le chemin.
hp_sw : vérifie l'état du chemin pour les matrices de stockage HP avec le micrologiciel Active/Standby.
rdac : vérifie les statistiques du chemin pour le contrôleur de stockage RDAC LSI/Engenio.
directio : lit le premier secteur avec E/S directes.
La valeur par défaut est directio.
failback
Gère le failback du groupe de chemins.
La valeur immediate indique une restauration automatique (failback) immédiate au groupe de chemins avec la plus haute priorité qui contient des chemins actifs.
La valeur manual indique qu'il ne devrait pas y avoir de failback immédiat et que le failback ne peut avoir lieu que sur intervention de l'opérateur.
La valeur followover spécifie que le failback automatique devrait etre effectué lorsque le premier chemin d'un groupe de chemins devient actif. Ceci empêche le nœud de se restaurer automatiquement lorsqu'un autre nœud requiert le failback.
Une valeur numérique supérieure à zéro indique un failback différé, en secondes.
La valeur par défaut est manual.
rr_min_io Spécifie le nombre de requêtes d'E/S à diriger vers un chemin avant de passer au chemin suivant dans le groupe de chemins actuel. Ce paramètre fonctionne uniquement avec les systèmes exécutant des noyaux plus anciens que 2.6.31. Les nouveaux systèmes devraient utiliser rr_min_io_rq. La valeur par défaut est 1000.
rr_min_io_rq Spécifie le nombre de requêtes d'E/S à diriger vers un chemin avant de passer au chemin suivant dans le groupe de chemins actuel, en utilisant le mappeur de périphériques à multiples chemins d'accès (« device-mapper-multipath ») basé sur requêtes. Ce paramètre devrait être utilisé sur les systèmes exécutant des noyaux actuels. Sur les systèmes exécutant des noyaux plus anciens que 2.6.31, veuillez utiliser rr_min_io. La valeur par défaut est 1.
rr_weight S'il est configuré sur priorities, alors au lieu d'envoyer des demandes rr_min_io vers un chemin avant d'appeler le path_selector pour déterminer le prochain chemin, le nombre de demandes à envoyer est déterminé par rr_min_io multiplié par la priorité du chemin, déterminée par la fonction prio. Si définis sur uniform, tous les chemins auront la même priorité. La valeur par défaut est uniform.
no_path_retry
Une valeur numérique pour cet attribut indique que le nombre de fois que le système doit tenter d'utiliser un chemin inaccessible avant que la file d'attente ne soit désactivée.
Une valeur fail indique un échec immédiat, sans file d'attente.
La valeur queue indique que la mise en file d'attente ne devrait pas s'arrêter avant que le chemin ne soit corrigé.
La valeur par défaut est 0.
user_friendly_names Le paramètre yes précise que le système devrait utiliser le fichier /etc/multipath/bindings pour assigner un alias unique et persistant vers le multipath, sous la forme mpathn. Si défini sur no, le système devrait utiliser le WWID en tant qu'alias pour le multipath. Dans les deux cas, ce qui est spécifié ici sera remplacé par n'importe quel alias spécifique aux périphériques que vous aurez déterminé dans la section multipaths du fichier de configuration. La valeur par défaut est no.
queue_without_daemon S'il est défini sur no, le démon multipathd désactivera les mises en file d'attente pour tous les périphériques lors de la fermeture. La valeur par défaut est no.
flush_on_last_del S'il est défini sur yes, le démon multipathd désactivera les files d'attente lorsque le dernier chemin vers un périphérique aura été supprimé. La valeur par défaut est no.
max_fds Définit le nombre maximum de descripteurs de fichiers ouverts pouvant être ouvert par multipath et le démon multipathd. Ceci est équivalent à la commande ulimit -n. À partir de Red Hat Enterprise Linux 6.3, La valeur par défaut est max, ce qui définit ceci sur la limite du système à partir de /proc/sys/fs/nr_open. Sur les versions antérieures, si cette valeur n'est pas définie, le nombre maximum de descripteurs de fichiers ouvert est pris à partir du processus d'appel, habituellement 1024. Par sécurité, cette valeur doit être définie sur le nombre maximum de chemins plus 32, si ce nombre est plus important que 1024.
checker_timeout Délai d'expiration à utiliser pour les vérificateurs de chemins qui effectuent des commandes SCSI avec un délai d'expiration explicite en secondes. La valeur est prise dans sys/block/sdx/device/timeout.
fast_io_fail_tmo Nombre de secondes que la couche SCSI attendra après qu'un problème soit détecté sur un port distant FC avant que les E/S n'échouent sur les périphériques de ce port distant. Cette valeur doit être plus petite que la valeur de dev_loss_tmo. Définir cette valeur sur off désactivera le délai. La valeur par défaut est déterminée par le système d'exploitation.
dev_loss_tmo Nombre de secondes que la couche SCSI attendra après qu'un problème soit détecté sur un port distant FC avant de le supprimer du système. Cette valeur définie sur l'infini correspondra à 2147483647 secondes, ou 68 ans. La valeur par défaut est déterminée par le système d'exploitation.
hwtable_regex_match
(Red Hat Enterprise Linux 6.3 et versions supérieures) Contrôle comment multipath intègre les configurations de périphériques depuis la section devices (périphériques) du fichier de configuration avec les configurations intégrées du périphérique.
Chaque configuration de périphérique dans la section devices du fichier multipath.conf créera sa propre configuration de périphérique ou modifiera l'une des configurations de périphérique intégrées. Avant Red Hat Enterprise Linux 6.3, si les chaînes du vendeur, du produit et de révision dans la configuration du périphérique d'un utilisateur correspondaient exactement aux chaînes dans une configuration intégrée de périphérique, alors la configuration intégrée étais modifiée par les options dans la configuration de l'utilisateur. Sinon, la configuration du périphérique de l'utilisateur était traitée comme étant une nouvelle configuration.
Si hwtable_regex_match est défini sur yes, une correspondance d'expression régulière est utilisée à la place. Les chaînes du vendeur, produit et de la révision sont toutes des expressions régulières. Les valeurs de configuration du périphérique de l'utilisateur de ces options sont comparées aux valeurs de configuration intégrées du périphérique. Cette correspondance fonctionne de la même manière que la comparaison réelle des chaînes de vendeur, produit et de révision d'un périphérique avec les chaînes de configuration du périphérique afin de voir quelle configuration devra être utilisée pour le périphérique. Si la configuration du périphérique de l'utilisateur fonctionne, alors la configuration intégrée est modifiée par les options dans la configuration de l'utilisateur. Sinon, la configuration du périphérique de l'utilisateur est traitée en tant que nouvelle configuration.
retain_attached_hw_handler (Red Hat Enterprise Linux 6.4 et versions supérieures) Si ce paramètre est défini sur yes et que la couche SCSI a déjà attaché un gestionnaire de matériel au périphérique de chemins, multipath ne forcera pas le périphérique à utiliser le gestionnaire de matériel hardware_handler spécifié par le fichier mutipath.conf. Si la couche SCSI n'a pas attaché de gestionnaire de matériel, multipath continuera d'utiliser son gestionnaire de matériel configuré comme normalement. La valeur par défaut est no.
detect_prio (Red Hat Enterprise Linux 6.4 et versions supérieures) Si ceci est défini sur yes, multipath commencera par vérifier si le périphérique prend en charge ALUA, si c'est le cas, il assignera automatiquement au périphérique le hiérarchiseur alua. Si le périphérique ne prend pas ALUA en charge, il déterminera le hiérarchiseur comme toujours. La valeur par défaut est no.