4.4. Funções de Configuração do Dispositivo dos Multipaths

Tabela 4.2, “Funções do Multipath” exibe as funções que você configurou na seção multipaths do arquivo de configuração multipath.conf para cada dispositivo específico do multipath. Estas funções se aplicam somente àquele multipath especificado. Estes padrões são usados pelo DM-Multipath e sobrescrevem funções configuradas nas seções defaults e devices do arquivo do multipath.conf.

Tabela 4.2. Funções do Multipath

Funções Descrição
wwid Especifica o WWID do dispositivo do multipath para o qual as funções do multipath se aplicam. Este parâmetro é obrigatório para esta seção do arquivo multipath.conf.
alias Especifica o nome simbólico para o dispositivo multipath para o qual a ferramenta multipath se aplicará. Se você estiver usando o user_friendly_names, não defina este valor para mpathn; isto deve conflitar com um nome user friendly atribuído automaticamente e lhe fornecer os nomes de nós de dispositivos incorretos.
path_grouping_policy
Especifica a política de agrupamento do caminho padrão para aplicar em multipaths não especificados. Valores possíveis incluem:
failover = 1 caminho por grupo prioritário
multibus = todos os caminhos em um grupo prioritário
group_by_serial = 1 grupo prioritário por número em série detectado
group_by_prio = 1 grupo prioritário por valor prioritário do caminho
group_by_node_name = 1 grupo prioritário por nome de nó alvo
path_selector
Especifica o algorítmo padrão para usar ao determinar qual caminho usar para a próxima operação de E/S. Valores possíveis incluem:
round-robin 0: Volta por todos os caminhos dentro do grupo de caminho, enviando a mesma quantia de E/S para cada um.
queue-length 0: Envia a proxima quantia de E/S pelo caminho com o mínimo de requisições de E/S restantes.
service-time 0: Envia o próximo pacote de E/S pelo caminho com o tempo de serviço mais curto estimado, o qual é determinado dividindo o tamanho total das E/S restantes para cada caminho pela entrada relevante.
failback
Especifica o failback do grupo do caminho.
O valor 0 ou immediate especifica um failback imediato para um grupo de caminho com a prioridade mais alta que contenha caminhos ativos.
Um valor de manual especifica que o failback não deve ser imediato e que pode acontecer somente com a intervenção do operador.
Um valor de followover especifica que failback automático deve ser realizado quando o primeiro caminho de um grupo de caminho se torna ativo. Isto evita que um nó retorne automaticamente quando outro nó requisitar o failover.
Um valor numérico maior que zero, especifica o retorno de falha deferido, expressado em segundos.
prio
Especifica o programa padrão e argumentos para chamar e obter um valor do caminho prioritário. Por exemplo, a parte ALUA em SPC-3 fornece um valor prio explorável. Valores possíveis incluem:
const: Define uma prioridade de 1 caminho para todos.
emc: Gera o caminho por grupo prioritário para diretrizes EMC.
alua: Gera a prioridade de caminho baseado em configurações de SCSI-3 ALUA.
tpg_pref: Gera a prioridade de caminho baseada nas configurações do SCSI-3 ALUA, usando o bit de porta preferida.
ontap: Gera o caminho prioritário para diretrizes NetApp.
rdac: Gera a prioridade de caminho para o controlador LSI/Engenio RDAC.
hp_sw: Gera a prioridade do caminho para o controlador Compaq/HP em modo ativo/standby.
hds: Gera a prioridade de caminho para as diretrizes de armazenamento do Hitachi HDS Modular
no_path_retry
Um valor numérico para esta função especifica o número de vezes que o sistema deve tentar usar um caminho falho antes de habilitar o enfileiramento.
O valor de fail indica falha imediata, sem enfileirar.
Um valor de queue indica que o enfileiramento não deve parar até que o caminho seja reparado.
rr_min_io Especifica o número de requisições de E/S para rotear para um caminho antes de mudar para o próximo caminho no grupo de caminho atual. Esta configuração funciona somente para sistemas que executam os kernels anteriores ao 2.6.31. Os sistemas mais novos devem utilizar o rr_min_io_rq. O valor padrão é 1000.
rr_min_io_rq Especifica o número de requisições de E/S para rotear em um caminho antes de alterar para o próximo caminho no grupo atual do caminho, utilizando o device-mapper-multipath baseado em requisção. Esta configuração deve ser utilizada em sistemas que executam os kernels atuais. Em sistemas que executam kernels anteriores ao 2.6.31, utilize o rr_min_io. O valor padrão é 1.
rr_weight Caso seja configurado para priorities, ao invés de enviar requisições de rr_min_io para um caminho antes de chamar o path_selector para escolher um próximo caminho, o número de requisições a enviar é determinado pelo rr_min_io vezes a prioridade do caminho, como determinado pelo programa prio. Se estiver definido para .uniform, todos os caminhos possuem o mesmo peso.
flush_on_last_del Se configurado para yes, então o multipath irá desabilitar a fila quando o último caminho para um dispositivo houver sido removido.
user_friendly_names Caso seja configurado para yes, especifica que o sistema deve usar o arquivo /etc/multipath/bindings para atribuir um álias persistente e único ao multipath, na forma mpathn. Se configurado para no, especifica que o sistema deveria usar o WWID como o aliás para o multipath. Em qualquer dos casos, o que é especificado aqui será sobrescrito por qualquer dispositivo específico na seção multipaths do arquivo de configuração.
O exemplo a seguir exibe as funções do multipath especificadas no arquivo de configuração para os dois dispositivos do multipath específicos. O primeiro dispositivo possui um WWID do 3600508b4000156d70001200000b0000 e um nome simbólico de yellow.
O segundo dispositivo do multipath no exemplo possui um WWID de1DEC_____321816758474 e um nome simbólico de red. Neste exemplo, as funções de rr_weight são configuradas 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
        }
}