InfoScale™ Cluster Server 9.0 Bundled Agents Reference Guide - Solaris

Last Published:
Product(s): InfoScale & Storage Foundation (9.0)
Platform: Solaris
  1. Introducing bundled agents
    1.  
      About bundled agents
    2.  
      Resources and their attributes
    3.  
      Modifying agents and their resources
    4.  
      Attributes
    5.  
      Zone-aware agents
    6.  
      IMF-aware agents
    7.  
      Enabling debug log messages
    8.  
      VCS support for multi-pathing solutions
  2. Storage agents
    1.  
      About the storage agents
    2. DiskGroup agent
      1.  
        IMF awareness
      2.  
        Dependencies for DiskGroup agent
      3.  
        Agent functions for DiskGroup agent
      4.  
        State definitions for DiskGroup agent
      5.  
        Attributes for DiskGroup agent
      6.  
        Resource type definition for DiskGroup agent
      7. Notes for DiskGroup agent
        1.  
          High availability fire drill
        2.  
          Using volume sets
        3. Setting the noautoimport flag for a disk group
          1.  
            VxVM noautoimport flag usage
        4.  
          Configuring the Fiber Channel adapter
        5.  
          Using the DiskGroup agent with IMF
        6.  
          Using the DiskGroup agent with NFS
      8. Sample configurations for DiskGroup agent
        1.  
          DiskGroup resource configuration
      9.  
        Debug log levels for DiskGroup agent
    3. DiskGroupSnap agent
      1.  
        Dependencies for DiskGroupSnap agent
      2.  
        Agent functions for DiskGroupSnap agent
      3.  
        State definitions for DiskGroupSnap agent
      4.  
        Attributes for DiskGroupSnap agent
      5. Notes for DiskGroupSnap agent
        1.  
          Fire drill configuration after upgrading VCS
        2.  
          Configuring the SystemZones attribute for the fire drill service group
        3.  
          Configuring the FireDrill service group
        4.  
          Adding the ReuseMntPt attribute to the ArgList attribute for the Mount agent type
        5.  
          Configuration considerations
        6.  
          Agent limitations
      6.  
        Resource type definition for DiskGroupSnap agent
      7. Sample configurations for DiskGroupSnap agent
        1.  
          Typical main.cf configuration for DiskGroupSnap agent
        2.  
          Sample main.cf of DiskGroupSnap with Oracle resource
      8.  
        Debug log levels for DiskGroupSnap agent
    4. Disk agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6.  
        Debug log levels
    5. Volume agent
      1.  
        Dependencies for Volume agent
      2.  
        Agent functions for Volume agent
      3.  
        State definitions for Volume agent
      4.  
        Attributes for Volume agent
      5.  
        Resource type definition for Volume agent
      6.  
        Sample configuration for Volume agent
      7.  
        Debug log levels for Volume agent
    6. VolumeSet agent
      1.  
        Dependencies for VolumeSet agent
      2.  
        Agent functions for VolumeSet agent
      3.  
        State definitions for VolumeSet agent
      4.  
        Attributes for VolumeSet agent
      5.  
        Resource type definition for VolumeSet agent
      6. Sample configurations for VolumeSet agent
        1.  
          A configured VolumeSet that is dependent on a DiskGroup resource
      7.  
        Agent notes for VolumeSet agent
      8.  
        Inaccessible volumes prevent the VolumeSet agent from coming online
      9.  
        Debug log levels for VolumeSet agent
    7. Mount agent
      1.  
        IMF awareness
      2.  
        Dependencies for Mount agent
      3.  
        Agent functions for Mount agent
      4.  
        State definitions for Mount agent
      5.  
        Attributes for Mount agent
      6.  
        Resource type definition for Mount agent
      7.  
        Notes for Mount agent
      8.  
        High availability fire drill
      9.  
        VxFS file system lock
      10.  
        IMF usage notes
      11.  
        IPv6 usage notes
      12.  
        Support for loopback file system
      13.  
        Enabling Level two monitoring for the Mount agent
      14.  
        ZFS file system and pool creation example
      15.  
        Support for VxFS direct mount inside non-global zones
      16. Sample configurations for Mount agent
        1.  
          VxFS configuration example for Mount agent
      17.  
        Debug log levels for Mount agent
    8. Zpool agent
      1.  
        Limitations for Zpool agent
      2.  
        Dependencies for Zpool agent
      3.  
        Agent functions for Zpool agent
      4.  
        State definitions for Zpool agent
      5.  
        Attributes for Zpool agent
      6.  
        Resource type definition for Zpool agent
      7.  
        Sample configurations for Zpool agent
      8.  
        Debug log levels for Zpool agent
    9. VMwareDisks agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Attributes
      4.  
        Resource type definition
      5.  
        Sample configurations
    10. SFCache agent
      1.  
        Resource dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6. Notes for SFCache agent
        1.  
          Configuring SFCache resource with CVM/CFS
      7.  
        Debug log levels
  3. Network agents
    1. About the network agents
      1. Agent comparisons
        1.  
          IP and NIC agents
        2.  
          IPMultiNICB and MultiNICB agents
        3.  
          802.1Q trunking
        4.  
          Link aggregation support
    2. IP agent
      1.  
        High availability fire drill for IP agent
      2.  
        Dependencies for IP agent
      3.  
        Agent functions for IP agent
      4.  
        State definitions for IP agent
      5.  
        Attributes for IP agent
      6.  
        Resource type definition for IP agent
      7. Sample configurations for IP agent
        1.  
          Configuration 1
        2.  
          NetMask in decimal (base 10)
        3.  
          Configuration of NetMask in hexadecimal (base 16)
      8.  
        Debug log levels for IP agent
    3. NIC agent
      1.  
        Dependencies for NIC agent
      2.  
        Agent functions for NIC agent
      3.  
        State definitions for NIC agent
      4.  
        Attributes for NIC agent
      5.  
        Resource type definition for NIC agent
      6. Notes for the NIC agent
        1.  
          High availability fire drill for NIC agent
        2.  
          Solaris 11: Change of behavior in IPv4 and IPv6 interface state
      7. Sample configurations for NIC agent
        1.  
          Configuration without network hosts (using default ping mechanism) for NIC agent
        2.  
          Configuration with network hosts for NIC agent
        3.  
          IPv6 configuration for NIC agent
      8.  
        Exclusive IP Zone configuration for NIC agent
      9.  
        Debug log levels for NIC agent
    4. About the IPMultiNICB and MultiNICB agents
      1.  
        Checklist to ensure the proper operation of MultiNICB
    5. IPMultiNICB agent
      1.  
        Dependencies for IPMultiNICB agent
      2.  
        Requirements for IPMultiNICB
      3.  
        Agent functions for IPMultiNICB agent
      4.  
        State definitions for IPMultiNICB agent
      5.  
        Attributes for IPMultiNICB agent
      6.  
        Resource type definition for IPMultiNICB agent
      7.  
        Manually migrating a logical IP address for IPMultiNICB agent
      8. Sample configurations for IPMultiNICB agent
        1.  
          Other sample configurations for IPMultiNICB and MultiNICB
      9.  
        Debug log levels for IPMultiNICB agent
    6. MultiNICB agent
      1.  
        Base and Multi-pathing modes for MultiNICB agent
      2.  
        Oracle trunking for MultiNICB agent
      3.  
        The haping utility for MultiNICB agent
      4.  
        Dependencies for MultiNICB agent
      5.  
        Agent functions for MultiNICB agent
      6.  
        State definitions for MultiNICB agent
      7.  
        Attributes for MultiNICB agent
      8.  
        Optional attributes for Base and Mpathd modes for MultiNICB agent
      9.  
        Optional attributes for Base mode for MultiNICB agent
      10.  
        Optional attributes for Multi-pathing mode for MultiNICB agent
      11.  
        Resource type definition for MultiNICB agent
      12.  
        Solaris operating modes: Base and Multi-Pathing for MultiNICB agent
      13.  
        Base mode for MultiNICB agent
      14.  
        Failover and failback for MultiNICB agent
      15.  
        Multi-Pathing mode for MultiNICB agent
      16.  
        Configuring MultiNICB and IPMultiNICB agents on Solaris 11
      17.  
        Trigger script for MultiNICB agent
      18. Sample configurations for MultiNICB agent
        1.  
          Interface configuration for MultiNICB agent on Solaris
        2.  
          Setting up test IP addresses for Base Mode
        3.  
          IPMultiNICB and MultiNICB configuration for MultiNICB agent
        4.  
          IPv6 configuration for MultiNICB agent
      19.  
        Debug log levels for MultiNICB agent
    7. DNS agent
      1.  
        Dependencies for DNS agent
      2.  
        Agent functions for DNS agent
      3.  
        State definitions for DNS agent
      4.  
        Attributes for DNS agent
      5.  
        Resource type definition for DNS agent
      6. Agent notes for DNS agent
        1. About using the VCS DNS agent on UNIX with a secure Windows DNS server
          1.  
            Software requirement for DNS agent
          2.  
            Configuration requirement for DNS agent
        2.  
          High availability fire drill for DNS agent
        3.  
          Monitor scenarios for DNS agent
        4.  
          Sample Web server configuration for DNS agent
        5.  
          Secure DNS update for BIND 9 for DNS agent
        6.  
          Setting up secure updates using TSIG keys for BIND 9 for DNS agent
      7. Sample configurations for DNS agent
        1.  
          Basic IPv6 configuration for DNS agent
        2.  
          IPv6 CNAME sample configuration for DNS agent
        3.  
          IPv4 A sample configuration for DNS agent
      8.  
        Debug log levels for DNS agent
  4. File share agents
    1.  
      About the file service agents
    2. NFS agent
      1.  
        Dependencies for NFS agent
      2.  
        Agent functions for NFS agent
      3.  
        State definitions for NFS agent
      4.  
        Attributes for NFS agent
      5.  
        Resource type definition for NFS agent
      6.  
        Sample configurations for NFS agent
      7.  
        Debug log levels for NFS agent
    3. NFSRestart agent
      1.  
        Dependencies for NFSRestart agent
      2.  
        Agent functions for NFSRestart agent
      3.  
        State definitions
      4.  
        Attributes for NFSRestart agent
      5.  
        Resource type definition for NFSRestart agent
      6. Notes for NFSRestart agent
        1.  
          About high availability fire drill
        2.  
          Mounting NFS export with the -vers options can cause lock failure
        3.  
          Providing a fully qualified host name
        4.  
          Service Management Facility
      7. Sample configurations for NFSRestart agent
        1.  
          Basic agent configurations
      8.  
        Debug log levels for NFSRestart agent
    4. Share agent
      1.  
        Dependencies for Share agent
      2.  
        Agent functions for Share agent
      3.  
        State definitions for Share agent
      4.  
        Attributes for Share agent
      5.  
        Resource type definition for Share agent
      6. Notes for Share agent
        1.  
          High availability fire drill
      7.  
        Sample configurations for Share agent
      8.  
        Debug log levels for Share agent
    5. About the Samba agents
      1.  
        The Samba agents
      2.  
        Before using the Samba agents
      3.  
        Supported versions for Samba agents
      4. Notes for configuring the Samba agents
        1.  
          Configuring multiple SambaServer resources
        2.  
          Configuring Samba for non-standard configuration files or non-standard lock directories
      5. SambaServer agent
        1.  
          Dependencies for SambaServer agent
        2.  
          Agent functions for SambaServer agent
        3.  
          State definitions for SambaServer agent
        4.  
          Attributes for SambaServer agent
        5.  
          Resource type definitions for SambaServer agent
        6.  
          Sample configurations for SambaServer agent
        7.  
          Debug log levels for SambaServer agent
      6. SambaShare agent
        1.  
          Dependencies for SambaShare agent
        2.  
          Agent functions for SambaShare agent
        3.  
          State definitions for SambaShare agent
        4.  
          Attributes for SambaShare agent
        5.  
          Resource type definition for SambaShare agent
        6.  
          Sample configuration for SambaShare agent
        7.  
          Debug log levels for SambaShare agent
    6. NetBios agent
      1.  
        Dependencies for NetBios agent
      2.  
        Agent functions for NetBios agent
      3.  
        State definitions for NetBios agent
      4.  
        Attributes for NetBios agent
      5.  
        Resource type definition for NetBios agent
      6.  
        Sample configuration for NetBios agent
      7.  
        Debug log levels for NetBios agent
  5. Service and application agents
    1.  
      About the services and applications agents
    2. AlternateIO agent
      1.  
        Dependencies for AlternateIO agent
      2.  
        Agent functions for AlternateIO agent
      3.  
        State definitions for AlternateIO agent
      4.  
        Attributes for AlternateIO agent
      5.  
        Resource type definition for AlternateIO agent
      6.  
        Sample configurations for AlternateIO agent
      7.  
        Debug log levels for AlternateIO agent
    3. Apache HTTP server agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6. Apache HTTP server notes
        1.  
          Tasks to perform before you use the Apache HTTP server agent
        2.  
          About detecting application failure
        3.  
          About bringing an Apache HTTP server online outside of VCS control
        4.  
          About high Availability fire drill
        5.  
          Using Apache agent with IMF
        6.  
          Troubleshooting Apache service group issue
      7. Sample configurations
        1.  
          Basic configuration for Solaris
        2.  
          Basic IPv6 configuration
        3.  
          Sample output of the amfstat command
      8.  
        Debug log level
    4. Application agent
      1.  
        IMF awareness
      2.  
        High availability fire drill for Application agent
      3.  
        Dependencies for Application agent
      4.  
        Agent functions
      5.  
        State definitions for Application agent
      6.  
        Attributes for Application agent
      7.  
        Resource type definition for Application agent
      8. Notes for Application agent
        1.  
          Using Application agent with IMF
        2.  
          Level two monitoring through MonitorProgram
        3.  
          Using Application agent with ProPCV
        4.  
          Requirement for programs
        5.  
          Requirement for default profile
        6.  
          Support for cloned Application agent
      9. Sample configurations for Application agent
        1.  
          Configuration 1 for Application agent
        2.  
          Configuration 2 for Application agent
        3.  
          Configuration 3 for Application agent
      10.  
        Debug log levels for Application agent
    5. CoordPoint agent
      1.  
        Coordination Point server as a coordination point
      2.  
        SCSI-3 based disk as a coordination point
      3.  
        Dependencies
      4.  
        Agent functions
      5.  
        State definitions
      6.  
        Attributes
      7.  
        Resource type definition
      8. Notes for the CoordPoint agent
        1.  
          CoordPoint agent I/O fencing reporting activities
        2.  
          AutoStartList attribute
        3.  
          Detailed monitoring for the Coordpoint resource
        4.  
          The ActionOnCoordPointFault attribute set to RefreshRegistrations
      9.  
        Sample configuration
      10.  
        Debug log levels
    6. LDom agent
      1.  
        Configuring primary and logical domain dependencies and failure policy
      2.  
        IMF awareness
      3. Dependencies
        1.  
          Network resources
        2.  
          Storage resources
      4.  
        Agent functions
      5.  
        State definitions
      6.  
        Attributes
      7.  
        Resource type definition
      8.  
        LDom agent notes
      9.  
        About the auto-boot? variable
      10.  
        Notes for the DomainFailurePolicy attribute
      11.  
        Using VCS to migrate a logical domain
      12.  
        Configuring the LDom agent for DR in a Global Cluster environment
      13.  
        Using the LDom agent with IMF
      14.  
        Sample configuration 1
      15.  
        Sample configuration 2
      16.  
        Configuration to support user-initiated LDom migration
      17.  
        Configuration for VCS-initiated migration
      18.  
        Sample configuration (Dynamic virtual machine service group failover)
      19.  
        Debug log levels
    7. Process agent
      1.  
        IMF awareness
      2.  
        High availability fire drill for Process agent
      3.  
        Dependencies for Process agent
      4.  
        Agent functions for Process agent
      5.  
        State definitions for Process agent
      6.  
        Attributes for Process agent
      7.  
        Resource type definition for Process agent
      8. Usage notes for Process agent
        1.  
          Prerequisites for processes
      9. Sample configurations for Process agent
        1.  
          Configuration 1 for Process agent
        2.  
          Configuration 2 for Process agent
      10.  
        Debug log levels for Process agent
    8. ProcessOnOnly agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6. ProcessOnOnly agent usage notes
        1.  
          Requirement for programs
      7.  
        Sample configurations
      8.  
        Debug log levels
    9. Project agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        Attributes
      4.  
        Resource type definition
      5.  
        Sample configuration
      6.  
        Debug log levels
    10. RestServer agent
      1.  
        Service group resource dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6.  
        Sample configuration
      7.  
        Troubleshooting information
    11. Zone agent
      1.  
        IMF awareness
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        Attributes
      5.  
        Configuring the Zone agent for DR in a Global Cluster environment
      6.  
        Resource type definition
      7.  
        Zone agent notes
      8.  
        Using the Zone agent with IMF
      9.  
        Debug log levels
  6. Infrastructure and support agents
    1.  
      About the infrastructure and support agents
    2. NotifierMngr agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6. Sample configuration
        1.  
          Configuration
      7.  
        Debug log levels
    3. Proxy agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        Attributes
      4.  
        Resource type definition
      5. Sample configurations
        1.  
          Configuration 1
        2.  
          Configuration 2
        3.  
          Configuration 3
      6.  
        Debug log levels
    4. Phantom agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        Resource type definition
      4. Sample configurations
        1.  
          Configuration 1
        2.  
          Configuration 2
    5. RemoteGroup agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6.  
        Debug log levels
  7. Testing agents
    1.  
      About the testing agents
    2. ElifNone agent
      1.  
        Dependencies for ElifNone agent
      2.  
        Agent function for ElifNone agent
      3.  
        State definitions for ElifNone agent
      4.  
        Attributes for ElifNone agent
      5.  
        Resource type definition for ElifNone agent
      6.  
        Sample configuration for ElifNone agent
      7.  
        Debug log levels for ElifNone agent
    3. FileNone agent
      1.  
        Dependencies for FileNone agent
      2.  
        Agent functions for FileNone agent
      3.  
        State definitions for FileNone agent
      4.  
        Attribute for FileNone agent
      5.  
        Resource type definition for FileNone agent
      6.  
        Sample configuration for FileNone agent
      7.  
        Debug log levels for FileNone agent
    4. FileOnOff agent
      1.  
        Dependencies for FileOnOff agent
      2.  
        Agent functions for FileOnOff agent
      3.  
        State definitions for FileOnOff agent
      4.  
        Attribute for FileOnOff agent
      5.  
        Resource type definition for FileOnOff agent
      6.  
        Sample configuration for FileOnOff agent
      7.  
        Debug log levels for FileOnOff agent
    5. FileOnOnly agent
      1.  
        Dependencies for FileOnOnly agent
      2.  
        Agent functions for FileOnOnly agent
      3.  
        State definitions for FileOnOnly agent
      4.  
        Attribute for FileOnOnly agent
      5.  
        Resource type definition for FileOnOnly agent
      6.  
        Sample configuration for FileOnOnly agent
      7.  
        Debug log levels for FileOnOnly agent
  8. Replication agents
    1.  
      About the replication agents
    2. RVG agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        Sample configurations
    3. RVGPrimary agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        Sample configurations
    4. RVGSnapshot
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        Sample configurations
    5. RVGShared agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        Sample configurations
    6. RVGLogowner agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        RVGLogowner agent notes
      7.  
        Sample configurations
    7. RVGSharedPri agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definitions
      6.  
        Sample configuration

Attributes for Mount agent

Table: 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"

  • IPv4

  • "10.209.70.90:/dirname/anotherdir"

  • IPv6

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

FsckOpt

Mandatory for the following file system types:

  • ufs

  • 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 or -n. 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

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 ufs, nfs, zfs, lofs, or vxfs.

Type and dimension: string-scalar

Example: "vxfs"

MountPoint

Directory for mount point

Type and dimension: string-scalar

Example: "/tmp/mnt"

Table: 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 Storage Checkpoints when 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

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. All directories in the path are created with system default permissions.

Note:

Permissions on mount points must be a minimum of 555 for the operating system commands to work correctly.

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

VxFSMountLock

This attribute is only applicable to File System (VxFS). 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

CacheRestoreAccess

This attribute is applicable only if:

  • File system type is VxFS.

  • Writeback caching is enabled for the SmartIO feature.

The value of this attribute determines whether to perform restore access operation or not. Following are the values:

  • 0: Does not perform restore access operation.

  • 1: Performs restore access operation.

Type and dimension: boolean-scalar

Default: 0

Note:

For the procedure and implications of enabling writeback caching, refer to the InfoScale SmartIO for Solid State Drives Solutions Guide.

Table: Internal attribute

Internal attribute

Description

AEPTimeout

This is an internal attribute. Do not modify this attribute. This attribute is used to pass the timeout value of agent entry points.