SUSE Support

Here When You Need Us

io_setup failed errors when using multipath commands

This document (7022738) is provided subject to the disclaimer at the end of this document.


SUSE Linux Enterprise Server 12 Service Pack 1 (SLES 12 SP1)
SUSE Linux Enterprise Server 12 Service Pack 2 (SLES 12 SP2)


multipath commands cause io_setup failed messages.  The following error messages have been observed in the output after running multipath -ll and multipath -v3:

      io_setup failed


Increasing (tripling) the value of aio-max-nr resolves the errors.  

These changes can be performed by adding or modifying the following in /etc/sysctl.conf
fs.aio-max-nr = 1048576

or adding an entry to a local sysctl file, for example, appending the following to /etc/sysctl.d/99-sysctl.conf:
fs.aio-max-nr = 1048576


aio-max-nr value was set too low

Additional Information


This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:7022738
  • Creation Date: 15-Mar-2018
  • Modified Date:03-Mar-2020
    • SUSE Linux Enterprise Server

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.