Enable discovery debug modes
search cancel

Enable discovery debug modes

book

Article ID: 332084

calendar_today

Updated On:

Products

VMware Smart Assurance

Issue/Introduction

Enable debug in IP domain to troubleshoot Device discovery issues. 

Environment

SMARTS 10.1.x

Resolution

Steps to enable debugging information in the log files:

Modify the file <basedir>/IP/smarts/conf/discovery/discovery.conf to reflect:
    ShowPendingNONSNMP = TRUE
  LogDiscoveryProgress = TRUE

 

You can also enable these via dcmtl (from <basedir>/IP/smarts/bin/):

  • For debugging issues with the pending list:
    dmctl -s <server> put AD_TopologyManager::ICF-TopologyManager::ShowPendingNONSNMP TRUE
     
  • For debugging issues with Discovery or Auto Discovery:
    dmctl -s <server> put AD_TopologyManager::ICF-TopologyManager::LogDiscoveryProgress
         TRUE

     
  • For debugging issues with OV or InCharge placing a device on the Pending list during Discovery or Auto Discovery:
    dmctl -s <server> put AD_TopologyManager::ICF-TopologyManager::LogPending TRUE
     
  • For debugging Name Resolution Issues:
    dmctl -s <server> invoke ICF_TopologyManager::ICF-TopologyManager insertParameter NameResolveDebug TRUE

To verify:
dmctl -s <server> invoke ICF_TopologyManager::ICF-TopologyManager findParameter NameResolveDebug
 

  • For detailed debug:
    dmctl -s <server> put ICF_TopologyManager::ICF-TopologyManager::DebugEnabled TRUE

To disable:

dmctl -s <server> put ICF_TopologyManager::ICF-TopologyManager::DebugEnabled FALSE


All the commands above should be reset to FALSE after the discovery is completed to reduce the amount of logging during regular discovery processes.

Additional Information

Best practices:

Please roll the IP domain log after enabling the discovery debug.  
dmctl -s <IP DOMAIN> exec roll_log

Below is the example of connecting to IP domain via dmctl command, and running these commands inside the dmctl command line window.

dmctl -s <IP DOMAIN> <enter>
put ICF_TopologyManager::ICF-TopologyManager::DebugEnabled TRUE 
put ICF_TopologyManager::ICF-TopologyManager::LogDiscoveryProgress TRUE 
put ICF_TopologyManager::ICF-TopologyManager::TraceRule TRUE 
invoke ICF_TopologyManager::ICF-TopologyManager insertParameter NameResolveDebug TRUE
put ICF_TopologyManager::ICF-TopologyManager::ShowTracing TRUE 
put ICF_TopologyManager::ICF-TopologyManager::LogTracing TRUE 
put ICF_TopologyManager::ICF-TopologyManager::LogPending TRUE 
exec roll_log


Once the discovery is complete, then use the same commands but change the parameter from TRUE to FALSE to disable the debug logging.