                         HP Network Configuration Tool

Table of Contents
=================
Introduction
Known Issues
Installation
Configuration
The hp-nic_ports Utility
Troubleshooting
Removal
Licensing



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

The HP Network Configuration Tool (NCT) displays configuration information for
HP ProLiant Network Server Adapters. NCT allows users to graphically view an
adapters configuration. 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 Network Server Adapter. If running on c-Class BladeSystem
enclosures, the physical rack bay and slot associated with the adapter is
displayed allowing users to easily connect network cables to specific blade
adapter 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 network adapters in
the server are loaded. Even if the network adapters are not yet configured, the
network adapter drivers must be loaded in order for NCT to query the network
adapters.

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

This 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 network
      server adapter information, and thus will not run without root privileges.



The hp-nic_ports Utility
################################################################################

The hp-nic_ports utility lists the slot and port of each network server adapter
if the hpasm and hprsm packages are installed, see the Installation section of
this document. On C-Class blade enclosures, the bay and bay port for each
server adapter is displayed instead of the slot and port. Sample command usage
is shown below:

[root@tonycu ~]# /opt/hp/hp-nct/hp-nic_ports
iface slot    port    bay     bayport  Model Name
eth0  0       1       n/a     n/a      Compaq NC7781 Gigabit Server Adapter
eth1  0       2       n/a     n/a      Compaq NC7781 Gigabit Server Adapter
eth2  1       1       n/a     n/a      HP NC7170 Gigabit Server Adapter
eth3  2       1       n/a     n/a      HP NC7771 Gigabit Server Adapter
eth4  3       1       n/a     n/a      HP NC370T Multifunction Gigabit Server Ad
eth5  1       2       n/a     n/a      HP NC7170 Gigabit Server Adapter
[root@tonycu ~]#

If only the hp-nic_ports utility is desired from the NCT package, the following
commands can be run to extract the utility from the NCT RPM. This is useful
if the graphic libraries are not installed on the target server and only
the hp-nic_ports utility is desired.

   rpm -ivh --nodeps  hp-nct-x.x.x-x.distribution.linux.rpm
   cp /opt/hp/hp-nct/hp-nic_ports .
   rpm -e hp-nct

The hp-nic_ports utility is now located in the current directory and can be
run by the following command:
   ./hp-nic_port


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

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

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

Possible solution:
      Don't rename the server adapter interfaces.


Problem:
      Network server adapter configuration information is not displayed.

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

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


Problem: 
      Network server adapter 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 network server adapter configuration
      file and restart NCT.


Problem:
      Network server adapter 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 server adapter IP address does not match the IP address currently
      assigned to the server adapter 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
      server adapter and the server adapter has been dynamically assigned an
      IP address, the address assigned to the server adapter 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
      server adapter 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-2007 Hewlett-Packard Development Company, L.P.

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


