Configure o DM-Multipath no SLES 15 para obter caminhos SAN confiáveis.

Para armazenamento SCSI ou DASD no SLES 15, use o Device Mapper Multipath (DM-Multipath): faça com que o array apresente o mesmo LUN em vários caminhos suportados, habilite-o multipathde verifique o mapeamento resultante antes de direcionar as cargas de trabalho para ele. Comece com as configurações padrão de hardware detectadas pela SUSE e as orientações de compatibilidade do seu fornecedor de armazenamento; uma configuração genérica multipath.confcopiada de outro array pode definir o comportamento de caminho incorreto.

Este procedimento segue o Guia de Administração de Armazenamento do SLES 15 SP7, verificado em outubro de 2026. Certifique-se de que as orientações e as configurações do array correspondam ao pacote de serviços instalado; não existe uma configuração única que seja adequada para todos os SANs.

1. Confirme o modelo de armazenamento e multipathing.

O DM-Multipath combina vários caminhos do lado do host para um único dispositivo de armazenamento em um único mapa. Ele pode manter a E/S disponível quando um caminho de conexão falha, mas não protege contra falhas do LUN ou array subjacente. O guia do SUSE SLES 15 afirma que o multipathing nativo do kernel é o método padrão e recomendado para NVMe; use este guia passo a passo do DM-Multipath para SCSI ou DASD, a menos que o fornecedor do array documente uma configuração diferente suportada.

Antes de alterar o host, confirme se o array apresenta o mesmo LUN em pelo menos dois caminhos, com o zoneamento, a máscara de LUN, o acesso ao host e os drivers HBA configurados conforme exigido pelo fornecedor. Cada caminho deve reportar a mesma identidade de LUN.

Execute o seguinte comando de inventário somente leitura para ver os dispositivos que o Linux detecta atualmente:

lsblk -o NAME,TYPE,HCTL,WWN,SIZE,MOUNTPOINTS

A capacidade por si só não comprova que os dispositivos compartilham um LUN. Se os caminhos ou WWNs estiverem ausentes, corrija primeiro os problemas de apresentação do array, zoneamento, mascaramento ou HBA. Identifique qualquer sistema de arquivos, volume LVM ou aplicativo que utilize um /dev/sdXcaminho bruto; migrar um consumidor em produção requer planejamento.

2. Instale e inicie o serviço multipath.

Instale as ferramentas multipath do SUSE e o utilitário de mapeamento de partições, caso ainda não estejam presentes:

sudo zypper install multipath-tools kpartx

Habilite o daemon para que ele inicie na inicialização do sistema, inicie-o agora e verifique seu status:

sudo systemctl enable multipathd
sudo systemctl start multipathd
sudo systemctl status multipathd

multipathdGerencia os mapas detectados. Se desativado, os mapas podem não ser configurados na inicialização. Um serviço em execução por si só não prova que o array expôs vários caminhos; inspecione o mapa abaixo.

3. Verifique as configurações padrão do SUSE antes de editar a configuração.

A maioria dos hardwares compatíveis pode usar a configuração integrada, portanto, geralmente não é necessário que um administrador crie uma /etc/multipath.confnova. Primeiro, pergunte às ferramentas qual perfil de hardware foi detectado e execute um teste:

sudo multipath -T
sudo multipath -d

multipath -TExibe as configurações que correspondem ao hardware detectado; não as aplica. multipath -dÉ uma simulação, útil para verificar quais mapeamentos seriam formados sem criá-los. Compare a saída com as orientações atuais do fabricante do array para o SLES. O capítulo sobre multipath do SUSE SLES 15 SP7 descreve o comportamento e a configuração da ferramenta. Para obter notas sobre a configuração de multipath da SUSE, consulte o artigo 3955167 da Base de Conhecimento da SUSE .

Evite adicionar regras de lista negra amplas ou seções de dispositivo copiadas como primeira solução. A inclusão em listas negras pode ocultar um dispositivo do multipath, enquanto uma substituição específica do dispositivo pode alterar a verificação de caminho, o agrupamento ou o comportamento de failover. Se a SUSE e o fornecedor do array especificarem valores diferentes, use a combinação suportada pelo fornecedor para o pacote de serviços instalado e reporte a discrepância em vez de tentar adivinhar.

4. Adicione apenas as configurações específicas do WWID necessárias.

Se você precisar apenas de um nome estável e legível, adicione um alias para o WWID exato do LUN. Por exemplo, a configuração abaixo mapeia um WWID de exemplo para data01; substitua o identificador de exemplo pelo valor do seu LUN.

multipaths {
    multipath {
        wwid 3600a098000aad1e3000064e45f2c2355
        alias data01
    }
}

Salve a estrofe em /etc/multipath.conf. O WWID é a identidade do dispositivo; o alias altera o nome legível do mapa. Um alias é opcional e não substitui a correspondência do WWID correto. Em um cluster, mantenha os aliases relevantes e a configuração de multipath consistentes em todos os nós para que as definições de recursos resolvam o mesmo dispositivo de armazenamento.

Não defina opções como path_checker`__init__`, path_grouping_policy` failback__outit__`, `__outit__` ou ` no_path_retry__outit__` a partir de um exemplo não relacionado. A escolha de enfileirar E/S ou retornar erros quando todos os caminhos estiverem indisponíveis depende da aplicação e do array: o enfileiramento pode preservar a E/S pendente durante uma breve interrupção, mas o enfileiramento prolongado pode deixar os processos paralisados ​​e consumir memória. Siga a política do fornecedor do armazenamento e da aplicação.

5. Aplique a configuração e atualize a imagem de inicialização.

Após salvar uma alteração de configuração, solicite ao daemon em execução que a recarregue e, em seguida, reconstrua o initramfs:

sudo multipathd reconfigure
sudo dracut -f

A SUSE alerta que o initramfs deve permanecer sincronizado com a configuração multipath e os arquivos de estado relacionados. Uma incompatibilidade pode impedir a inicialização normal do sistema ou enviá-lo para um shell de emergência. Isso é especialmente importante quando o sistema de arquivos raiz está em um armazenamento SAN: faça a alteração durante uma janela de manutenção controlada, preserve o acesso ao console ou à recuperação e siga as instruções correspondentes da SUSE para root em multipath antes de reiniciar.

6. Verifique o mapa e utilize seu caminho persistente.

Inspecione a topologia e confirme se o LUN esperado aparece uma única vez como um mapa de múltiplos caminhos com todos os caminhos esperados abaixo dele:

sudo multipath -ll
sudo multipathd show topology
ls -l /dev/disk/by-id/dm-uuid-mpath-*

Em multipath -ll, readyindica um caminho utilizável, faultyindica um caminho com falha e ghostpode descrever um caminho passivo em um arranjo ativo/passivo. Confirme o número esperado de caminhos e interprete os estados passivos em relação ao projeto do arranjo. Se o LUN estiver ativo, configure os consumidores para usar o dispositivo multipath, como /dev/mapper/data01para o alias ou o /dev/disk/by-id/dm-uuid-mpath-<WWID>link persistente. Evite /dev/dm-N, cujo número pode mudar, e evite vincular cargas de trabalho a um /dev/sdXcaminho individual.

Para garantir resiliência, agende um teste de failover de caminho único com suporte do fornecedor e verifique se a carga de trabalho continua sem erros de E/S. Em seguida, confirme se o caminho retorna. Não desconecte os links de produção como um teste improvisado. A configuração estará pronta quando o WWID esperado for resolvido para um único mapa, todos os caminhos projetados tiverem os estados apropriados, a configuração de inicialização estiver sincronizada e os consumidores usarem o mapa em vez de um único caminho.