Using ClusterCATS
ClusterCATS Utilities

Using btcfgchk

The btcfgchk utility is a network management tool that displays information about your IP and DNS configurations. Use it to analyze and troubleshoot the servers and network.

Syntax

Invoke btcfgchk from the command line in the <CC_install_directory>/ directory using the following syntax:

btcfgchk

Sample output

The following sample output shows how btcfgchk displays configuration information for a system with one network adapter and two IP addresses:

btcfgchk FQHN is hartford.brighttiger.com 

El90x1 [PRIMARY]:

hartford.brighttiger.com        192.168.0.31
255.255.255.0
hartford.brighttiger.com

hartford1.brighttiger.com       192.168.0.32
255.255.255.0
hartford1.brighttiger.com

btcfgchk DNS errors

The btcfgchk utility reports on DNS configuration problems. ClusterCATS requires that your DNS be configured with correct forward and reverse mappings. A forward mapping (AName record) translates the host name to an IP address. A reverse mapping (PRT record) translates an IP address to its host name. ClusterCATS expects the mapping to be one-to-one (one host name to one IP address).

Error	Description
Host name does not map to a single IP address	The main host name for this system is not mapping to one IP address. Possible problems are: The main host name of the system could not be resolved to an IP address. Your fully qualified host name is the combination of the host name and the domain name. Ensure that no typos appear in these names in DNS definitions, on the DNS server and on each cluster member's DNS definition. To verify that the host name is correct, enter nslookup <FQHN> at a command-line prompt (FQHN stands for fully-qualified hostname). The host name is a round-robin DNS name. Run the ClusterCATS hostinfo utility to see whether more than one IP address is configured for the domain. For more information, see "Using hostinfo".
No adapter associated with host name found	btcfgchk is unable to find the primary network adapter. The primary network adapter should be the network adapter containing the IP address of the main host name.
Duplicate Primary Adapter	btcfgchk found two network adapters with the same IP address. Use the ifconfig -a command to see information about your adapter.
Name lookup for <hostname> failed	btcfgchk was not able to determine the IP address for the specified host. Your DNS server may be down. Use nslookup to see whether it can contact your DNS server.
<IP_address1> reverse maps to <hostname> which then forward maps to <IP_address2>	btcfgchk did a lookup on <IP_address1> and found a host name to which it is mapped. It then attempted to verify that the host name maps back to the IP address specified, and the verification failed. There is likely an issue with your DNS configuration. Use the ClusterCATS hostinfo utility to get more information on how the names and IP addresses are configured. For more information, see "Using hostinfo".
Error looking up <hostname> by name	ClusterCATS could not resolve the given host name to an IP address. Use nslookup to look up the host name in DNS.
Host name a round-robin name, or does not map to configured IP address	The host name maps to more than one IP address (round-robin DNS) or maps to an IP address not found on the computer. Use the ClusterCATS hostinfo utility to check the host name DNS configuration: hostinfo <hostname> If more than one IP address is listed, round-robin DNS is in use. If one IP address is listed, check whether the address is configured on the computer. You can use the ipconfig/all command to view all IP addresses on this computer.
Host name not found in any reverse mapping Probable forward mapping misconfiguration for <hostname>	For each IP address found on the system, an attempt was made to find the corresponding host name. None of the IP addresses on the system reverse mapped to the system's main fully qualified host name. The problem is either: The host name maps to the wrong IP address. The IP address that the host name maps to does not have an entry in the DNS table for the reverse map. Consequently, nslookup does not return the hostname.
Probable round robin configuration for <hostname>	The host name does not map to one IP address. Use the hostinfo tool to determine to which IP address it maps. For more information, see "Using hostinfo".

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments