Scripting options for a findComputerSystem() call

Products

• VMware Smart Assurance
• Network Observability

Issue/Introduction

This article explains about all possible options on the findComputerSystem() call.

Symptoms:

• These options are crucial to understand delays in Syslog processing or Trap Processing due to system lookup calls.

Environment

All Supported Smarts versions

Resolution

Following options are available to troubleshoot and test the FindComputerSystem calls:

• For Debug Purposes use Trace options during the initial setup. :

  •     <string> findComputerSystemWithArgsTrace <string>nameOrAddr <string>DNSDomainNames <boolean>useDNSLookupInThisDomain <boolean>useDNSLookupInUnderlyingDomains <boolean>useDNSDomainsInDNSLookup <boolean>disableUnderlyingDomainsQuery <string>underlyingDomainsOrder <string>fullyQualifiedDomainSuffixes

  •     <string> findComputerSystemExTrace <string>nameOrAddr <boolean>allowDNSLookup

• Once the Trace debugs are tested and a valid condition has been met based on user's environment, you may choose one of the following:

  •     <object> findComputerSystemWithArgs <string>nameOrAddr <string>DNSDomainNames <boolean>useDNSLookupInThisDomain <boolean>useDNSLookupInUnderlyingDomains <boolean>useDNSDomainsInDNSLookup <boolean>disableUnderlyingDomainsQuery <string>underlyingDomainsOrder <string>fullyQualifiedDomainSuffixes

  •     <object> findComputerSystemEx <string>nameOrAddr <boolean>allowDNSLookup

  •     <object> findComputerSystem <string>nameOrAddr

The fields explained in the Syntax are explained as follows:

• Use DNS Lookup in This Domain: For Find Computer System: tells whether to use DNS lookup in this Smarts domain. Set it to TRUE, if you want to query the DNS in this Smarts domain. 
• Use DNS Lookup in Underlying Domains: For Find Computer System: tells whether to use DNS lookup in the Smarts domains that are connected to the current Smarts domain. Set it to true, if you want to query the DNS in the underlying Smarts domains. 
• Use DNS Domains in DNS Lookup: For Find Computer System: The DNSDomainNames field is used to append Domains on the end of the name that is trying to be resolved. When using DNS, this is often redundant since DNS will perform the same operation. If this flag is FALSE, then only the original name will try to be resolved with DNS. Set it to true, if you want to query the DNS in the underlying Smarts domains. 
• DNS Domain Names: For Find Computer System: This string holds a comma separated list of domain names.
  Example: "mycompany.com, org.com, org.net". 
• Underlying Domains Order: For Find Computer System: The order in which the Smarts underlying domains need to be searched. All Domains should be represented as a comma separated list.
  Example: "INCHARGE-OI, INCHARGE-AM, <domains>". "<domains>" means: the rest of the underlying domains. 
• Fully Qualified Domain Suffixes: For Find Computer System: This option says that if an incoming name matches as a suffix, any of the suffixes in this list, then the incoming name is assumed to be fully qualified. If it is fully qualified, the DNSDomainNames option above will be ignored.
  Example: ".com, .net, .gov, .org".