                            HP Network Configuration Tool

Table of Contents
=================
Introduction
Known Issues
Installation
Configuration
Troubleshooting
Removal
Licensing



Introduction
################################################################################

The HP Network Configuration Tool (NCT) displays configuration information
for HP ProLiant network interface cards (NICs). NCT gives users the ability 
to view the NIC configuration in a graphical fashion. If the HP Advanced 
System Management (ASM) and Remote System Management (RSM) Agents are 
installed, the physical slot and port will be displayed for each NIC. If 
running on certain blade enclosures, the physical rack bay and slot 
associated with the NIC will be displayed allowing users to easily connect 
network cables to specific blade ports.



Known Issues
################################################################################

See the Troubleshooting section for resolving common problems.
No known issues with this release.



Installation
################################################################################

Run the following command to install the HP NCT package:

   rpm -Uvh hp-nct-x.x.x-x.distribution.linux.rpm

Where "x.x.x-x" is the version of HP NCT, and "distribution" is the distribution
identifier.

If the physical slot/bay and port are desired, install the hprsm and hpasm
packages using the following commands:

   rpm -Uvh hprsm-x.x.x-x.distribution.architecture.rpm
   rpm -Uvh hpasm-x.x.x-x.distribution.architecture.rpm

Where "x.x.x-x" is the version of HP NCT, "distribution" is the distribution
identifier, and "architecture" is the machine architecture.

HP recommends running the latest drivers with hp-nct. For the latest driver, 
firmware, and documentation updates, go to http://www.hp.com/servers/networking



Configuration
################################################################################

Ensure the network drivers (e1000, tg3, bnx2, etc) for the NICs in the server 
are loaded. Event if the NICs are not yet configured, the NIC drivers must be 
loaded in order for NCT to query the NICs.

Start NCT by running:
   /opt/hp/hp-nct/hp-nct

A link can be created to hp-nct to prevent one from having to enter
the entire path. Create the link using:

   ln -s /opt/hp/hp-nct/hp-nct /usr/local/bin/hp-nct

The should launch by running hp-nct, provided /usr/local/bin is in the
$PATH environment variable (echo $PATH).

NOTE: The hp-nct application requires root privileges to access certain NIC
      information, and thus will not run without root privileges.


Troubleshooting
################################################################################

Problem: 
      Only NIC interfaces starting with "eth" show up in the GUI.

Possible cause:
      The NCT application only displays NIC interfaces beginning
      with "eth", such as "eth0". It is common practice for operating
      system to name NIC interfaces starting with "eth", thus NCT
      only displays interfaces beginning with "eth".

Possible solution:
      Don't rename the NIC interfaces.


Problem: 
      NIC configuration information is not displayed.

Possible cause:
      The driver for NIC is not loaded, thus the information is not
      available.

Possible solution:
      Load the NIC driver and restart the hp-nct application.


Problem: 
      NIC configuration information, such as the IP address, does not
      match the IP address currently assigned to the interface.

Possible cause:
      The IP address has been changed via command line utility, such
      as ifconfig. The NCT application collects configuration information 
      from the configuration files. Changes that are dynamically made will
      not be reflected in NCT.

Possible solution:
      Make the configuration change in the NIC configuration file and
      restart NCT.


Problem: 
      NIC physical slot and port (or blade bay and port) are not
      displayed by NCT.

Possible cause:
      The hpasm and hprsm packages are not installed.

Possible solution:
      Install the hpasm and hprsm packages. See the "Installation" section
      of this README for details on installing these two packages.


Problem: 
      The NIC IP address does not match the IP address currently assigned
      to the NIC interface.

Possible cause:
      NCT obtains the IP address from the configuration file. If an IP
      address is not found in the configuration file associated with the
      NIC and the NIC has been dynamically assigned an IP address, the 
      address assigned to the NIC will be displayed.

Possible solution:
      If the IP address is dynamically assigned via such applications as DHCP 
      or the bonding driver, do not assign an IP address in the 
      NIC configuration file since it will over-ride the dynamically assigned
      IP address.


Removal
################################################################################
To remove the HP Network Configuration Tool package, run the following command:

   rpm -e hp-nct



Licensing
################################################################################
See the LICENSE text file in this directory.


--------------------------------------------------------------------------------
Copyright 2006 Hewlett-Packard Development Company, L.P.

Product names mentioned herein may be trademarks and/or registered
trademarks of their respective companies.


