Configuration parameters for AFM
The following table lists the AFM and AFM-based DR configuration parameters with their default values and the commands to set and edit the parameters.
AFM configuration parameter | Unit | Mode on AFM | Valid values | Default value | Tunable at the cluster level | Tunable at the fileset level |
---|---|---|---|---|---|---|
afmAsyncDelay Indicates the time at which the requests start flushing to the home cluster. For write-intensive applications that write to the same set of files, this delay is helpful because it replaces multiple writes to the home cluster with a single write containing the latest data. However, setting a very high value weakens the consistency of the data on the remote cluster. |
Seconds | SW, IW | 1 - 2147483647 | 15 | yes | yes |
afmDirLookupRefreshInterval Defines the frequency of revalidation triggered by a look-up operation such as ls or stat on a directory from the cache cluster. AFM sends a message to the home cluster to find out whether the metadata of that directory is modified since it was last revalidated. If so, the latest metadata information at the home cluster is reflected on the cache cluster. |
Seconds | RO, LU, IW | 0 - 2147483647 | 60 | yes | yes |
afmDirOpenRefreshInterval Defines the frequency of revalidations triggered by the read and update operations on a directory from the cache cluster. AFM sends a message to the home cluster to find whether the metadata of that directory is modified since it was last revalidated. Open requests on files or sub-directories on that directory are served from the cache fileset until the afmDirOpenRefreshInterval expires, after which the open requests are sent to the home cluster. |
Seconds | RO, LU, IW | 0 - 2147483647 | 60 | yes | yes |
afmDisconnectTimeout Defines the interval until which the MDS waits after it detects that the home cluster is inaccessible before declaring the outage by moving the cache cluster state to Disconnected. |
Seconds | RO, SW, IW, LU | 0 - 2147483647, disable | 60 | yes | no |
afmEnableNFSSec If enabled at cache, exported paths from home with kerberos-enabled security levels like sys, krb5, krb5i, krb5p are mounted at cache in the increasing order of security level - sys, krb5, krb5i, krb5p. For example, the security level of exported path is krb5i then at cache, AFM tries to mount with level sys, followed by krb5, and finally mounts with the security level krb5i. If disabled at cache, exported paths from home are mounted with security level sys at cache. You must configure KDC clients on all the gateway nodes at cache before enabling this parameter. |
Boolean | RO, SW, IW,LU | yes | no | no | yes | no |
afmExpirationTimeout Is used with afmDisconnectTimeout to control the duration of a network outage between the cache and home clusters before the data in the cache expires and becomes unavailable until a home reconnection occurs. |
Seconds | RO | 0 - 2147483647, disable | disabled | yes | yes |
afmFileLookupRefreshInterval Defines the frequency of revalidation triggered by a look-up operation on a file such as ls or stat, from the cache cluster. AFM sends a message to the home cluster to determine that the metadata of the file is modified since it was last revalidated. If so, the latest metadata information at home is reflected on the cache cluster. |
Seconds | RO, LU, IW | 0 - 2147483647 | 30 | yes | yes |
afmFileOpenRefreshInterval Defines the frequency of revalidations triggered by the read and write operations on a file from the cache cluster. AFM sends a message to the home cluster to determine that the metadata of the file is modified since it was last revalidated. Open requests on the file are served from the cache fileset until the afmFileOpenRefreshInterval expires, after which the open requests are sent to the home cluster. |
Seconds | RO, LU, IW | 0 - 2147483647 | 30 | yes | yes |
afmEnableAutoEviction Indicates if automatic eviction is triggered on a fileset. |
Boolean | RO, SW, IW,LU | yes | no | yes | no | yes |
afmPrefetchThreshold Controls the partial file caching feature.
|
Whole number | RO, SW, IW,LU | 0 - 100 | 0 | no | yes |
afmShowHomeSnapshot Controls the visibility of the home snapshot directory in the cache cluster. For this to be visible in the cache cluster, this variable must to be set to yes, and the snapshot directory name in the cache and home clusters must not be the same. |
Boolean | RO, LU | yes | no | no | yes | yes |
afmReadSparseThreshold When a sparse file at the home cluster is read into the cache, the cache cluster maintains the sparseness, if the size of the file exceeds the afmReadSparseThreshold. If the size of a file is less than the threshold, sparseness is not maintained at the cache cluster. |
Bytes | RO, SW, IW,LU | 0 - 2147483647 | 128 M | yes | yes |
afmHashVersion Specifies the gateway node hashing algorithm that minimizes the impact of gateway nodes joining or leaving the active cluster by running as few recoveries as possible and balance mapping of AFM filesets across the gateway node. Valid values are 1,2,4, and 5. Default value is 2. You can specify the value by using mmchconfig. For example, to set the value 4, run mmchconfig afmHashVersion=4. |
Number | Not applicable | 1 | 2 | 4| 5 | 2 | yes | no |
afmMaxParallelRecoveries Specifies the number of filesets in the cluster on all file systems, on which recovery is run. |
Whole number | RO, SW, IW,LU | 0 - 128 | 0 | yes | no |
afmMountRetryInterval Specifies the interval after which the primary gateway retries an operation at home, in cases where home is in an unhealthy state (see Unmounted, Dropped states). Needs the GW node recycle or -i option for immediate effect. |
Seconds | RO, SW, IW,LU | 1 - (2 GiB - 1) | 300 | no | no |
afmAsyncOpWaitTimeout Specifies the time that AFM waits for completion of any inflight asynchronous operation which is synchronizing with the home cluster. Subsequently, AFM cancels the operation and synchronizes again after home is available. |
Seconds | RO, SW, IW | 5 - 2147483647 | 300 | yes | no |
afmSyncOpWaitTimeout Specifies the time that AFM waits for completion of any inflight synchronous operation which is synchronizing with the home cluster. When any application is performing any synchronous operation at cache, AFM tries to get a response from home. If home is not responding, application might be unresponsive. If operation does not complete in this timeout interval, AFM cancels the operation. |
Seconds | RO, SW, IW | 5 - 2147483647 | 180 | yes | no |
afmRevalOpWaitTimeout Specifies the time that AFM waits for completion of revalidation to get response from the home cluster. Revalidation checks if any changes are available at home (data and metadata) that need to be updated to the cache cluster. Revalidation is performed when application trigger operations like lookup or open at cache. If revalidation is not completed within this time, AFM cancels the operation and returns data available at cache to the application. |
Seconds | RO, IW | 5 - 2147483647 | 180 | yes | no |
afmRefreshAsync Cache data refresh operation in asynchronous mode improves performance of applications querying data. Specify the value as 'yes' for the cache data refresh operation to be in asynchronous mode. In IW mode, revalidation request for files or directories is queued as an asynchronous request, and data in the last synchronized state is returned. The data is refreshed at cache after revalidation with home is complete. Revalidation time depends on the network availability and its bandwidth. |
Boolean | RO, SW, IW, LU | yes | no | no | yes | no |