SM_IP_VERSIONS

The SM_IP_VERSIONS environment variable enables you to control the address family used for hostname resolution. It affects the following:

• VMware Smart Assurance utilities that use a command line (for example, sm_snmpwalk, dmctl, sm_tpmgr)

• Name resolution during discovery

• ASL scripts

• Ping

• DNS lookup

  SM_IP_VERSIONS also controls which ports a Domain Manager listens on:

• If SM_IP_VERSIONS is set to "v4" or "v6", a Domain Manager will only open sockets and listen on that address family.

• If SM_IP_VERSIONS is set to "v4v6" or "v6v4", a Domain Manager will listen on both address families.

  The SM_IP_VERSIONS setting is also dependent on the address family as follows:

• If you are running on a system which only supports a single address family, it is recommended that SM_IP_VERSIONS be set to "v4" or "v6", as appropriate.

• If you are running on a system which supports both address families, set it to the value which best describes your administrative preferences.

  The variable can be set depending on the order in which you want to do hostname resolution.If the variable is not set, and the address family is not explicitly provided on the command line (for example, frame.someDomain.vmware.com:v4), the default behavior is to resolve the hostname as an IPv4 hostname. The variable should be set to the address family that is predominate for the network.

  To set this variable, add it to the runcmd_env.sh file, which is located in the BASEDIR/smarts/local/conf directory of the product suite.

  The syntax of the environment variable is:

  SM_IP_VERSIONS="<ip_value>"
  

  Acceptable values for the SM_IP_VERSIONS environment variable lists acceptable values for the SM_IP_VERSIONS environment variable.

Table 1. Acceptable values for the SM_IP_VERSIONS environment variable

ip_value	Description
"V4"	The hostname is resolved to an IPv4 hostname (default).
"V6"	The hostname is resolved to an IPv6 hostname.
"V4V6"	The hostname is resolved to an IPv4 hostname. If that fails, the Domain Name System server tries to resolve the hostname to an IPv6 hostname.
"V6V4"	The hostname is resolved to an IPv6 hostname. If that fails, the Domain Name System server tries to resolve the hostname to an IPv4 hostname.
Note: The acceptable value can also be lowercase ("v4", "v6", "v4v6" or "v6v4").

Detailed instructions about setting environment variables and information about the runcmd_env.sh file is provided in the “Methods for setting environment variables for ITOps software” on page 138.