Le fichier de configuration principal pour DM-Multipath est /etc/multipath.conf . Ce fichier n'est pas créé par l'installation initiale du package RPM. Cependant, le fichier suivant est installé dans /usr/share/doc/device-mapper-multipath-[version] répertoire :
- multipath.conf – Fichier de configuration de base avec quelques exemples pour DM-Multipath. Ce fichier est utilisé pour créer le fichier /etc/multipath.conf.
Le fichier multipath.conf contient les sections suivantes, et chaque section contient un ou plusieurs attributs ou sous-sections.
| Section | Description |
|---|---|
| valeurs par défaut | Définit les paramètres par défaut pour DM-Multipath. Ces paramètres peuvent être remplacés par les sections périphériques et multichemins. |
| liste noire | Définit les périphériques à exclure de la découverte de la topologie multivoie. Les périphériques qui sont sur liste noire ne sont pas regroupés dans un périphérique multivoie. |
| blacklist_exceptions | Définit les périphériques à inclure dans la découverte de la topologie multivoie, même si les périphériques sont répertoriés dans la section liste noire. |
| multichemins | Définit les paramètres des périphériques multivoies individuels. Les appareils sont identifiés par le mot-clé wwid. Les paramètres de cette section ont la priorité absolue. |
| appareils | Définit les paramètres pour les types de contrôleur de stockage individuels. Les types de contrôleurs sont identifiés par des mots-clés de fournisseur, de produit et de révision, qui doivent correspondre aux informations sysfs sur l'appareil. |
Attributs par défaut dans /etc/multipath.conf
Vous trouverez ci-dessous un exemple de section par défaut du fichier /etc/multipath.conf.
defaults {
polling_interval 10
path_selector "round-robin 0"
path_grouping_policy multibus
uid_attribute ID_SERIAL
prio alua
path_checker readsector0
rr_min_io 100
max_fds 8192
rr_weight priorities
failback immediate
no_path_retry fail
user_friendly_names yes
} Une liste partielle des attributs définis dans la section par défaut du fichier de configuration est la suivante :
- udev_dir – Répertoire où udev crée des nœuds de périphérique. La valeur par défaut est /dev.
- polling_interval – Intervalle en secondes pendant lequel les chemins sont vérifiés. La valeur par défaut est de 5 secondes.
- path_selector – L'un des algorithmes de sélection de chemin suivants à utiliser :
- round robin 0 :boucle sur chaque chemin en envoyant la même quantité d'E/S à chacun. C'est la valeur par défaut.
- longueur de la file d'attente 0 :Envoie les E/S vers un chemin avec le moins d'E/S en attente.
- temps de service 0 :envoie des E/S vers un chemin en fonction de la quantité d'E/S en attente et du débit relatif.
- path_grouping_policy – Les chemins sont regroupés en groupes de chemins. La politique détermine comment les groupes de chemins sont formés. Il existe cinq politiques différentes.
- basculement :Un chemin par groupe prioritaire
- multibus :Tous les chemins dans un groupe prioritaire. C'est la valeur par défaut.
- group_by_serial :Un groupe prioritaire par contrôleur de stockage (numéro de série)
- group_by_prio :Un groupe de priorité par valeur de priorité
- group_by_node_name :Un groupe de priorité par nom de nœud cible
- prior – L'une des méthodes suivantes est utilisée pour obtenir une valeur de priorité de chemin :
- const – Définissez une priorité de un pour tous les chemins. C'est la valeur par défaut.
- emc – Générer la priorité de chemin pour les baies de stockage EMC.
- alua – Générez la priorité de chemin en fonction des paramètres d'accès à l'unité logique asymétrique SCSI-3 (ALUA). ALUA permet à un appareil de signaler l'état de ses ports aux hôtes. Cet état est utilisé par les hôtes pour hiérarchiser les chemins et prendre des décisions de basculement et d'équilibrage de charge.
- tpg_pref – Générez la priorité de chemin en fonction des paramètres SCSI-3 ALUA, en utilisant le bit de port préféré.
- appuyez – Générer la priorité de chemin pour les baies de stockage NetApp.
- rdac – Générer la priorité de chemin pour le contrôleur de réseau de disques redondants (RDAC) LSI/Engenio/NetApp E-Series.
- hp_sw – Générer la priorité de chemin pour le contrôleur Compaq/HP en mode Actif/Veille.
- HD – Générer la priorité de chemin pour le contrôleur Hitachi HDS Compaq/HP en mode actif/veille.
- path_checker – L'une des méthodes suivantes est utilisée pour déterminer l'état des chemins :
- liresecteur0 – Lire le premier secteur de l'appareil. C'est la valeur par défaut.
- tour – Envoyez une commande Test Unit Ready (TUR) à l'appareil.
- emc_clarrion – Interrogez la page EVPD spécifique à EMC CLARiiON 0xC0 pour déterminer l'état du chemin.
- hp_sw – Vérifiez l'état du chemin d'accès pour les baies de stockage HP avec le micrologiciel actif/en veille.
- rdac – Vérifiez l'état du chemin pour le RDAC LSI/Engenio/NetApp E-Series.
- directio – Lire le premier secteur avec des E/S directes.
- rr_min_io – Le nombre d'E/S à acheminer vers un chemin avant de passer au chemin suivant dans le même groupe de chemins. Ceci est pour les systèmes exécutant des noyaux antérieurs à 2.6.31. Les systèmes plus récents utilisent rr_min_io_rq. La valeur par défaut est 1 000.
- max_fds – Le nombre maximum de descripteurs de fichiers pouvant être ouverts par multipath et multipathd
- rr_weight – Le poids du chemin. Les valeurs possibles sont les priorités ou uniformes.
- restauration automatique – L'une des méthodes suivantes est utilisée pour gérer le rétablissement du groupe de chemins :
- immédiat – Revenez immédiatement au groupe de chemins ayant la priorité la plus élevée contenant des chemins actifs.
- manuel – Ne pas effectuer de restauration automatique.
- suivi – Effectuez une restauration automatique uniquement lorsque le premier chemin d'un groupe de chemins devient actif.
- valeurs> 0 – Cela indique le délai de report du rétablissement en secondes.
Section liste noire dans /etc/multipath.conf
Vous trouverez ci-dessous un exemple de liste noire section du fichier /etc/multipath.conf.
blacklist {
wwid 26353900f02796769 ### blacklist using WWID
devnode "^sd[a-z]" ### blacklist all scsi Devices
device { ### blacklist by device type
vendor "COMPAQ"
product "HSV110 (C)COMPAQ"
}
} Utilisez la section liste noire dans le fichier /etc/multipath.conf pour exclure les périphériques du regroupement dans un périphérique multipath. Vous pouvez mettre sur liste noire les appareils utilisant l'un des identifiants suivants. Utilisez les mêmes identifiants dans la section blacklist_exceptions.
- WWID
- Nom de l'appareil :Utilisez le mot-clé devnode.
- Type d'appareil :Utilisez la sous-section de l'appareil.
Section multipaths dans /etc/multipath.conf
Vous trouverez ci-dessous un exemple de multichemins section du fichier /etc/multipath.conf.
multipaths {
multipath {
wwid 3600508b4000156d700012000000b0000
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
}
} Définissez les attributs dans la section multipaths du fichier de configuration pour chaque périphérique multipath individuel. Ces attributs s'appliquent à un chemin multiple spécifié et remplacent les attributs définis dans les sections par défaut et appareils.
La section des exemples de chemins multiples ci-dessus montre les paramètres qui remplacent les paramètres par défaut de restauration et de no_path_retry pour le premier WWID et définissent des alias pour les deux WWID. Les valeurs valides pour l'attribut no_path_retry sont :
- [n] - Le nombre de tentatives jusqu'à ce que le multipath arrête la file d'attente et échoue le chemin
- échec – Spécifie un échec immédiat (pas de file d'attente)
- file d'attente – Ne jamais arrêter de faire la queue (faire la queue pour toujours jusqu'à ce que le chemin s'anime)
Section appareils dans /etc/multipath.conf
Vous trouverez ci-dessous un exemple d'appareils section du fichier /etc/multipath.conf.
devices {
device {
vendor "COMPAQ "
product "HSV110 (C)COMPAQ"
path_grouping_policy multibus
path_checker readsector0
path_selector "round-robin 0"
hardware_handler "0"
failback 15
rr_weight priorities
no_path_retry queue
}
device {
vendor "COMPAQ "
product "MSA1000 "
path_grouping_policy multibus
}
} DM-Multipath inclut la prise en charge des baies de stockage les plus courantes. Exécutez l'une des commandes suivantes pour afficher les informations sur les appareils pris en charge :
# multipathd show config # multipath –t
Pour ajouter un périphérique de stockage qui n'est pas pris en charge par défaut, obtenez les informations sur le fournisseur, le produit et la révision du système de fichiers sysfs pour le périphérique de stockage et ajoutez-les au fichier /etc/multipath.conf. Consultez les fichiers suivants pour obtenir ces informations :
- /sys/block/device_name/device/vendor – Informations sur le fournisseur
- /sys/block/device_name/device/model – Informations sur le produit
- /sys/block/device_name/device/rev – Informations de révision