이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 8. Troubleshooting DM Multipath


If you have trouble implementing a multipath configuration, there are a variety of issues you can check for. 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, as described in Configuring DM Multipath. The multipathd daemon must be running to use multipathed devices.
Issues with queue_if_no_path feature
If a multipath device is configured with the features "1 queue_if_no_path" option, then any process that issues I/O hangs until one or more paths are restored.

8.1. Troubleshooting issues with queue_if_no_path feature

If a multipath device is configured with the features "1 queue_if_no_path" option, then any process that issues I/O hangs until one or more paths are restored. To avoid this, set the no_path_retry N parameter in the /etc/multipath.conf file, where N is the number of times the system should retry a path.

To use the features "1 queue_if_no_path" option without the described problem, you can disable the queueing policy at runtime for a particular LUN, for which all paths are unavailable.

Procedure

  1. Disable queueing:

    • For a specific device:

      # multipathd disablequeueing map device
      Copy to Clipboard Toggle word wrap
    • For all devices:

      # multipathd disablequeueing maps
      Copy to Clipboard Toggle word wrap

      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
      Copy to Clipboard Toggle word wrap
    • For all devices:

      # multipathd restorequeueing maps
      Copy to Clipboard Toggle word wrap

8.2. Troubleshooting with the multipathd interactive console

The multipathd -k command is an interactive interface to the multipathd daemon. Entering this command brings up an interactive multipath console. After executing this command, you can enter help to get a list of available commands and Ctrl+D to quit.

Use the multipathd interactive console to troubleshoot problems you might have with your system.

Procedure

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

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

    # multipathd -k
    multipathd> reconfigure
    multipathd> Ctrl+D
    Copy to Clipboard Toggle word wrap
  3. Ensure that the path checker is working properly:

    # multipathd -k
    multipathd> show paths
    multipathd> Ctrl+D
    Copy to Clipboard Toggle word wrap
  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
    Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat