AIX Disk Queue Depth Tuning for Performance « UnixMANTRA

Purpose

The purpose of this document is to describe how IOs are queued the disk device driver and the adapter device driver,

SDD, and SDDPCM and to explain how these can be tuned to increase performance. And this also includes the use of

VIO. This information is also useful for AIX LPARs using other multi-path code as well.

Where this stuff fits in the IO stack

Following is the IO stack from the application to the disk:

Application

File system (optional)

LVM device driver (optional)

SDD or SDDPCM or other multi-path driver (if used)

hdisk device driver

adapter device driver

interconnect to the disk

Disk subsystem

Disk

Note that even though the disk is attached to the adapter, the hdisk driver code is utilized before the adapter driver

code. So this stack represents the order software comes into play over time as the IO traverses the stack.

Why do we need to simultaneously submit more than one IO to a disk?

This improves performance. And this would be performance from an application's point of view. This is especially

important with disk subsystems where a virtual disk (or LUN) is backed by multiple physical disks. In such a situation,

if we only could submit a single IO at a time, we'd find we get good IO service times, but very poor thruput. Submitting

multiple IOs to a physical disk allows the disk to minimize actuator movement (using an "elevator" algorithm) and get

more IOPS than is possible by submitting one IO at a time. The elevator analogy is appropriate. How long would people

be waiting to use an elevator if only one person at a time could get on it? In such a situation, we'd expect that people

would wait quite a while to use the elevator (queueing time), but once they got on it, they'd get to their destination

quickly (service time). So submitting multiple in-flight IOs to a disk subsystem allows it to figure out how to get the

most thruput and fastest overall IO service time.

Theoretically, the IOPS for a disk is limited by queue_depth/(average IO service time). Assuming a queue_depth of 3,

and an average IO service time of 10 ms, this yields a maximum thruput of 300 IOPS for the hdisk. And for many

applications this may not be enough thruput.

Where are IOs queued?

As IOs traverse the IO stack, AIX needs to keep track of them at each layer. So IOs are essentially queued at each

layer. Generally, some number of in flight IOs may be issued at each layer and if the number of IO requests exceeds

that number, they reside in a wait queue until the required resource becomes available. So there is essentially an "in

process" queue and a "wait" queue at each layer (SDD and SDDPCM are a little more complicated).

At the file system layer, file system buffers limit the maximum number of in flight IOs for each file system. At the LVM

device driver layer, hdisk buffers limit the number of in flight IOs. At the SDD layer, IOs are queued if the dpo device's

attribute, qdepth_enable, is set to yes (which it is by default). Some releases of SDD do not queue IOs so it depends

on the release of SDD. SDDPCM on the other hand does not queue IOs before sending them to the disk device driver.

The hdisks have a maximum number of in flight IOs that's specified by its queue_depth attribute. And FC adapters also

have a maximum number of in flight IOs specified by num_cmd_elems. The disk subsystems themselves queue IOs

and individual physical disks can accept multiple IO requests but only service one at a time. Here are an ESS hdisk's

attributes:

Popular Tags Blog Archives

Enter your email address Subscribe

Search

Get FREE updates on your Email | RSS

258LikeLike Like us on Facebook

AIX Disk Queue Depth Tuning for Performance - UnixMantra http://www.unixmantra.com/2013/05/aix-disk-queue-depth-tuning-for.html

1 of 9 3/18/2015 12:21 PM

# lsattr -El hdisk33

PR_key_value none Reserve Key True

location Location Label True

lun_id 0x5515000000000000 Logical Unit Number ID True

lun_reset_spt yes Support SCSI LUN reset True

max_transfer 0x40000 N/A True

node_name 0x5005076300c096ab FC Node Name False

pvid none Physical volume identifier False

q_type simple Queuing TYPE True

qfull_dly 20 delay in seconds for SCSI TASK SET FULL True

queue_depth 20 Queue DEPTH True

reserve_policy single_path Reserve Policy True

rw_timeout 60 READ/WRITE time out value True

scbsy_dly 20 delay in seconds for SCSI BUSY True

scsi_id 0x620713 SCSI ID True

start_timeout 180 START unit time out value True

ww_name 0x5005076300cd96ab FC World Wide Name False

The default queue_depth is 20, but can be changed to as high as 256 for ESS, DS6000 and DS8000. One can display

allowable values with:

# lsattr -Rl hdisk33 -a queue_depth

1...256 (+1)

indicating the value can be anywhere from 1 to 256 in increments of 1. One can use this command to see any allowable

value for attributes which can be changed (showing a value of True in the last field of "lsattr -El " for the

device using:

# lsattr -Rl -a

Here's a FC adapter's attributes:

# lsattr -El fcs0

bus_intr_lvl 65703 Bus interrupt level False

bus_io_addr 0xdec00 Bus I/O address False

bus_mem_addr 0xe8040000 Bus memory address False

init_link al INIT Link flags True

intr_priority 3 Interrupt priority False

lg_term_dma 0x800000 Long term DMA True

max_xfer_size 0x100000 Maximum Transfer Size True

num_cmd_elems 200 Maximum number of COMMANDS to queue to the adapter True

pref_alpa 0x1 Preferred AL_PA True

sw_fc_class 2 FC Class for Fabric True

The default queue depth (num_cmd_elems) for FC adapters is 200 but can be increased up to 2048 for most adapters.

Here's the dpo device's attributes for one release of SDD:

# lsattr -El dpo

Enterpr_maxlun 600 Maximum LUNS allowed for Enterprise Products True

Virtual_maxlun 512 Maximum LUNS allowed for Virtualization Products False

persistent_resv yes Subsystem Supports Persistent Reserve Command False

qdepth_enable yes Queue Depth Control True

When qdepth_enable=yes, SDD will only submit queue_depth IOs to any underlying hdisk (where queue_depth here is

the value for the underlying hdisk's queue_depth attribute). When qdepth_enable=no, SDD just passes on the IOs

directly to the hdisk driver. So the difference is, if qdepth_enable=yes (the default), IOs exceeding the queue_depth

will queue at SDD, and if qdepth_enable=no, then IOs exceed the queue_depth will queue in the hdisk's wait queue. In

other words, SDD with qdepth_enable=no and SDDPCM do not queue IOs and instead just pass them to the hdisk

drivers. Note that at SDD 1.6, it's preferable to use the datapath command to change qdepth_enable, rather than using

chdev, as then it's a dynamic change, e.g., datapath set qdepth disable will set it to no. Some releases of SDD don't

include SDD queueing, and some do, and some releases don't show the qdepth_enable attribute. Either check the

manual for your version of SDD or try the datapath command to see if it supports turning this feature off.

If you've used both SDD and SDDPCM, you'll remember that with SDD, each LUN has a corresponding vpath and an

hdisk for each path to the vpath or LUN. And with SDDPCM, you just have one hdisk per LUN. Thus, with SDD one can

submit queue_depth x # paths to a LUN, while with SDDPCM, one can only submit queue_depth IOs to the LUN. If you

switch from SDD using 4 paths to SDDPCM, then you'd want to set the SDDPCM hdisks to 4x that of SDD hdisks for an

equivalent effective queue depth. And migrating to SDDPCM is recommended as it's more strategic than SDD.


2 of 9 3/18/2015 12:21 PM

Both the hdisk and adapter drivers have an "in process" and "wait" queues. Once the queue limit is reached, the IOs

wait until an IO completes, freeing up a slot in the service queue. The in process queue is also sometimes referred to

as the "service" queue

It's worth mentioning, that many applications will not generate many in flight IOs, especially single threaded

applications that don't use asynchronous IO. Applications that use asynchronous IO are likely to generate more in flight

IOs.

What tools are available to monitor the queues?

For AIX, one can use iostat (at AIX 5.3 or later) and sar (5.1 or later) to monitor the hdisk driver queues. The iostat -D

command generates output such as:

hdisk6 xfer: %tm_act bps tps bread bwrtn

4.7 2.2M 19.0 0.0 2.2M

read: rps avgserv minserv maxserv timeouts fails

0.0 0.0 0.0 0.0 0 0

write: wps avgserv minserv maxserv timeouts fails

19.0 38.9 1.1 190.2 0 0

queue: avgtime mintime maxtime avgwqsz avgsqsz sqfull

15.0 0.0 83.7 0.0 0.0 136

Here, the avgwqsz is the average wait queue size, and avgsqsz is the average service queue size. The average time

spent in the wait queue is avgtime. The sqfull value has changed from initially being a count of the times we've

submitted an IO to a full queue, to now where it's the rate of IOs per second submitted to a full queue. The example

report shows the prior case (a count of IOs submitted to a full queue), while newer releases typically show decimal

fractions indicating a rate. It's nice that iostat -D separates reads and writes, as we would expect the IO service times

to be different when we have a disk subsystem with cache. The most useful report for tuning is just running "iostat -D"

which shows statistics since system boot, assuming the system is configured to continuously maintain disk IO history

(run # lsattr -El sys0, or smitty chgsys to see if the iostat attribute is set to true). And the author's favorite iostat

command flags are "iostat -RDTl ".

From the application's point of view, the length of time to do an IO is its service time plus the time it waits in the hdisk

wait queue.

The sar -d command changed at AIX 5.3, and generates output such as:

16:50:59 device %busy avque r+w/s Kbs/s avwait avserv

16:51:00 hdisk1 0 0.0 0 0 0.0 0.0

hdisk0 0 0.0 0 0 0.0 0.0

The avwait and avserv are the average times spent in the wait queue and service queue respectively. And avserv here

would correspond to avgserv in the iostat output. The avque value changed; at AIX 5.3, it represents the average

number of IOs in the wait queue, and prior to 5.3, it represents the average number of IOs in the service queue.

SDDPCM provides the "pcmpath query devstats" and "pcmpath query adaptstats" commands to show hdisk and

adapter queue statistics. SDD similarly has "datapath query devstats" and "datapath query adaptstats". You can refer

to the SDD/SDDPCM manual for syntax, options and explanations of all the fields. Here's some devstats output for a

single LUN:

Device #: 0

=============

Total Read Total Write Active Read Active Write Maximum

I/O: 29007501 3037679 1 0 40

SECTOR: 696124015 110460560 8 0 20480

Transfer Size:

For SDD, the Maximum for devstats will not exceed queue_depth x # paths when qdepth_enable=yes. But Maximum

for adaptstats can exceed num_cmd_elems as it represents the maximum number of IOs submitted to the adapter

driver and includes IOs for both the service and wait queues. If, in this case, we have 2 paths and are using the default

queue_depth of 20, then the 40 indicates we've filled the queue at least once and increasing queue_depth can help

performance.

For SDDPCM, if the Maximum value equals the hdisk's queue_depth, then the hdisk driver queue was filled during the

interval, and increasing queue_depth is usually appropriate.

One can similarly monitor adapter IOPS with # iostat -at and for adapter queue

information, run # iostat -aD, optionally with an interval and number of intervals. For FC adapters, the fcstat command

provides information on the adapter queue and resource use, and can tell us if we need to increase its queue sizes.

For adapter queues, the fcstat command is used and is discussed below.

How to tune

First, one should not indiscriminately just increase these values. It's possible to overload the disk subsystem or cause

problems with device configuration at boot. So the approach of adding up the hdisk's queue_depths and using that to

determine the num_cmd_elems isn't necessarily the best approach. Instead, it's better to use the maximum number of

submitted IOs to each device for tuning. When you increase the queue_depths and number of in flight IOs that are sent

to the disk subsystem, the IO service times are likely to increase, but throughput will also increase. If IO service times

start approaching the disk timeout value, then you're submitting more IOs than the disk subsystem can handle. If you

start seeing IO timeouts and errors in the error log indicating problems completing IOs, then this is the time to look for

hardware problems or to make the pipe smaller.

A good general rule for tuning queue_depths, is that one can increase queue_depths until IO service times start

exceeding 15 ms for small random reads or writes or one isn't filling the queues. Once IO service times start

increasing, we've pushed the bottleneck from the AIX disk and adapter queues to the disk subsystem. Two approaches

to tuning queue depth are 1) base the queue depths on actual IO requests your application generate or 2) use a test

tool to see what the disk subsystem can handle and tune the queues based on what the disk subsystem can handle.

The ndisk tool (part of the nstress package available on the internet at http://www-941.ibm.com/collaboration

/wiki/display/WikiPtype/nstress) can be used to stress the disk subsystem to see what it can handle. The author's

preference is to tune based on your application IO requirements, especially when the disk is shared with other servers.

For tuning, we can categorize the situation into four categories:

We're filling up the queues and IOs are waiting in the hdisk or adapter drivers1.

We're not filling up the queues, and IO service times are good2.

We're not filling up the queues, and IO service times are poor3.

We're not filling up the queues, and we're sending IOs to the storage faster than it can handle and it loses the

IOs

4.

We want to tune the queues to be in either situation 2 or 3. If we're in situation 3, that indicates a bottleneck beyond

the hdisk driver which will typically be in the disk subsystem itself, but could also be in the adapter driver or SAN

fabric.

Situation 4 is something we do want to avoid. All disks and disk subsystem have limits regarding the number of

in-flight IOs they can handle, mainly due to memory limitations to hold the IO request and data. When the storage

loses IOs, the IO will eventually time out at the host, recovery code will be used and resubmit the IO, but in the

meantime transactions waiting on that IO will be stalled. This isn't a desirable situation, as the CPU ends up doing more

work to handle IOs than necessary. If the IO eventually fails, then this can lead to an application crash or worse. So be

sure to check your storage documentation to understand its limits.

Then after running your application during peak IO periods look at the statistics and tune again.

Regarding the qdepth_enable parameter for SDD, the default is yes which essentially has SDD handling the IOs beyond

queue_depth for the underlying hdisks. Setting it to no results in the hdisk device driver handling them in its wait

queue. In other words, with qdepth_enable=yes, SDD handles the wait queue, otherwise the hdisk device driver

handles the wait queue. There are error handling benefits to allowing SDD to handle these IOs, e.g., if using LVM

mirroring across two ESSs. With heavy IO loads and a lot of queueing in SDD (when qdepth_enable=yes) it's more

efficient to allow the hdisk device drivers to handle relatively shorter wait queues rather than SDD handling a very long

wait queue by setting qdepth_enable=no. In other words, SDD's queue handling is single threaded where each hdisk

driver has its own thread. So if error handling is of primary importance (e.g. when LVM mirroring across disk

subsystems) then leave qdepth_enable=yes. Otherwise, setting qdepth_enable=no more efficiently handles the wait

queues when they are long. Note that one should set the qdepth_enable parameter via the datapath command as it's a

dynamic change that way (using chdev is not dynamic for this parameter).

If error handling is of concern, then it's also advisable, assuming the disk is SAN switch attached, to set the fscsi device


4 of 9 3/18/2015 12:21 PM

attribute fc_err_recov to fast_fail rather than the default of delayed_fail, and also change the fscsi device dyntrk

attribute to yes rather than the default of no. These attributes assume a SAN switch that supports this feature.

What are reasonable average IO service times?

What is good or reasonable is somewhat a factor of the technology of the storage and the storage cache sizes.

Assuming no IOs are queued to a disk, a typical read will take somewhere from 0 to 15 ms, or so, depending on how

far the actuator has to travel (seek time), how long it takes the disk to rotate to the right sector (rotation time), and

how long it takes to read the data (transfer time). Then the data must move from the storage to the host. Typically the

time is dominated by seek time + rotation time, though for large IOs transfer time also can be significant. Sometimes

the data will be in disk subsystem read cache, in which case the IO service time is around 1 ms. Typically for large disk

subsystems that aren't overloaded, IO service times will average around 5-10 ms. When small random reads start

averaging greater than 15 ms, this indicates the storage is getting busy.

Writes typically go to write cache (assuming it exists) and then these average typically less than about 2.5 ms. But

there are exceptions. If the storage is synchronously mirroring the data to a remote site, writes can take much longer.

And if the IO is large (say 64 KB or larger) then the transfer time becomes more significant and the average time is

slightly worse. If there's no cache, then writes take about the same as reads.

If the IO is large block sequential, then besides the increased transfer time, we expect IOs to queue at the physical

disk, and IO service times to be much longer on average. E.G., if an application submits 50 IOs (say 50 64 KB IOs

reading a file sequentially) then the first few IOs will have reasonably good IO service times, while the last IO will have

had to wait for the other 49 to finish first, and will have a very long IO service time.

IOs to SSDs are typically less than 1 ms, and for SSDs in disk subsystems, typically less than 2 ms, and on occasion

higher.

Tuning the FC adapter num_cmd_elems

The fcstat command is perhaps the easiest tool to look for blocked IOs in the adapter's queues, e.g.:

# fcstat fcs0

FIBRE CHANNEL STATISTICS REPORT: fcs0

...

FC SCSI Adapter Driver Information

No DMA Resource Count: 0

No Adapter Elements Count: 104848

No Command Resource Count: 13915968

...

The values for "No Adapter Elements Count" and "No Command Resource Count" are the number of times since boot

that an IO was temporarily blocked due to an inadequate num_cmd_elems attribute value. Non-zero values indicate

that increasing num_cmd_elems may help improve IO service times. Of course if the value increments slowly, then the

improvement may be very small, while quickly incrementing values means tuning is more likely to have a measurable

improvement in performance.

Like the hdisk queue_depth attribute, changing the num_cmd_elems value requires stopping use of the resources or a

reboot.

Queue depths with VSCSI VIO

When using VIO, one configures VSCSI adapters (for each virtual adapter in a VIOS, known as a vhost device, there

will be a matching VSCSI adapter in a VIOC). These adapters have a fixed queue depth that varies depending on how

many VSCSI LUNs are configured for the adapter. There are 512 command elements of which 2 are used by the

adapter, 3 are reserved for each VSCSI LUN for error recovery and the rest are used for IO requests. Thus, with the

default queue_depth of 3 for VSCSI LUNs, that allows for up to 85 LUNs to use an adapter: (512 - 2) / (3 + 3) = 85

rounding down. So if we need higher queue depths for the devices, then the number of LUNs per adapter is reduced.

E.G., if we want to use a queue_depth of 25, that allows 510/28= 18 LUNs. We can configure multiple VSCSI adapters

to handle many LUNs with high queue depths. each requiring additional memory. One may have more than one VSCSI

adapter on a VIOC connected to the same VIOS if you need more bandwidth.

Also, one should set the queue_depth attribute on the VIOC's hdisk to match that of the mapped hdisk's queue_depth

on the VIOS.

For a formula, the maximum number of LUNs per virtual SCSI adapter (vhost on the VIOS or vscsi on the VIOC) is

=INT(510/(Q+3)) where Q is the queue_depth of all the LUNs (assuming they are all the same).


5 of 9 3/18/2015 12:21 PM

Note that to change the queue_depth on an hdisk at the VIOS requires that we unmap the disk from the VIOC and

remap it back, or a simpler approach is to change the values in the ODM (e.g. # chdev -l hdisk30 -a queue_depth=20

-P) then reboot the VIOS.

For LV VSCSI hdisks, where multiple VIOC hdisks are created from a single VIOS hdisk, then one may take a dedicated

resource, shared resource or an in between approach to the VIOS hdisk queue slots. See the section below

entitled Further theoretical thoughts on shared vs. dedicated resources.

Queue depths with NPIV VIO

When using NPIV, we have virtual FC adapters (vFC) and real FC adapters, and often have multiple vFCs tied to a single

real FC adapter.

If you increase num_cmd_elems on the virtual FC (vFC) adapter, then you should also increase the setting on the real

FC adapter.

You can use the fcstat command for both the virtual adapter as well as the real adapter for tuning purposes.

A special note on the FC adapter max_xfer_size attribute

This attribute for the fscsi device, which controls the maximum IO size the adapter device driver will handle, also

controls a memory area used by the adapter for data transfers. When the default value is used

(max_xfer_size=0x100000) the memory area is 16 MB in size. When setting this attribute to any other allowable value

(say 0x200000) then the memory area is 128 MB in size. At AIX 6.1 TL2 or later a change was made for virtual FC

adapters so the DMA memory area is always 128 MB even with the default max_xfer_size. This memory area is a DMA

memory area, but it is different than the DMA memory area controlled by the lg_term_dma attribute (which is used for

IO control). The default value for lg_term_dma of 0x800000 is usually adequate.

So for heavy IO and especially for large IOs (such as for backups) it's recommended to set max_xfer_size=0x200000.

The fcstat command can also be used to examine whether or not increasing num_cmd_elems or max_xfer_size could

increase performance

# fcstat fcs0

...

FC SCSI Adapter Driver Information

No DMA Resource Count: 0

No Adapter Elements Count: 0

No Command Resource Count: 0

This shows an example of an adapter that has sufficient values for num_cmd_elems and max_xfer_size. Non zero value

would indicate a situation in which IOs queued at the adapter due to lack of resources, and increasing num_cmd_elems

and max_xfer_size would be appropriate.

Note that changing max_xfer_size uses memory in the PCI Host Bridge chips attached to the PCI slots. The

salesmanual, regarding the dual port 4 Gbps PCI-X FC adapter states that "If placed in a PCI-X slot rated as SDR

compatible and/or has the slot speed of 133 MHz, the AIX value of the max_xfer_size must be kept at the default

setting of 0x100000 (1 megabyte) when both ports are in use. The architecture of the DMA buffer for these slots does

not accommodate larger max_xfer_size settings"

If there are too many FC adapters and too many LUNs attached to the adapter, this will lead to issues configuring the

LUNs. Errors will look like:

LABEL: DMA_ERR

IDENTIFIER: 00530EA6

Date/Time: Mon Mar 3 10:48:09 EST 2008

Sequence Number: 863

Machine Id: 00C3BCB04C00

Node Id: p595back

Class: H

Type: UNKN

Resource Name: PCIDMA

Resource Class: NONE

Resource Type: NONE

Location:

Description


6 of 9 3/18/2015 12:21 PM

UNDETERMINED ERROR

Probable Causes

SYSTEM I/O BUS

SOFTWARE PROGRAM

ADAPTER

DEVICE

Recommended Actions

PERFORM PROBLEM DETERMINATION PROCEDURES

Detail Data

BUS NUMBER

FFFF FFFF 9000 00E4

CHANNEL UNIT ADDRESS

0000 0000 0000 018B

ERROR CODE

0000 0000 1000 0003

So if you get these errors, you'll need to change the max_xfer_size back to the default value. Also note that if you are

booting from SAN, if you encounter this error, you won't be able to boot, so be sure to have a back out plan if you plan

to change this and are booting from SAN.

Further theoretical thoughts on shared vs. dedicated resources

The astute reader will have considered the fact that typically we have many hdisk drivers sharing multiple adapters and

adapter drivers, thus, the FC queue slots are a shared resource for the hdisk drivers:

Thus, it's possible to ensure that we never fill the adapter queues, by making SUM(hdisk0 queue_depth, hdisk1

queue_depth, ... hdiskM queue_depth)

This would be considered a shared resource approach where the 10 adapter queue slots could be filled up from a single

hdisk driver.

And here's an example of something in between:

Here, there will always be at least 5 queue slots available in the adapter driver for either hdisk driver.

There are pros and cons to each approach. The benefit of the dedicated resource approach is that the resources

allocated will always be available but typically there will be fewer resources available to each user of the resource (here

the resource we're considering is the adapter queue slots, and the users of the resource are the hdisk drivers). The

benefit of the shared resource approach is that we'll have more resources for an individual user of the resource when it

needs it and it will be able to get greater thruput than in the dedicated resource approach. The author generally prefers

a shared resource approach, as generally provides the best thruput and price performance.

Note that this situation of shared resources occurs in several possible ways beyond hdisk drivers using adapter drivers.

It is also involved when:

Several LV VSCSI hdisks for a single hdisk on a VIOS

Several vFC adapters using a single real FC adapter

Several LPARs using the same disk subsystem

Source:


8 of 9 3/18/2015 12:21 PM

Comment as:

Publish

Select Language

Powered by Translate

Search


9 of 9 3/18/2015 12:21 PM

Documents

AIX Disk Queue Depth Tuning for Performance « UnixMANTRA