\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{mer. oct. 12 14:06:24 CEST 2016}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={multipath.conf},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Fichier de configuration pour multipath},
CreationDate={D:20161012140624},
ModDate={D:20161012140624},
Keywords={raid;storages;Haute Disponibilité}
}}
\begin{document}
 
\begin{center}
{\Huge multipath.conf }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Fichier de configuration pour multipath}
 
\vspace{10mm}
 
\hspace{1mm}  Chaque section contient un ou plusieurs attributs ou sous-sections. Les mots clé reconnus pour les attributs ou sous-sections dépendent de la section dans laquelle elles se trouvent. Les sections suivantes sont reconnues:
\vspace{5mm} \\
 
 
\begin{description} \normalsize
\item[\hspace{6mm} defaults]{Cette section définis les valeurs par défaut pour les attributs qui sont utilisé quand aucune valeur n'est donnée dans le périphérique approprié ou de nom de section}
\item[\hspace{6mm} blacklist]{Définis quels périphériques devraient être exclus de la découverte de topologie multipath}
\item[\hspace{6mm} blacklist\_exceptions]{Définis quels périphérique devraient être inclus dans la découverte de topologie multipath, même s'ils sont listés dans la section blacklist}
\item[\hspace{6mm} multipaths]{Définis les topologies multipath. Elles sont indexées par un WWID (Word Wide Identifier)}
\item[\hspace{6mm} devices]{Définis les paramètres spécifique à un périphérique}
\item[\hspace{6mm} overrides]{Définis les valeurs pour les attributs qui devraient remplacer les paramèters spécifique au périphérique pour tous les périphériques}
\end{description}
 
\vspace{1cm}{\huge Section defaults }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} verbosity]{Niveau de verbosité. (de 0 à 6, défaut: 2)}
\item[\hspace{1mm} polling\_interval]{Interval entre 2 vérifications de chemin, en seconde. Pour un fonctionnement correcte, l'interval entre les vérifications augmente graduellement jusqu'à max\_polling\_interval. Cette valeur sera remplacée par le paramètre WatchdogSec dans multipathd.service si systemd est utilisé. (défaut: 5).}
\item[\hspace{1mm} max\_polling\_interval]{Interval maximum entre 2 vérifications de chemin, en secondes. Défaut: 4 * polling\_interval}
\item[\hspace{1mm} reassign\_maps]{Active le réassignement des mappages device-mapper. Avec cette option, multipathd remap les mappages DM pour continuellement pointer vers un périphérique multiple, et non les périphériques block sous-jacent. Défaut: no}
\item[\hspace{1mm} multipath\_dir]{Répertoire où les objets partagés sont stockés. Défaut: /lib[64]/multipath/}
\item[\hspace{1mm} path\_selector]{Chemin par défaut pour l'algorithme à utiliser. Généralement offert par le kernel:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} round-robin 0]{Boucle tout chemin dans le groupe de chemin, envoyant la même quantité d'E/S dans chaque}
\item[\hspace{6mm} queue-length 0]{Envoie le prochain pool d'E/S sur le chemin ayant le moins de traitement E/S en cours}
\item[\hspace{6mm} service-time 0]{Choisi le chemin pour le prochain pool d'E/S basé sur sur la quantité de traitement d'E/S dans le chemin et sa bande passante relative.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} path\_grouping\_policy]{Stratégie de groupement de chemin par défaut à appliquer aux multipaths non-spécifiés:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} failover]{On chemin par groupe de priorité}
\item[\hspace{6mm} multibus]{Tous les chemins dans un groupe de priorité}
\item[\hspace{6mm} group\_by\_serial]{Un groupe de priorité par numéro de série}
\item[\hspace{6mm} group\_by\_prio]{Un groupe de priorité par valeur de priorité.}
\item[\hspace{6mm} group\_by\_node\_name]{Un groupe de priorité par nom de nœud cible}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} uid\_attribute]{Attribut udev fournissant un identifiant unique de chemin}
\item[\hspace{1mm} prio]{Le nom de la routine de priorité de chemin. La routine spécifiée devrait retourner une valeur numérique spécifiant la priorité relative de ce chemin. Actuellement, les routines suivantes sont implémentées:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} const]{Retourne une priorité constante de 1}
\item[\hspace{6mm} sysfs]{Utilise les attributs sysfs access\_state et preferred\_path pour générer la priorité de chemin. Accepte l'option exclusive\_pref\_bit}
\item[\hspace{6mm} emc]{dépendant du hardware. Génère la priorité de chemin pour les array de classe DGC}
\item[\hspace{6mm} alua]{dépendant du hardware. Génère la priorité de chemin basé sur les paramètres SCSI-3 ALUA}
\item[\hspace{6mm} ontap]{dépendant du hardware. Génère la priorité de chemin pour la classe RDAC LSI/Engenio/NetApp}
\item[\hspace{6mm} hp\_sw]{dépendant du hardware. Génère la priorité de chemin pour les arrays HP/COMPAQ/DEC HSG80 et MSA/HSV}
\item[\hspace{6mm} hds]{dépendant du hardware. Génère la priorité de chemin pour les arrays Hitachi HDS Modular}
\item[\hspace{6mm} random]{Génération aléatoire entre 1 et 10}
\item[\hspace{6mm} weightedpath]{Génère la priorité de chemin basé sur l'expression régulière et la priorité fournie come argument nécessite prio\_args}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} prio\_args]{Arguments à passer à la fonction prio}
\item[\hspace{1mm} features]{Spécifie des fonctionnalités device-mapper à utiliser. La syntaxe est \textbf{num list} ou num est le numéro, entre 0 et 6, des fonctionnalités dans list. Les valeurs possible pour liste sont:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} queue\_if\_no\_path]{Met en queue si aucun chemin n'est actif}
\item[\hspace{6mm} no\_partitions]{Désactive la génération de partitions automatique via kpartx}
\item[\hspace{6mm} pg\_init\_retries]{Nombre de retentatives pg\_init, doit être entre 1 et 50}
\item[\hspace{6mm} pg\_init\_delay\_msecs]{Nombre de secondes avant une retentative pg\_init, doit être entre 0 et 60000}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} path\_checker]{Méthode par défaut à utiliser pour déterminer les états de chemin. Les valeurs possibles sont:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} tur]{Émet une commande TEST UNIT READY au périphérique}
\item[\hspace{6mm} emc\_clarification]{dépendant du hardware. requête la page spécifique EVPD 0xC0 DGC/EMC pour déterminer l'état de chemin pour les arrays CLARiiON CX/AX et EMC VNX}
\item[\hspace{6mm} hp\_sw]{dépendant du hardware. Vérifie l'état de chemin pour les arrays HP/COMPAQ/DEC HSG80 et MSA/HSV}
\item[\hspace{6mm} rdac]{dépendant du hardware. Vérifie l'état de chemin pour la classe RDAC LSI/Engenio/NetApp}
\item[\hspace{6mm} cciss\_tur]{dépendant du hardware. Vérifie l'état de chemin pour les contrôleurs HP/COMPAQ Smart Array(CCISS)}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} alias\_prefix]{Préfix user\_friendly. Défaut: mpath}
\item[\hspace{1mm} failback]{Indique comment gérer les erreurs de groupe de chemin:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} immediate]{failback immédiatement au chemin du groupe à la priorité la plus élevée qui contient des chemins actifs.}
\item[\hspace{6mm} manual]{N'effectue pas de failback automatique}
\item[\hspace{6mm} followover]{N'effectue un failback automatique quand quand le premier chemin d'un pathgroup devient actif. Cela permet d'empêcher un nœud d'être rejeté quand un autre nœud demande le failover}
\item[\hspace{6mm} values > 0]{Défère le failback (temps en secondes)}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} rr\_min\_io]{Nombre d'E/S à route dans le chemin avant de basculer dans le suivant dans le même groupe de chemin. Uniquement pour le multipath basé sur BIO. Défaut: 1000}
\item[\hspace{1mm} rr\_min\_io\_rq]{Nombre de requêtes d'E/S à router vers un chemin avant de basculer vers le suivant dans le même groupe de chemin. Uniquement pour les requêtes basées sur multipath. Défaut: 1}
\item[\hspace{1mm} max\_fds]{Nombre maximum de descripteurs de fichier qui peuvent être ouverts par multipath et multipathd. 'max' prend la valeur dans /proc/sys/fs/nr\_open. Si non définis, utilise open\_fds du processus appelant. généralement 1024. Pour plus de sécurité devrait être le nombre max de chemins + 32, si ce nombre est supérieur à 1024. Défaut: max}
\item[\hspace{1mm} rr\_weight]{à priorities, le configurateur multipath assigne un poid de chemin tel que "path prio * rr\_min\_io". peut être priorities ou uniform}
\item[\hspace{1mm} no\_path\_retry]{Spécifie le nombre de retentatives jusqu'à désactiver la queue, ou fail pour échouer immédiatement. queue ne stop jamais la queue. Si non définis, aucune queue n'est tentée}
\item[\hspace{1mm} queue\_without\_daemon]{à no, quand multipathd stoppe, la queue est désactivée pour tous les périphériques. Utile pour les périphériques qui définissent no\_path\_retry. Si une machine s'éteint alors que tous les chemins sont down, il est possible de bloquer en attende d'E/S du périphérique après que multipathd ai été stoppé. Sans multipathd, l'accès aux chemins ne peut être restauré, et le kernel ne peut pas indiquer de stopper la queue. Défaut: no}
\item[\hspace{1mm} checker\_timeout]{Spécifie le timeout à utiliser pour la vérification de chemin et es prioritiseurs qui émettent des commandes SCSI avec un timeout explicit. Défaut: /sys/block/sd<x>/device/timeout}
\item[\hspace{1mm} flush\_on\_last\_del]{À yes, multipathd désactive la queue quand le dernier chemin vers un périphérique a été supprimé. Défaut: no}
\item[\hspace{1mm} user\_friendly\_names]{À yes, en utilisant le fichier /etc/multipath/bindings pour assigner de manière persistante et unique un alias au multipath, sous la forme mpath<n>. À no, utilise le wwid comme alias.}
\item[\hspace{1mm} fast\_io\_fail\_tmo]{Nombre de secondes d'attente de la couche SCSI après qu'un problème ait été détecté sur un port distant FO avant d'échouer les E/S sur ce port. Devrait être inférieur à dev\_loss\_tmo. Défaut: 5}
\item[\hspace{1mm} dev\_loss\_tmo]{Nombre de secondes d'attente de la couche SCSI après qu'un problème ait été détecté sur un port distant FO avant de le supprimer du système. 'infinity' définis à la valeur max (2147483647 secondes, ou 68ans). Il sera automatiquement ajusté à l'interval no\_path\_retry addentry articles autoadd autofind autoprod createalpha createbeta createdb createprod findentry fullpowa generator.php genhtml genman genmd gentex html insert man md pdf regen setfor setfor2 sql temp temp-new-pc tex threads ToDo polling\_interval si un nombre de tentatives est donné dans no\_path\_retry et que l'interval de retentative qlobal est supérieur à dev\_loss\_tmo. Linux définis cette valeur à 300 si fast\_io\_fail\_tmo n'est pas définis. Défaut: 600}
\item[\hspace{1mm} bindings\_file]{Chemin complet du fichier binding à utiliser quand l'option user\_friendly\_names est définis.}
\item[\hspace{1mm} wwids\_file]{Chemin complet du fichier eds WWID, utilisé pour garder une trace des WWID pour les LUN qui ont été créés dans le passé}
\item[\hspace{1mm} log\_checker\_err]{À 'once', multipathd log la première erreur de vérification de chemin au niveau 2, et les autres erreur au niveau 3 jusqu'à ce que le périphérique soit restauré. À 'always', multipathd logs toujours au niveau 2}
\item[\hspace{1mm} reservation\_key]{Clé de réservation d'action du service utilisé par mpathpersist. Il doit être définis pour tous les périphériques multipath utilisant les réservation persistantes, et doit être identique au champ RESERVATION KEY du paramètre PERSISTENT RESERVE OUT.}
\item[\hspace{1mm} retain\_attached\_hw\_handler]{À yes, si la couche SCSI a déjà attaché un hardware\_handler au périphérique multipath, multipath ne force pas le périphérique à utiliser celui spécifié dans ce fichier de configuration. Défaut: yes}
\item[\hspace{1mm} detect\_prio]{À yes, multipath tente de détecter si le périphérique supporte SCSI-3 ALUA. Si c'est le cas, le périphérique utilisera automatiquement le prioritizer sysfs si les attributs access\_state et preferred\_path sont supportés, ou le prioritiseur alua le cas échéant.}
\item[\hspace{1mm} force\_sync]{À yes, multipathd Vérifie les chemin en mode sync uniquement. Cela signifie que seul un vérificateur tourne à la fois, utile quand les vérificateurs tournant en parallèle créent une surchage CPU.}
\item[\hspace{1mm} strict\_timinig]{À yes, multipathd démarre une nouvelle boucle de vérification de chemin après exactement 1 seconde, pour que chaque vérification de chemin se produise exactement à polling\_interval secondes. Si les systèmes surchargés, les vérification peuvent prendre plus d'une seconde}
\item[\hspace{1mm} deferred\_remove]{À yes, multipathd déferre la suppresion au lieu d'une suppression régulière quand le dernier chemin a été supprimé. Cela signifie que si le périphérique continue à être utilisé, il sera libéré quand le dernier utilisateur le fermera.}
\item[\hspace{1mm} partition\_delimiter]{Non définis, quand multipath renomme un périphérique, il agit simplement comme kpartx. ajoute seulement un 'p' aux noms se terminant dans un nombre. Si définis, multipath agit comme "kpartix -p" et ajoute toujours un délimiteur}
\item[\hspace{1mm} config\_dir]{Si définis, multipath recherche dans ce répertoire pour des fichiers .conf, et y lit les informations de configuration, tout comme /etc/multipath.conf.}
\item[\hspace{1mm} delay\_watch\_checks]{> 0, multipathd recherche les chemins qui sont devenus récemment valides durant ce délai.}
\item[\hspace{1mm} delay\_wait\_checks]{> 0, quand un périphérique qui est récemment revenu online échoue de nouveau dans le délai delay\_watch\_checks, la prochaine fois qu'il revient online il sera marqué et retardé, et ne sera pas utilisé jusqu'à ce qu'il ait passé ces vérification}
\item[\hspace{1mm} find\_multipaths]{À yes, au lieu de tenter de créer un périphérique multipath pour chaque chemin non-blacklisté, multipath créé seulement un périphérique si une des 3 conditions sont rencontrées: 1) il y a au moins 2 chemins non-blacklistés avec le même WWID, 2) l'utilisateur force manuellement la création en spécifinat un périphérique avec la commande multipath, ou 3) un chemin a le même wwid précédemment créé. Défaut: no}
\item[\hspace{1mm} uxsock\_timeout]{timeout CLI reçu en ms. Défaut: 1000}
\item[\hspace{1mm} retrigger\_tries]{Nombre de fois que multipathd tente de gérer un uevent pour obtenir le WWID. Défaut: 3}
\item[\hspace{1mm} retrigger\_delay]{Définis le délai, en secondes, d'attente entre les triggers. Défaut: 10}
\item[\hspace{1mm} missing\_uev\_wait\_timeout]{Contrôle le délai d'attente de multipathd après qu'un nouveau périphérique multipath soit créé, pour reçevoir un évènement de changement de udev pour ce périphérique, avant d'activer automatiquement les reloads de périphérique. Défaut: 30}
\end{description}
 
\vspace{1cm}{\huge Section blacklist }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} devnode]{expression régulière des périphériques à exclure}
\item[\hspace{1mm} wwid]{Le wwid d'un périphérique}
\item[\hspace{1mm} property]{Expression régulière d'une propriété udev à exclure}
\item[\hspace{1mm} device]{Sous-section pour la description d'un périphérique. Accepte les mots-clé vendor et product}
\end{description}
 
\vspace{1cm}{\huge Section blacklist }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} devnode]{expression régulière des périphériques à inclure}
\item[\hspace{1mm} wwid]{Le wwid d'un périphérique}
\item[\hspace{1mm} property]{Expression régulière d'une propriété udev à inclure}
\item[\hspace{1mm} device]{Sous-section pour la description d'un périphérique. Accepte les mots-clé vendor et product}
\end{description}
 
\vspace{1cm}{\huge Section multipaths }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} multipath]{Sous-section décrivant un multipath}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} wwid]{Index du conteneur}
\item[\hspace{6mm} alias]{nom symbolique pour le mappage multipath}
\item[\hspace{6mm} path\_grouping\_policy]{}
\item[\hspace{6mm} path\_selector]{}
\item[\hspace{6mm} prio]{}
\item[\hspace{6mm} prio\_args]{}
\item[\hspace{6mm} failback]{}
\item[\hspace{6mm} rr\_weight]{}
\item[\hspace{6mm} no\_path\_retry]{}
\item[\hspace{6mm} rr\_min\_io]{}
\item[\hspace{6mm} rr\_min\_io\_rq]{}
\item[\hspace{6mm} flush\_on\_last\_del]{}
\item[\hspace{6mm} features]{}
\item[\hspace{6mm} reservation\_key]{}
\item[\hspace{6mm} user\_friendly\_names]{}
\item[\hspace{6mm} deferred\_remove]{}
\item[\hspace{6mm} delay\_watch\_checks]{}
\item[\hspace{6mm} delay\_wait\_checks]{Identiques à la section defaults}
\end{description}
 
\vspace{1cm}{\huge Section devices }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} device]{Sous-section décrivant un périphérique}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} vendor]{Identifiant de vendeur}
\item[\hspace{6mm} product]{Identifiant de produit}
\item[\hspace{6mm} revision]{Identifiant de révision}
\item[\hspace{6mm} product\_blacklist]{Chaîne à blacklister pour ce vendeur}
\item[\hspace{6mm} alias\_prefix]{Préfix user\_friendly à utiliser pour ce type de périphérique}
\item[\hspace{6mm} hardware\_handler]{hardware handler à utiliser pour ce type de périphérique:}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{12mm} emc]{DGC class arrays as CLARiiON CX/AX and EMC VNX}
\item[\hspace{12mm} rdac]{LSI/Engenio/NetApp RDAC class}
\item[\hspace{12mm} hp\_sw]{HP/COMPAQ/DEC HSG80 and MSA/HSV arrays}
\item[\hspace{12mm} alua]{SCSI-3 ALUA compatible arrays}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} path\_grouping\_policy]{}
\item[\hspace{6mm} uid\_attribute]{}
\item[\hspace{6mm} path\_selector]{}
\item[\hspace{6mm} path\_checker]{}
\item[\hspace{6mm} prio]{}
\item[\hspace{6mm} prio\_args]{}
\item[\hspace{6mm} features]{}
\item[\hspace{6mm} failback]{}
\item[\hspace{6mm} rr\_weight]{}
\item[\hspace{6mm} no\_path\_retry]{}
\item[\hspace{6mm} rr\_min\_io]{}
\item[\hspace{6mm} rr\_min\_io\_rq]{}
\item[\hspace{6mm} fast\_io\_fail\_tmo]{}
\item[\hspace{6mm} dev\_loss\_tmo]{}
\item[\hspace{6mm} flush\_on\_last\_del]{}
\item[\hspace{6mm} retain\_attached\_hw\_handler]{}
\item[\hspace{6mm} detect\_prio]{}
\item[\hspace{6mm} deferred\_remove]{}
\item[\hspace{6mm} delay\_watch\_checks]{}
\item[\hspace{6mm} delay\_wait\_checks]{Options identiques à la section defaults}
\end{description}
 
\vspace{1cm}{\huge Section overrides }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} path\_grouping\_policy]{}
\item[\hspace{1mm} uid\_attribute]{}
\item[\hspace{1mm} getuid\_callout]{}
\item[\hspace{1mm} path\_selector]{}
\item[\hspace{1mm} path\_checker]{}
\item[\hspace{1mm} alias\_prefix]{}
\item[\hspace{1mm} features]{}
\item[\hspace{1mm} prio]{}
\item[\hspace{1mm} prio\_args]{}
\item[\hspace{1mm} failback]{}
\item[\hspace{1mm} rr\_weight]{}
\item[\hspace{1mm} no\_path\_retry]{}
\item[\hspace{1mm} rr\_min\_io]{}
\item[\hspace{1mm} rr\_min\_io\_rq]{}
\item[\hspace{1mm} flush\_on\_last\_del]{}
\item[\hspace{1mm} fast\_io\_fail\_tmo]{}
\item[\hspace{1mm} dev\_loss\_tmo]{}
\item[\hspace{1mm} user\_friendly\_names]{}
\item[\hspace{1mm} retain\_attached\_hw\_handler]{}
\item[\hspace{1mm} detect\_prio]{}
\item[\hspace{1mm} deferred\_remove]{}
\item[\hspace{1mm} delay\_watch\_checks]{}
\item[\hspace{1mm} delay\_wait\_checks]{Options identiques à la section devices ou defaults}
\end{description}
\end{flushleft}
\end{document}
