----------------------------
HP Server Agents 5.53 readme
----------------------------

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

Versions Supported:

- Red Hat 7.2
- Red Hat 7.1
- SuSE 7.3
- SuSE 7.2
- Turbolinux 6.5
- Caldera OpenLinux Server 3.1
- Debian 2.2

The purpose of this document is to insure that you are aware of the latest
information for your HP Server 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
----------------

1.1 New Features:

    1. This release does not have support for the LSI Logic SNMP Extension agent.
       So, information about common SCSI devices (devices not attached to NetRAID
       controllers) will NOT be displayed in the pages: 
	    Status/System Status/Physical Storage/Hard Disk Status, 
	    Configuration/Configuration/Physical Storage and 
	    Reports/Detailed Report.
    2. This release does not support Revision Management. Inventory information
       will not be displayed.         
    3. Distributions based on Linux kernel 2.2.x are no longer supported.
    4. Memory events are reported in Status/System Status/Memory Status page. 
    5. HP NetRAID agent updated to version B.02.01.
    
   
1.2. New Linux kernels supported:
     - Debian 2.2
	2.4.18-386
	2.4.18-686
	2.4.18-686-smp
     
     - Red Hat 7.1
	2.4.9-31
	2.4.9-31smp
	2.4.9-31enterprise
     
     - Red Hat 7.2
	2.4.9-31
	2.4.9-31smp
	2.4.9-31enterprise     
		
1.3 Fixed Bugs:
    
    1. The traps configuration file /usr/hpserver/etc/hptraps.cfg is now
  correct. The traps to the localhost were being sent to a community called
  "publicr" instead of "public".

    2. The hpsftsvc service is obsolete and is not included in the SNMP Agents
  package anymore. Wrong information about this service was being shown in
  Configuration / Configuration / Management Software. 

    3. Many fixes to the HP NetCitizen agent (hpentagt and hpetyagt).

    4. For distributions that support UCD SNMP version 4.2.3, the bug of 
  cleanning fields (System Location, User Name, Rack Identifier and Rack 
  Position) in  Configuration / Settings page was fixed. To clean these fields
  it's only necessary to keep them blank.
  
    5. Machine serial number is correctly reported by HP Server Agents through
    the command:
	snmpwalk -t 60 localhost public .1.3.6.1.4.1.11.2.36.1.1.5.1.1.10.1
  PS: the option "-t 60" avoids a timeout.
	    
    6. Update of HP Server Agents for Red Hat 7.2 from version 5.51.00-02 to 
  5.52.00-01 occurs without any errors.
        
    7. Service hpnictrapd do not stop after package installation in machines
   that dont have NetRAID controllers.
   
    8. Tables of Physical Drivers and Logical Drivers do appear in page 
   Reports / Detailed Report / Disk Array(s).
   
    9. Status tab / Hard Disk Status / HP NetRAID Attached Hard Disk Drives / 
   Disk Drive Utility / test is available now. 
    
    10. Service hplersvc do not stop after package installation.
    

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

Welcome to HP Server Agents, Hewlett-Packard's Server 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 Server Agents on your HP Server
system, verify that all requirements are satisfied.


3.1.1. Hardware Requirements

This version of the Server Agents for Linux can be installed only on a
specific set of HP Server computers, listed below:
 
 
e 60, e 800,
lpr,
lxr 8500,
lc 2000, lc 2000r,
lh 3000, lh 3000r,
lh 6000, lh 6000r,
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:

lh 6000 U3,
lc 2000 U3,
lh 3000 U3,
lt 6000 U3

3.1.1.3. Hardware support added on release 5.50.14:

lp 1000r (1.13 and 1.26 GHz),
lp 2000r (1.13 and 1.26 GHz)

3.1.1.4. Hardware support added on release 5.52.00:

tc 3100,
tc 4100


3.1.2. Hard Disk Space Requirements

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


3.1.3. Software Requirements

You will need the Curl and UCD SNMP packages installed on your Linux system
before proceeding with the Server Agents installation (instructions at section 
3.2 - Installation Procedure). These packages are included together with the
Server Agents package.

In order to get information provided by the Motherboard Management Card (MMC)
the Server Agents need to add a device driver to the kernel. If you have one 
of the Linux distributions/kernels supported (please, see section 3.1.3.1),
this driver is already provided in the mmcdev package, included in the
distribution CD. Otherwise you must verify if there is a patch to add MMC
support to your kernel (please, see section 3.1.3.2). This patch and the
instructions about how to add it to the kernel are available in the
distribution CD.

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.1 Linux distributions supported

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

For Red Hat 7.1:

- Kernel (one of the following):
     2.4.2-2
     2.4.2-2smp
     2.4.2-2enterprise
     2.4.3-12
     2.4.3-12smp
     2.4.3-12enterprise
     2.4.9-6
     2.4.9-6smp
     2.4.9-6enterprise
     2.4.9-12
     2.4.9-12smp
     2.4.9-12enterprise
     2.4.9-31
     2.4.9-31smp
     2.4.9-31enterprise
- RPM 4.0.2
- Curl 7.7.2
- UCD SNMP 4.2.3-1.7.1.4

For Red Hat 7.2:

- Kernel (one of the following):
     2.4.7-10
     2.4.7-10enterprise
     2.4.7-10smp
     2.4.9-7
     2.4.9-7enterprise
     2.4.9-7smp
     2.4.9-13
     2.4.9-13enterprise
     2.4.9-13smp
     2.4.9-31
     2.4.9-31smp
     2.4.9-31enterprise
- RPM 4.0.3
- Curl 7.8-1
- UCD SNMP 4.2.3-1.7.2.3

For SuSE 7.2:

- Kernel (one of the following):
     2.4.4-4GB
     2.4.4-4GB-SMP
     2.4.4-64GB-SMP
     2.4.7-4GB
     2.4.7-4GB-SMP
     2.4.7-64GB-SMP
     2.4.16-4GB
     2.4.16-4GB-SMP
     2.4.16-64GB-SMP
- Curl 7.7.2
- UCD SNMP 4.2.3-79

For SuSE 7.3:

- Kernel (one of the following):
     2.4.10-4GB
     2.4.10-4GB-SMP
     2.4.10-64GB-SMP
     2.4.16-4GB
     2.4.16-4GB-SMP
     2.4.16-64GB-SMP
- Curl 7.8.1-24
- UCD SNMP 4.2.3-79

For TurboLinux Server 6.5:

- Kernel (one of the following):
     2.4.5-0.5
     2.4.5-0.5smp
- Curl 7.7.2
- UCD SNMP 4.2.3-1

For Caldera OpenLinux Server 3.1:

- Kernel:
     2.4.2
- Curl 7.7.2
- UCD SNMP 4.2.1-17

For Debian 2.2:

- Kernel (one of the following):
	   2.4.18-386
	   2.4.18-686
	   2.4.18-686-smp
- Curl 7.7.2-1
- UCD SNMP 4.2.3-2

3.1.3.2  MMC as a kernel patch

MMC as a kernel patch is only available for the following configuration:
  - Kernel stock 2.4.5
	- RPM 4.0.2
	- Curl 7.7.2
	- UCD SNMP 4.2
	
Note: this patch was only tested on Red Hat 6.2.

3.1.4. Management Software

The current implementation of the Server 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 Procedure

Before installing the Server Agents on an HP Server 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 the procedure listed
below for each supported distribution.

Note that package file names have the following format:

<package_name>-<version>.<patchlevel>-<release>_<distrib>.i386.<rpm>

As an example, agents_lx-5.50.09-01_rh71.i386.rpm refers to the
version 5.50, patchlevel 09 and release 01 for Red Hat 7.1 of a package named
agents_lx. Note that <version> is composed by a major and a minor version
numbers.

In the following sections the patchlevel, release and distrib fields will be
represented by letters xx, yy and zzz, respectively.

The Server Agents installation process will install all necessary files
and start services, which are registered for automatic execution on the
next system initialization. No reboot is necessary after the installation
process.

The package contains a hardware check procedure to verify if the Server
under use is supported by this Server Agents version. If not, a warning
message is displayed and the installation aborts.
 

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

    1. In order to upgrade snmp agents for Red Hat 7.1 from a version older
       than 5.51.00-03 you need to uninstall all the packages from the old
       version (including ucd-snmp) before installing the newer one.
       For information on how to uninstall these packages, please refer to
       the uninstall section of this document.

    2. For all Linux distributions, when updating Server 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:

       2.1 For distributions based on RPM (Red Hat, SuSE, TurboLinux and
           Caldera):
        
           To know the version of the hpserver-core package, type the following
           command:
           
               # rpm -q hpserver-core

           To remove agents_lx, itt_lx and hpserver-core execute the commands
           below:

               # rpm -e agents_lx
               # rpm -e itt_lx
               # rpm -e hpserver-core

       2.2 For debian:
           
           To know the version of the hpserver-core package, type the following
           command:
           
               # dpkg -s hpserver-core

           To remove agents_lx, itt_lx and hpserver-core execute the commands
           below:

               # dpkg -P agents-lx
               # dpkg -P itt-lx
               # dpkg -P hpserver-core

       Notice that some data files will be removed, and Agents will not keep
       "Contact" and "Location" information.

    3. When updating the mmcdev package from a version older than 5.52.00 for
       Red Hat 7.2, or older than 5.02.02 for all other Linux distributions,
       first remove this package before proceeding with the installation:

       3.1 For distributions based on RPM (Red Hat, SuSE, TurboLinux and
           Caldera):

           To know the version of the mmcdev package, type the following
           command:

               # rpm -q mmcdev

           To be able to update this package remove it by typing the following
           commands:

               # rpm -e mmcdev

       3.2 For debian:

           To know the version of the mmcdev package, type the following
           command:

               # dpkg -s mmcdev

           To be able to update this package remove it by typing the following
           commands:

               # dpkg -P mmcdev

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

           # Creating directory: /var/ucd-snmp

           or

           # UCD-SNMP version <version_number>

       Please, press Enter key to continue.
       
    5. When updating Server Agents package for SuSE 7.2 from version 
       5.51.00-02_suse72 to 5.52.00-01_suse72 it will be shown some messages 
       about services (hprmsvc, hprisvc and hpenvsvc) that did not stop 
       apropriately. Check if these services could start successfully and if 
       this is the case, just disregard those messages.
       
    6. For machines without NetRAID controllers, a message may be displayed 
       during installation of the Server Agents package warning that the HP 
       NetRAID daemon could not start. This is the expected behaviour so, this
       message can be safely disregarded. 


3.2.1. For Red Hat:

    1. Download the zip file containing the appropriate Server 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 Server Agents to a temporary
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_zip_file> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages:

	3.1. Type the command EXACTLY as shown below, asterisk included (don't
	     replace the asterisk):

		# rpm -U /tmp/ucd-snmp*.i386.rpm

             NOTE: this command installs all UCD SNMP packages simultaneously.

    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:

	5.1 For Red Hat 7.2:
           # rpm -U /tmp/curl-7.8-yy_zzz.i386.rpm

        5.2 For Red Hat 7.1:
           # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm

    6. Install the MMC device driver:
           # rpm -U /tmp/mmcdev-5.53.xx-yy_zzz.i386.rpm
           NOTE: if the MMC device driver is already built in kernel or
                 installed as a kernel module, this package is not needed and
                 its installation will be aborted with a warning message.

    7. Install the Server core component:
           # rpm -U /tmp/hpserver-core-5.53.xx-yy_zzz.i386.rpm

    8. Install the Server Agents package:
           # rpm -U /tmp/agents_lx-5.53.xx-yy_zzz.i386.rpm

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

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

    11. No system reboot is necessary.


3.2.2. For SuSE:

    1. Download the zip file containing the appropriate Server 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 Server Agents to a temporary 
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_zip_file> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages:

	3.1. Type the command EXACTLY as shown below, asterisk included (don't
	     replace the asterisk):

		# rpm -U /tmp/ucdsnmp*.i386.rpm
	   
    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
           For SuSE 7.2 and 7.3:
               # cp -f /tmp/snmpd.conf /etc/ucdsnmpd.conf

    5. Install the Curl package:
           For SuSE 7.2:
               # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm
           For SuSE 7.3:
	       # rpm -U /tmp/curl.rpm

    6. Install the MMC device driver:
           # rpm -U /tmp/mmcdev-5.53.xx-yy_zzz.i386.rpm
           NOTE: if the MMC device driver is already built in kernel or
                 installed as a kernel module, this package is not needed and
                 its installation will be aborted with a warning message.

    7. Install the Server core component:
           # rpm -U /tmp/hpserver-core-5.53.xx-yy_zzz.i386.rpm

    8. Install the Server Agents package:
           # rpm -U /tmp/agents_lx-5.53.xx-yy_zzz.i386.rpm

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

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

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

    11. No system reboot is necessary.


3.2.3. For Turbo Linux:

    1. Download the zip file containing the appropriate Server 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 Server Agents to a temporary 
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_zip_file> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages - type the command EXACTLY as shown below,
       asterisk included (don't replace the asterisk):
           # rpm -U /tmp/ucd-snmp-*.i386.rpm
           NOTE: this command installs all UCD SNMP packages simultaneously.

    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:
            # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm

    6. Install the MMC device driver:
           # rpm -U /tmp/mmcdev-5.53.xx-yy_zzz.i386.rpm
           NOTE: if the MMC device driver is already built in kernel or
                 installed as a kernel module, this package is not needed and
                 its installation will be aborted with a warning message.

    7. Install the Server core component:
            # rpm -U /tmp/hpserver-core-5.53.xx-yy_zzz.i386.rpm

    8. Install the Server Agents package:
            # rpm -U /tmp/agents_lx-5.53.xx-yy_zzz.i386.rpm

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

    10. Start the SNMP daemon:
            # /etc/rc.d/init.d/snmpd start

    11. No system reboot is necessary.


3.2.4. For Caldera OpenLinux Server:

    1. Download the zip file containing the appropriate Server 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 Server Agents to a temporary 
       location on your Linux system (for example /tmp)
           # unzip -o <name_of_zip_file> -d /tmp
       for example,
           # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages - type the command EXACTLY as shown below,
       asterisk included (don't replace the asterisk):
           # rpm -U /tmp/ucd-snmp-*.i386.rpm
           NOTE: this command installs all UCD SNMP packages simultaneously.

    4. Copy the alternate configuration file for the SNMP service (see item 6
       - Important Notes):
           # cp -f /tmp/snmpd.conf /etc/snmp/
	   
    5. Check the privileges of the SNMP daemon:
	   the original UCD SNMP 4.2.1-17 package registers the snmpd service to 
	   run as user nobody. If this is the case, you must change these 
	   privileges so that the snmpd service runs as user root. For example,
	   assuming that 65534 is the user id for the user nobody an that the 
	   snmpd service is registered in /etc/sysconfig/daemons, you 
	   can edit the file /etc/sysconfig/daemons/snmpd and replace the line:
			OPTIONS="-u 65534 -g 65534"	
	   by the following line:
			OPTIONS=
	   

    6. Install the Curl package:
           # rpm -U /tmp/curl-7.7.2-yy_zzz.i386.rpm

    7. Install the MMC device driver:
           # rpm -U /tmp/mmcdev-5.53.xx-yy_zzz.i386.rpm
           NOTE: if the MMC device driver is already built in kernel or
                 installed as a kernel module, this package is not needed and
                 its installation will be aborted with a warning message.

    8. Install the Server core component:
           # rpm -U /tmp/hpserver-core-5.53.xx-yy_zzz.i386.rpm

    9. Install the Server Agents package:
           # rpm -U /tmp/agents_lx-5.53.xx-yy_zzz.i386.rpm
	   
    10. Register the SNMP daemon for automatic execution:
       Edit the configuration file for the SNMP daemon, for example: 
       /etc/sysconfig/daemons/snmpd, and replace the string "no" for "yes" at
       the ONBOOT field.

    11. Start the SNMP daemon:
           # /etc/rc.d/init.d/snmpd start

    12. No system reboot is necessary.


3.2.5. 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_zip_file> -d /tmp
           for example,
             # unzip -o customer.zip -d /tmp

    3. Install the UCD SNMP packages:
           # dpkg -i -G -E /tmp/libsnmp-base_4.2.3-2_all.deb
           # dpkg -i -G -E /tmp/libsnmp4.2_4.2.3-2_i386.deb
           # dpkg -i -G -E /tmp/snmp_4.2.3-2_i386.deb
           # dpkg -i -G -E /tmp/snmpd_4.2.3-2_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 -E /tmp/libcurl_7.7.2-1_i386.deb

    6. Install the MMC device driver:
           # dpkg -i -G -E /tmp/mmcdev-5.53.xx-yy_zzz.i386.deb
           NOTE: if the MMC device driver is already built in kernel or
                 installed as a kernel module, this package is not needed and
                 its installation will be aborted with a warning message.

    7. Install the Netserver core component:
           # dpkg -i -G -E /tmp/hpserver-core-5.53.xx-yy_zzz.i386.deb

    8. Install the Netserver Agents package:

            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 -E /tmp/agents-lx-5.53.xx-yy_zzz.i386.deb

    9. No system reboot is necessary.


3.3. How to verify that the Server Agents are Running 

To make sure Server Agents are running, check MMC and SEL device drivers and
Server Agents services.
 

3.3.1. Checking MMC

Type the command:

    # cat /proc/devices | grep mmcdev

    The output will be:
        - <nnn> mmcdev, if the MMC device driver is correctly installed;
        - nothing, otherwise.

3.3.2. Checking SEL

Type the command:

    # lsmod | grep ^seldev

    The output will be:
        - seldev <size> <use_count> <depends>, if the SEL device driver 
        is correctly installed;
        - nothing, otherwise.

Notices:
    - <nnn> is a dynamic value assigned by the operating system.
    - <size>, <use_count> and <depends> are the amount of memory used, a use
    counter and a list of what device drivers depends on this module,
    respectively.
    - MMC and SEL device drivers will not be installed on Servers from 
    E series (e.g., e 60, etc.). Some services will be unable to run without
    this device driver.


3.3.3. Checking Server Agents services 

The following services must be running: hpasrsvc, hpcagsvc, hpdmmsvc, 
hpesysvc,hpevcsvc, hpevttrapd, hplersvc, hpnictrapd, hppfmsvc, hprccsvc,
hpsdnsvc, hpswvsvc, hptatsvc, hpvcptrapd, hpenvsvc, hpnragent and snmpd. 
Note that the hpnragent service only runs on machines with NetRAID controllers;
the status of this service may not be considered on machines that dont have 
this kind of controllers. 

The command to verify the status of a service is:

For Red Hat:

    # /sbin/service <service_name> status

    The output will be:
    - <service_name> (pid <process id>) is running..., if the service is
    running;

    - <service_name> is stopped, otherwise.
    

For SuSE 7.2 and 7.3:

    # /etc/init.d/<service_name> status

    The output will be:
    - running, if the service is running;
    - unused, otherwise.


For TurboLinux:

    # /etc/rc.d/init.d/<service_name> status

    The output will be:
    - <service_name> (pid <process id>) is running..., if the service is
    running;
    - <service_name> is stopped, otherwise.

    TurboLinux has all networking access denied by default for security
    reasons. If all services are running and you do not obtain responses
    from them, probably you must grant access to the host. Edit the file
    /etc/hosts.deny, remove the line containing "ALL: ALL" and restart the snmp
    daemon:
        # killall -HUP snmpd


For Caldera OpenLinux Server:

    if the service to be checked is snmpd:
    
    # ps ax | grep snmp
    
    The output must show a line containing the string "snmpd" (without the 
    quotes).
     

    if the service to be checked is hpnragent:
    
    # ps ax | grep hpnr
    
    The output must show one or more lines containing the string "hpnragent" 
    (without the quotes).
    
    
    For other services:

    # /etc/rc.d/init.d/<service_name> showstatus

    The output will be:
    - <service_name> is running..., if the service is running;
    - <service_name> is NOT running..., otherwise.

For Debian:

    # ps axo command | grep <service_name> | grep -v "grep"

    The output will be:
    - the service name, if the service is running;
    - nothing, otherwise.
    

3.4. Using the Server Agents 

To access information supplied by the Server 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 (e.g. Red Hat, SuSE, TurboLinux and Caldera)

If you wish to uninstall the Server Agents from your system, execute the 
following steps, logged on as root:

    4.1.1. Uninstall the Agents:	

	# rpm -e agents_lx

    4.1.2. Uninstall the HP Core Components:

	# rpm -e hpserver-core

    NOTE: the hpserver-core package is used by several HP products, and if 
          any of those products happen to be installed in your system, RPM
          will alert you of a failed dependency against those products
          and will not uninstall the package. This warning should be 
          considered OK since it's just alerting that if the hpserver-core
	  package be uninstalled then the other products will not work.

    4.1.3. Uninstall the HP MMC Module Driver:

    If you could NOT uninstall hpserver-core, jump to step 4.1.4; see section
    4.2 for more details.
    If you successfully uninstalled hpserver-core, verify if the mmcdev package
    is installed in your system through the command:

	# rpm -q mmcdev

    If so, remove it by typing the following command:

    **PLEASE**, just do that if you are sure that the
    hpserver-core package was already UNINSTALLED !!!

	# rpm -e mmcdev

    4.1.4. Uninstall the curl package (see the notes below): 

	# rpm -e curl

    4.1.5. Uninstall the ucd-snmp packages (see the notes below):

        For SuSE 7.2 and 7.3 only:
            # rpm -e ucdsnmp

        Otherwise:
	    # rpm -e ucd-snmp-utils
	    # rpm -e ucd-snmp


Notice that rpm may display warning messages about directories not empty.
You can safely disregard these messages.
Notice that hpserver-core, curl, ucd-snmp and ucd-snmp-utils packages may be
in use by other products and if so RPM will tell you that and will not uninstall
the package.
No reboot is necessary.

4.2. For Debian

If you wish to uninstall the Netserver Agents from your system, execute the
following steps, logged on as root:

    4.2.1. Uninstall the Agents:

	# dpkg -P agents-lx

    4.2.2. Uninstall the HP Core Components:

	# dpkg -P hpserver-core

    NOTE: the hpserver-core package is used by several HP products, and if
          any of those products happen to be installed in your machine, the
          RPM will alert you of a failed dependency against those products
          and will not uninstall the package. This warning should be
          considered OK, since if the RPM uninstall the hpserver-core package
          will render the other products broken.
 
    4.2.3. Uninstall the HP MMC Module Driver:
 
    If you could NOT uninstall hpserver-core, jump to step 4.2.4; see section
    4.3 for more details.
    If you successfully uninstalled hpserver-core, verify if the mmcdev package
    is installed in your system through the command:

	# dpkg -s mmcdev

    If so, remove it by typing the following command:

    **PLEASE**, just do that if you are sure that the
    hpserver-core package was already UNINSTALLED !!!

	# dpkg -P mmcdev

    4.2.4. Uninstall the curl package (see the notes below):
 
        # dpkg -P libcurl
 
    4.2.5. Uninstall the ucd-snmp packages (see the notes below):
 
        # dpkg -P snmpd
        # dpkg -P snmp
        # dpkg -P libsnmp4.2
        # dpkg -P libsnmp-base

Notice that dpkg may display warning messages about directories not empty.
You can safely disregard these messages.
Notice that hpserver-core, libcurl, snmp, snmpd, libsnmp and libsnmp-base
packages may be in use by other products and if so dpkg will tell you and will
not uninstall the package. 
No reboot is necessary.

4.3. Important Notes

The hpserver-core package may be in use by other HP products and if so, an
error message will be displayed when you try to remove the package. The package
will remain installed in the system until all the other HP products, that
require it, be uninstalled.

The uninstall of the Server 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:

     1. The NIC Agent (hpnicagt), responsible for gathering information about
  the network interface cards installed in the system, does not support
  token ring cards 

     2. The software version agent will report updates for the Server Agents 
  when clicking on Update button or when setting Polltime apropriatelly in 
  Reports / Configuration Changes page.

     3. 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.

     4. The agents will stop responding if the disk utilization reach 100%.

     5. If information about ITT isn't shown when trying to run ITT from TTDM, 
  it may be necessary to remove the Server from TTDM database and insert it 
  again.

     6. Uninstall of the Server Agents (agents_lx and hpserver-core) will cause
  Location and Contact data to be lost.
 
     7. The value shown for BIOS version on PCI bus may be wrong. The correct 
  value will be shown after reboot.

     8. Historical data for mounted filesystems is incomplete. It's not shown
  for the last mounted filesystem under Status | System Status | Storage 
  Capacity. 

     9. The NetRAID Service (hpnragent) may stop running.

    10. SNMP Agents for Linux do not support DMI. Information that depends on 
  DMI will not be shown:
     - The serial number will not be shown in the Identity page.
     - The Manage Drivers/Firmware option will not be available.

    11. The HP Environment Service (hpenvsvc) can crash while collecting the
  status from chassis sensors in some HP Servers. If it happens, temperature 
  fan and voltage information will not be available.

    12. Status tab / Physical Storage / Hard Disk Status - when click on status 
  in the table, the current drive letter displayed is "No configuration 
  available".
  
    13. Stressed characters should not be used in the fields of page 
  Configuration / Settings. If so, unexpected words will appear. Also, be 
  carefull about the fact that these fields are interpreted as HTML.


5.2. Issues for SuSE 7.2 only:

     1. When System Event Log is stressed, some links may be not displayed
on pages accessed by Configuration tab and Configuration button. 


5.3. Issues for Turbo Linux 6.5 only:

     1. 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 occurred in 
 a recent date.
 
     2. Hard disk firmware update is not available due to problems related 
     with the threads support.


5.4. Issues for Caldera OpenLinux Server 3.1 only:
     
     1. SNMP Agents will not show any information about PCI devices and slots.
 The Configuration | Configuration | PCI Bus page may not be shown correctly.
 
     2. When the snmp development package is removed after agents_lx
 installation, the link (libsnmp.so) to the snmp library is removed and should   
 be created again:

       1. Discover the snmp library name with the command:

       # libname=$(for f in $(ls -l /usr/lib/libsnmp*so* 2>/dev/null | grep '^-' 
     2>/dev/null | awk '{print $9}' ) ; do  test -f $f && echo $f; done | uniq)

       2. Create the link to the snmp library this way:

       # ln -s $libname /usr/lib/libsnmp.so
       # ldconfig
 
 

5.5. Issues for Debian 2.2 only:

     1. 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.

     2. Sometimes, a wrong BIOS or firmware update is reported on
  Reports page / Configuration Changes / BIOS / Firmware section.

     3. When the snmp development package is removed after agents-lx
 installation, the link (libsnmp.so) to the snmp library is removed and should   
 be created again:

       1. Discover the snmp library name with the command:

       # libname=$(for f in $(ls -l /usr/lib/libsnmp*so* 2>/dev/null | grep '^-' 
     2>/dev/null | awk '{print $9}' ) ; do  test -f $f && echo $f; done | uniq)

       2. Create the link to the snmp library this way:

       # ln -s $libname /usr/lib/libsnmp.so
       # ldconfig

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

     1. 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 Procedure.
  If this open permission is not acceptable, do not execute 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

     2. 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 needed packages are not installed by the rpm utility, the system
  administrator should solve those dependencies so that installation of the
  Server Agents for Linux can proceed.
