Cluster Server 7.4.1 Bundled Agents Reference Guide - Windows

Last Published:
Product(s): InfoScale & Storage Foundation (7.4.1)
Platform: Windows
  1. Introducing VCS bundled agents
    1.  
      About VCS bundled agents
    2.  
      Resources and their attributes
    3.  
      Modifying agents and their resources
    4. Attributes
      1.  
        Attribute data types
      2.  
        Attribute dimensions
    5. Categories of bundled agents
      1.  
        Storage agents
      2.  
        Network agents
      3.  
        FileShare agents
      4.  
        Services and applications agents
      5.  
        VCS infrastructure and support agents
    6.  
      Which agents should I use?
  2. Storage agents
    1.  
      About Storage agents for VCS
    2. DiskReservation (DiskRes) agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    3. Mount agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5.  
        Attribute definitions
      6.  
        Sample configurations
    4. Volume Manager Diskgroup (VMDg) agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    5. MountV agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5.  
        Attribute definitions
      6.  
        Sample configuration
    6. VVRSnap agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    7. VMwareDisks agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attributes
      5.  
        Sample configuration
    8. VMNSDg agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    9. NativeDisks agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    10.  
      AWS EBSVol agent
    11.  
      AzureDisk agent
    12.  
      GoogleDisk agent
  3. Network agents
    1.  
      About network agents
    2. NIC agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    3. IP agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definitions
      5.  
        Attribute definitions
      6.  
        Sample configuration
    4. IPv6 agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5.  
        Attribute definitions
      6.  
        Sample configuration
    5. Lanman agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5. Attribute definitions
        1.  
          Updating manual DNS entries
        2.  
          Updating DNS servers
      6.  
        Sample configurations
    6.  
      AWSIP agent
    7.  
      AzureIP agent
    8. 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
    9.  
      GoogleIP agent
  4. FileShare agents
    1.  
      About FileShare agents
    2. FileShare agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        About ForceControl function
      5.  
        Resource type definition
      6.  
        Attribute definitions
      7.  
        Sample configuration
    3. CompositeFileShare agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        About ForceControl function
      5.  
        Resource type definition
      6.  
        Attribute definitions
      7.  
        Sample configuration
  5. Services and applications agents
    1.  
      About services and application agents
    2. Internet Information Services agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5. Sample configurations
        1.  
          Sample configuration I
        2.  
          Sample configuration II
    3. GenericService agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    4. ServiceMonitor agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configurations
    5. Process agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    6. MSMQ agent
      1.  
        Dependencies
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5.  
        Attribute definitions
      6.  
        Sample configuration
    7.  
      AzureAuth agent
  6. VCS infrastructure and support agents
    1.  
      About VCS infrastructure and support agents
    2. NotifierMngr agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    3. Registry Replication (RegRep) agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5. Attribute definitions
        1.  
          Excluding keys
        2.  
          Configuring registry keys
        3.  
          Ignoring subkeys
      6.  
        Sample configuration
    4. Proxy agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configurations
    5. Phantom agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Attribute definitions
      4.  
        Sample configuration
    6. FileNone agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    7. ElifNone agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    8. FileOnOff agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    9. FileOnOnly agent
      1.  
        Agent functions
      2.  
        State definitions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    10. RemoteGroup agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        State definitions
      4.  
        Resource type definition
      5. Attribute definitions
        1.  
          About the ControlMode attribute
      6. Sample scenario
        1.  
          Service group behavior
  7. VCS hardware replication agent for NetApp
    1.  
      About hardware replication agents for NetApp
    2. NetApp Filer agent
      1.  
        Agent function
      2.  
        Resource type definition
      3.  
        Attribute definitions
      4.  
        Sample configuration
    3. NetApp SnapDrive agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        Resource type definition
      4.  
        Attribute definitions
      5.  
        Sample configuration
    4. NetApp SnapMirror agent
      1.  
        Dependency
      2.  
        Agent functions
      3.  
        Action function
      4.  
        Resource type definition
      5.  
        Attribute definitions
      6.  
        Sample configuration
  8. Troubleshooting bundled agents
    1.  
      About troubleshooting bundled agents
    2.  
      VCS logging
    3. Troubleshooting storage agents
      1.  
        Disk Reservation agent error messages
      2.  
        Mount agent error messages
      3.  
        Volume Manager (VMDg) agent error messages
      4.  
        MountV agent error messages
    4. Troubleshooting network agents
      1.  
        NIC agent error messages
      2.  
        IP agent error messages
      3.  
        Lanman agent error messages
    5. Troubleshooting FileShare agents
      1.  
        FileShare agent error messages
      2.  
        CompositeFileShare agent error messages
    6. Troubleshooting services and application agents
      1.  
        IIS agent error messages
      2.  
        GenericService agent error messages
      3.  
        ServiceMonitor agent error messages
      4.  
        Process agent error messages
      5.  
        MSMQ agent error messages
    7. Troubleshooting infrastructure and support agents
      1.  
        Notifier Manager agent error messages
      2.  
        Registry Replication agent error messages
      3.  
        Proxy agent error messages
      4.  
        Phantom agent error message
      5.  
        FileNone agent error message
      6.  
        ElifNone agent error message
      7.  
        FileOnOff agent error messages
      8.  
        FileOnOnly agent error messages
    8.  
      Troubleshooting NetApp agents

AWSIP agent

The AWSIP agent manages the networking resources in an Amazon Web Services (AWS) cloud environment. The following are the networking resources:

  • Private IP - Private IP is a private numerical address that networked devices use to communicate with one another.

  • Elastic IP - An Elastic IP address is a static IPv4 public address designed for dynamic cloud computing. An Elastic IP address is associated with your AWS account.

  • Overlay IP - AWS allows you to redirect IP address traffic to an Elastic Compute Cloud (EC2) instance in a Virtual Private Network (VPC) no matter which subnet or availability zone (AZ) it is in. Overlay IP provides IP failover functionality for nodes spread across subnets or availability zones. Overlay IP must be outside of the VPC Classless Inter-Domain Routing (CIDR) block.

The agent uses AWS CLIs to associate IP resources in an AWS cloud environment. The agent does the following:

  • Assigns and unassigns private IP address

  • Associates and disassociates Elastic IP address and assigns/unassigns private IP

  • Manages route table entries of overlay IP for failing over across subnets

Prerequisites

  • Install the AWS CLI package.

  • Go to EC2 instance > Networking > Change Source/Dest. Check and disable Change Source/Dest. Check for overlay IP.

  • Create an IAM role with requisite permissions and attach the roles to the EC2 cluster instances.

    Go to IAM > Create Policy > Role and create the role.

    The following is a sample of the policy.json file:

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "ec2:AssignPrivateIpAddresses",
                "ec2:DescribeAddresses",
                "ec2:DisassociateAddress",
                "ec2:AssociateAddress",
                "ec2:UnassignPrivateIpAddresses",
                "ec2:AssignPrivateIpAddresses",
																"ec2:AssignIpv6Addresses",
                "ec2:UnassignIpv6Addresses", 
                "ec2:DescribeInstances",
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeRouteTables",
                "ec2:CreateRoute",
                "ec2:DeleteRoute",
                "ec2:ReplaceRoute"
              ],
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

  • Ensure that all outgoing traffic goes through network address translation (NAT) gateways. The agent uses AWS CLIs and requires access to the Amazon EC2 API endpoints.

  • Ensure that the subnets in which the EC2 exists are associated with the route table.

Dependency

AWSIP resources depend on IP resources.

Agent functions

Online

  • Private IP: Assigns the private IP to a NIC Elastic Network Interface (ENI).

  • Elastic IP: Works only if a private IP is defined in the configuration. Associates the private IP with an elastic IP. Agent automatically detects the ENI based on the Device attribute.

  • Overlay IP: Creates a route in the route table given in the RouteTableIds attribute with destination as the OverlayIP and target as the ENI on which the entry point is running.

Offline

  • Private IP: Unassigns from the ENI.

  • Elastic IP: Disassociates the elastic IP.

  • Overlay IP: Deletes the route from the route table.

Monitor

  • Private IP: Monitors the assignment of the private IP to the ENI.

  • Elastic IP: Monitors the association between private IP and elastic IP.

  • Overlay IP: Monitors the routing information and checks whether the route table entry exists for the overlay IP.

Clean

  • Private IP: Unassigns the private IP.

  • Elastic IP: Disassociates the elastic IP and unassigns the private IP address.

  • Overlay IP: Deletes the route from the route table.

State definitions

ONLINE

  • Private IP: Private IP is assigned to the ENI.

  • Elastic IP: Private IP is assigned and elastic IP is associated with the private IP.

  • Overlay IP: Route table entry exists for the overlay IP.

OFFLINE

  • Private IP: Private IP is not assigned to the ENI.

  • Elastic IP: Private IP is not assigned or elastic IP is not associated with the private IP.

  • Overlay IP: Route table entry does not exist for the overlay IP.

UNKNOWN

If private IP, elastic IP, or overlay IP is in UNKNOWN state, one of the following could be true:

  • AWS CLI is not installed.

  • AWSBinDir attribute is not configured correctly. That is, the AWSBinDir attribute is not set to the location where AWS CLI is installed. For example, C:\Program Files\Amazon\AWSCLI.

  • Roles are not configured correctly or attached to the instance.

FAULTED

Indicates that the IP resources could not be brought online or abruptly stopped outside of VCS control.

Resource type definition
type AWSIP (
	   static i18nstr ArgList[] = { PrivateIP, OverlayIP, ElasticIP, 
 	    Device, RouteTableIds, AWSBinDir }
   	str PrivateIP
   	str OverlayIP
   	str ElasticIP
   	str Device
   	keylist RouteTableIds
   	str AWSBinDir
)
Attribute definitions

Table: Required attributes

Attribute

Description

PrivateIP

Secondary private IP address of the EC2 instance.

Type and dimension: string-scalar

OverlayIP

Overlay IP provides IP failover functionality for nodes spread across subnets or availability zones. Overlay IP must be outside of the VPC CIDR block in which the nodes are present.

Type and dimension: string-scalar

Table: Optional attributes

Attribute

Description

ElasticIP

An Elastic IP address is a static IPv4 address designed for dynamic cloud computing. An Elastic IP address is associated with your AWS account. You can map the Elastic IP address to a secondary private IP address.

Note:

IPv6 addresses are not supported with this attribute.

Type and dimension: string-scalar

Device

The physical address of the interface or the interface name of the NIC to which the virtual IP address to be monitored is assigned. Note that this attribute is always local, that is, it is different for each system.

If you change the interface name, you must update the attribute value to specify the new name.

When you edit the MACAddress attribute of the IP or the NIC agent to specify the interface name, you must specify the name of only one interface.

For more details on modifying the default value of the attribute, refer to the Cluster Server Administrator's Guide.

Note:

Use the ipconfig -all command to retrieve the physical address of a NIC.

Type and Dimension: string-scalar

RouteTableIds

Describes all the route tables. It can be one or more route table IDs.

Type and dimension: string-list

AWSBinDir

Location of AWS EC2 commands and binaries.

Type and dimension: string-scalar

Sample configuration
Private IP
AWSIP privateip (
	PrivateIP = "10.239.3.97"
	Device@WIN-38PNEVJSR2K = "12-7F-CE-5B-E2-6E"
	Device@WIN-75PQEVSRV2K = "13-7F-CE-6B-E2-6E"
	)
Elastic IP
AWSIP elasticip (
	PrivateIP = "10.239.3.95"
	ElasticIP = "34.193.196.156"
	Device @WIN-38PNEVJSR2K = "12-7F-CE-5B-E2-6E"
	Device @WIN-42PNEVXYR5K = "18-6F-BE-9B-E2-6E"
	)
Overlay IP
AWSIP overlayip (
	OverlayIP = "172.16.8.55/32"
	Device @WIN-38PNEVJSR2K = "12-7F-CE-5B-E2-6E"
	Device @WIN-45ABCVJSR2K = "14-7E-DE-6B-E2-8E"
	RouteTableIds = { rtb-c5272ca3, rtb-fb97ac9d }
	)