Telegraf Agent Install Fails With Error "PrerequisiteCheckException: VC port connectivity check failed for VC:443" due to timeout
search cancel

Telegraf Agent Install Fails With Error "PrerequisiteCheckException: VC port connectivity check failed for VC:443" due to timeout

book

Article ID: 388239

calendar_today

Updated On:

Products

VMware Aria Suite

Issue/Introduction

  • Attempting to install telegraf agents from the Manage Telegraf Agents page results in Install Failed.

  • Hovering the cursor over the Install Failed icon shows error "PrerequisiteCheckException: VC port connectivity check failed for VC:443" where VC is the name of the VM's parent vCenter

  • Testing the connection to the vCenter using the command below results in failure (0 indicates success, any number other than 0 indicates failure)

    timeout 5 bash -c '</dev/tcp/vc_fqdn/443'; echo $?
    Note: replace vc_fqdn with the FQDN of the VM's parent vCenter

  • Errors like below are seen in the /storage/vcops/log/collector.log file

    ERROR [Thread-123] (123) com.vmware.ucp.api.operations.bootstrap.ManageEndpointsService.error - PrerequisiteCheckException
    java.util.concurrent.TimeoutException: null


Environment

VMware Aria Operations 8.x

Cause

The connectivity check to the vCenter performed by the agent installer times out before the default timeout of 5 seconds.

Resolution

Increase the default timeout from 5 seconds to 10 seconds

  1. Log in to the cloud proxy that is used for the telegraf agent install as root via SSH

    Note: If using a HA enabled collector group, the steps should be followed for all cloud proxies in the collector group

  2. Modify the config .properties file to increase the timeout to 10 seconds

    sed -i 's/prerequisite.check.arc.port.connectivity.timeoutInSeconds=5/prerequisite.check.arc.port.connectivity.timeoutInSeconds=10/g' /ucp/config/config.properties
  3. Restart the collector service

    systemctl restart collector
  4. Retry the telegraf agent install

Note: This workaround will need to be reapplied after any upgrade or patch is applied to Aria Operations.