AIX Configuration Guide (Formerly Known as FAQ 1589)
Explore this Page
- Overview
- Change Summary
- AIX Compatibility List
- DataCore Server Settings
- AIX Host Settings
- Known Issues in AIX Configuration Guide
- Appendices
Overview
This guide provides configuration settings and considerations for Hosts running Advanced Interactive eXecutive (AIX) with SANsymphony.
Basic AIX storage administration skills are assumed including how to connect to iSCSI and Fibre Channel target ports and the discovering, mounting, and formatting of disk devices.
Change Summary
Changes since October 2019
| Section(s) | Content Changes |
|---|---|
| General Updates | This document has been reviewed for SANsymphony 10.0 PSP11. No additional settings or configurations are required. |
AIX Compatibility List
AIX Operating System Versions
Applies to all versions of SANsymphony 10.x.
| AIX | WITH AULA | WITHOUT AULA |
|---|---|---|
| 5.x | Not Supported | Not Supported |
| 6.1 | Not Supported | Not Supported |
| 7.1 | Not Supported | Qualified[1] |
| 7.2 | Not Qualified | Not Qualified[2] |
- Qualified vs Not Qualified vs Not Supported
- Refer to the Qualified vs Not Qualified vs Not Supported section for definitions.
- DataCore Server Port connections
- For AIX hosts, only Fibre Channel Front-end (FE) connections are supported.
- FE iSCSI connections are not supported.
- SCSI UNMAP
- There is no support for SCSI UNMAP from AIX hosts.
IBM PowerHA System Mirror (Formerly known as IBM PowerHA and HACMP)
Applies to all versions of SANsymphony 10.x. Refer to Qualified vs Not Qualified vs Not Supported for definitions.
| AIX | WITH AULA | WITHOUT AULA |
|---|---|---|
|
5.2 |
Not Supported | Not Supported |
|
5.3 |
Not Supported | Not Supported |
|
6.1 |
Not Supported | Not Supported |
|
7.1 |
Not Supported | Not Qualified |
|
7.2 |
Not Supported | Not Qualified |
Qualified vs Not Qualified vs Not Supported
Qualified
This combination has been tested by DataCore and all the host-specific settings listed in this document applied using non-mirrored, mirrored and dual virtual disks (vDisks).
Not Qualified
This combination has not yet been tested by DataCore using Mirrored or Dual vDisks types. DataCore cannot guarantee 'high availability' (failover/failback, continued access, etc.) even if the host-specific settings listed in this document are applied. Self-qualification may be possible.
Mirrored or dual vDisks types are configured at the user's risk; however, any problems that are encountered while using AIX versions that are 'Not Qualified' will still get root-cause analysis.
Non-mirrored vDisks are always considered 'Qualified' - even for 'Not Qualified' combinations of AIX/SANsymphony
Not Supported
This combination has either failed 'high availability' testing by DataCore using mirrored or dual vDisks types; or the operating System's requirements/limitations (e.g. age, specific hardware requirements) make it impractical to test. DataCore will not guarantee 'high availability' (failover/failback, continued access, etc.) if the host-specific settings listed in this document are applied. Mirrored or dual vDisks types are configured at the user's risk. Self-qualification is not possible.
Mirrored or dual vDisks types are configured at the user's risk; however, any problems that are encountered while using AIX versions that are 'Not Supported' will get best-effort DataCore Technical Support (e.g. to get access to vDisks) but no root-cause analysis will be done.
Non-mirrored vDisks are always considered 'Qualified' - even for 'Not Supported' combinations of AIX/SANsymphony
AIX versions that are End of Service
Self-qualification may be possible for versions that are considered ‘Not Qualified’ by DataCore but only if there is an agreed ‘support contract’ with IBM. Contact DataCore Technical Support before attempting any self-qualification of AIX versions that are End of Service (EOS).
For any problems that are encountered while using AIX versions that are EOS with DataCore Software, only best-effort DataCore Technical Support will be performed (e.g. to get access to vDisks). Root-cause analysis will not be done.
Non-mirrored vDisks are always considered 'Qualified'.
DataCore Server Settings
Operating System Type
When registering the host, select one of the appropriate options:
- AIX 5.2 with ML9 or earlier chose ‘IBM AIX Native MPIO Legacy’
- AIX 5.2 with TL10 select ‘IBM AIX’
- AIX 5.3 with ML5 or earlier chose ‘IBM AIX Native MPIO Legacy’
- AIX 5.3 with TL6 or greater select ‘IBM AIX’
- AIX 6.1 and AIX 7.x select ‘IBM AIX’
Port Roles
Ports that are used to serve virtual disks (vDisks) to hosts should only have the Front-end (FE) role checked. While it is technically possible to check additional roles on an FE port (i.e., Mirror and Backend), this may cause unexpected results after stopping the SANsymphony software.
Any port with FE role (and is serving vDisks to hosts) also has either the mirror and/or backend role enabled will remain ‘active’ even when the SANsymphony software is stopped. There is some slight difference in behavior depending on the version of SANsymphony installed.
SANsymphony 10.0 PSP7 and earlier
Any port that has the mirror and/or back-end role checked will remain ‘active’ after the SANsymphony software has been stopped.
SANsymphony 10.0 PSP8 and later
Only ports with the back-end role checked will remain ‘active’ after the SANsymphony software has been stopped.
FE ports that are serving vDisks but remain active after the SANsymphony software has been stopped can cause unexpected results for some host operating systems as they continue to try to access vDisks from the ‘active’ port on the now-stopped DataCore Server. This, in turn, may end up delaying host fail-over or result in complete loss of access from the host’s application/virtual machines (VM).
Multipathing
The Multipathing Support option should be enabled so that mirrored vDisks or dual vDisks can be served to hosts from all available DataCore FE ports. Refer to the Multipathing Support documentation for more information.
Non-mirrored vDisks and multipathing
Non-mirrored vDisks can still be served to multiple hosts and/or multiple host ports from one or more DataCore Server FE Ports if required; in this case, the host can use its own multipathing software to manage the multiple host paths to the single vDisk as if it was a mirrored or dual vDisk.
ALUA Support
Refer to AIX Compatibility List for more information.
Serving Virtual Disks
Serve a ‘LUN 0’ virtual disk to all hosts first
AIX’s MPIO uses the ‘LUN 0’ disk device on each port to be able to discover new disk devices that are served to the same port on an AIX Host. DataCore recommend to create one small, non-mirrored, virtual disk (vDisk)– on each DataCore Server in the Server Group - just for this purpose to make managing the serving of new virtual disks more convenient.
- Create one, ‘Single’ (i.e. non-mirrored) vDisk on each DataCore Server in the server group. The size of the vDisk should be as small as possible - i.e. the size of a single disk pool storage allocation unit (SAU).
- Serve each of these vDisks to all AIX host ports and ensure that the paths for these vDisks are configured as LUN 0.
Here is an example of one of these vDisks created on and served from DATACORE1 to both AIX Host 1 and AIX Host 2 as LUN 0 on each of their own Fibre Channel (FC) Ports.
- Make sure that each host discovers the vDisk on each of its ports from each of the DataCore Servers. There is no need to format this vDisk on the AIX Host as AIX’s MPIO is only using the disk device for discovering new LUNs on the port.
- Do not mirror the LUN 0 Virtual Disk
As no data is stored on this disk device there is no need to mirror the vDisk and it also avoids situations when the DataCore Server’s remote, mirror partner sets the vDisk as 'unavailable' to the AIX Host while the mirror is broken/in recovery. This prevents access to this LUN 0 and so stops (re)discovery of LUNs already served to the same host port.
- All other vDisks
DataCore recommends that before serving vDisks for the first time to a host, all DataCore FE ports on all DataCore Servers are correctly discovered by the host first.
Then, from within the SANsymphony Console, the vDisk is marked Online, up to date and that the storage sources have a host access status of Read/Write.
- To more than one Host port
DataCore vDisks always have their own unique Network Address Authority (NAA) identifier that a Host can use to manage the same vDisk being served to multiple ports on the same host server and the same vDisk being served to multiple Hosts.
While DataCore cannot guarantee that a disk device's NAA is used by a host's operating system to identify a disk device served to it over different paths generally we have found that it is. Additionally, while there is sometimes a convention that all paths by the same disk device always using the same LUN 'number' guarantees consistency for device identification, this may not be technically true. Always refer to the Host Operating System vendor’s documentation for advice on this.
DataCore's Software does, however always try to create mappings between the host's ports and the DataCore Server's FE ports for a vDisk using the same LUN number where it can. The software will first find the next available (lowest) LUN 'number' for the Host- DataCore FE mapping combination being applied and will then try to apply that same LUN number for all other mappings that are being attempted when the vDisk is being served. If any Host-DataCore FE port combination being requested at that moment is already using that same LUN number (e.g. if a host has other vDisks served to it from previous) then the software will find the next available LUN number and apply that to those specific Host-DataCore FE mappings only.
AIX Host Settings
DataCore Support for AIX MPIO Software
Download and install the DataCore Support for AIX MPIO software package on the AIX Host. For installation and configuration instructions, visit DataCore Support.
Disk Timeouts
rw_timeout and hcheck_interval settings
Set the ‘rw_timeout’ to 60 seconds and the ‘hcheck_interval’ to something equal to or higher than the ‘rw_timeout’ setting - as per IBM’s own recommendations.
Use the following command to change both the ‘hcheck_interval’ and ‘rw_timeout’ values at the same time:
A reboot of the Host is required to make these settings permanent.
Enable Fast I/O Failure
Use the following command to enable Fast I/O Failure for all Fibre Channel (FC) devices:
Device Queue Depth
Set the Device Queue Depth for all served DataCore virtual disks (vDisks).
- Identify the DataCore vDisk.
The following example shows 'hdisk2' as the DataCore vDisk.
- Get the disk device's attributes.
In the example above, the queue depth value is 1.
- Set the value to 16.
- Verify the change.
16 is the value that DataCore use when qualifying AIX. Larger values are possible up to and including 32. Larger values are not supported. Smaller values are also possible but may reduce Host performance for DataCore vDisks.
Known Issues in AIX Configuration Guide
The following is intended to make DataCore Software users aware of any issues that affect performance, access or may give unexpected results under particular conditions when SANsymphony is used in configurations with AIX Hosts.
These known issues may have been found during DataCore’s own testing but others may have been reported by our users when a solution was found that was not to do with DataCore’s own products.
DataCore cannot be held responsible for incorrect information regarding another vendor’s products and no assumptions should be made that DataCore has any communication with these other vendors regarding the issues listed here.
We always recommend that the vendor’s should be contacted directly for more information on anything listed in this section.
For ‘Known issues’ that apply to DataCore Software’s own products, refer to the relevant DataCore Software Component’s release notes.
AIX may set the device queue depth to 1 for all DataCore virtual disks
It has been found in testing that disks served to AIX Hosts that are not detected as ‘IBM storage’ can have the queue depth to the minimum value of 1 which will significantly reduce host performance for DataCore virtual disks (vDisks). DataCore recommend a value of 16. Refer to the Device Queue Depth for instructions on how to change the queue depth setting on served DataCore vDisks.
Appendices
A: Preferred Server and Preferred Path Settings
Without ALUA Enabled
If hosts are registered without ALUA support, the Preferred Server and Preferred Path settings will serve no function. All DataCore Servers and their respective Front-end (FE) paths are considered ‘equal’.
It is up to the Host’s Operating System or Failover Software to determine which DataCore Server is its preferred server.
With ALUA Enabled
ALUA is not supported for AIX Hosts.
Refer to Preferred Servers and Preferred Paths for more information.
B: Reclaiming Storage from Disk Pools
How Much Storage will be Reclaimed?
This is impossible to predict.
SANsymphony can only reclaim Storage Allocation Units (SAU) that have no block-level data on them. If a host writes its data ‘all over’ its own filesystem, rather than contiguously, the amount of storage that can be reclaimed may be significantly less than expected.
Defragmenting Data on Virtual Disks
It may be possible to use a host’s defragmentation tools to consolidate data spread out all over the host’s filesystem but care should be taken as even more storage may be allocated while the existing data is defragmented.
Once any defragmentation is completed then additional steps will need to wipe the ‘free’ filesystem space on the host and then use SANsymphony’s ‘Manual Reclamation’ feature.
Notes on SANsymphony's Reclamation Feature
Automatic Reclamation
SANsymphony checks for any ‘zero’ write I/O as it is received by the disk pool and keeps track of which block addresses they were sent to. When all the blocks of an allocated SAU have received ‘zero’ write I/O, the storage used by the SAU is then reclaimed.
Mirrored and replicated virtual disks (vDisks) will mirror/replicate the ‘zero’ write I/O so that storage can be reclaimed on the mirror/replication destination DataCore Server in the same way.
Manual Reclamation
SANsymphony checks for ‘zero’ block data by sending read I/O to the storage. When all the blocks of an allocated SAU are detected as having ‘zero’ data on them, the storage used by the SAU is then reclaimed.
Mirrored vDisks will receive the manual reclamation ‘request’ on all DataCore Servers involved in the mirror configuration at the same time and each DataCore Server will read from its own storage.
The Manual reclamation ‘request’ is not sent to replication destination DataCore Servers from the source. Replication destinations will need to be manually reclaimed separately.
Reclaiming Storage on the Host Manually
A suggestion would be to create a ‘sparse file’ of an appropriate size and write zeroes it using the ‘dd’ command.
Here is an example with a 2TB sparse file: