Questo contenuto non è disponibile nella lingua selezionata.

Chapter 8. Troubleshooting DM Multipath


Troubleshoot multipath configuration issues by checking daemon status, "queue_if_no_path" feature problems, and the multipathd interactive console for diagnostics.

The following issues may result in a slow or non-functioning multipath configuration:

The multipath daemon is not running
If you find you have trouble implementing a multipath configuration, ensure that the multipathd daemon is running.
Issues with queue_if_no_path feature
If a multipath device is configured with the "1 queue_if_no_path" option, any process issuing I/O will hang. It remains hung until one or more paths are restored.

8.1. Troubleshooting issues with queue_if_no_path feature

Resolve I/O hangs from queue_if_no_path by setting no_path_retry N in /etc/multipath.conf, limiting retries when all paths fail. You can also disable queueing at runtime for specific Logical Unit Numbers (LUNs) to prevent applications from hanging during path outages.

Procedure

  1. Disable queueing:

    • For a specific device:

      # multipathd disablequeueing map device
    • For all devices:

      # multipathd disablequeueing maps

      After you disable queueing, it will remain disabled until you restart or reload multipathd.

  2. Reset queueing to a previous value:

    • For a specific device:

      # multipathd restorequeueing map device
    • For all devices:

      # multipathd restorequeueing maps

8.2. Troubleshooting with the multipathd interactive console

Use the multipathd -k interactive console to troubleshoot multipath issues in real time. This console provides access to status info, config details, and control commands. Type help for commands and press Ctrl+D to exit without disrupting services.

Procedure

  1. Display the multipath configuration, including the default values, before exiting the console:

    # multipathd -k
    multipathd> show config
    multipathd> Ctrl+D
  2. Ensure that multipath picked up all changes to the multipath.conf file:

    # multipathd -k
    multipathd> reconfigure
    multipathd> Ctrl+D
  3. Ensure that the path checker is working properly:

    # multipathd -k
    multipathd> show paths
    multipathd> Ctrl+D
  4. You can also run a single multipathd interactive command directly from the command line, without starting the interactive console. For example, to check that multipath picks up all changes to the multipath.conf file, run the following command:

    # multipathd reconfigure
Red Hat logoGithubredditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni sulla documentazione di Red Hat

Aiutiamo gli utenti Red Hat a innovarsi e raggiungere i propri obiettivi con i nostri prodotti e servizi grazie a contenuti di cui possono fidarsi. Esplora i nostri ultimi aggiornamenti.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Theme

© 2026 Red Hat
Torna in cima