This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.
TrueSight Capacity Optimization
TSCO ALL VERSIONS - vCenter Service ETL how to use whitelist and blacklist parameters
Trying to use the vCenter Service ETL whitelist and blacklist options but the results in the workspace are not what are expected.
Details for accessing the vCenter Service ETL whitelist and blacklist options are in the TSCO documentation. Some of the links can be found below:
TSCO 11.0 - https://docs.bmc.com/docs/display/btco110/Configuring+the+continuous+polling+and+collection+of+data+from+a+VMware+environment
TSCO 10.7 - https://docs.bmc.com/docs/display/btco107/Configuring+the+continuous+polling+and+collection+of+data+from+a+VMware+environment
Look for the Import Filter on the documentation to find the information about Whitelist and Blacklist.
To blacklist only certain cluster or hosts and whitelist VMs using a whitelist file, below is an example of the ETL import filter settings:
Blacklist does not provide support for regular expression, to exclude monitoring of a set of VMs which certain string in the name use a white list file with an inverted regular expression (see details more below).
The contents of the whitelist file used in the "Blacklist file path option" are listed below:
The results of the imported systems in the workspace are:
*** Note the inclusion of BCOQA-DC and New Datacenter is being tracked by defect DRCOZ-16609. These datacenters should not have been imported. When defect DRCOZ-16609 is fixed they will not be loaded into TSCO since there are not part of the whitelist information.
When higher logging is enabled, the service log will show the follow information about the whitelist otpions:
2018-04-11 11:45:17,558 DEBUG [service-104-1]- Adding vm regex to whitelist: ^vw\-pun\-co\-aut19.* 2018-04-11 11:45:17,558 INFO [service-104-1]- Loaded whitelist regex file - #1 regex will be used for whitelisting vms. 2018-04-11 11:25:01,260 DEBUG [service-104-1]- Whitelisted VMs: [vw-pun-co-aut19.dsl.bmc.com] 2018-04-11 11:25:01,260 DEBUG [service-104-1]- Blacklisted VMs: [vw-pun-co-aut18.dsl.bmc.com, vl-pun-bco-qa52, vw-pun-co-aut32.dsl.bmc.com, vl-pun-aut-qa55, vw-pun-aut-qa02.dsl.bmc.com, vl-pun-aut-qa56, vl-pun-aut-qa57, vw-pun-co-aut17.dsl.bmc.com, vw-pun-co-aut20.dsl.bmc.com, vl-pun-bco-qa54, vl-pun-bco-qa53]
The above information is only available after the saver has run for the service.
The Whitelist file can also be used to get an inverted selection from the vCenter. An example would be, you can use this way to blacklist a set of VMs. In the example below no VMs with the including the string vl-pun are monitored.
The above will result in the following whitelist and blacklist output as shown in the log. The regex string will whitelist all VMs not matching "vl-pun, the "vl-pun" VMs will be added to the blacklist as shown below:
2018-04-11 19:00:00,616 DEBUG [service-106-1]- Blacklisted VMs: [vl-pun-aut-qa29, vl-pun-aut-qa01_old, vl-pun-bco-neuton, vl-pun-bco-qa02-2, vl-pun-bco-ADDM11202, vl-pun-aut-qa15, vl-pun-bco-pt08-BCO-RHEL5.9-64, vl-pun-rds-tl1d, vl-pun-bco-qa52, vl-pun-bcm-ADDM1102, vl-pun-aut-qa55, vl-pun-aut-qa56, vl-pun-aut-qa57, vl-pun-aut-qa14, vl-pun-bld-qa01, vl-pun-bco-qa57, vl-pun-bco-qa13, vl-pun-bco-cmdb01, vl-pun-bco-qa54, vl-pun-bco-qa53, vl-pun-bco-qa02 - SUSE12, vl-pun-bco-qa56, vl-pun-bco-qa12, vl-pun-bco-qa55, vl-pun-bco-qa11, vl-pun-bcm-ADDM112, vl-pun-bco-octa, vl-pun-openn-vc01, vl-pun-bco-rsso1, vl-pun-bco-pt06, vl-pun-bcm-dv28, vl-pun-bcm-dv26, vl-pun-bco-pt03, vl-pun-bco-pt02, vl-pun-aut-qa01, vl-pun-bcm-dv27, vl-pun-bco-pt05, vl-pun-aut-qa02, vl-pun-bco-pt04, vl-pun-bcm-qa09-CentOS-6.5-64, vl-pun-bco-qa05, vl-pun-bco-qa06-CentOS6.5-64, vl-pun-bco-pt03c, vl-pun-bco-pt03b, vl-pun-bco-pt03a, vl-pun-bcm-dv19, vl-pun-bcm-dv15, vl-pun-bcm-dv16, vl-pun-octa2-qa02, vl-pun-bcm-qa10, vl-pun-bco-qa02-1 - SUSE12, vl-pun-bcm-qa13, vl-pun-bco-qa39, vl-pun-bcm-qa12, vl-pun-open-new01, vl-pun-bcm-qa11, vl-pun-bco-pt01, vl-pun-ocata-qa01, vl-pun-bco-mitaka3]
NotesIt is a best practice to be running a recent TSCO Cumulative Hot Fix (CHF) level. For example, for TSCO 11.0 and earlier Defect DRCOZ-16117 fixed in the CHF could make it difficult to determine the proper case of VMs on the vCenter side even when high logging is enabled in the ETL due to all VMs being reported in lowercase but the filtering being done against the mixed case name.
Additional InformationThe vCenter ETL does not log when a whitelist file has been specified but cannot be found on the ETL Engine Server (because it doesn't exist or the path/filename have been specified incorrectly). The ETL behaves as if no whitelist file has been specified.
Defect DRCOZ-22315: 'The vCenter ETL does not generate a clear WARNING or ERROR message when whitelist file doesn't exist' has been logged to request a clear WARNING message from the vCenter ETL if the specified whitelist/blacklist file doesn't exist.