A seguir estão os poucos exemplos de configuração DM Multipath:

1.1.1. Configuração multipista ativa/passiva com um dispositivo RAID

Nesta configuração, há dois Adaptadores Host Bus (HBAs) no servidor, dois switches SAN, e dois controladores RAID. A seguir estão as possíveis falhas nesta configuração:

• Falha na HBA
• Falha do cabo de Fibre Channel
• Falha do interruptor SAN
• Falha na porta do controlador de matriz

Com DM Multipath configurado, uma falha em qualquer um destes pontos faz com que DM Multipath mude para o caminho de E/S alternativo. Figura 1.1, “Configuração multipista ativa/passiva com um dispositivo RAID” descreve a configuração com dois caminhos de E/S do servidor para um dispositivo RAID. Aqui, há um caminho de E/S que passa por hba1, SAN1, e cntrlr1 e um segundo caminho de E/S que passa por hba2, SAN2, e cntrlr2.

Figura 1.1. Configuração multipista ativa/passiva com um dispositivo RAID

1.1.2. Configuração multipath ativo/passivo com dois dispositivos RAID

Nesta configuração, há dois HBAs no servidor, dois switches SAN, e dois dispositivos RAID com dois controladores RAID cada um. Com DM Multipath configurado, uma falha em qualquer um dos pontos do caminho de E/S para qualquer um dos dispositivos RAID faz com que DM Multipath mude para o caminho de E/S alternativo para aquele dispositivo. Figura 1.2, “Configuração multipista ativa/passiva com dois dispositivos RAID” descreve a configuração com dois caminhos de E/S para cada dispositivo RAID. Aqui, há dois caminhos de E/S para cada dispositivo RAID.

Figura 1.2. Configuração multipista ativa/passiva com dois dispositivos RAID

1.1.3. Configuração multipath ativa/ativa com um dispositivo RAID

Nesta configuração, há dois HBAs no servidor, dois switches SAN e dois controladores RAID. Figura 1.3, “Configuração multipath ativa/ativa com um dispositivo RAID” descreve a configuração com dois caminhos de E/S do servidor para um dispositivo de armazenamento. Aqui, as E/S podem ser distribuídas entre estes dois caminhos.

Figura 1.3. Configuração multipath ativa/ativa com um dispositivo RAID

Tabela 1.1, “Componentes do DM Multipath” descreve os componentes DM Multipath.

Quando novos dispositivos estão sob o controle da DM Multipath, esses dispositivos são criados no diretório /dev/mapper/ e /dev/. Quaisquer dispositivos do formulário /dev/dm-X são apenas para uso interno e nunca devem ser usados diretamente pelo administrador.

Nomes de dispositivos multicaminhos:

Por exemplo, um nó com dois HBAs ligados a um controlador de armazenamento com duas portas por meio de um único interruptor FC sem zonagem vê quatro dispositivos: /dev/sda, /dev/sdb, /dev/sdc e /dev/sdd. DM Multipath cria um único dispositivo com um único WWID que redireciona E/S para esses quatro dispositivos subjacentes de acordo com a configuração multipath.

Além das opções user_friendly_names e alias, um dispositivo multicaminhos também possui outros atributos. Você pode modificar esses atributos para um dispositivo multicaminhos específico criando uma entrada para esse dispositivo na seção multipaths do arquivo /etc/multipath.conf.

Depois de criar dispositivos multicaminhos, você pode usar os nomes dos dispositivos multicaminhos assim como usaria um nome de dispositivo físico ao criar um volume físico LVM. Por exemplo, se /dev/mapper/mpatha for o nome de um dispositivo multicaminhos, o comando pvcreate /dev/mapper/mpatha marca /dev/mapper/mpatha como um volume físico.

Você pode usar o dispositivo físico LVM resultante quando você cria um grupo de volume LVM da mesma forma que usaria qualquer outro dispositivo físico LVM.

Quando você cria um volume lógico LVM que usa active/passive matrizes multicaminhos como os dispositivos físicos subjacentes, você pode opcionalmente, incluir filtros no arquivo /etc/lvm/lvm.conf para excluir os discos que sublinham os dispositivos multicaminhos. Isto porque se o array muda automaticamente o caminho ativo para o caminho passivo quando recebe E/S, o multipath irá falhar e failback sempre que o LVM varrer o caminho passivo se estes dispositivos não forem filtrados. Para os arrays active/passive que requerem um comando para tornar o caminho passivo ativo, o LVM imprime uma mensagem de aviso quando isto ocorre.

Para filtrar todos os dispositivos sd no arquivo /etc/lvm/lvm.conf, adicione o filter = [ "r/block/", "r/disk/", "r/sd./", "a/./" ] filtro na seção devices do arquivo.

Você criou o DM Multipath com o utilitário mpathconf, que cria o arquivo de configuração multipath /etc/multipath.conf.

Para mais informações sobre a utilidade mpathconf, consulte a página de manual mpathconf(8).

Se você não precisar editar o arquivo /etc/multipath.conf, você pode configurar o DM Multipath para uma configuração básica de failover, executando o seguinte comando mpathconf. Este comando habilita o arquivo de configuração multi-caminho e inicia o daemon multipathd.

# mpathconf --enable --with_multipathd y

Se você precisar editar o arquivo /etc/multipath.conf antes de iniciar o daemon multipathd. use o seguinte procedimento para configurar o DM Multipath para uma configuração básica de failover.

Algumas máquinas têm cartões SCSI locais para seus discos internos. O DM Multipath não é recomendado para estes dispositivos. Se você definir o parâmetro de configuração find_multipaths para on, você não deve ter que colocar estes dispositivos na lista negra. Se você não definir o parâmetro de configuração find_multipaths para on, você pode usar o seguinte procedimento para modificar o arquivo de configuração multipath para ignorar os discos locais ao configurar o multipath.

Por padrão, o DM Multipath inclui suporte para as matrizes de armazenamento mais comuns que suportam eles mesmos o DM Multipath. Para informações sobre o valor de configuração padrão, incluindo os dispositivos suportados, execute um dos seguintes comandos.

# multipathd show config
# multipath -t

Se você precisar adicionar um dispositivo de armazenamento que não seja suportado por padrão como um dispositivo multicaminhos conhecido, edite o arquivo /etc/multipath.conf e insira as informações apropriadas do dispositivo.

Por exemplo, para acrescentar informações sobre a série HP Open-V, a entrada se parece com isto. Este exemplo coloca o dispositivo em fila de espera por um minuto (ou 12 tentativas e 5 segundos por tentativa) depois de todos os caminhos terem falhado.

devices {
        device {
                vendor "HP"
                product "OPEN-V"
                no_path_retry 12
        }
}

Você pode configurar o multicaminhos no sistema de arquivos initramfs. Após configurar o multipath, você pode reconstruir o sistema de arquivos initramfs com os arquivos de configuração multipath executando o comando dracut com as seguintes opções:

# dracut --force --add multipath

Se você executar multipath a partir do sistema de arquivos initramfs e fizer quaisquer mudanças nos arquivos de configuração multipath, você deve reconstruir o sistema de arquivos initramfs para que as mudanças tenham efeito.

O arquivo de configuração multicaminhos está dividido nas seções seguintes:

Quando o sistema determina os atributos de um dispositivo multicaminhos, primeiro ele verifica as configurações de multicaminhos, depois as configurações dos dispositivos, depois os padrões do sistema multicaminhos.

A opção recovery_tmo sysfs controla o timeout de um determinado dispositivo iSCSI. As opções a seguir substituem globalmente os valores recovery_tmo:

A opção DM Multipath fast_io_fail_tmo tem precedência sobre replacement_timeout. A Red Hat não recomenda usar replacement_timeout para substituir recovery_tmo em dispositivos gerenciados pela DM Multipath porque a DM Multipath sempre reinicia recovery_tmo quando o serviço multipathd é recarregado.

A seção blacklist do arquivo de configuração multipath especifica os dispositivos que não serão usados quando o sistema configurar dispositivos multipath. Os dispositivos que estiverem na lista negra não serão agrupados em um dispositivo multicaminhos.

Se o parâmetro de configuração find_multipaths estiver definido para off, o multipath sempre tenta criar um dispositivo multipath para cada caminho que não esteja explicitamente na lista negra. Se o parâmetro de configuração find_multipaths for definido para on, então o multipath criará um dispositivo somente se uma das três condições for atendida:

Além de on e off, você também pode definir find_multipaths para os seguintes valores:

O valor padrão embutido de find_multipaths é off. O arquivo padrão multipath.conf criado por mpathconf, entretanto, definirá o valor de find_multipaths para on.

Para mais informações sobre os valores que você pode definir para find_multipaths, consulte a página de manual multipath.conf(5).

Com o parâmetro find_multipaths ajustado para on, você precisa colocar na lista negra apenas os dispositivos com caminhos múltiplos que não deseja que sejam multipathed. Por causa disso, geralmente não será necessário colocar os dispositivos na lista negra.

Se você precisar colocar dispositivos na lista negra, você pode colocar dispositivos na lista negra por WWID, nome do dispositivo, tipo de dispositivo, propriedade e protocolo. Para cada dispositivo, estes cinco critérios da lista negra são avaliados na ordem "propriedade, devnode, dispositivo, protocolo, wwid". Se um dispositivo for incluído na lista negra por qualquer critério, ele é excluído do manuseio por multipathd, e os critérios posteriores não são avaliados. Para cada critério, a lista branca tem precedência sobre a lista negra se um dispositivo corresponder a ambos.

Por padrão, uma variedade de tipos de dispositivos estão na lista negra, mesmo depois que você comenta a seção inicial da lista negra do arquivo de configuração. Para informações, veja Seção 4.3.2, “Colocação na lista negra por nome de dispositivo”.

blacklist {
       wwid 26353900f02796769
}

blacklist {
       devnode "^sd[a-z]"
}

blacklist {
       devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
       devnode "^(td|ha)d[a-z]"
}

blacklist {
       device {
               vendor  "IBM"
               product "3S42"       #DS4200 Product 10
       }
       device {
               vendor  "HP"
               product ".*"
       }
}

blacklist {
        property "ID_ATA"
}

blacklist {
        protocol "scsi:unspec"
        protocol "undef"
}

blacklist {
        wwid ".*"
}

blacklist_exceptions {
        wwid "3600d0230000000000e13955cc3757803"
}

blacklist_exceptions {
        property "(SCSI_IDENT_|ID_WWN)"
}

O arquivo de configuração /etc/multipath.conf inclui uma seção defaults que define o parâmetro user_friendly_names como yes, como segue.

defaults {
        user_friendly_names yes
}

Isto sobrescreve o valor padrão do parâmetro user_friendly_names.

O arquivo de configuração inclui um modelo de padrões de configuração. Esta seção é comentada da seguinte forma.

#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
#}

Para sobregravar o valor padrão de qualquer parâmetro de configuração, você pode copiar a linha relevante deste modelo para a seção defaults e descomentar. Por exemplo, para sobrescrever o parâmetro path_grouping_policy para que seja multibus ao invés do valor padrão de failover, copie a linha apropriada do modelo para a seção inicial defaults do arquivo de configuração, e descomente-o, como a seguir.

defaults {
        user_friendly_names     yes
        path_grouping_policy    multibus
}

Para informações sobre os atributos que estão definidos na seção defaults do arquivo de configuração multipath.conf, consulte a página de manual multipath.conf(5). Estes valores são usados pela DM Multipath a menos que sejam sobrescritos pelos atributos especificados nas seções devices, multipaths, ou overrides do arquivo multipath.conf.

Os atributos na seção multipaths do arquivo de configuração multipath.conf se aplicam somente ao multipath especificado. Estes padrões são usados pela DM Multipath e os atributos de substituição definidos nas seções overrides, defaults, e devices do arquivo multipath.conf.

Para informações sobre os atributos que estão definidos na seção multipaths do arquivo de configuração multipath.conf, consulte a página de manual multipath.conf(5).

O exemplo a seguir mostra atributos multicaminhos especificados no arquivo de configuração para dois dispositivos multicaminhos específicos. O primeiro dispositivo tem um WWID de 3600508b4000156d70001200000b0000 e um nome simbólico de yellow.

O segundo dispositivo multipath no exemplo tem uma WWID de 1DEC_321816758474 e um nome simbólico de red. Neste exemplo, os atributos rr_weight estão definidos para priorities.

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
        }
}

A seção devices do arquivo de configuração multipath.conf define atributos para dispositivos de armazenamento individuais. Estes atributos são usados pela DM Multipath a menos que sejam sobrescritos pelos atributos especificados nas seções multipaths ou overrides do arquivo multipath.conf para caminhos que contenham o dispositivo. Estes atributos substituem os atributos definidos na seção defaults do arquivo multipath.conf.

Para informações sobre os atributos que estão definidos na seção devices do arquivo de configuração multipath.conf, consulte a página de manual multipath.conf(5).

Muitos dispositivos que suportam multipathing estão incluídos por padrão em uma configuração multipathing. Para informações sobre o valor padrão da configuração, incluindo os dispositivos suportados, execute um dos seguintes comandos.

# multipathd show config
# multipath -t

Você provavelmente não precisará modificar os valores para estes dispositivos, mas se você fizer isso, você pode sobrescrever os valores padrão incluindo uma entrada no arquivo de configuração do dispositivo que sobrescreve estes valores. Você pode copiar os valores padrão de configuração do dispositivo que o comando multipathd show config exibe e sobrescrever os valores que você deseja modificar.

Para adicionar um dispositivo que não é configurado automaticamente por padrão a esta seção do arquivo de configuração, você precisa definir os parâmetros vendor e product. Você pode encontrar estes valores olhando para /sys/block/device_name/device/vendor e /sys/block/device_name/device/model onde device_name é o dispositivo a ser multipathed, como no exemplo a seguir:

# cat /sys/block/sda/device/vendor
WINSYS
# cat /sys/block/sda/device/model
SF2372

Os parâmetros adicionais a especificar dependem de seu dispositivo específico. Se o dispositivo estiver ativo/ativo, você normalmente não precisará definir parâmetros adicionais. Talvez você queira definir path_grouping_policy para multibus. Outros parâmetros que você talvez precise definir são no_path_retry e rr_min_io.

Se o dispositivo estiver ativo/passivo, mas muda automaticamente os caminhos com E/S para o caminho passivo, você precisa mudar a função de verificação para uma que não envie E/S para o caminho para testar se ele está funcionando (caso contrário, seu dispositivo continuará a falhar). Isto quase sempre significa que você configura o path_checker para tur; isto funciona para todos os dispositivos SCSI que suportam o comando Test Unit Ready, o que a maioria faz.

Se o dispositivo precisar de um comando especial para mudar os caminhos, então a configuração deste dispositivo para multicaminhos requer um módulo de kernel manipulador de hardware. O manipulador de hardware atualmente disponível é emc. Se isto não for suficiente para seu dispositivo, você pode não ser capaz de configurar o dispositivo para multipath.

O exemplo a seguir mostra uma entrada device no arquivo de configuração multipath.

#	}
#	device {
#		vendor			"COMPAQ  "
#		product			"MSA1000         "
#		path_grouping_policy	multibus
#		path_checker		tur
#		rr_weight		priorities
#	}
#}

A seção overrides do arquivo de configuração multipath.conf permite que você defina um valor de configuração para todos os seus dispositivos. Por exemplo, você pode querer que todos os dispositivos definam no_path_retry para fail. Esta seção suporta todos os atributos que são suportados pela seção devices e defaults do arquivo de configuração multipath.conf, que são todos os atributos da seção devices exceto vendor, product e revision. Estes atributos são usados pela DM Multipath para todos os dispositivos a menos que sejam sobrescritos pelos atributos especificados na seção multipaths do arquivo multipath.conf para caminhos que contenham o dispositivo. Estes atributos substituem os atributos especificados nas seções devices e defaults do arquivo multipath.conf.

Para informações sobre os atributos que estão definidos nas seções devices e defaults do arquivo de configuração multipath.conf, consulte a página de manual multipath.conf(5).

O comando multipath é usado para detectar e coalescer múltiplos caminhos para dispositivos. Ele oferece uma variedade de opções que você pode usar para administrar seus dispositivos multipathed.

Tabela 5.1, “Útil multipath Opções de comando” descreve algumas opções do comando multipath que você pode achar útil.

action_if_any: alias (wwid_if_different_from_alias) dm_device_name_if_known vendor,product size=size features='features' hwhandler='hardware_handler' wp=write_permission_if_known

- - policy='scheduling_policy' prio=prio_if_known status=path_group_status_if_known

 `- host:channel:id:lun devnode major:minor dm_status_if_known path_status online_status

3600d0230000000000e13955cc3757800 dm-1 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-+- policy='round-robin 0' prio=1 status=active
| `- 6:0:0:0 sdb 8:16  active ready  running
`-+- policy='round-robin 0' prio=1 status=enabled
  `- 7:0:0:0 sdf 8:80  active ready  running

# multipath -l
3600d0230000000000e13955cc3757800 dm-1 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-- policy='round-robin 0' prio=1 status=active
| `- 6:0:0:0 sdb 8:16  active ready  running
`-- policy='round-robin 0' prio=1 status=enabled
  `- 7:0:0:0 sdf 8:80  active ready  running

# multipath -ll
3600d0230000000000e13955cc3757801 dm-10 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-- policy='round-robin 0' prio=1 status=enabled
| `- 19:0:0:1 sdc 8:32  active ready  running
`-- policy='round-robin 0' prio=1 status=enabled
  `- 18:0:0:1 sdh 8:112 active ready  running
3600d0230000000000e13955cc3757803 dm-2 WINSYS,SF2372
size=125G features='0' hwhandler='0' wp=rw
`-+- policy='round-robin 0' prio=1 status=active
  |- 19:0:0:3 sde 8:64  active ready  running
  `- 18:0:0:3 sdj 8:144 active ready  running

Se você precisar redimensionar um dispositivo multipath online, use o seguinte procedimento.

Se você instalou seu sistema em um dispositivo de um único caminho e mais tarde adicionou outro caminho ao sistema de arquivos raiz, você precisará mover seu sistema de arquivos raiz para um dispositivo com vários caminhos. Esta seção documenta o procedimento para mover de um dispositivo de um único caminho para um dispositivo multi-percurso.

Depois de garantir que você tenha instalado o pacote device-mapper-multipath, execute o seguinte procedimento:

Por padrão, os dispositivos de troca são configurados como volumes lógicos. Isto não requer nenhum procedimento especial para configurá-los como dispositivos multicaminhos desde que você configure multicaminhos nos volumes físicos que constituem o grupo de volume lógico. Entretanto, se seu dispositivo swap não for um volume LVM, e for montado pelo nome do dispositivo, talvez seja necessário editar o arquivo /etc/fstab para mudar para o nome do dispositivo multipath apropriado.

Você pode usar o comando dmsetup para descobrir quais entradas de mapeadores de dispositivos correspondem aos dispositivos multipathed.

O seguinte comando exibe todos os dispositivos de mapeamento de dispositivos e seus números maiores e menores. Os números menores determinam o nome do dispositivo dm. Por exemplo, um número menor de 3 corresponde ao dispositivo multipathed /dev/dm-3.

# dmsetup ls
mpathd  (253:4)
mpathep1        (253:12)
mpathfp1        (253:11)
mpathb  (253:3)
mpathgp1        (253:14)
mpathhp1        (253:13)
mpatha  (253:2)
mpathh  (253:9)
mpathg  (253:8)
VolGroup00-LogVol01     (253:1)
mpathf  (253:7)
VolGroup00-LogVol00     (253:0)
mpathe  (253:6)
mpathbp1        (253:10)
mpathd  (253:5)

Os comandos multipathd podem ser usados para administrar o daemon multipathd. Para informações sobre os comandos disponíveis multipathd, consulte a página de manual multipathd(8).

O seguinte comando mostra o formato padrão padrão para a saída do comando multipathd show maps.

# multipathd show maps
name sysfs uuid
mpathc dm-0 360a98000324669436c2b45666c567942

Alguns comandos multipathd incluem uma opção format seguida por um wildcard. Você pode exibir uma lista de curingas disponíveis com o seguinte comando.

# multipathd show wildcards

O comando multipathd suporta comandos de formato que mostram o status de dispositivos multipath e caminhos em versões em formato "raw". No formato "raw", nenhum cabeçalho é impresso e os campos não são acolchoados para alinhar as colunas com os cabeçalhos. Em vez disso, os campos são impressos exatamente como especificado na cadeia de formato. Esta saída pode então ser mais facilmente utilizada para escrita de scripts. Você pode exibir os wildcards usados na cadeia de formato com o comando multipathd show wildcards.

Os seguintes comandos multipathd mostram os dispositivos multicaminhos que multipathd está monitorando, usando uma cadeia de formatos com wildcards multicaminhos, em formato regular e cru.

list|show maps|multipaths format $format
list|show maps|multipaths raw format $format

Os seguintes comandos multipathd mostram os caminhos que multipathd está monitorando, usando uma cadeia de formatos com wildcards multicaminhos, em formato regular e cru.

list|show paths format $format
list|show paths raw format $format

Os comandos a seguir mostram a diferença entre os formatos não-raw e raw para o multipathd show maps. Observe que no formato raw não há cabeçalhos e somente um único espaço entre as colunas.

# multipathd show maps format "%n %w %d %s"
name   uuid                              sysfs vend/prod/rev
mpathc 360a98000324669436c2b45666c567942 dm-0  NETAPP,LUN

# multipathd show maps raw format "%n %w %d %s"
mpathc 360a98000324669436c2b45666c567942 dm-0 NETAPP,LUN

Se você tiver a oportunidade de remover o arquivo device-mapper-multipath rpm ., observe que isto não remove os arquivos /etc/multipath.conf, /etc/multipath/bindings, e /etc/multipath/wwids. Talvez seja necessário remover esses arquivos manualmente em instalações subseqüentes do pacote device-mapper-multipath.

Diretiva não-resolvida em master.adoc - inclui::montagens/montagem_removimento-armazenamentodispositivos.adoc[leveloffset= 1] :leveloffset: 1