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

Versions Supported:

- Red Hat 7.1
- Red Hat 7.0
- Red Hat 6.2
- SuSE 7.2
- SuSE 7.0
- Debian 2.2

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. Instant Toptools Installation
4. Instant Toptools Uninstall
5. Accessing Instant Toptools
6. Browser Settings
7. Resolving IP PORT Conflicts
8. Known Issues


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

New Features

   1. This is the first release of Instant Toptools for Linux.


Issues Fixed

   1. None


Issues Fixed for Other Distributions

   1. None

 
------------
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.  Instant Toptools 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.  Software Requirements

Instant TopTools for Linux supports the following Linux distributions:

Red Hat 6.2:    
                Kernel 2.2.16-3
                Kernel 2.2.16-3smp
                Kernel 2.2.17-14
                Kernel 2.2.17-14smp
                Kernel 2.2.19-6.2.1
                Kernel 2.2.19-6.2.1smp
                Kernel 2.2.19-6.2.7
                Kernel 2.2.19-6.2.7smp

Red Hat 7.0:
                Kernel 2.2.16-22
                Kernel 2.2.16-22smp
                Kernel 2.2.17-14
                Kernel 2.2.17-14smp
                Kernel 2.2.19-7.0.1
                Kernel 2.2.19-7.0.1smp

Red Hat 7.1:
		Kernel 2.4.2-2
		Kernel 2.4.2-2smp

SuSE 7.2:       
		kernel 2.4.4-4GB
		kernel 2.4.4-64GB-SMP
                Kernel 2.2.19
                Kernel 2.2.19-SMP

SuSE 7.0:       
                Kernel 2.2.16
                Kernel 2.2.16-SMP

Debian 2.2:     
                Kernel 2.2.17

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

If you have doubts about how to update kernel versions, please go to the link
below: 

http://www.redhat.com/support/docs/howto/kernel-upgrade/kernel-upgrade.html

		
3.1.2.  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/r, 
    lh 3000/r, lh 6000/r 
    lt 6000r, 
    lp 1000r, lp 2000r


3.1.2.1. Hardware support added on release 5.02.07:

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

    
3.1.3.  Hard Disk Space Requirements

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


3.1.4. Coexistence with other products

This version of ITT cannot be installed in a machine with Red Hat 6.2 and the
"hp_evt_snmp_ext" package installed. If is the case, you must uninstall the 
"hp_evt_snmp_ext" package before install this version of ITT.
 
To know if "hp_evt_snmp_ext" package is installed, type the following command:

	# rpm -q hp_evt_snmp_ext

If there is a version of "hp_evt_snmp_ext" installed you should remove it
before install the ITT, through the command:

	# rpm -e hp_evt_snmp_ext


3.2.  Installation Overview

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 your distribution:

Note: The letters PP in file names specify the patchlevel; letters XXX in
file names specify the Linux distribution and the letters RR specify the
release. For instance, itt-lx-5.02.02-03_debian22.i386.deb refers to Instant
Top Tools version 5.02, patchlevel 02, release 03 for Debian 2.2.


3.2.1 For distributions based on RPM

   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. Copy the zip file containing the Instant TopTools to a temporary
   location on your Linux system (for example /tmp/itt)

   3. Expand the zip file using the following command:
        # unzip <name_of_the_package>

   4. Install the HP NetServer core component (see note below before):
        # rpm -U hpserver-core-5.02.PP-RR_XXX.i386.rpm

   5. Install the ITT package (see note below before):
        # rpm -U itt_lx-5.02.PP-RR_XXX.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. Copy the zip file containing the Instant TopTools to a temporary
   location on your Linux system (for example /tmp/itt)

   3. Expand the zip file using the following command:
        # unzip <name_of_the_package>

   for example,
        # unzip customer.zip

   4. Install the HP NetServer core component (see note below before):
        # dpkg -i -G hpserver-core-5.02.PP-RR_XXX.i386.deb

   5. Install the ITT package (see note below before):
        # dpkg -i -G itt-lx-5.02.PP-RR_XXX.i386.deb

   6. No system reboot is necessary.


		
3.3.  Installation Details

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.


3.4.  How to verify that ITT is Running

To make sure ITT is running on the NetServer machine two services must be
running: hpipmsvc and webs.

The command to verify the status of Toptools services is:


3.4.1 On RedHat or SuSE 7.0

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

    E.g.,:

    # /etc/rc.d/init.d/webs status
    OK


After this test, type the command:

    # lsmod

ITT is running OK if is displayed an output like this:

Module                  Size  Used by
mmcdev                  6876   0
 .
 .

Notice that values for Size and Used by may differ from values above
mentioned.

3.4.2 On SuSE 7.2

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

    E.g.,:

    # /etc/init.d/webs status
    Checking for process webs:                            running


After this test, type the command:

    # lsmod

ITT is running OK if is displayed an output like this:

Module                  Size  Used by
mmcdev                  6876   0
 .
 .

Notice that values for Size and Used by may differ from values above
mentioned.

3.4.3 On Debian

    # ps axo command | grep <service_name>

    E.g.,:

    # ps axo command | grep webs

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

After this test, type the command:

    # lsmod

ITT is running OK if is displayed an output like this:

Module                  Size  Used by
mmcdev                  6876   0
 .
 .
	
Notices:

Values for Size and Used by may differ from values above mentioned.
The mmcdev module will not be installed on NetServers from E series (e.g., 
e 60, etc.).


------------------------------
4.  Instant Toptools Uninstall
------------------------------

If you wish to remove ITT from your hard disk, execute the following steps, 
logged on as root:


4.1 For distributions based on RPM

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

Notice that hpserver-core package may be in use by another 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 warning messages about directories not empty. You can
safely disregard these messages.


4.2 For Debian

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

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


------------------------------
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 Instant Toptools services:

   On RedHat or SuSE 7.0:

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

   On SuSE 7.2:

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

   On Debian:
        
    # /etc/init.d/hpipmsvc stop
    # /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 Toptools services:

   On RedHat or SuSE 7.0:

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

   On SuSE 7.2:

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

   On Debian:

    # /etc/init.d/hpipmsvc start
    # /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 Fibre 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. This version of ITT does not support RAID configurations, so
information about these devices will not be reported by ITT.

   7. The link http://www.netserver.hp.com/netserver/support/default.asp
present on support page does not work. It must be changed to the following
link: http://netserver.hp.com/netserver/support/default.asp

   8. When uninstalling ITT (itt-lx and/or hpserver-core), rpm displays 
warning messages about directories not empty. You can safely disregard those
messages.

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

   10. The follow messages are displayed when 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.
   The workaround is stop and start hpipmsvc service.

   11. When stressing event generation and trying to access Configuration |
Version Information | Firmware and Report | Version Information | Firmware page,
no information is available for this page. The workaround is stop and start
hpipmsvc service.

   12. 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.
  
   13. When the system is under a very high load, some information may not 
be correctly shown due to timeouts.

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.
  
 
8.3. Known Issues for Debian 2.2 user's only:

   1. Not all drivers displayed on Drivers page may be correct.

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

   3. When uninstalling itt-lx, messages are displayed about directories not
empty trying to be removed by the uninstall process.

   4. When uninstalling hpserver-core, messages are displayed about directories
not empty trying to be removed by the uninstall process.

   5. The drivers displayed on Configuration page, when clicking on
Configuration button, may not be completely right.


8.4. Known Issues for SuSE 7.0 user's only:

   1. Configuration page, Storage Information link. Controllers item shows 
type columns as "Unknown type". This value is wrong.

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

   1. Sometimes no information is displayed for Physical Devices on lpr.
