BackUp LevelNext

Solaris Network Management Tools

A number of Bright Tiger network management tools are provided that you can use to troubleshoot and analyze your server systems and network.

Using btcfgchk

To run btcfgchk use the following syntax:

/<bt-installdir>/program/btcfgchk

The following sample output shows how btcfgchk reports 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

Errors reported by btcfgchk

Errors reported by btcfgchk generally involve a misconfiguration of your DNS Server. Bright Tiger requires that DNS be setup to provide both forward and reserve mappings. Forward mapping is when the hostname is translated to an IP address. Conversely reserve mapping is taking an IP Address and mapping it to its hostname. ClusterCATS expects the mapping to be 1 to 1 (one hostname, one IP Address).

The following table shows errors btcfgchk may report.

Errors reported by btcfgchk
Error Explanation
Hostname does not map to a single IP address The main hostname for this system is not mapping to 1 IP address. Possible problems are: The main hostname of the system could not be resolved to any IP address. The DNS tab of the TCP/IP property sheet in the network control panel applet shows you the hostname and the domain. Your fully qualified hostname is the combination of these two fields. Make sure there are no typos in these names. If using DNS, type:
nslookup <fully qualified hostname> 

This will verify that the hostname is correct. If you're using local hosts file, look in the hosts file (/etc/hosts) to make sure the fully qualified hostname entry contains no typos. There is a DNS entry for this name.

or:

The hostname is a DNS Round Robin name. If you run the Bright Tiger hostinfo tool and see more than one IP address, this is the problem.
No adapter associated with hostname 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 hostname.
Error: Duplicate Primary Adapter btcfgchk found two network adapters with the same IP address. Use the command ifconfig -a to look at your adapter information.
Name lookup for <hostname> failed btcfgchk was not able to determine the IP address for the specified host. Possible problem:
  • Your DNS server may be down. Use nslookup to see if it can contact your DNS server.
<IP address 1> reverse maps to <hostname> which then forward maps to <IP address 2> btcfgchk did a lookup on <IP address 1> and found what hostname it is mapped to. It then took the hostname returned and verified that this name maps back to the IP address specified. The verification failed. There is likely an issue with your DNS setup. Use Bright Tiger hostinfo the tool to gather more information on how the names/IP Address are configured.
hostinfo <IP address 1>
hostinfo <hostname returned from initial hostinfo>
Error looking up <hostname> by name Bright Tiger could not resolve the given hostname to an IP addresses. Use nslookup to look up the hostname in DNS, or look in your /etc/hosts file if using local hosts file.
Hostname a round robin name, or does not map to configured IP address The hostname maps to more than 1 IP address (DNS Round Robin) or maps to an IP address not found on this machine. Use the Bright Tiger tool:
hostinfo <hostname>

If you see more than one IP address, it is DNS Round Robin. If you see one IP address, check to see if that address is configured on this machine. You can use ipconfig/all to view the IP addresses on this machine.
Hostname 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 hostname. None of the IP addresses on the system reverse mapped to the system's main fully qualified hostname. The problem is either:
  • The hostname maps to the wrong IP address.
  • The IP address that the hostname maps to does not have an entry in the DNS for the reverse map. nslookup does not return the hostname.
Probable round robin configuration for <hostname> The hostname does not map to a single IP address. Use the hostinfo tool to view the IP address it maps to.

Using the Bright Tiger hostinfo utility

Hostinfo displays information about a specific domain name.To run hostinfo:

#cd <btinstall-dir>/program/

Set the default directory to the Programs Directory under Bright Tiger.

#<btinstall-dir>/program> hostinfo domain_name 

The following shows sample output for hostinfo for a set of DNS round robin host names.

##<btinstall-dir>/program> hostinfo www.brighttiger.com
Information for host 'www.brighttiger.com':

FQHN: www.brighttiger.com
Primary Address: 0.0.0.0
Domain: .brighttiger.com
Aliases: btweb1.brighttiger.com 
    btweb2.brighttiger.com
    www.brighttiger.com 
Addresses: 444.87.27.76 444.87.27.77

Hostinfo displays the domain name, the primary address and any aliases. If the primary address is 0.0.0.0, the domain is using round robin and the round robin names will appear under the Alias and the round robin addresses will appear under Addresses.

Using the Bright Tiger sniff utility

Sniff displays packets that a specific Network Interface Card (NIC) is hearing. To run sniff:

#/<btinstall-dir>/program/sniff

The following shows sample output for sniff:

Mail Test Environment Variables:
   BTMailHost,     BTSender,       BTRecipients,   BTSubject,    BTText
 Packet Test Environment Variables:
   BTPort,         BTMcastTTL,     BTUcastCount,   BTBcastCount, 
BTMcastCount
   BTSendInterval, BTDoLocalBind,  BTUcastAddress, BTBcastAddress
   BTMcastAddress, BTLocalAddress, BTSendSize,     BTRecvSize
   BTConsole,      BTLogFile,      BTSystem

 Press keys at run-time:
  d - dump sniff configuration information
  H - display this and more help
  h - display this help
  l - run load balance test thread
  m - run mail test thread
  p - toggle packet dump display
  q, <ESC>, <ENTER> - quit all active threads and exit
  r - run UDP listener thread
  s - run packet test thread
  x - execute system command

Use the "r" command within sniff to listen to intra-cluster packets:
Listen Thread thread running on 'any' interface...

[ SrvHello    @ Tue Jun 30 17:01:57 1998] 192.168.0.213
boston1.brighttiger.com          (192.168.0.118  ) (255.255.255.0  )
sales_automation   Mcast V1.2    Available   2/90
[[ SrvHello    @ Tue Jun 30 17:01:57 1998] 192.168.0.213
somewhere.brighttiger.com        (192.168.0.213  ) (255.255.255.0  )


BackUp LevelNext

allaire

AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.