Il file di configurazione principale per DM-Multipath è /etc/multipath.conf . Questo file non viene creato dall'installazione iniziale del pacchetto RPM. Tuttavia, il seguente file è installato in /usr/share/doc/device-mapper-multipath-[version] directory:
- multipath.conf – File di configurazione di base con alcuni esempi per DM-Multipath. Questo file viene utilizzato per creare il file /etc/multipath.conf.
Il file multipath.conf contiene le seguenti sezioni e ogni sezione contiene uno o più attributi o sottosezioni.
Sezione | Descrizione |
---|---|
predefiniti | Definisce le impostazioni predefinite per DM-Multipath. Queste impostazioni possono essere sovrascritte dalle sezioni dispositivi e percorsi multipli. |
lista nera | Definisce i dispositivi da escludere dal rilevamento della topologia multipath. I dispositivi inseriti nella lista nera non sono raggruppati in un dispositivo multipath. |
blacklist_eccezioni | Definisce i dispositivi da includere nel rilevamento della topologia multipath, anche se i dispositivi sono elencati nella sezione blacklist. |
multipercorsi | Definisce le impostazioni per i singoli dispositivi multipath. I dispositivi sono identificati dalla parola chiave wwid. Le impostazioni in questa sezione hanno la massima priorità. |
dispositivi | Definisce le impostazioni per i singoli tipi di controller di archiviazione. I tipi di controller sono identificati da parole chiave fornitore, prodotto e revisione, che devono corrispondere alle informazioni sysfs sul dispositivo. |
Attributi predefiniti in /etc/multipath.conf
Di seguito è riportata una sezione di default di esempio dal file /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 }
Un elenco parziale degli attributi definiti nella sezione defaults del file di configurazione è il seguente:
- udev_dir – Directory in cui udev crea i nodi del dispositivo. L'impostazione predefinita è /dev.
- polling_interval – Intervallo in secondi di verifica dei percorsi. Il valore predefinito è 5 secondi.
- selettore_percorso – Uno dei seguenti algoritmi di selezione del percorso da utilizzare:
- round-robin 0 :scorre ogni percorso inviando la stessa quantità di I/O a ciascuno. Questa è l'impostazione predefinita.
- lunghezza coda 0 :invia I/O lungo un percorso con la quantità minima di I/O in sospeso.
- tempo di servizio 0 :invia I/O lungo un percorso in base alla quantità di I/O in sospeso e al relativo throughput.
- politica_di_raggruppamento_percorso – I percorsi sono raggruppati in gruppi di percorsi. Il criterio determina come vengono formati i gruppi di percorsi. Esistono cinque diverse politiche.
- failover :un percorso per gruppo prioritario
- multibus :Tutti i percorsi in un gruppo di priorità. Questa è l'impostazione predefinita.
- gruppo_per_seriale :un gruppo di priorità per controller di archiviazione (numero di serie)
- gruppo_per_prio :un gruppo di priorità per valore di priorità
- group_by_node_name :un gruppo di priorità per nome del nodo di destinazione
- prio – Viene utilizzato uno dei seguenti metodi per ottenere un valore di priorità del percorso:
- cost – Impostare una priorità di uno su tutti i percorsi. Questa è l'impostazione predefinita.
- ecc – Genera la priorità del percorso per gli storage array EMC.
- alua – Generare la priorità del percorso in base alle impostazioni di SCSI-3 Asymmetric Logical Unit Access (ALUA). ALUA consente a un dispositivo di segnalare lo stato delle sue porte agli host. Questo stato viene utilizzato dagli host per stabilire la priorità dei percorsi e prendere decisioni di failover e bilanciamento del carico.
- tpg_pref – Genera la priorità del percorso in base alle impostazioni SCSI-3 ALUA, utilizzando il bit della porta preferito.
- attiva – Genera la priorità del percorso per gli storage array NetApp.
- rdac – Generare la priorità del percorso per LSI/Engenio/NetApp E-Series Redundant Disk Array Controller (RDAC).
- hp_sw – Genera la priorità del percorso per il controller Compaq/HP in modalità Attivo/Standby.
- HD – Genera la priorità del percorso per il controller Hitachi HDS Compaq/HP in modalità attiva/standby.
- controllo_percorso – Uno dei seguenti è il metodo utilizzato per determinare lo stato dei percorsi:
- settore di lettura0 – Leggi il primo settore del dispositivo. Questa è l'impostazione predefinita.
- tur – Inviare un comando Test Unit Ready (TUR) al dispositivo.
- emc_clarrion – Interrogare la pagina EVPD specifica di EMC CLARiiON 0xC0 per determinare lo stato del percorso.
- hp_sw – Verificare lo stato del percorso per gli storage array HP con il firmware Active/Standby.
- rdac – Verificare lo stato del percorso per LSI/Engenio/NetApp E-Series RDAC.
- direzione – Leggi il primo settore con I/O diretto.
- rr_min_io – Il numero di I/O da instradare a un percorso prima di passare al percorso successivo nello stesso gruppo di percorsi. Questo è per i sistemi che eseguono kernel precedenti alla 2.6.31. I sistemi più recenti usano rr_min_io_rq. Il valore predefinito è 1000.
- max_fds – Il numero massimo di descrittori di file che possono essere aperti da multipath e multipathd
- rr_weight – Il peso del percorso. I valori possibili sono prioritari o uniformi.
- Failback – Viene utilizzato uno dei seguenti metodi per gestire il failback del gruppo di percorsi:
- immediato – Fai tornare immediatamente al gruppo di percorsi con priorità più alta che contiene percorsi attivi.
- manuale – Non eseguire il failback automatico.
- seguente – Esegui il failback automatico solo quando il primo percorso di un gruppo di percorsi diventa attivo.
- valori> 0 – Indica il tempo per rinviare il failback in secondi.
Sezione blacklist in /etc/multipath.conf
Di seguito è riportato un esempio di lista nera sezione dal file /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" } }
Utilizzare la sezione blacklist nel file /etc/multipath.conf per escludere i dispositivi dal raggruppamento in un dispositivo multipath. Puoi inserire nella blacklist i dispositivi utilizzando uno dei seguenti identificatori. Usa gli stessi identificatori nella sezione blacklist_exceptions.
- WWID
- Nome dispositivo :usa la parola chiave devnode.
- Tipo di dispositivo :usa la sottosezione del dispositivo.
Sezione multipath in /etc/multipath.conf
Di seguito è riportato un esempio di percorsi multipli sezione dal file /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 } }
Impostare gli attributi nella sezione multipaths del file di configurazione per ogni singolo dispositivo multipath. Questi attributi si applicano a un multipath specificato e sostituiscono gli attributi impostati nelle sezioni dei dispositivi e dei valori predefiniti.
La sezione multipath di esempio sopra mostra le impostazioni che sovrascrivono le impostazioni predefinite di failback e no_path_retry per il primo WWID e impostano alias per entrambi i WWID. I valori validi per l'attributo no_path_retry sono:
- [n] – Il numero di tentativi fino a quando multipath interrompe l'accodamento e non riesce il percorso
- fallire – Specifica un errore immediato (nessuna coda)
- coda – Non smettere mai di fare la coda (fai la coda per sempre finché il percorso non prende vita)
Sezione dispositivi in /etc/multipath.conf
Di seguito è riportato un esempio di dispositivi sezione dal file /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 include il supporto per gli storage array più comuni. Esegui uno dei seguenti comandi per visualizzare le informazioni sui dispositivi supportati:
# multipathd show config # multipath –t
Per aggiungere un dispositivo di archiviazione che non è supportato per impostazione predefinita, ottenere le informazioni sul fornitore, sul prodotto e sulla revisione dal file system sysfs per il dispositivo di archiviazione e aggiungerlo al file /etc/multipath.conf. Visualizza i seguenti file per ottenere queste informazioni:
- /sys/block/device_name/device/vendor – Informazioni sul venditore
- /sys/block/device_name/device/model – Informazioni sul prodotto
- /sys/block/device_name/device/rev – Informazioni sulla revisione