Attributes

Required attributes

Required attribute

Description

BlockDevice 

Block device for mount point. 

When you specify the block device to mount, enclose IPv6 addresses in square brackets. The mount command requires square brackets around the IPv6 address to differentiate between the colons in the address and the colon that separates the remote host and remote directory. 

Type and dimension: string-scalar 

Examples: 

  • "/dev/vx/dsk/myvcs_dg/myvol"
  • IPv6

    "[fe80::1:2:3]:/dirname/anotherdir"

 

FsckOpt 

Mandatory for the following file systems types: 

  • jfs
  • jfs2
  • vxfs

Use this attribute to specify options for the fsck command. You must correctly set this attribute for local mounts. If the mount process fails, the fsck command is executed with the specified options before it attempts to remount the block device. Its value must include either -y, -n, or -p. The -p option is only for jfs or jfs2 file systems on AIX. Refer to the fsck manual page for more information. 

For NFS mounts, the value of this attribute is not applicable and is ignored. 

Type and dimension: string-scalar 

Example: "-n" 

Example: "-y" 

 

FSType 

Type of file system. 

Supports jfs, jfs2, nfs, namefs, or vxfs. 

Type and dimension: string-scalar 

Example: "vxfs" 

 

MountPoint 

Directory for mount point 

Type and dimension: string-scalar 

Example: "/tmp/mnt" 

 

VxFSMountLock 

This attribute is only applicable to Veritas (VxFS) file systems. This attribute controls a file system locking feature to prevent accidental unmounts.  

This attribute can take three values: 0, 1, or 2. 

VxFSMountLock=0 

The resource does not detect any changes to the lock when VCS reports that it is online after you set the value to zero. 

  • If the mount point is initially locked with the mntlock="VCS", the monitor agent function unlocks it.
  • If the mount point is initially locked with a key that is not equal to "VCS", the agent logs a message once.
  • If the mount point is initially not locked, no action is performed.

VxFSMountLock=1 

The resource does not detect changes to the lock when VCS reports it online after the value was set to one. VCS does not monitor the lock. 

  • If the mount point is initially locked with the mntlock="VCS", no action is performed.
  • If the mount point is initially locked with a key that is not equal to "VCS", the agent logs a message once.
  • If the mount point is initially not locked, the monitor agent function locks it with the mntlock="VCS".

VxFSMountLock=2 

When the value of the VxFSMountLock is 2, the file system is locked and the agent monitors any change to mntlock. 

  • If the mount point is locked with the mntlock="VCS", no action is performed.
  • If the mount point is initially locked with a key that is not equal to "VCS", the monitor agent function logs a message whenever a change in mntlock is detected.
  • If the mount point is not locked, the agent locks it with the mntlock="VCS".

Type and dimension: integer-scalar 

Default: 1 

 

Optional attributes

Optional attribute

Description

MountOpt 

Options for the mount command. Refer to the mount manual page for more information. 

Do not set the VxFS mount option "mntlock=key". The agent uses this option only when bringing a Mount resource online. 

Type and dimension: string-scalar 

Example: "rw" 

 

SnapUmount 

If the value of this attribute is 1, this attribute automatically unmounts VxFS snapshots when the file system is unmounted. 

If the value of this attribute is 0, and snapshots are mounted, the resource cannot be brought offline. In this case, failover does not occur.  

Type and dimension: integer-scalar 

Default: 0 

 

CkptUmount 

If the value of this attribute is 1, this attribute automatically unmounts VxFS checkpoints when file system is unmounted. 

If the value of this attribute is 0, and checkpoints are mounted, then failover does not occur. 

Type and dimension: integer-scalar 

Default: 1 

 

SecondLevelMonitor 

This attribute is only applicable for an NFS client mount. 

If the value of this attribute is 1, this attribute enables detailed monitoring of an NFS mounted file system. The agent executes the df -k command for the NFS mounted file system to detect network outage. 

Type and dimension: boolean-scalar 

Default: 0 

 

SecondLevelTimeout 

This attribute is only applicable for an NFS client mount. 

This attribute is the timeout (in seconds) for the SecondLevelMonitor attribute. This attribute is only functional when the value of the SecondLevelMonitor attribute is 1. The actual timeout value can be much smaller. This setting depends on how much time remains before it exceeds the MonitorTimeout interval. 

Type and dimension: integer-scalar 

Default: 30 

 

AccessPermissionChk 

If the value of this attribute is 1 or 2, the monitor verifies that the values of the MntPtPermission, MntPtOwner, and MntPtGroup attributes are the same as the actual mounted file system values. 

If any of these do not match the values that you have defined, a message is logged. 

If the value of this attribute is 2, and if the mounted file system permissions do not match the attribute values, the Monitor agent function returns the state as offline

Type and dimension: integer-scalar 

Default: 0 

 

CreateMntPt 

If the value of this attribute is 0, no mount point is created. The mount can fail if the mount point does not exist with suitable permissions. 

If the value of this attribute is 1 or 2, and a mount point does not exist, the agent creates a mount point with system default permissions when the resource is brought online. If the permissions for the mount point are less than 555, a warning message is logged. 

If the value of this attribute is 2, and the mount point does not exist, the agent creates a mount point with system default permissions when the resource is brought online. If the permissions for the mount point are less than 555, a warning message is logged. In addition, VCS deletes the mount point and any recursively created directories when the resource is brought offline. The mount point gets deleted only if it is empty, which is also true for recursive mount points.  

Type and dimension: integer-scalar 

Default: 0 

 

MntPtGroup 

This attribute specifies the group ownership of the mounted file system. The agent verifies the group ownership of the mounted file system every monitor cycle if the value of the AccessPermissionChk attribute is not 0. 

Type and dimension: string-scalar 

Example: "grp1" 

 

MntPtOwner 

This attribute specifies the user ownership of the mounted file system. The agent verifies the user ownership of the mounted file system every monitor cycle if the value of the AccessPermissionChk attribute is not 0. 

Type and dimension: string-scalar 

Example: "usr1" 

 

MntPtPermission 

This attribute specifies the permissions of the mounted file system in an absolute format of a four-digit octal. The agent verifies the mode of the mounted file system every monitor cycle if the value of the AccessPermissionChk attribute is not 0. 

Type and dimension: string-scalar 

Example: "0755" 

 

OptCheck 

The value of this attribute determines if VCS should verify the mount options. The state of the resource is determined based on the result of the verification. 

If the value of this attribute is 0 (default), the mount options are not checked. 

If the value of the OptCheck attribute is 1, 2 or 3, a check is performed to see if the mount command options that you have specified for VCS are set in the MountOpt attribute. The MountOpt attributes should be the same as the actual mount command options. If the actual mount options differ from the MountOpt attribute, a message is logged. The state of the resource depends on the value of this attribute. 

If the value of the attribute is 1, the state of the resource is unaffected.  

If the value is 2, the state of the resource is set to offline.  

If the value is 3, state of the resource is set to unknown. 

Type and dimension: integer-scalar  

Default: 0 

 

RecursiveMnt 

If the value of this attribute is 1, VCS creates all the parent directories of the mount point if necessary. 

Type and dimension: boolean-scalar 

Default: 0 

 

ReuseMntPt 

If the same mount point needs to be specified in more than one mount resource, set the value of this attribute to 1. Note that this attribute only accepts a value of 1 or 0. 

To use this attribute, the cluster administrator needs to add this attribute to the ArgList resource type attribute of the agent. Set the appropriate group and resource dependencies such that only one resource can come online on a system at a time. 

Type and dimension: integer-scalar 

Default: 0