Cluster Server 7.3.1 Bundled Agents Reference Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (7.3.1)
Platform: Linux
  1. Introducing Bundled agents
    1.  
      About Bundled agents
    2.  
      Resources and their attributes
    3.  
      Modifying agents and their resources
    4.  
      Attributes
    5.  
      IMF-aware agents
    6.  
      Enabling debug log messages
    7.  
      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
      7. Notes for DiskGroup agent
        1.  
          High availability fire drill
        2.  
          Using volume sets
        3.  
          Setting the noautoimport flag for a disk group
        4.  
          Configuring the Fiber Channel adapter
        5.  
          Using the DiskGroup agent with IMF
      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. 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
    5. 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
    6. LVMLogicalVolume agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Attributes
      5.  
        Resource type definition
      6.  
        Sample configuration
      7.  
        Debug log levels
    7. LVMVolumeGroup agent
      1.  
        Dependencies for LVMVolumeGroup agent
      2.  
        Agent functions for LVMVolumeGroup agent
      3.  
        State definitions for LVMVolumeGroup agent
      4.  
        Attributes for LVMVolumeGroup agent
      5.  
        Resource type definition for LVMVolumeGroup agent
      6.  
        LVMVolumeGroup agent notes
      7.  
        Enabling volume group activation protection for Dynamic Multi-Pathing
      8.  
        Notes for volume group activation protection
      9. Sample configurations for LVMVolumeGroup agent
        1.  
          Linux configuration 1
        2.  
          Linux Configuration 2
      10.  
        Debug log levels for LVMVolumeGroup agent
    8. 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.  
        Support for spaces in directory names
      9.  
        Support for multiple bindfs
      10.  
        High availability fire drill
      11.  
        VxFS file system lock
      12.  
        IMF usage notes
      13.  
        Enabling Level two monitoring for the Mount agent
      14.  
        RHEL 7: NFS file system version
      15.  
        RHEL 7: Configuring bind mounts
      16.  
        Support for Amazon EFS
      17. Sample configurations for Mount agent
        1.  
          Basic configuration for Mount agent
        2.  
          VxFS mount lock example for Mount agent
        3.  
          NFS mount example for Mount agent
        4.  
          EFS mount example for Mount agent
      18.  
        Debug log levels for Mount 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
    11. AWS EBSVol agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Sample configuration
      8.  
        Debug log levels
    12. AzureDisk agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Sample configuration
      8.  
        Debug log levels
  3. Network agents
    1. About the network agents
      1. Agent comparisons
        1.  
          IP and NIC agents
        2.  
          IPMultiNIC and MultiNICA agents
        3.  
          802.1Q trunking
    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.  
          IPv4 Configuration
        2.  
          IPv6 Configuration
      8.  
        Debug log levels for IP agent
    3. NIC agent
      1.  
        Dependencies for NIC agent
      2.  
        Bonded network interfaces for NIC agent
      3.  
        Agent functions for NIC agent
      4.  
        State definitions for NIC agent
      5.  
        Attributes for NIC agent
      6.  
        Resource type definition for NIC agent
      7. Notes for the NIC agent
        1.  
          Monitoring bonded NICs for NIC agent
        2.  
          Setting Mii and miimon for NIC agent
        3.  
          High availability fire drill for NIC agent
      8.  
        Case 1
      9.  
        Case 2
      10.  
        Case 3
      11. Sample configurations for NIC agent
        1.  
          Configuration for using Mii for NIC agent
        2.  
          Configuration for using network hosts for NIC agent
        3.  
          IPv6 configuration for NIC agent
      12.  
        Debug log levels for NIC agent
    4. IPMultiNIC agent
      1.  
        Dependencies for IPMultiNIC agent
      2.  
        Agent functions for IPMultiNIC agent
      3.  
        State definitions for IPMultiNIC agent
      4.  
        Attributes for IPMultiNIC agent
      5.  
        Resource type definition for IPMultiNIC agent
      6. Sample configuration: IPMultiNIC and MultiNICA
        1.  
          IPv4 configuration for IPMultiNIC agent
        2.  
          IPv6 configuration for IPMultiNIC agent
        3.  
          Mixed mode configuration - IPv4 and IPv6 for IPMultiNIC agent
      7.  
        Debug log levels
    5. MultiNICA agent
      1.  
        Dependencies for MultiNICA agent
      2. IP Conservation Mode (ICM) for MultiNICA agent
        1.  
          Configuration for MultiNICA agent
        2.  
          Operation for MultiNICA agent
      3. Performance Mode (PM) for MultiNICA agent
        1.  
          Configuration for MultiNICA agent
        2.  
          Operation for MultiNICA agent
      4.  
        Agent function for MultiNICA agent
      5.  
        Attributes for MultiNICA agent
      6.  
        Resource type definition for MultiNICA agent
      7. Sample configurations for MultiNICA agent
        1.  
          MultiNICA and IPMultiNIC Performance Mode configuration
        2.  
          MultiNICA and IPMultiNIC IP Conservation Mode Configuration
      8.  
        IPv6 configuration for MultiNICA agent
      9.  
        Mixed mode configuration - IPv4 and IPv6 for MultiNICA agent
      10.  
        Debug log levels for MultiNICA agent
    6. 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
    7. AWSIP agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Samples configurations
    8. AWSRoute53 agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Sample configuration
    9. AzureIP agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Sample configuration
      8.  
        Debug log levels
    10. AzureDNSZone agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Samples configurations
      8.  
        Delegating a domain to Azure DNS
  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. Notes for NFS agent
        1.  
          Prerequisites for NFS lock recovery
        2.  
          Using NFSv4
      7.  
        Sample configurations for NFS agent
      8.  
        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.  
          Providing a fully qualified host name
      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.  
          Support for spaces in directory names
        2.  
          High availability fire drill
        3.  
          About entering an IP address in the Client attribute
      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.  
          Enabling VCS to detect services started and stopped by smb
        2.  
          Configuring multiple SambaServer resources
        3.  
          Configuring Samba for non-standard configuration files or non-standard lock directories
    6. 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
    7. 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
    8. 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. 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
      7. Sample configurations
        1.  
          Running two instances of httpd for Linux
        2.  
          Sample main.cf file
        3.  
          Basic IPv6 configuration
        4.  
          Sample output of the amfstat command
      8.  
        Debug log level
    3. 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 on Linux
      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.  
          Application monitoring inside Docker container
        7.  
          Using the hadockersetup utility
        8.  
          Requirement for systemd support
      9. Sample configurations for Application agent
        1.  
          Configuration 1 for Application agent
        2.  
          Configuration 2 for Application agent
        3.  
          Configuration 3 for Application agent
        4.  
          Configuration 4 for Application agent
        5.  
          Configuration 5 for Application agent
      10.  
        Debug log levels for Application agent
    4. 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
    5. KVMGuest agent
      1.  
        Dependencies for KVMGuest agent
      2.  
        Agent functions for KVMGuest agent
      3.  
        State definitions for KVMGuest agent
      4.  
        Attributes for KVMGuest agent
      5.  
        Resource type definition for KVMGuest agent
      6. Notes for KVMGuest agent
        1.  
          Support for guests created on RHEL 6, RHEL 7 (KVM environment), and SuSE Enterprise Linux 11 SP2 and SP3
        2.  
          Storage and network configurations
        3.  
          Guest live migration
        4.  
          Managing virtual machines in RHEV environment
        5.  
          Managing ISO image in SuSE KVM
        6.  
          Using VCS to migrate virtual machines
        7.  
          Configuring the KVMGuest agent for DR in a global cluster setup
        8.  
          Configuring a non-admin user for RHEV-M that is using AD-based domain
        9.  
          Virtual machine failover if host crashes
        10.  
          KVMGuest agent requires curl and xpath commands in RHEV environment
        11.  
          RHEV environment: If a node on which the VM is running panics or is forcefully shutdown, VCS is unable to start the VM on another node
      7. Sample configurations for KVMGuest environment
        1.  
          Sample Configuration 1
        2.  
          Sample Configuration 2
        3.  
          Sample Configuration 3
      8. Sample configurations for RHEV environment
        1.  
          Sample Configuration 1
        2.  
          Sample Configuration 2
        3.  
          Sample Configuration 3
      9.  
        Sample Configuration for SuSE KVM
      10.  
        Debug log levels for KVMGuest agent
    6. 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 for Process agent
      10.  
        Debug log levels for Process agent
    7. 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
    8. AzureAuth agent
      1.  
        Prerequisites
      2.  
        Dependencies
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Attributes
      6.  
        Resource type definition
      7.  
        Sample configuration
      8.  
        Obtaining the authentication keys
  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 configurations
    8. VFRJob agent
      1.  
        Overview
      2. Dependencies for VFRJob agent
        1.  
          Group dependency for VFRJob agent in Custer File Systems or VxFS File Systems
        2.  
          Group dependency for VFRJob agent in VxFS File Systems
      3.  
        High availability of scheduler and replicator daemons
      4.  
        Agent functions for VFRJob agent
      5.  
        State definitions for VFRJob agent
      6.  
        Attributes for VFRJob Agent
      7.  
        Resource type definitions for VFRJob agent
      8.  
        High availability of VFR daemons
      9.  
        Configuration of VFRJob service groups on the source system
      10.  
        Sample configuration of VFRJob agent on source system
      11.  
        Configuration for VFRJob service groups on the target system
      12.  
        Sample configuration of VFRJob agent on target system
      13.  
        Changing file replication direction
      14. Notes for the VFRJob agent
        1.  
          Using a different port number for the replication daemon

Attributes

Table: Required attributes

Attribute

Description

RvgResourceName

The name of the RVG resource type that this agent promotes. The name RVG resource type which has been configured using the RVG agent.

Type and dimension: string-scalar

AutoTakeover

A flag to indicate whether the agent should perform a takeover on online if the original Primary is down.

AutoTakeover and AutoResync are mutually exclusive attributes.

When AutoTakeover=0, the primary-elect feature is not applicable; therefore, it is not supported.

Type and dimension: integer-scalar

AutoResync

Indicates whether the agent should attempt to automatically perform a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns.

You can use the following values for this attribute:

  • 0 - instructs the agent to not attempt to perform a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns.

  • 1 - instructs the agent to attempt to automatically perform a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns.

  • 2 - instructs the agent to use the primary-elect feature. The agent does not attempt to perform a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns. The RVGPrimary agent also creates space-optimized snapshots for all the data volumes in the RVG resource.

    If you set the AutoResync attribute to 2 (to enable the primary-elect feature) the value of the BunkerSyncTimeOut attribute must be zero to disable the automated bunker replay feature. You cannot use the automated bunker replay feature and the primary-elect feature in the same environment.

AutoTakeover and AutoResync are mutually exclusive attributes.

When AutoTakeover=0, the primary-elect feature is not applicable; therefore, it is not supported.

Type and dimension: integer-scalar

BunkerSyncTimeOut

The value for the BunkerSyncTimeOut attribute determines if you want the bunker to perform a replay or not. You set the value in seconds for the time that you want to allot for the replay.

Use one of the following values for the BunkerSyncTimeOut attribute:

  • If you do not use a value for this attribute (the default null value), the RVGPrimary agent considers it an infinite timeout value. The agent replays all the writes on the Bunker Replicator Log to the Secondary. Only after the agent sends all the writes, VCS performs the takeover on the Secondary.

  • If you set the value for this attribute to 0, you disable bunker replay for the agent. The RVGPrimary agent immediately performs a takeover on the Secondary. The agent does not send pending writes from the Bunker to the Secondary.

  • If you set the value to a number of seconds, then the RVGPrimary agent sends writes for that amount of time to the Secondary. After the agent meets the time limit, it performs the takeover on the Secondary. The bunker replay time in this case is equal to the value in seconds. You can set this value dynamically.

The RVGPrimary agent's OnlineTimeout and OnlineRetryLimit attribute values determine the available time for an RVGPrimary resource to complete its online operation.

Use the following formula to get the Time Available for Online to Complete (TAOC):

TAOC = (OnlineTimeout + (OnlineRetryLimit * OnlineTimeout))

BunkerSyncTimeOut (cont.)

When you set the BunkerSyncTimeOut value in seconds, the value of TAOC for the RVGPrimary agent should be greater than the desired BunkerSyncTimeOut value. Using a TAOC value that is greater than BunkerSyncTimeOut value ensures that the bunker replay and the RVG takeover can complete in the allotted time for that particular online operation. If the TAOC is smaller than BunkerSyncTimeOut value and the bunker replay does not complete within the allotted time for the online process, the resource faults. If the resource faults, clear the fault. Try the online operation again if the resource has not failed over to other cluster node in the configuration.

If you increase the value of the BunkerSyncTimeOut attribute, you need to increase the value of the OnlineTimeout or OnlineRetryLimit attribute so that TAOC remain greater than changed value. This is to ensure to have bunker replay completed within allotted time for online.

If the value of the AutoResync attribute is 2, you must set the value of the BunkerSyncTimeOut attribute to 0 (to disable automated bunker replay).

Type and dimension: string-scalar

Default value: ""

Table: Optional attributes

Attribute

Description

NumThreads

Number of threads used within the agent process for managing resources. This number does not include threads used for other internal purposes.

Do not modify this attribute for this agent.

Setting this attribute to a higher value may result in agent function timeouts due to serialization of underlying commands.

Default: 1

ResyncType

Allows you to choose between automatic synchronization and difference-based synchronization.

By default, difference-based synchronization is enabled for resynchronization.

To enable automatic synchronization, run the following commands:

# haconf -makerw

# hares -modify RVGPrimary_resource_name ResyncType 1

# haconf -dump -makero

# hares -value RVGPrimary_resource_name ResyncType

To track automatic synchronization progress, run the following commands:

# vxrlink -g dg_name -i time_interval status rlk_name

# vradmin -g dg_name repstatus rvg_name

Type and dimension: integer-scalar

Default: 0

Table: Internal attribute

Attribute

Description

BunkerSyncElapsedTime

For internal use only, do not modify. This value in seconds signifies the amount of time that a Secondary RVG has waited for synchronization from the bunker host to complete.

Type and dimension: integer-scalar

Note:

Default settings of AutoTakeover=1 and AutoResync=0 cause the first failover to succeed when the original Primary goes down, and upon the original Primary's return, the RDS (Replicated Data Set) has a Primary-Primary configuration error. Set the default value of the AutoResync attribute of the RVGPrimary and RVGSharedPri agents to 1 if you want the agent to automatically attempt a fast-failback resynchronization of the original Primary after a takeover and after the original Primary returns. This prevents the Primary-Primary configuration error.