CVIPINFO.NLM

Scope

Intended Audience
All X
CommVault Internal  
CE/System Test  
Development  

Release

  • CommVault Software independent

Description

CVIPInfo is a diagnostic tool for getting information about the IP configuration of a machine. It is mostly used to verify the configuration of multiple network cards to be used with Galaxy.

Configuring Galaxy for Multiple Network Interfaces

In order for Galaxy to utilize secondary network interfaces, the secondary interfaces must be configured correctly. Galaxy requires that each interface be given a unique name. This name will need to be the primary name for that address. If using host files, this would be the first name after the IP address; if using DNS, it would be the Fully Qualified Domain Name (FQDN) that causes the DNS server to reply (see Note regarding Windows 2000). It is possible to allow one IP address to resolve directly to the machine name; however this address must be bound first so that it is the primary address for the machine.

Once the machine's network cards and name/address resolution are correctly configured, Galaxy must be instructed to use the secondary interfaces. This is done through setting pipeline pairs. A pipeline pair is configured at the subclient level; it is an advanced property on the Storage Device Pane. When adding a pipeline pair, it is important to make sure that the interfaces are capable of communicating with each other. Although pipeline pairs are configured at the subclient level, they affect all backups and restores that are done between that Client and MediaAgent. Configuration of one pipeline pair will automatically update all other subclients on that Client that point to the same MediaAgent (not just the storage policy). If multiple pipeline pairs are configured for a Client/MediaAgent, Galaxy will alternate between them.

NOTE

  • Windows 2000 has introduced some problems in resolving addresses back to names. In Windows 2000 and Windows 2000 SP1, address lookups would skip the Host file and DNS and simply return the local node name. This causes all pipeline pair entries to return the machine name. This issue was fixed with hotfix Q265017. Windows 2000 SP2 has re-introduced part of this problem in that DNS is ignored when resolving addresses. This requires all interface names to be registered in the local hosts file.

Usage

When CVIPInfo is run without arguments, it lists all the addresses that are bound to the local machine. It then takes each address and attempts to do a reverse lookup to find the name for that address. This list of names is the list of interfaces that Galaxy will display as possible selections for pipeline pairs. CVIPInfo will then try to find the primary address for each interface name. This address should match the address that was resolved back to the interface name; if so, cvipinfo simply displays a + after the interface name. If the address does not match, CVIPinfo displays a - after the interface name and prints the address that was returned. If a interface name is used that did not resolve back to the correct address, Galaxy will use the second address listed. Put simply, Galaxy will only correctly use addresses that displayed a +.

When CVIPInfo has checked all the addresses, it will print a warning report about any problems it encountered. This will include any address that did not have a name entry, names that didn't have address entries, and finally names that had mismatched addresses.

CVIPInfo can also look up remote names. This is done by specifying the name to look up as the first parameter on the command line. This can be useful to ensure that two machines know a name as the same address.

Using the Utility

  1. Copy CVIPINFO.NLM on the NetWare server in the SYS:\SYSTEM folder.
  2. From the System Console on the server, run LOAD CVIPINFO [hostname]

Examples

  1. LOAD CVIPINFO
  2. LOAD CVIPINFO <hostname>

Sample Output

Sample 1: Looking up Local Host info for mystery
Host Name: mystery.commvault.com
Address Type: 2
Address Length: 4
Aliases:
Addresses: 172.19.60.203 mystery.commvault.com +
           172.19.177.12 mystery.henry.commvault.com +

In this sample the both addresses are correctly configured and Galaxy will not have any problems using either address.

Sample 2: Looking up Local Host info for GLADIATOR
Host Name: GLADIATOR.commvault.com
Address Type: 2
Address Length: 4
Aliases:
Addresses: 172.19.63.139 GLADIATOR.commvault.com +
           192.168.0.1 GLADIATOR.commvault.com - 172.19.63.139
           192.168.0.11 GLADIATOR.commvault.com - 172.19.63.139
           192.168.0.111 GLADIATOR.commvault.com - 172.19.63.139


WARNING: 3 Interface Names did not resolve back to the correct address

In this sample, none of the secondary addresses are registered in DNS or the host file. Galaxy will list GLADIATOR.commvault.com four times and they will all use 172.19.63.139 to communicate.

Sample 3: Looking up Local Host info for mystery
Host Name: mystery.commvault.com
Address Type: 2
Address Length: 4
Aliases: Addresses: 172.19.177.12 mystery.henry.commvault.com +
                    172.19.60.203 mystery.commvault.com - 172.19.177.12

WARNING: 1 Interface Names did not resolve back to the correct address

In this sample, the second address, which actually has the primary address's name, points back to the primary address. This is due to an incorrect binding order. The address that has the machine name as its own name should be bound before secondary cards.

History

Revision Date Description
Revision 1 January 1, 2007 Initial revision.

Disclaimer of Warranties

CommVault provides software tools and utilities on an "as is" basis, as a courtesy and convenience to its users, and they may be changed from time to time without notice. These tools and utilities are provided without express, implied, or statutory warranties of any kind. You assume full risk and responsibility for the selection, possession, performance and proper installation and use of the software tools and utilities, and for verifying the results obtained there from. Your use of CommVault software tools and utilities indicates your unconditional acceptance of the above disclaimer.