Troubleshooting the VMware vCenter ETLs

The VMware vCenter ETLs might fail due to incorrect configurations and other issues. Review the ETL logs to investigate and troubleshoot these issues.

Resolutions for common issues

The following table explains the common issues for the ETL failures and their resolutions.


The log contains the following error:

BCO_ETL_FAIL103: Cannot connect to vCenter.
Contacting vCenter

This error occurs when the incorrect URL details are provided in the vCenter ETL configuration.

Make sure that the vCenter URL is https://<YourVecnterServerName>/sdk.

For more information, see Knowledge article 000264459 Open link

(Support logon ID is required).

The vCenter History ETL fails with the following error:
"This operation is restricted by the administrator - 'vpxd.stats.maxQueryMetrics'

In vCenter 5.5 Update 3 and 6.x, some vSphere APIs limit the number of metrics extracted during each API call.

  • For daily data collection, make sure to use the vCenter Service ETL.
  • For historical data recovery, ignore the vpxd.stats.maxQueryMetrics message and the failed ETL status.

For more information, see  KA 000224393 Open link

(Support logon ID is required).

The ETL fails to run and the log displays the following message:

BCO_ETL_ERR011: Detected an abnormal ETL termination.


HTTP transport error:

The server selected protocol version TLS10 is not accepted by client preferences TLS13, TLS12]at

The ETL is using version 1.0 of TLS to connect to the vCenter Server. 

The VMware - vCenter and ESX Server History ETLs use TLS version 1.1 or 1.2 to connect to the vCenter Server. Therefore, update the vCenter server protocol to TLS 1.1 or 1.2. For more information, see  VMware documentation Open link

(Support logon ID is required).

Frequently asked questions

The option to setup the whitelist and blacklist filter is available in the Import filter section of the Advanced properties configuration. This setting accepts a whitelist text file or a blacklist text file. The whitelist file supports a regular expression, and the blacklist file accepts only a list of virtual machine names and vCenter UUIDs. For more information, see VMware vCenter ETLs.

Do the following steps:

  1. Log in to database (BCO_OWN) using the SQL PLUS or psql command. For details, see Knowledge article 000386376 Open link  (Support logon ID is required).
  2. Note the vCenter ETL task ID.

  3. Run the following query to confirm that the ETL status is shown as running.
    select * from task_status where taskid=<TASK_ID>;
  4. Stop the scheduler on the ETL engine.
    ./cpit stop scheduler
  5. Update the ETL status and unschedule it using this query:
    update task_status set status='STOPPED' where taskid=<TASK_ID>;
    update task set enabled=0 where taskid=<TASK_ID>;
  6. Perform a clean restart of the scheduler on the ETL engine, and confirm that you can start or stop the vCenter ETL.
    ./cpit clean scheduler

Do the following steps:

  1. Navigate to Administration> ETL & System TasksVMware - vCenter and ESX Server History Extractor.
  2. Click Edit Configuration and then click Advanced.

  3. Click Entity catalog, and then select Sharing with Entity Catalog > Default Entity Catalog.

  4. Under Existing domain, select the domain of the current vCenter Service Extractor.
  5. To resolve the conflict, select ETL migration.
  6. Select the hierarchy rule for vCenter Service Extractor.
  7. Under VMware ETL configuration, set the extraction period to a short period, such as 5 days.
  8. Save the changes and run the ETL.

For more information, see Knowledge article 000210677 Open link  (Support logon ID is required).

Was this page helpful? Yes No Submitting... Thank you