Attributes for Mount agent
Prev Mount agent Next

Attributes for Mount agent

Table: Required attributes

Required attribute

Description

BlockDevice

Block device for mount point.

When you specify the block device to mount NFS remote file system with IPv6 addresses, 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:

  • VxVM

    "/dev/vx/dsk/myvcs_dg/myvol"

  • LVM

    "/dev/vg01/lvol01"

  • IPv4

    "10.209.70.90:/dirname/anotherdir"

  • IPv6

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

FsckOpt

Mandatory for non-NFS mounts.

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 or -n. Refer to the fsck manual page for more information.

Both the -y and -n arguments enable the VxFS file systems to perform a log replay before a full fsck operation. -n will check the file system and log it. Read man fsck for further information.

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

Type and dimension: string-scalar

VxFS example: -y

Note:

When you use the command line, add the % sign to escape '-'. For example: hares -modify MntRes FsckOpt %-y

FSType

Type of file system.

Supports vxfs, hfs, lofs, or nfs.

Type and dimension: string-scalar

Example: "nfs"

MountPoint

Directory on which the BlockDevice needs to be mounted.

Type and dimension: string-scalar

Example: "/campus1"

VxFSMountLock

This attribute is only applicable to 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 agent's monitor 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 agent's monitor 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 every monitor cycle.

  • If the mount point is not locked, the agent locks it with the mntlock="VCS".

Type and dimension: integer-scalar

Default: 1

Table: Optional attributes

Optional attribute

Description

CkptUmount

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

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

Type and dimension: integer-scalar

Default: 1

MountOpt

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

Type and dimension: string-scalar

Example: "rw"

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 of 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 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"

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 function returns the state as OFFLINE.

Type and dimension: integer-scalar

Default: 0

OptCheck

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

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

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, then failover does not occur.

Type and dimension: integer-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 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
Prev Up Next
State definitions for Mount agent Home Resource type definition for Mount agent