5.2. Fichier de configuration par défaut


Le fichier de configuration /etc/multipath.conf contient une section defaults. Cette section comprend la configuration par défaut de Device Mapper (DM) Multipath. Les valeurs par défaut peuvent différer en fonction des paramètres initiaux de l'appareil.

Si vous installez votre machine sur un périphérique à chemins multiples, la configuration par défaut des chemins multiples s'applique automatiquement. Si vous n'avez pas configuré le multipathing lors de l'installation, exécutez la commande to suivante pour obtenir la configuration par défaut :

# mpathconf --enable

La configuration par défaut comprend les éléments suivants :

# For a complete list of the default configuration values, run either
# multipath -t
# or
# multipathd show config
#
# For a list of configuration options with descriptions, see the multipath.conf
# man page
defaults
{         user_friendly_names yes         find_multipaths yes }

Le tableau suivant décrit les attributs définis dans la section defaults du fichier de configuration multipath.conf. Les attributs spécifiés dans la section multipaths ont une priorité plus élevée que les valeurs de la section devices. Les attributs spécifiés dans la section devices ont une priorité plus élevée que les valeurs par défaut. Utilisez la section overrides pour définir les valeurs des attributs pour tous les types de dispositifs, même si ces types de dispositifs ont une entrée de configuration intégrée dans la section devices. La section overrides n'a pas d'attributs obligatoires. Cependant, tout attribut défini dans cette section est prioritaire sur les valeurs des sections devices ou defaults.

Tableau 5.1. Configuration par défaut des chemins multiples
AttributDescription

polling_interval

Spécifie l'intervalle entre deux vérifications du chemin en secondes. Pour des chemins fonctionnant correctement, l'intervalle entre les vérifications augmente progressivement jusqu'à max_polling_interval. La valeur par défaut est 5.

max_polling_interval

Spécifie la longueur maximale de l'intervalle entre deux vérifications du chemin d'accès en secondes.

The default value is 4 * polling_interval.

find_multipaths

Définit le mode de configuration des dispositifs à trajets multiples. Les valeurs disponibles sont les suivantes :

no: Si find_multipaths est défini sur no, multipath applique les règles selon la valeur strict et le démon multipathd applique les règles selon la valeur greedy.

yes: S'il existe au moins deux périphériques qui ne sont pas sur le site blacklist et qui ont le même identificateur mondial (WWID), ou si multipath a créé un périphérique multipath avec un WWID de périphérique auparavant (même si ce périphérique multipath n'est plus présent), le périphérique est traité comme un chemin de périphérique multipath.

greedy: Les sites multipathd et multipath traitent chaque périphérique non inscrit sur la liste noire comme un chemin de périphérique à trajets multiples.

smart: Multipath considère automatiquement que tout périphérique non inscrit sur la liste noire est un périphérique multipath path. Si un second chemin, avec le même WWID, n'apparaît pas dans le délai fixé pour find_multipaths_timeout, multipath libère le périphérique et l'autorise à être utilisé par le reste du système. Le démon multipathd applique les mêmes règles que pour la valeur yes.

strict: Cette valeur ne traite un périphérique comme un chemin d'accès à trajets multiples que si vous créez un périphérique à trajets multiples avec le WWID du périphérique.

La valeur par défaut est off. Le fichier par défaut multipath.conf définit find_multipaths comme yes.

find_multipaths_timeout

Il s'agit du délai d'attente en secondes pour les chemins supplémentaires après la détection du premier, si l'option find_multipaths smart est activée. Les valeurs possibles sont les suivantes :

Positive value: Si la valeur est positive, le délai s'applique à tous les appareils qui ne figurent pas sur la liste noire.

Negative value: S'il est défini avec une valeur négative, le délai ne s'applique qu'aux périphériques connus qui ont une entrée dans la table matérielle multipath, soit dans la table intégrée, soit dans une section device. Les autres périphériques inconnus utilisent un délai de 1 seconde seulement pour éviter les retards de démarrage. Les autres périphériques inconnus utilisent un délai d'attente de seulement 1 seconde pour éviter les retards de démarrage.

0: Le système applique la valeur par défaut intégrée pour cet attribut.

La valeur par défaut pour le matériel connu est -10. Cela signifie que les appareils connus ont un délai d'attente de 10 secondes. Les appareils inconnus ont un délai d'attente de 1 seconde. Si l'attribut find_multipaths a une valeur autre que smart, cet attribut n'a aucun effet.

uxsock_timeout

Définir le délai d'attente des commandes interactives multipathd en millisecondes.

Pour les systèmes comportant un grand nombre d'appareils, les commandes interactives multipathd peuvent dépasser le délai et échouer. Dans ce cas, augmentez ce délai pour résoudre le problème.

La valeur par défaut est 4000.

reassign_maps

Activer la réaffectation des cartes de mappes de périphériques. Avec cette option, le démon multipathd réaffecte les mappes de périphériques existantes pour qu'elles pointent toujours vers le périphérique multipath, et non vers les périphériques de blocs sous-jacents. Les valeurs possibles sont yes et no. La valeur par défaut est no.

verbosity

La valeur de verbosité par défaut est 2. Les valeurs supérieures augmentent le niveau de verbosité. Les niveaux valides se situent entre 0 et 4.

path_selector

Spécifie l'algorithme par défaut à utiliser pour déterminer le chemin à emprunter pour l'opération d'E/S suivante. Les valeurs possibles sont les suivantes :

round-robin 0: Boucle sur tous les chemins du groupe de chemins, en envoyant à chacun le même nombre de demandes d'E/S, déterminé par rr_min_io ou rr_min_io_rq.

queue-length 0: Envoyer le groupe suivant de demandes d'E/S par le chemin ayant le moins de demandes d'E/S en attente.

service-time 0: Envoyer le groupe suivant de demandes d'E/S par le chemin dont le temps de service estimé est le plus court. Ce temps est déterminé en divisant la taille totale des E/S en attente sur chaque chemin par le débit relatif.

La valeur par défaut est service-time 0.

path_grouping_policy

Spécifie la stratégie de groupement de chemins par défaut à appliquer aux chemins multiples non spécifiés. Les valeurs possibles sont les suivantes :

failover: 1 chemin par groupe de priorité.

multibus: Tous les chemins valides dans 1 groupe de priorité.

group_by_serial: 1 groupe de priorité par numéro de série détecté.

group_by_prio: 1 groupe de priorité par valeur de priorité de chemin. Les priorités sont déterminées par l'attribut prio.

group_by_node_name: 1 groupe de priorité par nom de nœud cible. Le répertoire /sys/class/fc_transport/target*/node_name contient les noms des nœuds cibles.

La valeur par défaut est failover.

uid_attrs

Cette option permet d'activer la fusion de uevents par WWID. Cette action peut améliorer l'efficacité du traitement des événements. Il s'agit également d'une méthode alternative pour configurer les propriétés udev à utiliser pour déterminer les identifiants de chemin uniques (WWID).

La valeur de cette option est une liste d'enregistrements séparés par des espaces, comme type:ATTR, où type est comparé au début du nom du nœud du périphérique, et ATTR est le nom de la propriété udev à utiliser pour faire correspondre les périphériques.

Si vous configurez cette option et qu'elle correspond au nom du nœud d'un périphérique, elle remplace toutes les autres méthodes configurées pour déterminer le WWID de ce périphérique.

Vous pouvez activer la fusion uevent en définissant cette valeur sur sd:ID_SERIAL dasd:ID_UID nvme:ID_WWN.

La valeur par défaut est unset.

prio

Spécifie la fonction par défaut à appeler pour obtenir une valeur de priorité de chemin. Par exemple, les bits ALUA dans SPC-3 fournissent une valeur exploitable prio. Les valeurs possibles sont les suivantes :

const: Attribuer une priorité de 1 à tous les chemins.

emc: Génère la priorité des chemins pour les baies EMC.

sysfs: Génère la priorité du chemin à partir de sysfs. Ce prioritizer accepte la valeur optionnelle prio_arg exclusive_pref_bit . La valeur sysfs utilise les attributs sysfs access_state et preferred_path.

alua: Génère la priorité du chemin en fonction des paramètres SCSI-3 ALUA. Si vous spécifiez prio alua et prio_args exclusive_pref_bit dans la configuration de votre périphérique, multipath crée un groupe de chemins qui contient uniquement le chemin avec l'ensemble exclusive_pref_bit et attribue à ce groupe de chemins la priorité la plus élevée. Reportez-vous à la page de manuel multipath.conf(5) pour plus d'informations sur ce type de cas.

ontap: Génère la priorité des chemins d'accès pour les baies NetApp.

rdac: Génère la priorité du chemin pour le contrôleur LSI/Engenio RDAC.

hp_sw: Génère la priorité de chemin pour le contrôleur Compaq/HP en mode actif/standby.

hds: Génère la priorité du chemin pour les baies de stockage Hitachi HDS Modular.

random: Génère une priorité aléatoire entre 1 et 10.

weightedpath: Génère la priorité du chemin en fonction de l'expression régulière et de la priorité fournie en tant qu'argument. Nécessite le mot-clé prio_args.

path_latency: Génère la priorité du chemin sur la base d'un algorithme de latence. Nécessite le mot-clé prio_args.

ana: Génère la priorité du chemin en fonction des paramètres NVMe ANA. Cette routine de priorité dépend du matériel.

datacore: Génère la priorité du chemin pour certaines baies de stockage DataCore. Nécessite le mot-clé prio_args. Cette routine de priorité dépend du matériel.

iet: Génère une priorité de chemin pour les cibles iSCSI en fonction de leur adresse IP. Nécessite le mot-clé prio_args. Cette routine de priorité n'est disponible qu'avec iSCSI.

La valeur par défaut dépend du paramètre detect_prio. Si detect_prio est défini sur yes, l'algorithme de priorité par défaut est sysfs. La seule exception concerne la série E de NetAPP, pour laquelle la valeur par défaut est alua. Si detect_prio est défini sur no, l'algorithme de priorité par défaut est const.

prio_args

Arguments à transmettre à la fonction prio. Ceci ne s'applique qu'aux prioriseurs suivants :

weighted: A besoin d'une valeur de la forme <hbtl,devname,serial,wwn> <regex1> <prio1> <regex2> <prio2>

hbtl: La valeur Regex peut être au format SCSI H:B:T:L. Par exemple : 1:0:.:. , *:0:0:.

devname: La valeur Regex peut être au format du nom de l'appareil. Par exemple : sda, sd.e.

serial: La valeur Regex peut être sous forme de numéro de série. Recherchez serial en passant par sysfs, ou en exécutant la commande multipathd show paths format "%z".

wwn: La valeur Regex peut se présenter sous la forme host_wwnn:host_wwpn:target_wwnn:target_wwpn. Ces valeurs peuvent être recherchées par le biais de sysfs ou en exécutant la commande multipathd show paths format %N:%R:%n:%r".

path_latency: Requiert une valeur sous la forme io_num= <integer> base_num=<integer>.

io_num: Le nombre d'IO de lecture, continuellement envoyés au chemin actuel. Cette valeur permet de calculer la latence moyenne du chemin. Les valeurs valides sont Integer, [2, 200].

base_num: La valeur du nombre de base de l'échelle logarithmique. Cette valeur permet de répartir les différents rangs de priorité. Les valeurs valides sont Integer, [2, 10]. La valeur maximale de la latence moyenne est 100s et la valeur minimale de la latence moyenne est 1us.

alua: Si la valeur exclusive_pref_bit est définie, les chemins dont la valeur preferred_path_bit est définie créent toujours leur propre groupe de chemins.

sysfs: Si la valeur exclusive_pref_bit est définie, les chemins dont la valeur preferred_path_bit est définie créent toujours leur propre groupe de chemins.

datacore: Requiert une valeur de la forme timeout=<milliseconds> preferredsds=<name>.

preferredsds: Cette valeur est obligatoire et représente le nom préféré du SDS.

timeout: Cette valeur est facultative. Définit le délai d'attente pour la demande en millisecondes.

iet: Requiert une valeur de la forme preferredip=<ip_address>.

preferredip: Cette valeur est obligatoire. Il s'agit de l'adresse IP préférée, en notation décimale pointée, pour les cibles iSCSI.

La valeur par défaut est unset.

features

Les caractéristiques supplémentaires par défaut des dispositifs à trajets multiples, au format : "number_of_features_plus_arguments feature1 …​".

Les valeurs possibles pour features sont les suivantes :

queue_if_no_path: C'est la même chose que de régler no_path_retry sur queue.

pg_init_retries n: Réessayer l'initialisation du groupe de chemins jusqu'à n fois avant d'échouer. Le nombre doit être compris entre 1 et 50.

pg_init_delay_msecs msecs: Nombre de millisecondes avant que pg_init n'entame une nouvelle tentative. Ce nombre doit être compris entre 0 et 60000.

queue_mode mode: Sélectionnez le mode de mise en file d'attente par dispositif à trajets multiples. Les valeurs possibles de mode sont bio, rq ou mq, ce qui correspond respectivement à bio-based, request-based et block-multiqueue request-based (blk-mq).

Par défaut, la valeur est unset.

path_checker

Spécifie la méthode par défaut pour déterminer l'état des chemins. Les valeurs possibles sont les suivantes :

readsector0: Lire le premier secteur de l'appareil.

tur: Émettre une commande TEST UNIT READY à l'intention de l'appareil.

emc_clariion: Interroger la page EVPD spécifique à EMC Clariion (0xC0) pour déterminer le chemin d'accès.

hp_sw: Vérifier l'état du chemin d'accès pour les baies de stockage HP dotées d'un micrologiciel actif ou en attente.

rdac: Vérifier l'état du chemin pour le contrôleur de stockage LSI/Engenio RDAC.

directio: Lire le premier secteur avec l'E/S directe.

cciss_tur: Vérifier l'état du chemin pour les contrôleurs HP/COMPAQ Smart Array(CCISS). Cela dépend du matériel.

none: Ne vérifie pas le dispositif. Renvoie à l'utilisation des valeurs récupérées sur sysfs.

La valeur par défaut est tur.

alias_prefix

Cet attribut représente le préfixe user_friendly_names.

La valeur par défaut est mpath.

failback

Gère la reprise des groupes de chemins. Les valeurs possibles sont les suivantes :

immediate: Spécifie un retour immédiat sur le groupe de chemins de priorité la plus élevée qui contient des chemins actifs.

manual: Spécifie qu'il n'y a pas de retour en arrière immédiat, mais que le retour en arrière ne peut se faire qu'avec l'intervention de l'opérateur.

followover: Spécifie que la reprise automatique ne peut être effectuée que lorsque le premier chemin d'un groupe de chemins devient actif. Cela permet d'éviter qu'un nœud ne bascule automatiquement lorsqu'un autre nœud a demandé le basculement.

Une valeur numérique supérieure à zéro spécifie une reprise différée et est exprimée en secondes.

La valeur par défaut est manual.

rr_min_io

Spécifie le nombre de requêtes d'E/S à acheminer vers un chemin avant de passer au chemin suivant dans le groupe de chemins actuel. Ce paramètre ne concerne que les systèmes utilisant des noyaux antérieurs à la version 2.6.31. Les systèmes plus récents doivent 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 à acheminer vers un chemin avant de passer au chemin suivant dans le groupe de chemins actuel. Utilise un device-mapper-multipath basé sur les requêtes. Ce paramètre peut être utilisé sur les systèmes utilisant les noyaux actuels. Sur les systèmes utilisant des noyaux antérieurs à 2.6.31, utilisez rr_min_io. La valeur par défaut est 1.

no_path_retry

Une valeur numérique pour cet attribut spécifie le nombre de fois que le vérificateur de chemin doit échouer pour tous les chemins dans un dispositif à chemins multiples, avant de désactiver la mise en file d'attente.

Une valeur de fail indique une défaillance immédiate, sans mise en file d'attente.

Une valeur de queue indique que la file d'attente ne doit pas s'arrêter tant que le chemin n'est pas fixé.

La valeur par défaut est fail.

user_friendly_names

Les valeurs possibles sont les suivantes :

yes: Spécifie que le système peut utiliser le fichier /etc/multipath/bindings pour attribuer un alias unique et permanent au chemin d'accès multiple, sous la forme mpath<n>.

no: Le système utilise le WWID comme alias pour le chemin multiple. Tout alias spécifique à un périphérique défini dans la section multipaths du fichier de configuration remplace ce nom.

La valeur par défaut est no.

queue_without_daemon

S'il a pour valeur no, le démon multipathd désactive la mise en file d'attente pour tous les périphériques lorsqu'il s'arrête. La valeur par défaut est no.

flush_on_last_del

S'il a pour valeur yes, le démon multipathd désactive la mise en file d'attente lorsque le dernier chemin d'accès à un périphérique est supprimé. La valeur par défaut est no.

max_fds

Définit le nombre maximum de descripteurs de fichiers ouverts qui peuvent être ouverts par multipath et le démon multipathd. Cela équivaut à la commande ulimit -n. La valeur par défaut est max, ce qui correspond à la limite système de /proc/sys/fs/nr_open.

checker_timeout

Le délai d'attente à utiliser pour les hiérarchiseurs et les vérificateurs de chemin qui émettent des commandes SCSI avec un délai d'attente explicite, en secondes. Le répertoire sys/block/sd<x>/device/timeout contient la valeur par défaut.

fast_io_fail_tmo

Le nombre de secondes que la couche SCSI attend après la détection d'un problème sur un port distant FC, avant d'interrompre les E/S vers les périphériques sur ce port distant. Cette valeur doit être inférieure à la valeur de dev_loss_tmo. La valeur de off désactive le délai d'attente. La valeur par défaut est 5. L'option fast_io_fail_tmo remplace les valeurs des options recovery_tmo et replacement_timeout des périphériques de chemin d'accès sous-jacents.

dev_loss_tmo

Le nombre de secondes que la couche SCSI attend après la détection d'un problème sur un port distant FC, avant de le retirer du système. La valeur infinie correspond à 2147483647 secondes, soit 68 ans. Le système d'exploitation détermine la valeur par défaut.

eh_deadline

Spécifie le nombre maximum de secondes que la couche SCSI consacre à la gestion des erreurs en cas de défaillance des périphériques SCSI. Après ce délai, la couche SCSI effectue une réinitialisation complète de l'adaptateur de bus hôte. Ce paramètre est nécessaire dans les cas où rport n'est jamais perdu, de sorte que fast_io_fail_tmo et dev_loss_tmo ne se déclenchent jamais, mais que les commandes scsi restent bloquées. Lorsque le gestionnaire d'erreurs SCSI effectue la réinitialisation de l'adaptateur de bus hôte, cela affecte tous les chemins cibles de cet adaptateur de bus hôte. La valeur eh_deadline ne doit être définie que dans les cas où toutes les cibles des adaptateurs de bus hôte affectés sont à chemins multiples.

La valeur par défaut est unset.

detect_prio

Si ce paramètre est défini sur yes, multipath détecte si le périphérique est un périphérique SCSI qui prend en charge l'accès aux unités logiques asymétriques (ALUA) ou un périphérique NVMe qui prend en charge l'accès asymétrique à l'espace de noms (ANA). Si le périphérique prend en charge ALUA, multipath lui attribue automatiquement le prioritizer alua. Si le périphérique prend en charge l'ANA, le multipath lui attribue automatiquement le prioritizer ana.

Si detect_prio est défini sur no, ou si le dispositif ne prend pas en charge ALUA ou ANA, l'attribut prio définit le prioritizer.

La valeur par défaut est yes.

uid_attribute

Spécifie l'attribut udev à utiliser pour le WWID de l'appareil.

La valeur par défaut dépend du périphérique : ID_SERIAL pour les périphériques SCSI, ID_UID pour les périphériques DASD et ID_WWN pour les périphériques NVMe.

force_sync

S'il est défini à yes, ce paramètre empêche les vérificateurs de chemin d'accès de fonctionner en mode asynchrone. Cela signifie qu'un seul vérificateur s'exécute à la fois. Ceci est utile dans les cas où de nombreux vérificateurs multipathd s'exécutent en parallèle, et peut causer une pression importante sur le processeur.

La valeur par défaut est no.

strict_timing

S'il a pour valeur yes, le démon multipathd démarre une nouvelle boucle de vérification de chemin après exactement une seconde, de sorte que chaque vérification de chemin se produise aux secondes exactement définies pour polling_interval. Sur les systèmes très sollicités, la vérification des chemins peut prendre plus d'une seconde. Les ticks manquants sont pris en compte dans le tour suivant. Un avertissement s'affiche si les vérifications de chemin prennent plus de temps que les secondes définies pour polling_interval.

La valeur par défaut est no.

retrigger_tries, retrigger_delay

Utilisez les paramètres retrigger_tries et retrigger_delay en conjonction pour que multipathd redéclenche les uevents. Si udev ne parvient pas à traiter complètement l'original uevents, multipath ne peut pas utiliser le dispositif. Le paramètre retrigger_tries définit le nombre de fois que multipath tente de redéclencher un uevent, dans le cas où un dispositif n'est pas complètement configuré. Le paramètre retrigger_delay définit le nombre de secondes entre les tentatives. Ces deux options acceptent des nombres supérieurs ou égaux à 0. La définition du paramètre retrigger_tries sur 0 désactive les tentatives de redéclenchement. La définition du paramètre retrigger_delay sur 0 entraîne la réémission de uevent lors de la prochaine boucle du vérificateur de chemin.

La valeur par défaut de retrigger_tries est 3. La valeur par défaut de retrigger_delay est 10.

missing_uev_wait_timeout

Cet attribut contrôle le nombre de secondes pendant lesquelles le démon multipathd attend de recevoir un événement de changement de udev pour un périphérique multipath nouvellement créé. Ensuite, il active automatiquement les rechargements de périphériques. Dans la plupart des cas, multipathd retarde les rechargements sur un périphérique jusqu'à ce qu'il reçoive un changement uevent du chargement initial de la table.

La valeur par défaut est 30.

deferred_remove

Si la valeur est yes, multipathd effectue une suppression différée, au lieu d'une suppression normale, lorsque le dernier périphérique de chemin d'accès est supprimé. Cela garantit que si un périphérique à plusieurs chemins est en cours d'utilisation lorsqu'une suppression régulière est effectuée et que celle-ci échoue, le périphérique est automatiquement supprimé lorsque le dernier utilisateur ferme le périphérique. La valeur par défaut est no.

san_path_err_threshold, san_path_err_forget_rate, san_path_err_recovery_time

Si vous donnez à ces trois attributs une valeur supérieure à zéro, ils permettent au démon multipathd d'empêcher la réintégration des chemins douteux, en surveillant la fréquence des échecs du vérificateur de chemins. Si un vérificateur de chemin échoue plus souvent que la valeur de l'attribut san_path_err_threshold, dans les vérifications san_path_err_forget_rate, le démon multipathd ne rétablit pas le chemin tant que la valeur de l'attribut san_path_err_recovery_time en secondes ne s'est pas écoulée, sans qu'aucun vérificateur de chemin n'ait échoué.

Voir la section Shaky paths detection du site multipath.conf(5) pour plus d'informations.

La valeur par défaut est no.

marginal_path_double_failed_time, marginal_path_err_sample_time, marginal_path_err_rate_threshold, marginal_path_err_recheck_gap_time

Si marginal_path_double_failed_time, marginal_path_err_rate_threshold, et marginal_path_err_recheck_gap_time sont définis sur des entiers supérieurs à 0 et que marginal_path_err_sample_time est défini sur un entier supérieur à 120, ils permettent au démon multipathd d'empêcher les chemins douteux de se rétablir, en testant le taux d'échec des entrées/sorties des chemins qui échouent de manière répétée.

Si un chemin échoue deux fois pendant la période définie dans l'attribut marginal_path_double_failed_time en secondes, le démon multipathd ne le rétablit pas immédiatement lorsque le vérificateur de chemin détermine qu'il est rétabli. Au lieu de cela, multipathd émet un flux régulier d'E/S de lecture vers le chemin pour la valeur définie dans l'attribut marginal_path_err_sample_time en secondes. Si le nombre d'erreurs par millier d'E/S est supérieur à la valeur définie dans l'attribut marginal_path_err_rate_threshold, multipathd attend marginal_path_err_recheck_gap_time secondes, puis lance un autre cycle de test du chemin avec des E/S de lecture. Dans le cas contraire, multipathd rétablit le chemin.

Voir la section Shaky paths detection du site multipath.conf(5) pour plus d'informations.

La valeur par défaut est no.

marginal_pathgroups

Les valeurs possibles sont les suivantes :

on: Lorsque l'une des méthodes de détection des chemins marginaux détermine qu'un chemin est marginal, le système rétablit le chemin et le place dans un groupe de chemins distinct. Ce groupe n'entre en vigueur qu'après que tous les groupes de chemins non marginaux ont été essayés. Cela permet d'éviter que des erreurs d'entrée-sortie se produisent alors que le système peut encore utiliser certains chemins marginaux. Le chemin retourne dans un groupe de chemins normal dès qu'il n'est plus surveillé pendant une période configurée.

off: Les attributs delay_*_checks, marginal_path_* et san_path_err_* empêchent le système de rétablir les chemins d'accès marginal ou shaky tant qu'ils n'ont pas été contrôlés pendant une période configurée.

fpin: Le démon multipathd reçoit les notifications fpin, définit l'état des chemins à marginal et regroupe les chemins, comme décrit pour la valeur on.

Les attributs marginal_path_* et san_path_err_* sont implicitement fixés à no.

Voir la section Shaky paths detection du site multipath.conf(5) pour plus d'informations.

La valeur par défaut est no.

log_checker_err

Si la valeur est once, multipathd enregistre la première erreur du vérificateur de chemin d'accès au niveau de verbosité 2. Le système consigne toute autre erreur au niveau de verbosité 3, jusqu'à ce que le périphérique soit restauré. Si le paramètre log_checker_err est défini sur always, multipathd enregistre toujours l'erreur du vérificateur de chemin au niveau de verbosité 2. La valeur par défaut est always.

skip_kpartx

Si la valeur est yes, kpartx ne crée pas automatiquement de partitions sur le périphérique. Cela vous permet de créer un périphérique à chemins multiples sans créer de partitions, même si le périphérique dispose d'une table de partition. La valeur par défaut de cette option est no.

max_sectors_kb

Cette option permet de définir le paramètre de file d'attente de périphérique max_sectors_kb à la valeur spécifiée sur tous les chemins sous-jacents d'un périphérique à chemins multiples, avant la première activation d'un périphérique à chemins multiples. Chaque fois que le système crée un nouveau périphérique à chemins multiples, celui-ci hérite de la valeur max_sectors_kb des périphériques de chemin d'accès. L'augmentation manuelle de cette valeur pour le périphérique à chemins multiples ou la diminution de cette valeur pour les périphériques de chemin d'accès peut entraîner la création d'opérations d'E/S plus importantes que celles autorisées par les périphériques de chemin d'accès. L'utilisation du paramètre max_sectors_kb est un moyen simple de définir ces valeurs, avant la création d'un périphérique multipath au-dessus des périphériques de chemin, et d'empêcher le passage d'opérations d'E/S de taille non valide. Si vous ne définissez pas ce paramètre, le pilote des périphériques de chemin d'accès le fait automatiquement et le périphérique à chemins d'accès multiples hérite de ce paramètre des périphériques de chemin d'accès.

ghost_delay

Cet attribut définit le nombre de secondes qu'attend le multipath après avoir créé un périphérique ne comportant que des chemins fantômes, avant de le marquer comme prêt à être utilisé dans systemd. Cela donne aux chemins actifs le temps d'apparaître avant que le multipath n'exécute le gestionnaire de matériel pour transformer les chemins fantômes en chemins actifs.

En fixant cette valeur à 0 ou no, multipath marque immédiatement comme prêt un périphérique qui n'a que des chemins fantômes.

La valeur par défaut est no.

enable_foreign

Cet attribut active ou désactive les bibliothèques étrangères.

La valeur est une expression régulière. Les bibliothèques étrangères sont chargées si leur nom correspond à l'expression.

Par défaut, aucune bibliothèque étrangère n'est activée. Utilisez nvme pour activer la prise en charge des chemins multiples natifs NVMe ou “.*” pour activer toutes les bibliothèques étrangères.

recheck_wwid

S'il est défini sur yes, lorsqu'un chemin défaillant est restauré, le démon multipathd vérifie à nouveau le WWID du chemin. En cas de modification du WWID, le chemin est supprimé du périphérique multipath actuel et ajouté à nouveau en tant que nouveau chemin. Le démon multipathd vérifie également à nouveau le WWID du chemin s'il est réajouté manuellement.

Cette option ne fonctionne que pour les périphériques SCSI configurés pour utiliser les valeurs par défaut uid_attribute, ID_SERIAL, ou sysfs, pour obtenir leur WWID.

La valeur par défaut est no.

remove_retries

Cette option définit le nombre de tentatives de retrait d'un périphérique en cours d'utilisation. Entre chaque tentative, multipath devient inactif pendant 1 seconde. La valeur par défaut est 0, ce qui signifie que multipath ne retente pas la suppression.

detect_checker

S'il est défini sur yes, multipath vérifie si le périphérique prend en charge ALUA ou Redundant Disk Array Controller (RDAC). Si le périphérique prend en charge ALUA, multipath lui attribue l'adresse tur path_checker . Si le périphérique prend en charge RDAC, le démon multipathd lui attribue rdac path_checker . Si le périphérique ne prend pas en charge ALUA ou RDAC, ou si l'attribut detect_checker est défini sur no, l'attribut path_checker définit le vérificateur de chemin.

La valeur par défaut est yes.

reservation_key

Le paramètre mpathpersist utilise cette clé de réservation d'action de service. Il doit être défini pour tous les dispositifs à trajets multiples utilisant des réservations persistantes et doit être identique au champ RESERVATION KEY de la liste de paramètres PERSISTENT RESERVE OUT, qui contient une valeur de 8 octets fournie par le client de l'application au serveur de dispositifs pour identifier le nexus I_T. Si vous utilisez l'option --param-aptpl lors de l'enregistrement de la clé avec mpathpersist, vous devez ajouter :aptpl à la fin de la clé de réservation.

Ce paramètre peut également être défini sur file, ce qui permet à mpathpersist de stocker automatiquement dans le fichier prkeys la clé RESERVATION KEY utilisée pour enregistrer le périphérique à chemins multiples. Le démon multipathd utilise ensuite cette clé pour enregistrer les chemins supplémentaires au fur et à mesure qu'ils apparaissent. Lorsque vous supprimez l'enregistrement, vous supprimez automatiquement la clé RESERVATION KEY du fichier prkeys. Il s'agit de unset par défaut. Si des réservations persistantes sont nécessaires, il est recommandé de définir cet attribut sur file.

all_tg_pt

Si cette option est définie sur yes lorsque mpathpersist enregistre des clés, elle traite une clé enregistrée d'un hôte à un port cible comme allant d'un hôte à tous les ports cibles. Cette option doit être définie à yes pour utiliser avec succès mpathpersist sur les matrices qui définissent et effacent automatiquement les clés d'enregistrement sur tous les ports cibles à partir d'un hôte, au lieu de le faire par port cible et par hôte. La valeur par défaut est no.

Ressources supplémentaires

  • multipath.conf(5) page de manuel
Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.