
DESCRIPTION OF FEATURES SUPPORTED BY THE COMPAQ INTERCONNECT
SWITCH MANAGEMENT AND DOCUMENTATION INSTALLATION ON LINUX
-------------------------------------------------------------

The following features are supported by the Compaq Interconnect
Switch Management Utilities and Documentation installation.

1. Documentation
2. Help
3. Tools
4. SNMP Mibs
5. Configuration Templates

Each of these features can be selectively installed or
uninstalled as desired.

The default installation directory for each feature is
/usr/local/Compaq/Interconnect_Switch/

During a fresh install of this package, the user has a choice
of selecting a different installation directory in the
Destination Path select screen.

We will refer to this base directory as INSTALLDIR throughout this
Readme.

Also, the terms "Target Machine" and "Deployment machine" will
be used inter-changeably throughout this Readme.

DOCUMENTATION
-------------

The Documentation feature installs the user guides for all the supported
switches. Currently, the user guide for the E-Class C-GbE switch will be
installed as a part of this feature.

	Target Path: INSTALLDIR/eCGbE/Docs

	
HELP
----

The help feature installs this Readme file. The user should select the
Help Package during installation to be able to install this Readme file.

	Target Path: INSTALLDIR/eCGbE/Help


TOOLS
-----

The Tools feature consists of utilities through which the
user could communicate and configure the switch using SNMP.

The Tools feature installs the following files under
INSTALLDIR/bin

cpqswcfg
cpqpgbe

and the following file under INSTALLDIR/Help

cpqswcfg.txt

cpqswcfg.txt is the File which explains the usage and other
information on how to run the cpqswcfg tool.

cpqswcfg is the Linux executable which provides a
front-end menu interface to the user, gets appropriate
configuration choices from the user and calls the
second-level script.

cpqpgbe is the second-level script which parses
the options passed to it, validates the commands accordingly
and then calls the next level utility to talk to the
switch using SNMP.

In the case of Linux, the set of utilities that
actually talk to the switch using SNMP are provided
by the Standard Linux installation CD. The names of
the packages are as follows.

For Redhat Linux installations, the dependencies are
on the following packages

ucd-snmp-utils
ucd-snmp

For SuSE Linux installations, the dependencies are
on the following packages

ucdsnmp

The Readme provided with the installation package
describes in more detail on the dependencies in the
section on Package dependencies.

cpqswcfg.txt explains in detail about the usage of
cpqswcfg utility


SNMP MIBS
---------

The SNMP Mibs Package installs the following SNMP Mibs

cimtraps.mib
cpqidrec.mib
cpqagent.mib
cpql2mgt.mib  ( Compaq Level 2 Switch Management Mib )
vesubio.mib
rfc1215.mib
rfc1907.mib
rfc2674.mib
rfc1493.mib
rfc2233.mib
rfc2737.mib
rfc1213.mib
rfc1757.mib
rfc2358.mib
rfc1155.smi

	Target Path: INSTALLDIR/Mibs


For more information on what each of these MIB's mean and a description,
please refer to Appendix E of the E-Class C-GbE User Guide. This user
guide will be installed on selection of the Documentation Feature.

Please note that the Appendix E of the E-Class C-GbE User Guide refers
to the file cpqSTrap.mib under Enterprise-Specific MIBs. This is a known error
in the user guide. cpqSTrap.mib is not provided as a part of this 
installation.  Also, reference to the file CIMTrap.mib in the same
section should actually be read as CIMTraps.mib

CONFIGURATION TEMPLATES
-----------------------

The Switch Configuration Template feature provides the user with a
set of scripts which can be run with the switch I.P Address as an argument,
talk to the switch and automatically configure the switch as per
a pre-defined environment.

The following scripts are installed as a part of this feature. Each of 
the scripts configures the switch to a pre-determined environment.

cpqebcfr.sh
cpqebcfr1.sh
CfgTmpEC.pdf

	Target Path: INSTALLDIR/eCGbE/config template scripts

The usage of these scripts is as follows

cpqebcfr.sh -i <Switch I.P Address> -c <SNMP Community String>
cpqebcfr1.sh -i <Switch I.P Address> -c <SNMP Community String>

The switch configuration that is generated after these scripts are
run can be compared with the tables provided in CfgTmpEC.pdf document
for verification purposes. 

The Configuration generated by running cpqebcfr.sh corresponds to 
Switch A and the Configuration generated by running cpqebcfr1.sh
corresponds to Switch B in the document.


--------------------------------------------------------------------
     KNOWN PROBLEMS WITH E-Class C-GbE SWITCH FIRMWARE VERSION 1.02
--------------------------------------------------------------------

1. Resetting to factory defaults and saving IP settings option will change
	 the switch set up from DHCP to manual IP setting. If you are using
	 DHCP to establish your IP address, use the "Reboot & Load Factory
	 Default Configuration" option instead of "Reboot & Load Factory
	 Default Configuration Except IP Address."


2. The Connection Timeout parameter in the Maintenance menu has a value
	 in minutes. The online help pages mistakenly says it is in seconds.

3. In the web based interface, under Advanced settings, attempting to set
	 the "AutoLogout" value pops up "Runtime Error" windows. However
	 the functionality is not affected.

4. Only "Permanent" unicast address filters can be created through the SNMP
	 interface.  Creating a "Delete on Reset" or "Delete on Timeout" 
	 filter is not supported via SNMP in the current release, although 
	 they can be created via the web and console interfaces. However, 
	 Deletion of any filter type can be done via SNMP.


5. There are no SNMP equivalents for items listed below.

	Trunk utilization
	From "Port Error Packets" (HTTP)
		ExDefer
		Late Coll
		Ex. Coll
		Single Coll
		Unicast Rx
		TX bytes
	Browse MAC address
	Switch history
	Dynamic group registration table

	port "type" and "VLAN name" in port configuration page.

	"Manufacturing date" 

	"backpressure"

	"Trunk load sharing algorithm"

	"telnet status" and "web status" (logins allowed)

	These can be set via the web or console interfaces if needed.


6. SNMP tables swL2IngrPortBwCtrlRefreshTable and Egress equivalent table
	 do not allow "read-create" and	hence no entries may be created


7. TFTP services do not work on the Web interface using Netscape 6.1.
       Java script messages are displayed and no file transfer occurs. Other browsers,
	such as Internet Explorer 5.5, work properly.


8. If you enter a list of Security IP addresses, web connections only work for the
	first 3 entries. Telnet connections work properly for all entries.


9. The default SNMP rwcommunity string is "private." Please change this on initial
	configuration of the switch if it does not meet your security needs. See the
	configuration chapters of the user guide for more information.

10.The following sections of the online help files incorrectly reference IP address
	instead of MAC address:  

	Configuring Advanced Settings
	Configuring Port Settings
	Configuring Unicast Settings
	Configuring Multicast Filtering
	Configuring Priority MAC Addresses
	Monitoring MAC Address Table
	Monitoring IGMP Snooping Table

        Please refer to Chapter 4 of the User Guide for more current information.

-----------------------------------------------------------------------------
Copyright 2002 Compaq Information Technologies Group, L.P. 
