4.4. Attributs de configuration de périphériques multipath

Tableau 4.2, « Attributs Multipath » indique les attributs que vous pouvez configurer dans la section multipaths du fichier de configuration multipath.conf pour chaque périphérique multipath précisé. Ces attributs s'appliquent uniquement au multipath spécifié. Ces valeurs par défaut sont utilisées par DM-Multipath et remplacent les attributs déterminés dans les sections defaults et devices du fichier multipath.conf.

Tableau 4.2. Attributs Multipath

AttributDescription
wwid Indique le WWID du périphérique multipath pour lequel les attributs multipath s'appliquent. Ce paramètre est obligatoire pour cette section du fichier multipath.conf.
alias Spécifie le nom symbolique du périphérique multipath auquel les attributs multipath s'appliquent. Si vous utilisez user_friendly_names, ne réglez pas cette valeur sur mpathn ; elle pourrait rentrer en conflit avec un nom convivial d'utilisateur qui aurait été assigné automatiquement, et pourrait vous donner de noms de nœuds de périphériques incorrects.
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 nombre de série détecté
group_by_prio = groupe de priorité 1 par valeur de priorité du chemin
group_by_node_name = 1 groupe de priorité par nom de nœud ciblé
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.
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.
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 (matrices) EMC.
alua : génère la priorité du chemin d'accès en fonction des paramètres ALUA SCSI-3. À partir de Red Hat Enterprise Linux 7,3, si vous spécifiez prio "alua exclusive_pref_bit" dans la configuration de votre périphérique, Multipath créera un groupe de chemin d'accès qui ne contiennent que le chemin d'accès avec pref définie et donnera à ce groupe Path la priorité la plus élevée.
ontap : génère la priorité de chemin pour les matrices (matrices) 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.
fonstionnalités
Les fonctionnalités supplémentaires par défaut des périphériques multipath, utilisant le format : "number_of_features_plus_arguments feature1 ...".
Les valeurs possibles des fonctionnalités sont :
queue_if_no_path, qui est la même configuration que no_path_retry pour queue. Pour obtenir plus d'informations sur les problèmes qui peuvent se poser quand vous utilisez cette fonctionnalité, consulter Section 5.7, « Problèmes avec la fonctionnalité queue_if_no_path ».
retain_attached_hw_handler : 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 multipath.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.
pg_init_retries n: esssayez à nouveau la réinitialisation de ce groupe de chemins jusqu'à n fois avant d'échouer avec 1 <= n <= 50.
pg_init_delay_msecs n : patientez n millisecondes entre les nouvelles tentatives d'initialisation de groupes de chemins avec 0 <= n <= 60000.
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é.
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 paramétrée sur uniform, alors tous les chemins auront la même importance.
flush_on_last_del Si configuré sur yes, alors multipath désactivera les files d'attente lorsque le dernier chemin vers un périphérique aura été supprimé.
user_friendly_names Le paramètre yes précise que le système doit utiliser le fichier /etc/multipath/bindings pour assigner un alias unique et persistant vers le multipath, sous la forme mpathn. Le paramètre no indique que le système doit 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.
delay_watch_checks (Red Hat Enterprise Linux Release 7.2 et versions ultérieures) Si défini sur une valeur supérieure à 0, le démon multipathd surveillera plusieurs chemins d'accès récemment devenus valides un nombre de fois spécifique. S'ils échouent à nouveau, alors ils deviendront valides à nouveau quand ils ne seront pas utilisés et seront restés en place durant le nombre de contrôles consécutifs spécifiés par delay_wait_checks. Cela vous permet de garder des chemins qui peuvent paraître peu fiables d'être immédiatement remis en service dès qu'ils reviennent en ligne.
delay_wait_checks (Red Hat Enterprise Linux Release 7.2 et versions ultérieures) Si défini sur une valeur supérieure à 0, quand un périphérique qui vient de revenir en ligne échoue à nouveau pendant le nombre de contrôles spécifiés par delay_watch_checks, la prochaine fois qu'il revient en ligne, il sera marqué et retardé et il ne sera pas utilisé tant qu'il n'a pas passé le nombre de contrôles spécifiés dans delay_wait_checks.
deferred_removeSi cette propriété est définie sur yes, la méthode multipathd effectuera une suppression différée au lieu d'une suppression régulière lorsque le dernier chemin d'accès de périphérique a été supprimé. Cela garantit que si un périphérique multipath est utilisé lorsqu'une suppression régulière est effectuée et que la suppression échoue, l'appareil sera automatiquement supprimé lorsque le dernier utilisateur aura fermé le périphérique.
skip_kpartxSi défini sur yes, kpartx va créer des partitions automatiquement sur le périphérique. Cela permettra de créer un périphérique multipath sans créer de partitions, même si le périphérique possède une table de partitions.
L'exemple suivant montre les attributs multipath spécifiés dans le fichier de configuration pour les deux périphériques multipath spécifiques. Le premier périphérique a un WWID de 3600508b4000156d70001200000b0000 et un nom symbolique yellow (jaune).
Le second périphérique multipath a un WWID de 1DEC_____321816758474 et un nom symbolique red (rouge). Dans cet exemple, les attributs rr_weight sont fixés à priorities (priorités).
multipaths {
       multipath {
              wwid                  3600508b4000156d70001200000b0000
              alias                 yellow
              path_grouping_policy  multibus
              path_selector         "round-robin 0"
              failback              manual
              rr_weight             priorities
              no_path_retry         5
       }
       multipath {
              wwid                  1DEC_____321816758474
              alias                 red
              rr_weight             priorities
        }
}