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

Versions Supported:

- Red Hat 7.0
- Red Hat 6.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 for Red Hat 6.2, Red Hat 7.0, Debian 2.2 and SuSE 7.0 distributions

1. lp 2000r picture displayed on identity page.

2. Instant Toptools can be launched when clicking on Management Home Page option of Toptools Device Manager.


Issues Fixed for Other Distributions

   1. None

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

HP Instant Toptools (ITT) 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

SuSE 7.0:       
                Kernel 2.2.16
                Kernel 2.2.16SMP

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

   E.g.,
        # 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 Red Hat or SuSE

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

for example:

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

After this test, type the command:

    # lsmod

ITT is running OK if it displays 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 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 Red Hat or SuSE:

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

   On Red Hat or SuSE:

    # /etc/rc.d/init.d/hpipmsvc start
    # /etc/rc.d/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 configurations, 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 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 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 only:

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

