----------------------------
Netserver Agents 5.50 readme
----------------------------

This readme contains an overview and known issues for the Netserver
Agents.

Versions Supported:

- Red Hat 7.1
- Red Hat 7.0
- Red Hat 6.2
- SuSE 7.2
- SuSE 7.0
- Debian 2.2
- Turbo Linux 6.5

The purpose of this document is to insure that you are aware of the latest
information for your Netserver Agents. To check for periodic updates, go to
http://www.hp.com/toptools.


--------
Contents
--------

1. Release Notes
2. Overview
3. Installation
4. Uninstall
5. Known Issues
6. Important Notes


----------------
1. Release Notes
----------------

New Features for All Distributions:
- This is the first release of Netserver Agents for Linux.

Issues Fixed for the Other Distributions:
- None.


-----------
2. Overview
-----------

Welcome to the Netserver Agents, Hewlett-Packard's Netserver manageability
software based on the SNMP protocol (Simple Network Management Protocol.)

The Linux version of the SNMP Agents was developed based on the extensibility
of the UCD SNMP agent package (see http://net-snmp.sourceforge.net.)


---------------
3. Installation
---------------

3.1. Before You Begin

Before starting the installation of the Netserver Agents on your HP Netserver
machine, verify that all requirements are satisfied.


3.1.1. Hardware Requirements

This version of the Netserver Agents for Linux can be installed only on a
specific set of HP Netserver computers, listed below:

e 60, e 800,
lpr, 
lxr 8500,
lc 2000/r, 
lh 3000/r, lh 6000/r 
lt 6000r 
lp 1000r, lp 2000r

3.1.1.1. Hardware support added on release 5.50.10:

lc II,
lh 3, lh 3r,
lc 3,
lh 4, lh 4r,
lxr 8000
		    
3.1.1.2. Hardware support added on release 5.50.11:

tc 6100,
lh 6000 U3,
lc 2000 U3,
lh 3000 U3,
tc 7100,
rc 7100

3.1.2. Software Requirements

This product needs the following packages installed in the system to run:


3.1.2.1 For Red Hat:
- Kernel: 
  - Red Hat 6.2: 
     2.2.16-3
     2.2.16-3smp
     2.2.17-14
     2.2.17-14smp
     2.2.19-6.2.1
     2.2.19-6.2.1smp
     2.2.19-6.2.7
     2.2.19-6.2.7smp
  - Red Hat 7.0: 
     2.2.16-22
     2.2.16-22smp
     2.2.17-14
     2.2.17-14smp
     2.2.19-7.0.1
     2.2.19-7.0.1smp
  - Red Hat 7.1:
     2.4.2-2
     2.4.2-2smp
- RPM 4.0.2
- Curl 7.7.2
- UCD SNMP:
  - Red Hat 6.2:
     4.2
  - Red Hat 7.0:
     4.2
  - Red Hat 7.1:
     4.2.1


3.1.2.2 For SuSE:
- Kernel:
  - SuSE 7.2:
     2.2.19
     2.2.19-smp
     2.4.4-4GB
     2.4.4-64GB-SMP
  - SuSE 7.0: 
     2.2.16
     2.2.16-smp
- Curl 7.7.2
- UCD SNMP:
  - SuSE 7.2:
     4.2.1
  - SuSE 7.0:
     4.2


3.1.2.3 For Debian
- Kernel:
    - Debian 2.2: 
     2.2.17
     2.2.19
- Curl 7.7.2
- UCD SNMP 4.2


3.1.2.4 For TurboLinux:
- Kernel:
  - TurboLinux Server 6.5
       2.2.18-2
       2.2.18-2smp
- Curl 7.7.2
- UCD SNMP 4.2
	    

The Curl and UCD SNMP packages you will find in the distribution CD together
with the Netserver Agents packages.

For information about how to upgrade the kernel, go to the link below:
http://www.redhat.com/support/docs/howto/kernel-upgrade/kernel-upgrade.html

For information about how to upgrade the RPM package, go to the link below:
http://www.redhat.com/support/errata/RHEA-2001-016.html


3.1.3. Hard Disk Space Requirements

The minimum amount of hard disk space needed for this product is 22 MB.


3.1.4. Management Software

The current implementation of Netserver Agents was tested and approved for
use with the HP Toptools Device Manager 5.5.


3.1.5. Coexistence with Other HP Products

As of this writing there are no known coexistence problems with other
HP products.


3.2.  Installation Details

IMPORTANT NOTICES:
++++++++++++++++++

    1. For RPM based distributions only (e.g. Red Hat and SuSE), when updating
       the Netserver Agents package, remove the old agents_lx package before 
       proceeding with the installation:

	    # rpm -e agents_lx
        
       Notice that to avoid removing the history data files from your computer,
       enabling Agents to keep historic information after an upgrading process, 
       hpserver-core must not be removed.

    2. For Red Hat 6.2 only, when updating Netserver core component 
       (hpserver-core) from a version older than 5.02.08, first remove 
       agents_lx, itt_lx and hpserver-core before proceeding with the 
       installation:
            
           # rpm -e agents_lx
           # rpm -e itt_lx
           # rpm -e hpserver-core
      
       Notice that some data files will be removed, and Agents will not keep 
       "Contact" and "Location" information.


    3. Before installing the Netserver Agents on a HP machine running Linux,
       verify if your platform satisfies the hardware and software requirements
       as listed in section 3.1. If all requirements are satisfied, just follow
       procedure listed below for each supported distribution. Note that
       letters xx and yy in package names specify respectively the patchlevel
       and release of the product.
       For instance, agents_lx-5.50.09-01_debian22.i386.deb refers to Netserver
       Agents version 5.50, patchlevel 09, release 01 for Debian 2.2.

    4. Sometimes, when snmp is being started, one of the following messages is
       displayed:

          # Creating directory: /var/ucd-snmp

          or

          # UCD-SNMP version 4.2.1

       Please, press Enter key to continue.


3.2.1. For Red Hat:

    1. Download the zip file containing the appropriate Netserver Agents
       installation files for your version of Linux (the installation files
       are separated in directories named by distribution version).

    2. Expand the zip file containing the Netserver Agents to a temporary
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_the_package> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages (see notes below) - notice the asterisk 
       in the command below:
           # rpm -U /tmp/ucd-snmp-*zzz.i386.rpm

    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
           # cp -f /tmp/snmpd.conf /etc/snmp/

    5. Install the Curl package (see notes below):
           # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm
           NOTE: For Red Hat 7.1 install the compatibility package
                 openssl095a-0.95a-1.i386.rpm found in 'Disc 2' of the Red Hat
		 7.1 distribution BEFORE installing the Curl package.

    6. Install the Netserver core component (see notes below):
           
       If you are running Red Hat 6.2, first of all install the MMC Module
       component using the following command:
               # rpm -U /tmp/mmcdev-5.02.xx-yy_zzz.i386.rpm
               Notice that if the MMC Module is already built in kernel or
               built as a kernel module, this package is not needed and its
               installation will not complete and a warning message will be
               displayed.

      For all distributions including Red Hat 6.2:
          Install the Netserver core component:
               # rpm -U /tmp/hpserver-core-5.02.xx-yy_zzz.i386.rpm

    7. Install the Netserver Agents package (see notes below):
           # rpm -U /tmp/agents_lx-5.50.xx-yy_zzz.i386.rpm

    8. Register the SNMP daemon for automatic execution:
           # /sbin/chkconfig snmpd on

    9. Start the SNMP daemon:
           # /sbin/service snmpd start

    10. No system reboot is necessary.


3.2.2. For SuSE:

    1. Download the zip file containing the appropriate Netserver Agents
       installation files for your version of Linux (the installation files
       are separated in directories named by distribution version).

    2. Expand the zip file containing the Netserver Agents to a temporary
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_the_package> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages (see notes below):
       For SuSE 7.2:
           Install the ucdsnmp package that comes with the SuSE distribution.
           # rpm -U ucdsnmp.rpm

       For SuSE 7.0:
           NOTICE: In order to update the ucd-snmp packages you must use remove
               (-e) and install (-i) rpm options instead of update (-U). E.g.:
               instead of 'rpm -U ucd-snmp*.rpm' use 
               'rpm -e ucd-snmp ucd-snmp-utils; rpm -i ucd-snmp*.rpm' 
               (without the quotes.)
               If you are not sure about how to proceed, try the steps below: 

           3.1. Discover all UCD-SNMP packages and its dependencies:
                # rpm -q --whatrequires ucd-snmp libsnmp.so.0

           3.2. Remove those packages (if there is no relevant packages, skip to 
                the next step):
                # rpm -e <package names>

           3.3. Install the new packages
                # rpm -i /tmp/ucd-snmp-*zzz.i386.rpm

    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
           For SuSE 7.0:
               # cp -f /tmp/snmpd.conf /etc/snmp/
           For SuSE 7.2:
               # cp -f /tmp/snmpd.conf /etc/ucdsnmpd.conf

    5. Install the Curl package (see notes below):
           # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm

    6. Install the Netserver core component (see notes below):
           # rpm -U /tmp/hpserver-core-5.02.xx-yy_zzz.i386.rpm

    7. Install the Netserver Agents package (see notes below):
           # rpm -U /tmp/agents_lx-5.50.xx-yy_zzz.i386.rpm

    8. Register the SNMP daemon for automatic execution:
       Edit /etc/rc.config and replace the string "no" for "yes" at
       the START_SNMPD field.

    9. Start the SNMP daemon, if it is not already running:
       To verify its status, type:
           For SuSE 7.0:
               # /sbin/init.d/snmpd status
           For SuSE 7.2:
               # /etc/init.d/snmpd status

       To start it, type:
           For SuSE 7.0:
               # /sbin/init.d/snmpd start
           For SuSE 7.2:
               # /etc/init.d/snmpd start

    10. No system reboot is necessary.


3.2.3. For Debian:

    1. Download the zip file containing the appropriate Netserver Agents
       installation files for your version of Linux (the installation files
       are separated in directories named by distribution version).

    2. Expand the zip file containing the Netserver Agents to a temporary
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_the_package> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages:
    	   # dpkg -i -G /tmp/libsnmp-base_4.2.1-4_all.deb      
	   # dpkg -i -G /tmp/libsnmp4.2_4.2.1-4_i386.deb
	   # dpkg -i -G /tmp/snmp_4.2.1-4_i386.deb
	   # dpkg -i -G /tmp/snmpd_4.2.1-4_i386.deb
	
       3.1. Edit the file /etc/default/snmpd and change the value of TRAPDRUN 
            to "no" (without the quotes).
       
       3.2. Restart the SNMPD daemon:
	    # /etc/init.d/snmpd restart

    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
            # cp -f /tmp/snmpd.conf /etc/snmp/

    5. Install the Curl package:
            # dpkg -i -G /tmp/libcurl_7.7.2-1_i386.deb

    6. Install the Netserver core component:
            # dpkg -i -G /tmp/hpserver-core-5.02.xx-yy_debian22.i386.deb

    7. Install the Netserver Agents package:
       
            7.1 Before installing agents-lx, if there are hard disk cage 
	    devices, look for special files /dev/sg*. If there are no such 
	    files, create them using the following commands:
	           # cd /dev
	           # ./MAKEDEV sg
                   # cd -
        
	After that, install Netserver Agents package:     
            # dpkg -i -G /tmp/agents-lx-5.50.xx-yy_debian22.i386.deb

    8. No system reboot is necessary.


3.2.4. For Turbo Linux:

    1. Download the zip file containing the appropriate Netserver Agents
       installation files for your version of Linux (the installation files
       are separated in directories named by distribution version).
		  
    2. Expand the zip file containing the Netserver Agents to a temporary
       location on your Linux system (for example /tmp)
	    # unzip -o <name_of_the_package> -d /tmp
       for example,
	    # unzip -o customer.zip -d /tmp
					  
    3. Install the UCD SNMP packages (see notes below) - notice the asterisk
       in the command below:
            # rpm -U /tmp/ucd-snmp-*zzz.i386.rpm
										
    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
            # cp -f /tmp/snmpd.conf /etc/snmp/       
											   
    5. Install the Curl package (see notes below):
            # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm
													  
    6. Install the Netserver core component (see notes below):
            # rpm -U /tmp/hpserver-core-5.02.xx-yy_zzz.i386.rpm
										 
    7. Install the Netserver Agents package (see notes below):
            # rpm -U /tmp/agents_lx-5.50.xx-yy_zzz.i386.rpm
															
    8. Register the SNMP daemon for automatic execution:
            # /sbin/chkconfig snmpd on
																		       
    9. Start the SNMP daemon:
            # /etc/rc.d/init.d/snmpd start

    10. No system reboot is necessary.


3.3. How to verify that the Netserver Agents are Running

To make sure Netserver Agents are running on the machine verify if the
following services are running: hpasrsvc, hpcagsvc, hpesysvc, hpevcsvc, 
hpevttrapd, hplersvc, hpnictrapd, hppfmsvc, hprccsvc, hpsdnsvc, hpsftsvc, 
hpswvsvc, hptatsvc, hpvcptrapd and snmpd.

Notice that hpsftsvc service will only be running if the system has a hard
disk cage installed.


The command to verify the status of a service is:


3.3.1. For Red Hat:
    # /sbin/service <service_name> status

    The output should be similar to:

    <service_name> (pid <process id>) is running...


3.3.2. For SuSE 7.0:
    # /sbin/init.d/<service_name> status

    The system replies with:
    - No process, if the service is not running.
    - OK, if the service is running.

3.3.3. For SuSE 7.2:
    # /etc/init.d/<service_name> status

    The system replies with:
    - Unused, if the service is not running.
    - Running, if the service is running.

3.3.4. For Debian
    # ps axo command | grep <service_name> | grep -v "grep"

    The command will output:
    - the service name, if it's running;
    - nothing, otherwise.

3.3.5 For TurboLinux:
    # /etc/rc.d/init.d/<service_name> status
    
    The output should be similar to:
	
    <service_name> (pid <process id>) is running...
	    
    TurboLinux has all networking access denied by default for security reasons.
    If all services are running and you don't obtain responses, probabily you
    must grant access to the host running. Edit the file /etc/hosts.deny, remove
    the line contends "ALL: ALL" and restart the snmp deamon:
        # killall -HUP snmpd
		      

3.4. Using the Netserver Agents

To access information supplied by the Netserver Agents you need an SNMP
enabled management tool such as the Toptools Device Manager 5.5 or OpenView.


------------
4. Uninstall
------------

4.1. For distributions based on RPM

If you wish to remove the Netserver Agents from your system, execute the 
following steps, logged on as root:
     
        # rpm -e agents_lx
        # rpm -e hpserver-core

     For Red Hat 6.2 only:
    
        # rpm -e mmcdev
        NOTE: If MMC Module component was not installed, this command will 
              display a warning message. You can safely disregard this message.
     
Notice that the hpserver-core package may be in use by other HP products and
if so the last command will tell you and will not uninstall the package.
No reboot is necessary.

Notice that rpm displays a warning messages about missing files. You can
safely disregard these messages.

The uninstall of the Netserver Agents does not remove the history data 
files from your computer, enabling the Agents to keep historic information
after a package upgrade.


4.2. For Debian

If you wish to remove the Netserver Agents from your system, execute the 
following steps, logged as root:
    
    # dpkg -P agents-lx
    # dpkg -P hpserver-core

Notice that the hpserver-core package may be in use by other HP products and
if so the last command will tell you and will not uninstall the package.
No reboot is necessary.

Uninstall of the Netserver Agents does not remove the history data files 
from your computer, enabling the Agents to keep historic information after 
a package upgrade.


---------------
5. Known Issues
---------------

5.1. General Issues:

- The hpnicagt, responsible for gathering information about the network
  interface cards installed in the system, does not support token ring cards.
- The Hard Disk Status page does not show any information.
- Due to a limitation of the UCD-SNMP master agent when handling character
  strings, the fields in System Location and User Name in page Configuration
  Settings must be filled with valid characters only. Valid characters are
  letters, numbers, space, '<' and '>' (without the quotes.)
- Due to a limitation of the UCD-SNMP master agent when handling character
  strings, in order to clear the fields System Location or User Name in page 
  Identity you must fill those fields with '<text>' (without the quotes) 
  in page Configuration Settings.
- The software version agent will report updates for the Netserver Agents 
  only after restarting the hpswvsvc service or clicking on Update button.
- There is no information about the SCSI subsystem in the Detailed Report 
  page.
- There is no Remote Locator button in the Reports page.
- When the system is under a very high load (CPU and/or memory usage), some 
  information from agents may not be shown due to a timeout.
- The agents will stop responding if the disk utilization reach 100%.
- The string "HP Netserver <name of the machine>" for Model field in 
  Identity page is displayed in lowercase instead of uppercase. The same 
  occurs to Netserver Model field (under the Netserver figure), Name field 
  present in Short Report / System Information and Detailed Report / System 
  Information, Name field present in Configuration / Configuration / 
  System Information.
- The string "HP" present in Identity page / Model field and in Reports 
  page / System Information group / Model field is shown in lowercase when 
  comparing it with Windows version of this same software.
- When trying to run ITT from TTDM, sometimes the TTDM shows an error 
  informing that the page cannot be loaded (browser error). The workaround 
  is update the discovery for the Netserver or remove it from TTDM database 
  and insert it again. 
- Uninstall of the Netserver Agents (agents_lx and hpserver-core) will cause
  Location and Contact data to be lost.

5.2. Issues for SuSE 7.0 only:

- Sometimes, a wrong BIOS or firmware update is reported on
  Reports page / Configuration Changes / BIOS / Firmware section.
- Sometimes, Detailed Report page can not be displayed by TTDM.


5.3. Issues for Red Hat 6.2/7.0 only:

- The value reported for I/O port of network interfaces may be wrong.
- The base address value displayed for I/O port field present in
  reports page / Detailed Reports /Network Interface card group.


5.4. Issues for Red Hat 7.1 only:

- Information about driver that has been updated is not available.


5.5. Issues for Debian 2.2 only:

- Under a stress of event log or when Event Log is full,
  the performance of Status tab / System event log slow down and
  several minutes are needed to recovery all logged events.
- Sometimes, a wrong BIOS or firmware update is reported on
  Reports page / Configuration Changes / BIOS / Firmware section.
- When hpserver-core is being uninstalled, warning messages are displayed
  about directories not empty being removed. Those messages can be
  safely disregarded.
- After uninstall Netserver Agents, Device Manager will show the column "SNMP"
  checked saying that HP Netserver has SNMP service installed. The workaround
  is update the discovery for the Netserver or remove it from TTDM database
  and insert it again. 

5.6. Issues for SuSE 7.2 only:

- Any information provided for aic7xxx.o driver may be wrong.
- When Event Log is been stressed, some links may be not displayed on
  pages accessed by Configuration tab and Configuration button.

5.7. Issues for Turbo Linux 6.5 only:

- The Agents will not show any information about HP NetRAID adapters and
  devices connected to it due to a bug in the kernel driver that prevents
  the agents from gathering NetRAID information.

- The Date/Time for failed CPU fan event may show a wrong date 
  (Jan,23 1954). This Data/Time is not correct, but the event really 
  ocurred in a recent date.

------------------
6. Important Notes
------------------

- The default configuration file of the UCD SNMP package does not define
  the accessible network address and the community name. We provided an
  alternative configuration file that permits read/write access to all hosts
  in step 4 of item 3.2 - Installation Details.
  If this open permission is not acceptable, do not execute the step 4 of the
  Installation Overview and please consult the manual pages of the UCD SNMP
  configuration file using the command below in order to learn how to
  configure the SNMP daemon to reply remote queries:
    # man snmpd.conf
- Some packages necessary for Agents depend on other packages that are not 
  released with these agents. Those packages occasionally may depend on other
  software too. As an example, agents-lx depends on curl and ucd-snmp, which 
  depend on openssl.
  If some necessary packages are not installed by rpm utility, the system 
  administrator should solve those dependencies for the completeness 
  installation of the agents for Linux.


