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.

Table 1. Configuration parameters used by AFM cache and AFM-DR primary clusters
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.
0
Full file prefetching after reading 3 blocks
1-99
The percentage of the file size that must be cached before the entire file is pulled into the cache cluster
100
Disables full file prefetching. Only fetches and caches data blocks that are read by the application. When all data blocks have been cached, the file is marked as cached
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
Start of changeafmRefreshAsync

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.

End of change
Start of changeBooleanEnd of change Start of changeRO, SW, IW, LUEnd of change Start of changeyes | noEnd of change Start of changenoEnd of change Start of changeyesEnd of change Start of changenoEnd of change