Cluster Server 7.4 Bundled Agents Reference Guide - Windows

Last Published:
Product(s): InfoScale & Storage Foundation (7.4)
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. 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 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
      1.  
        Prerequisites
      2.  
        Dependency
      3.  
        Agent functions
      4.  
        State definitions
      5.  
        Resource type definition
      6.  
        Attribute definitions
      7.  
        Sample configuration
    7. 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
    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
  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
      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. 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

ServiceMonitor agent error messages

The ServiceOrScriptName attribute has not been configured

No value specified for the ServiceorScriptName attribute.

Recommended Action: Verify the ServiceorScriptName attribute defined in the configuration file is assigned a value.

Failed to lookup the account name 'Account_Name'. Error = Error Code

The agent failed to obtain the SID for the specified user.

Recommended Action: Verify that the domain controller is accessible, or the specified user exists. See the error code if the problem persists.

The password attribute has not been configured

No value specified for the Password attribute.

Recommended Action: Verify the Password attribute defined in the configuration file is assigned a value and contains alphabets only.

Failed to get the password attribute. Error = Error Code

The agent failed to decrypt the specified password.

Recommended Action: Verify that the password is encrypted using the VCS Encrypt utility (described in the Cluster Server Administrator's Guide).

Failed to convert the password attribute. Error = Error Code

The agent failed to convert the password attribute. This is a VCS internal error.

Recommended Action: Offline and online the service group. Contact Veritas Technical Support if the problem persists.

Failed to open the SCM handle. Error = Error Code

The agent failed to obtain the SCM handle. This occurs if the SCM database does not exist, or if the SCM manager denies the requested access.

Recommended Action: Verify that SCM can be run on the host.

Failed to open the service 'Service_Name'. Error = Error Code

The resource definition in the configuration file contains an invalid, or incorrect service name.

Recommended Action: Verify that the ServiceOrScriptName defined in the configuration file is the same as the display name used by SCM. Also verify that the specified service is supported by the SCM version on the host and that the specified service was opened successfully.

Failed to query the status of the service 'Service_Name'. Error = Error Code

The agent failed to determine the status of the service. This is a VCS internal error.

Recommended Action: Verify that the attribute ServiceOrScriptName defined in the configuration file is the same as the display name used by SCM. Otherwise, offline and online the service group. Contact Veritas Technical Support if the problem persists.

The service 'Service_Name' is not in running state

The agent failed to offline the service because the service is not in STARTED state.

Recommended Action: Verify the state of the service and re-issue the online command.

Failed to get the user context of the running service 'Service_Name'. Error = Error Code

The agent failed to obtain the information about the user in whose context, the specified service will run.

Recommended Action: Verify that the user exists, or the domain controller is accessible. See the error code if the problem persists.

Failed to get the SID for user 'DomainName\Username'

The agent failed to obtain the SID for the specified user.

Recommended Action: Verify that the domain controller is accessible, or the specified user exists. See the error code if the problem persists.

The service 'Service_Name' is not running under the context of user DomainName\Username

The user information specified in the UserAccount information is different from the user information, in whose context the service will run.

Recommended Action: Stop the service and modify the user information. Re-issue the online command.

Failed to launch the monitor script 'Script_Name'. Error = Error Code

The agent failed to launch the script to monitor the service.

Recommended Action: Verify that the script is accessible. See the Windows error code if the problem persists.

Monitor script has not responded within the specified timeout of Timeout period seconds. Error = Error Code

The agent failed to receive a response from the monitor script.

Recommended Action: Review the configuration definition of the attribute MonitorProgTimeout. Increase its value if required.

Failed to terminate the monitor program. Error = Error Code

The agent failed to terminate the script specified in the MonitorService attribute.

Recommended Action: Stop the agent. See the Windows error code, if the problem persists.

Failed to get exit code of the monitor program. Error = Error Code

The agent failed to get a response from the script that monitors a specified service.

Recommended Action: Verify that the exit codes returned by the script conform to VCS standards. See the Windows error code for further information. Contact Veritas Technical Support if the problem persists.

Failed to enable the Privilege_Name' privilege. Error = Error Code

The agent failed to enable the privilege required to kill a process. See the Windows error code for further information.

Invalid Service name [service_name].

The resource definition in the configuration file contains an invalid or incorrect service name.

Recommended Action: Verify that the attribute ServiceOrScriptName defined in the configuration file is the same as the display name used by SCM. Also verify that the specified service is supported by the SCM version on the host.