----------------------------
Instant Toptools 5.02 readme
----------------------------

This readme contains an overview and known issues for Instant Toptools for
Linux.

Versions Supported:

- Red Hat 7.2
- 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
- Caldera OpenLinux Server 3.1

Manageability Technical Information is available on the web at:

http://netserver.hp.com/netserver/support/manaq_technical_info.asp


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

1. Release Notes
2. Overview
3. Installation
4. Uninstall
5. Accessing Instant Toptools
6. Browser Settings
7. Resolving IP PORT Conflicts
8. Known Issues


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

New Features:

        1. Linux distributions added:
           - Red Hat 7.2

        2. Bugs Fixed:
           - No warning message is showed when the hpserver-core package is
           being uninstalled on RPM based distributions;
           - No warning message is showed when the itt_lx package is being
           uninstalled.


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

HP Instant Toptools is a standalone browser-based tool for monitoring your HP
Netserver. HP Instant Toptools provides web pages that include information
about the current state of an HP Netserver to assist in troubleshooting.

All events (changes in the status of your server) are stored in your HP
Netserver's System Event Log. These events may be viewed while the server is up
and running by viewing the Event Log under the Status tab in HP Instant
Toptools.

NOTE:  Netserver Agents software shipped with your HP Netserver are required
for HP Toptools Device Manager. Netserver Agents are not required for Instant
Toptools. However, with the Netserver Agents software installed you will
additionally be able to receive predictive events, on all HP mass storage
events otherwise only obtainable through HP Toptools Device Manager.


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

3.1.  Before You Begin

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


3.1.1.  Hardware Requirements

This version of the Instant Toptools 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,
lh 3000, lh 6000,
lt 6000r,
lp 1000r, lp 2000r

3.1.1.1. Hardware support added on release 5.02.07:

lc II,
lh 3, lh 3r,
lc 3,
lh 4, lh 4r,
lxr 8000

3.1.1.2. Hardware support added on release 5.02.09:

tc 6100,
lh 6000 U3,
lc 2000 U3,
lh 3000 U3,
lt 6000r U3,
tc 7100,
rc 7100,
lp 1000r (1.13 and 1.26 GHz),
lp 2000r (1.13 and 1.26 GHz)

3.1.2.  Hard Disk Space Requirements

The minimum amount of hard disk space needed for this installation is 8 MB.


3.1.3.  Software Requirements

In order to get information provided by the Motherboard Management Card (MMC)
ITT needs 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 with Instant Toptools.
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 also available in the distribution CD.

The original kernel version 2.2.14 shipped with Red Hat 6.2 must be upgraded
to any one of the kernels mentioned below.

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 6.2:

- Kernel (one of the following):
     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
- RPM 4.0.2


For Red Hat 7.0:

- Kernel (one of the following):
     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
     2.2.19-7.0.8
     2.2.19-7.0.8smp
- RPM 4.0.2


For Red Hat 7.1:

- Kernel (one of the following):
     2.4.2-2
     2.4.2-2smp
     2.4.3-12
     2.4.3-12smp
- RPM 4.0.2


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
- RPM 4.0.3


For SuSE 7.0:

- Kernel (one of the following):
     2.2.16
     2.2.16-SMP
     2.2.18
     2.2.18-SMP
     2.2.19
     2.2.19-SMP


For SuSE 7.2:

- Kernel (one of the following):
     2.2.19
     2.2.19-SMP
     2.4.4-4GB
     2.4.4-64GB-SMP
     2.4.7-4GB
     2.4.7-4GB-SMP
     2.4.7-64GB-SMP


For Debian 2.2:

- Kernel (one of the following):
     2.2.17
     2.2.19


For TurboLinux Server 6.5:

- Kernel (one of the following):
     2.2.18-2
     2.2.18-2smp
     2.2.18-10.3
     2.2.18-10.3smp
     2.2.18-11
     2.2.18-11smp


For Caldera OpenLinux Server 3.1:

- Kernel:
     2.4.2


3.1.3.2 Linux distributions that support MMC as a kernel patch

Red Hat 6.2:
  - Kernel stock 2.4.5
  - RPM 4.0.2


3.1.4. Coexistence with other products

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


3.2.  Installation Procedure

Before installing Instant Toptools on a HP Netserver running Linux, verify if
your platform satisfies the hardware and software requirements as listed above
in section 3.1. If all requirements are satisfied, just follow procedure
listed below for each supported distribution.

Note that package file names have the following format:

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

As an example, itt-lx-5.02.02-03_debian22.i386.deb refers to the version 5.02,
patchlevel 02 and release 03 for Debian 2.2 of a package named itt-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 Instant Toptools installation process will install all necessary files
and start services, which are registered for the automatic execution on the
next computer's initialization. No reboot is necessary after installation
process.

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


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

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

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

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

    2. When updating the mmcdev package from a version older than 5.02.02,
       first remove this package before proceeding with the installation:

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

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

3.2.1 For distributions based on RPM (e.g. Red Hat, SuSE, TurboLinux and
      Caldera)

   1. Download the zip file containing the appropriate Instant Toptools
   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 Instant Toptools 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 MMC device driver:
        # rpm -U /tmp/mmcdev-5.02.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.

   4. Install the HP Netserver core component:
        # rpm -U /tmp/hpserver-core-5.02.xx-yy_zzz.i386.rpm

   5. Install the ITT package:
        # rpm -U /tmp/itt_lx-5.02.xx-yy_zzz.i386.rpm

   6. No system reboot is necessary.


3.2.2 For Debian

   1. Download the zip file containing the appropriate Instant Toptools
   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 Instant Toptools 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 MMC device driver:
        # dpkg -i -G -E /tmp/mmcdev-5.02.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.

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

   5. Install the ITT package:
        # dpkg -i -G -E /tmp/itt-lx-5.02.xx-yy_zzz.i386.deb

   6. No system reboot is necessary.



3.3.  How to verify that ITT is Running

To make sure ITT is running, check the MMC device driver and ITT 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.

Notices:
    - <nnn> is a dynamic value assigned by the operating system.
    - the MMC device driver will not be installed on Netservers from
    E series (e.g., e 60, etc.).


3.3.2. Checking ITT services

The following services must be running: hpipmsvc and webs.

Notice that in order to the GoAhead web server (webs service) run properly,
the user must configure the networking correctly. For further information
about configuring the network parameters, please refer to the OS vendor
documentation.

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.0:

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

    The output will be:
    - OK, if the service is running;
    - No process, otherwise.


For SuSE 7.2:

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

    The output will be:
    - Running, if the service is running;
    - Unused, 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.


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.


For Caldera OpenLinux Server:

    # /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.


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

4.1 For distributions based on RPM (e.g. Red Hat, SuSE, TurboLinux and Caldera)

If you wish to uninstall ITT, remove the itt_lx and hpserver-core
packages by executing the following commands (you must be root):

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

If you could NOT uninstall hpserver-core, do not proceed with the uninstall
process; 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:

    # 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

Notice that rpm may display warning messages about directories not empty. You
can safely disregard these messages.


4.2 For Debian

If you wish to uninstall ITT, remove the itt_lx and hpserver-core
packages by executing the following commands (you must be root):

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

If you could NOT uninstall hpserver-core, do not proceed with the uninstall
process; 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

Notice that dpkg may display warning messages about directories not empty. You
can safely disregard these messages.

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 Instant Toptools does not remove the history data
files from your computer, enabling ITT to keep historic information
after a package upgrade.


------------------------------
5.  Accessing Instant Toptools
------------------------------

An administrator can view information about an HP Netserver by pointing a
browser to the server using the syntax:

http://servername:280

where servername represents the host name, NetBIOS name, or IP address of the
server.


--------------------
6.  Browser Settings
--------------------

Browser settings are extremely important.

   1.  Be sure to set your browser to exclude using a proxy for your
   domain/local LAN:

   On IE, be sure to check "Bypass proxy server for local addresses":
   On IE4.01 SP2: Internet Options | Connections | Advanced | Exceptions.
   On IE 5.x: Tools | Internet Options | Connections | LAN Settings | Advanced.

   On Netscape, be sure to enter localhost in the domains exceptions list on
   the Advanced page.
   On Netscape: Edit | Preferences | Advanced | Proxies | select Manual then
   View.

   2. It is also helpful to set your browser to check for newer versions of
   stored pages on every visit to the page.

   3. It is recommended that Java is enabled on your browser:
   On IE: Tools | Internet Options | Security Tab | Select Local Intranet |
   Set the "Java Permissions" status to enable On Netscape: Edit | Preferences
   | Advanced | Verify the "Enabled Java" box is checked


-------------------------------
7.  Resolving IP Port Conflicts
-------------------------------

Instant Toptools makes use of networking port number 280 for delivery of its
management content. It is possible that another software package may already be
configured to use port 280. If that package cannot be reconfigured to use a
different port number, then the Instant Toptools web server can be reconfigured
to use a different port number. Note that in so doing Toptools Device Manager
will no longer be able to detect and integrate Instant Toptools and its
information.

To resolve the port conflict, you will need to configure a new port number for
the Instant Toptools web server. Note that changing the value of other registry
entries not associated with Instant Toptools can have severe consequences, so
care should be exercised when making these modifications.

To change the port number, start the Registry Editor as follows:

   1. Stop the webs service:

   On Red Hat, Turbo Linux or Caldera:

    # /etc/rc.d/init.d/webs stop

   On SuSE 7.0:

    # /sbin/init.d/webs stop

   On SuSE 7.2:

    # /etc/init.d/webs stop

   On Debian:

    # /etc/init.d/webs stop


   2. Using your preferred text editor, load the file '/var/hpserver/
   registry.ini'. Locate the registry key 'SOFTWARE\Hewlett-Packard\
   InstantToptools'. Under this key should exist a subkey named 'portnum'.
   Change its value to a port that does not conflict with other network
   resources (pick a value that does not causes conflict - 2345). The portnum
   string has the following format:

    portnum=c(W)PPP,

   where PPP means the port number in decimal and W the number of characters
   of PPP. For the suggested port number, the string must be:

    portnum=c(4)2345

   3. Save the modified file.

   4. Restart the webs service:

   On Red Hat, Turbo Linux or Caldera:

    # /etc/rc.d/init.d/webs start

   On SuSE 7.0:

    # /sbin/init.d/webs start

   On SuSE 7.2:

    # /etc/init.d/webs start

   On Debian:

    # /etc/init.d/webs start


The URL used to start Instant Toptools remotely must also specify the new port
number:

e.g.: http://servername:2345


---------------
8. Known Issues
---------------

8.1. General Issues:


   1. Instant Toptools has minimal support for NetRaid-4M. Instant Toptools
just acknowledge the presence of the controller but does not show further
information like physical devices attached to it and its firmware version.

   2. The Linux kernel does not support Fiber Channel. Instant Toptools does
not show any information at all about this controller and its attached devices.

   3. The information gathered through IPMI (versions 0.9 and 1.0) -
temperature, voltage and fan sensors - is only available for Netservers that
have installed an ISA or PCI SMIC (MMC).

   4. An erratic behavior may happen for Netservers with dual-boot (Windows
and Linux) and Instant Toptools installed on both platforms, mostly broken
links and blank pages show on the browser. This behavior is caused by the
browser trying to use a cached page from the different platform. Two settings
may contribute to this problem: the browser's local cache and a proxy server.

To correct this behavior you must clean the cache and disable the proxy server
if you have used the browser to access Instant Toptools in a platform and
intend to use the same browser to access the Instant Toptools in the other one
platform.

To clean the local cache in Internet Explorer browser:
      1. Select the Tools|Internet Options... menu item;
      2. Click the Delete Files... button;
      3. Check the Delete all offline content option;
      4. Click the OK button twice.

To disable the proxy server in Internet Explorer browser:
      1. Select the Tools|Internet Options... menu item;
      2. Select the Connections tab;
      3. Click the LAN Settings button;
      4. Uncheck the Use a proxy server option;
      5. Click the OK button twice.

   5. An erratic behavior could eventually occur for Contact and Location
values on the Identity Page. To correct this behavior proceed as described
above for dual boot machines.

   6. The help file made an NT reference... "Start ITT by clicking on
Start|Programs|HP Instant Toptools". Please, disregard this information.

   7. The follow messages are displayed while stressing event generation:
   No manageable temperature sensors are installed on this system;
   No manageable voltage sensors are installed on this system;
   No manageable fan sensors are installed on this system.

   8. The status severity of the CPU fan sensor may differ from the status
severity of the event generated for this same CPU fun. When the first one has
status signed as warning, the status for its event is equal to critical.

   9. When the system is under a very high load, some information may not
be correctly shown due to timeouts.

   10. For kernel 2.4 (all Linux distributions): Instant Top Tools does not
show any information about HP NetRAID adapters and devices connected to it.

   11. If ide-scsi emulation is enabled on the Linux Kernel, Configuration
page, Storage Information link will show it as a scsi controller. The type
column will be filled as "Unknown type".

   12. In Configuration Tab / Version Information, the Netserver image will
not be available for some recently supported Netservers, e.g. LT 6000r U3.


8.2. Known Issues for Red Hat 6.2 / 7.0 user's only:

   1. Sometimes, when CPU fan stops, no event is generated.

   2. The Status Page|Mass Storage link may time out (failed to load) perhaps
due to having a large number of events in the event log. After clearing event
log, the page loaded fine.

   3. (Found on an old release of ITT) After installing and navigating through
its pages using a remote machine with a browser, some messages appeared on the
Linux machine console referent to Data Overrun on the SCSI peripheral.

   4. Sometimes device drivers are displayed with the wrong date.

8.2.1 Known Issues for Red Hat 6.2 with kernel patch only:

   1. When running on Lp 1000r, the Status Page | Mass Storage link contains
no information for Physical Devices.

8.3. Known Issues for Red Hat 7.1 user's only:

   1. Sometimes device drivers are displayed with the wrong date.

8.4. Known Issues for Debian 2.2 user's only:

   1. Not all drivers displayed on Drivers page are correct and drivers
displayed on Configuration page, when clicking on Configuration button,
may not be completely right.

   2. Sometimes no information is displayed for Physical Devices on lp 2000r
and sometimes only after a reboot this information is provided.

8.5. Known Issues for Turbo Linux 6.5 user's only:

   1. The Instant Toptools does 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.

8.6. Known Issues for SuSE 7.2 user's only:

   1. Sometimes device drivers are displayed with the wrong date.
