Cluster Server 8.0 Bundled Agents Reference Guide - Windows

Last Published:
Product(s): InfoScale & Storage Foundation (8.0)
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

GenericService agent error messages

The ServiceName attribute has not been configured

No value specified for the ServiceName attribute.

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

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.

Failed to get the password attribute. Error = Error Code

The agent failed to decrypt the specified password.

Recommended Action: Use the vcsencrypt utility to get an encrypted password. Specify the encrypted password to the Password attribute in the configuration file.

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

The agent failed to allocate the memory. This is a VCS internal error.

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

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.

Failed to open the SCM handle. Error = Error Code

The agent failed to obtain the SCM handle. This occurs if the specified Service Control Manager (SCM) database does not exist, or the requested access is denied.

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

The service 'Service_Name' is not in stopped state

The agent failed to online the service because the service was not in STOPPED state.

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

Failed to decrypt the password

The agent failed to decrypt the specified password.

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

Failed to change the user context of the service 'Service_Name' to 'Domain\NameUsername.Error = Error Code

The agent failed to change the user context in which the service will run.

Recommended Action: See the Windows error code for further information.

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

The agent failed to start the specified service.

Recommended Action: Verify the binaries for the specified service exist, or the service is configured to run in the context of the specified user. Start the service manually if the problem persists.

The service 'Service_Name' did not start within the specified time limit

The agent failed to online the service within the time specified in the DelayAfterOnline attribute.

Recommended Action: Verify the state of the service in the SCM. If the state of the service is START PENDING, increase the time specified in DelayAfterOnline attribute. If the problem persists, start the service manually.

Failed to wait for the service 'Service_Name' to start. Error = Error Code

The agent did not wait for the service to start. This is a VCS internal error. Refer to the documentation specific to the service to determine the cause.

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.

The service 'Service_Name' shares the same process with other services. Killing it might affect those services

If the service has an invalid state, the agent attempts to offline the service. The agent fails to offline the service, if the process is shared with other services. In such cases, the agent attempts to kill the shared process. You risk potential data loss.

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.

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 the ServiceName attribute defined in the configuration file is the same as the display name used by SCM. Verify 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: Offline and online the service group. Contact Veritas Technical Support if the problem persists.

The service 'Service_Name' is not in running state. Attempt to stop it might be unsuccessful.

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.

The service 'Service_Name' did not stop. Error = Error Code.

The agent failed to stop the specified service.

Recommended Action: Verify the binaries for the specified service exist, or the service is configured to run in the context of the specified user. Stop the service manually if the problem persists.

The service 'Service_Name' did not stop within the specified timeout. Error = Error Code

The agent failed to offline the service within the time specified in the DelayAfterOffline attribute.

Recommended Action: Verify the state of the service in the SCM. If the state of the service is STOP PENDING, increase the time specified in DelayAfterOffline. If the problem persists, stop the service manually.