ProLiant BL SWITCH-Class GbE Interconnect Switch Utilities
==============================================================================
Overview
--------

The Interconnect Switch Utilities package is comprised of the following items:

	Switch configuration tool, "cpqswcfg".

	Integration for the ProLiant Essentials Rapid Deployment Pack (RDP),
	which integrates the configuration tool, cpqswcfg, into RDP.
	(Win32 only)

	Example switch configuration scripts, which demonstrate cpqswcfg 
	scripting.

	Switch SNMP MIBs.

	Switch firmware information tool, "swfwinfo".

	Safe XML configuration example template for switch spares.

	Integration of the switch into the HP management suite,
	"Insight Manager 7" (IM7).  To enable IM7 to discover and manage the
	switch, run this command on the IM7 server after the Utilities are 
	installed on it:

		C:\Program Files\ProLiant\Interconnect Switch\tools\
			SWITCH-GbE Utilities\Version VERSTRING\GbE_to_IM7.bat

	TFTP server (Win32).  See the TFTP discussion below if you use the 
	RDP PXE TFTP server.


Supported OS List
-----------------

	Microsoft(R) Windows(R):
		Windows 2000
		Windows Server (TM) 2003
		Windows XP

	Linux:
		Red Hat 7.x, 8.x
		Red Hat Enterprise Linux AS 2.x
		Red Hat Advanced Server 2.x
		SuSE Linux Enterprise Server 7.x, 8.x
		UnitedLinux 1.x


Notes:
	The preferred scripting interface is now the switch's CLI (command 
	line interface).  Since the switch configuration tool, cpqswcfg, is 
	deprecated, no new features have been added in this release.  New 
	scripts should be written to use the CLI.  See the switch User Guide 
	at www.compaq.com/support for more information.

	The installation folder is:
		Win32:
			C:\Program Files\ProLiant\Interconnect Switch\tools\
				SWITCH-GbE Utilities\Version VERSTRING
		Linux:
			/usr/local/ProLiant/Interconnect_Switch/Utilities/
				SWITCH-GbE/versionVERSTRING


Support Web page
----------------

	The switch may be kept up-to-date with the latest firmware package
	which also contains the latest Release Notes.  It is available at
	www.compaq.com/support 


See the discussion below for more information on these features.


==============================================================================
Switch configuration tool, "cpqswcfg"
-------------------------------------

NOTE: 	This tool is deprecated.  The preferred scripting interface is now the 
	switch's CLI.

cpqswcfg provides a simple means to configure and manage the switch via the 
SNMP interface.  The switch configuration tool may be invoked several ways: 

	(1) Start Menu 
		(Win32 only)
		
		Start->Programs->ProLiant Interconnect Switch->Tools->
			SWITCH-GbE Utilities->Version VERSTRING->Configuration Tool

		This will invoke the tool in the interactive menu mode in 
		which you are queried for operations to perform and their
		associated parameters.  

	(2) ProLiant Essentials Rapid Deployment Pack (RDP) "Tools" menu
		(Win32 only)

		A "Proliant Interconnect Switch Tools" item is placed in the 
		RDP "Tools" menu.

		Choose "Interconnect Switch Configuration" to run the tool.
  
		Choose "Remove Configuration Tool Defaults" to remove its 
		defaults.

		NOTE: RDP must be (re)started after the switch utilities 
		are installed in order for RDP to display the new Tools menu 
		items.  The RDP Tools menu integration survives uninstallation
		and/or reinstallation of RDP, but does not survive 
		uninstallation of the Interconnect Switch Utilities.  If you 
		have both the	e-class and p-class Utilities installed, 
		uninstallation of either one will remove the registry entry 
		which provides the integration.  Reinstall the desired
		version of the Utilities to restore the integration.

	(3) Command line 

		Win32:
			cd C:\Program Files\ProLiant\Interconnect Switch\
				tools\SWITCH-GbE Utilities\Version VERSTRING
		Linux:
			cd /usr/local/ProLiant/Interconnect_Switch/Utilities/
				SWITCH-GbE/versionVERSTRING

		cpqswcfg -q -y

		This is functionally equivalent to (1).

	(4) Scripting interface
		Within your script or executable:

		Win32:
			cd C:\Program Files\ProLiant\Interconnect Switch\
				tools\SWITCH-GbE Utilities\Version VERSTRING
		Linux:
			cd /usr/local/ProLiant/Interconnect_Switch/Utilities/
				SWITCH-GbE/versionVERSTRING

		cpqswcfg [options]

		The tool will perform the specified operation and report 
		results via %ERRORLEVEL% and output.


Note:	If you are running the RDP PXE TFTP server (Win32 only), it must be 
	stopped and a general purpose TFTP server (such as the one included)
	should be started for TFTP operations to the switch to perform 
	properly, since the RDP PXE TFTP server is unidirectional (to switch)
	only.


Detailed usage information:

INTRODUCTION:

cpqswcfg is a utility for managing ProLiant Interconnect switches.  
While this release manages switches via the SNMP interface, cpqswcfg may be 
used to manage a switch via any available interface by using its extensible 
device handler feature.  cpqswcfg may be invoked in either an interactive or 
command line (scriptable) mode.  cpqswcfg may be invoked on the command line, 
via a script (e.g. .bat file), from an executable (.exe), or any other way that 
doesn't interfere with text-based user input.  The discussion below describes 
SNMP operations, but other interfaces may be used by future device handlers in 
a similar fashion.

Versions of cpqswcfg are available for both Win32 and Linux.

cpqswcfg will process options and arguments and, if in interactive mode, 
solicit user input for any unspecified but required data.  cpqswcfg will 
process the options and save the defaults in an initialization file, 
cpqswcfg.ini. Future invocations will load the defaults.  Errors result in an 
exit(1) and an error or usage message.

Once the required data is available, cpqswcfg will invoke (via exec()) a 
device-specific handler to perform the selected function on the device.  The 
device-specific handler's only input will be via command line options (i.e. no 
user input).  For this release, a device-specific handler for the p-Class GbE 
and e-Class C-GbE Interconnect Switches is supplied.  The handler is named 
"cpqpgbe.bat" for Win32 and "cpqpgbe" for Linux.

The handler will typically perform several SNMP operations to complete a given 
function.  The Win32 version will invoke "cpqsnmp" to perform the actual SNMP 
calls to the switch.  cpqsnmp makes calls into the standard Win32 SNMP 
libraries.  The Linux version uses the snmpset, snmpget, and snmpwalk commands
installed via the Linux ucd-snmp package.  Version ucd-snmp-4.2.3 is 
supported, although any more recent version will also likely work.

Note that some functions cause the switch to reboot (e.g. "firmware", "reset").
While the switch is rebooting, new functions issued to the switch will timeout 
and the displayed function results may be inaccurate.  Wait for the switch to 
finish rebooting before issuing new functions.  

Note that some functions tell the switch merely to begin performing a function
and the displayed results refer to whether the switch accepted the command, not
that the command completed successfully.  The TFTP functions are an example of
this.  cpqswcfg requests that the switch begin the TFTP transfer and reports 
the success of issuing the command, not the success of the transfer itself.  
This is due to the fact that cpqswcfg has no knowledge of what TFTP server is 
being used and cannot query for success of the transfer.


SYNTAX:

cpqswcfg [options] [function]

These two options are special in that they will be saved (in cpqswcfg.ini) as 
defaults when specified.  The defaults persist until removed via the -z option.

	-i IPaddr		IPaddr specifies the IP address of the 
				target device.

	-d deviceType		deviceType specifies the type of device.  
				Default is "cpqpgbe".

	
These options will not be saved as defaults:

	-c community		community specifies the SNMP community string 
				of the target device.  The community string is 
				the SNMP version of a password and is required 
				for functions which communicate with the 
				switch.

	-h function|all		List the function(s) with a description, where 
				"function" is a valid function keyword or "all".

	-o "other args"		The "other args" are passed to the device-
				specific handler at the end of the command 
				line.  They must be enclosed in quotes.  
				Either a function or -o may be specified, not 
				both.  This option allows extensiblility to 
				future switch device handlers with arbitrary 
				functions and syntax.  Therfore, the syntax 
				and semantics of "other args" are undefined.

	-q			Query for function to perform.  Any command 
				line arguments are ignored.

	-x args			Invoke the cpqsnmp tool with "args".  All 
				remaining items on the command line will be 
				sent to cpqsnmp.  This option succeeds only in
				Win32 environments since no cpqsnmp is shipped
				with the Linux version, although one could be
				written to invoke snmpget, snmpset, etc., for
				equivalent function.

	-y			Invoke the device-specific processor with the 
				"-y" option so it will pause for user input 
				before exit, to allow the user to view results 
				before the "DOS box" disappears.
	
	-z			Reset (remove) defaults.  This will have the 
				effect of forcing a query for the defaultable 
				option values on the next invocation.  The 
				implementation is to delete cpqswcfg.ini.


The functions below specify the actual operations to be performed.  Specifying 
more than one at a time is an error.  Several functions below use a port mask.
The masks are specified in byte-wise hexadecimal format with the low numbered 
ports on the right.  Ports use a 1-based numbering scheme (there is no port 0).
For example, a mask specifying ports 1-4 would be 0xF0, ports 5-8 would be 
specified as 0xF, and ports 9-12 as 0xF000.
 
The p-Class GbE and e-Class C-GbE Interconnect Switch SNMP variable name is 
included in the relevant descriptions below.  More detail may be found by 
reading the SNMP MIB description of the variable.  Other switches may use other
means.

The first word in the descriptions below is the function keyword.

		
autologout web|console minutes	
				Sets the autologout timeout for the "web" or 
				"console" interface to the specified number of 
				minutes.  Note that accepted values may vary by 
				device and interface.  For example, the 
				"cpqpgbe" device accepts values of 0 (never), 
				2, 5, 10, and 15 minutes for the console, and 
				between 5 and 20 minutes for the web interface.
				"web" and "console" are keywords.

cos strict|round
cosQueue qnum packets latency	
				Configure Cost of Service.
			
	strict|round (keyword)	
				Indicates the scheduling mechanism for CoS 
				queues.  In strict mode - packet process will 
				start from highest CoS queue for a given port, 
				then moves on to the next lower CoS queue while 
				the higher CoS queue is empty packet.  In 
				roundRobin mode - packet process will start 
				from highest CoS queue for a given port, then 
				moves on to the next lower CoS queue after 
				sending swL2CosMaxPackets or when the higher 
				CoS queue is empty packet. 
				(swL2CosScheduleMethod)

	qnum (integer)		
				Specify the queue number to modify.

	packets (integer)	
				Indicates maximum packet count for a CoS Queue.
				This object only takes effect at roundRobin 
				mode of swL2CosScheduleMethod. 
				(swL2CosMaxPackets)
			
	latency (integer)	
				Indicates maximum allowable latency for packet 
				transmission on a CoS Queue such that the 
				packets on this queue are not delayed more than 
				the maximum allowable latency time. The 
				granularity of this timer is 16 microsecond. A 
				value of 0x00 disables this timer.  
				(swL2CosMaxLatency)


firmware TFTPaddr filename	
				Upgrade firmware (download from TFTP server).

get_cfgfile TFTPaddr filename
				Get configuration file (upload to TFTP server).

get_logfile TFTPaddr filename
				Get log file (upload to TFTP server).
				
gvrp enable|disable
	enable|disable (keyword)
				Enable or disable switch GVRP status.
				(dot1qGvrpStatus)
gvrpPort port# enable|disable
				Enable or disable port GVRP status. 
				(dot1qPortGvrpStatus)
	port# (integer)
				Specify port number.
	enable|disable (keyword)
				Enable or disable GVRP on the port.

igmpCreate VLANid interval maxTime robust v0Querier|v1Querier|v2Querier|other
igmpDelete VLANid
				This function configures IGMP behavior.

	VLANid (integer)  
				This object indicates the IGMP control entry's 
				VLAN id. If VLAN is disabled or in Mac-Base 
				mode, the Vid is always 0 and cannot be changed 
				by management users. If VLAN is in Port-Base 
				mode, the Vid is arranged from 1 to 12 , fixed 
				form. If VLAN is in 802.1q mode, the Vid 
				setting can vary from 1 to 4094 by management 
				user, and the Vid in each entry must be unique 
				in the IGMP Control Table. (swIGMPCtrlVid)
	interval  (integer) 
				The frequency at which IGMP Host-Query packets 
				are transmitted on this interface. 
				(swIGMPQueryInterval)
	maxTime(integer)
				The maximum query response time advertised in 
				IGMPv2 queries on this interface. 
				(swIGMPQueryMaxResponseTime)			
	robust (integer)
				The Robustness Variable allows tuning for the 
				expected packet loss on a subnet.  If a subnet 
				is expected to be lossy, the Robustness 
				Variable may be increased.  IGMP is robust to 
				(RobustnessVariable-1) packet losses. 
				(swIGMPQueryMaxResponseTime)
	v0Querier|v1Querier|v2Querier|other (keyword)
				IGMP querier version (swIGMPQuerierVersion).
		
IPaddress manual|BOOTP|DHCP [IPaddr subnetMask defaultGateway] 

	manual|BOOTP|DHCP (keyword)
				Specify from where switch gets its IP address 
				(BOOTP, DHCP, or manually via another interface 
				such as RS232 or HTTP).
	IPaddr (IP address)
				Argument when manual is specified.   
				It specifies the switch IP address.
	subnetMask (mask)
				Argument when manual is specified.   
				It specifies the switch subnet mask.
	defaultGateway (IP address)
				Argument when manual is specified.   
				It specifies the switch default gateway.

mib2 contact name location
	contact name location (text)	
				Set MIB2 system information: contact, name, and 
				location info for the switch.

mirrorCreate mirror# srcPort# targetPort# ingress|egress|both
mirrorDelete mirror#
				This function configures port mirroring.

	mirror# (integer) 
				Specifies the mirror number (only "1" is valid 
				for cpqpgbe device).  (swPortMirrorIndex)
	srcPort# (integer) 
				Specifies the source port  
				(swPortMirrorSourcePort)
	targetPort# (integer) 
				Specifies the target port 
				(swPortMirrorTargetPort)
	ingress|egress|both (keyword)  
				Specifies affected packet type  
				(swPortMirrorDirection)
	
multAddrFilter FDBid MACaddr receivePort egress forbid 
  invalid|perm|delReset|delTimeout
				This function configures Static (MAC) Multicast 
				Address Filtering
	FDBid (integer)
				The relevant Filtering Database ID (VLAN ID).
	MACaddr  (integer) 
				The destination MAC address in a frame to which 
				this entry's filtering information applies.  
				This object must take the value of a Multicast 
				or Broadcast address. 
				(dot1qStaticMulticastAddress)
	receivePort (integer)
				Either the value '0', or the port number of the 
				port from which a frame must be received in 
				order for this entry's filtering information to
				apply.  A value of zero indicates that this 
				entry applies on all ports of the device for 
				which there is no other applicable entry. 
				(dot1qStaticMulticastReceivePort)
	egress (mask)
				The set of ports to which frames received from 
				a specific port and destined for a specific 
				Multicast or Broadcast MAC address must be 
				forwarded, regardless of any dynamic 
				information e.g. from GMRP.  A port may not be 
				added in this set if it is already a member of 
				the set of ports in 
				dot1qStaticMulticastForbiddenEgressPorts. The 
				default value of this object is a string of 
				ones of appropriate length. 
				(dot1qStaticMulticastStaticEgressPorts)
	forbid (mask)
				The set of ports to which frames received from 
				a specific port and destined for a specific 
				Multicast or Broadcast MAC address must not be 
				forwarded, regardless of any dynamic 
				information e.g. from GMRP.  A port may not be 
				added in this set if it is already a member of 
				the set of ports in 
				dot1qStaticMulticastStaticEgressPorts. 
				The default value of this object is a string of 
				zeros of appropriate length. 
				(dot1qStaticMulticastForbiddenEgressPorts)
	invalid|perm|delReset|delTimeout (keyword)
		invalid
				Removes the corresponding entry.
		perm
				This entry is currently in use and will remain 
				so after the next reset of the bridge.
		delReset
				This entry is currently in use and will remain 
				so until the next reset of the bridge.
		delTimeout
				This entry is currently in use and will remain 
				so until it is aged out.
				(dot1qStaticMulticastStatus)

portName port# name		
portStatus port# enable|disable
portCfg port# flow|noflow nway|10half|10full|100half|100full|1000half|1000full
	port# (integer)		
				Specify port number.
	name (text)		
				The port name
	enable/disable (keyword)
				Enable or disable the port.
	flow (keyword) 
				Enables port flow control. 
				(swL2PortCtrlFlowCtrlState)
	noflow (keyword) 
				Disables port flow control.
	nway (keyword) 
				Enables N-way function mode.
	10half  (keyword) 
				Sets the port to 10Mbit/sec, half-duplex. 
				(swL2PortCtrlNwayState)
	10full (keyword) 
				Sets the port to 10Mbit/sec, full-duplex.
	100half  (keyword) 
				Sets the port to 100Mbit/sec, half-duplex.
	100full  (keyword)
				Sets the port to 100Mbit/sec, full-duplex.
	1000half (keyword) 
				Sets the port to 1000Mbit/sec, half-duplex.
	1000full  (keyword)
				Sets the port to 1000Mbit/sec, full-duplex.

query functionKeyword|all
				Display the SNMP configuration (OID, type, and 
				value) for the specified functionKeyword.  The 
				functionKeyword is one of the above function 
				keywords or "all". If  "all" is specified, the
				SNMP configuration for all the functions is 
				displayed.

qos basePort priority class
				Define Traffic Class (Quality of Service).
	basePort (integer)
				Specifies associated base port. (dot1dBasePort)
	priority (integer)
				Specifies associated priority. 
				(dot1dTrafficClassPriority)
	class (integer)
				The Traffic Class the received frame is mapped 
				to. (dot1dTrafficClass)		

reset reboot|save|default|def_noIP|nvram
	reboot (keyword)
				Causes a switch reboot. 
				(swL2DevCtrlSystemReboot)
	save (keyword)
				Causes a configuration save to NVRAM and reboot
	default (keyword)
				Causes load factory default reboot.
	def_noIP (keyword)
				Causes a load factory default except IP 
				addresses reboot.
	nvram (keyword)
				Write configuration to NVRAM (no reboot).


rs232 enable|oob|disable [2400|9600|19200|38400|57200|115200 
   [8dataBits|7dataBits [1stopBits|2stopBits [none|oddParity|evenParity]]]
				Configure the RS232 (console) port.

	enable|disable|oob
				Specify console mode on device restart.

	2400|9600|19200|38400|57200|115200 (keyword)	
				Specifies the BAUD rate 
				(agentConsoleModeManagerBaudRate)
	8dataBits|7dataBits
				The DataBits for console mode, If the 
				agentRs232PortConfig change to console mode 
				then the device will use this group to make a 
				setup for console value and 
				agentSlipModeManager group will deactive 
				automatically. 
				(agentConsoleModeManagerDataBits).
	1stopBits|2stopBits
				Specifies the number of stop bits. 
				(agentConsoleModeManagerStopBits)
	oddParity|evenParity
				The Parity for console mode, If the 
				agentRs232PortConfig change to console mode 
				then the device will use this group to make a 
				setup for console value and  
				agentSlipModeManager group will deactive 
				automatically. 
				(agentConsoleModeManager)

	
set_cfgfile TFTPaddr filename	
				Set configuration file (download from TFTP 
				server) and write to NVRAM.

snmpTrap IPaddr community create|delete
	create|delete (keyword)
				If "delete" is specified, the SNMP trap 
				recipient is deleted from the list, otherwise 
				it is added.	
	IPaddr (IP address/text)
				Specify the SNMP trap destination IP address.
	community (text)
				The SNMP community string of the trap recipient

stp enable|disable [bridgeMaxAge [bridgeHelloTime [bridgeFwdDelay [priority]]]]

				Configure Spanning Tree Protocol for switch.

	enable|disable (keyword)
				Enable or disable STP, switch-wide. 
				(swL2DevCtrlStpState)
	bridgeMaxAge (integer)
				The value that all bridges use for MaxAge when 
				this bridge is acting as the root.  Note that 
				802.1D-1990 specifies that the range for this 
				parameter is related to the value of 
				dot1dStpBridgeHelloTime. The granularity of 
				this timer is specified by 802.1D-1990 to be 1 
				second. An agent may return a badValue error if 
				a set is attempted to a value which is not a 
				whole number of seconds. (dot1dStpBridgeMaxAge)  
				Input in .01 seconds (i.e. 2000 is 20 seconds).
	bridgeHelloTime (integer)
				The value that all bridges use for HelloTime 
				when this bridge is acting as the root.  The 
				granularity of this timer is specified by 
				802.1D-1990 to be 1 second.  An agent may 
				return a badValue error if a set is attempted 
				to a value which is not a whole number of 
				seconds. (dot1dStpBridgeHelloTime)
	bridgeFwdDelay (integer)
				The value that all bridges use for ForwardDelay 
				when this bridge is acting as the root.  Note 
				that 802.1D-1990 specifies that the range for 
				this parameter is related to the value of 
				dot1dStpBridgeMaxAge.  The granularity of this 
				timer is specified by 802.1D-1990 to be 1 
				second. An agent may return a badValue error if 
				a set is attempted to a value which is not a 
				whole number of seconds. 
				(dot1dStpBridgeForwardDelay)
	priority (integer) 
				The value of the write-able portion of the 
				Bridge ID, i.e., the first two octets of the 
				(8 octet long) Bridge ID.  The other (last) 6 
				octets of the Bridge ID are given by the value 
				of  dot1dBaseBridgeAddress. (dot1dStpPriority)

stpPort port# enable|disable [priority [cost [byPassEnable|byPassDisable]]]
				Configure STP for port.

	port# (integer)
				Specify the port number.
	enable|disable (keyword)
				Enable or disable STP on the port. 
				(dot1dStpPortEnable)
	priority (integer)
				The value of the priority field which is 
				contained in the first (in network byte order) 
				octet of the (2 octet long) Port ID.  The other 
				octet of the Port ID is given by the value of 
				dot1dStpPort. (dot1dStpPortPriority)
	cost (integer)
				The contribution of this port to the path cost 
				of paths towards the spanning tree root which 
				include this port.  802.1D-1990 recommends that 
				the default value of this parameter be in 
				inverse proportion to the speed of the attached
				LAN. (dot1dStpPortPathCost)

	byPassEnable|byPassDisable (keyword)
				Enable/disable ByPass mode on the port.  ByPass
				sets the forwarding delay timer to zero, thus 
				bypassing the waiting time before the listening
				state.
		
trunkCreate trunk# name portmask
trunkDelete trunk#
				This function configures port trunking.

	trunk# (integer) 
				Specifies the switch trunk number. 
				(swPortTrunkIndex)
	name (text)
				Specifies the name of the switch. 
				(swPortTrunkName)
	portmask (mask) 
				Specifies which ports should be members of the 
				trunk (swPortTrunkPortList)
	

uniAddrFilter FDBid MACaddr receivePort portMask 
   invalid|perm|delReset|delTimeout
				This function configures Static (MAC) Unicast 
				Address Filtering

	FDBid (integer)
				The relevant Filtering Database ID (VLAN ID).

	MACaddr  (integer) 
				The destination MAC address in a frame to which
				this entry's filtering information applies.  
				This object must take the value of a unicast 
				address. (dot1qStaticUnicastAddress)
	receivePort (integer)
				Either the value '0', or the port number of the 
				port from which a frame must be received in 
				order for this entry's filtering information 
				to apply.  A value of zero indicates that this 
				entry applies on all ports of the device for 
				which there is no other applicable entry. 
				(dot1qStaticUnicastEntry)
	portMask (mask)
				The set of ports for which a frame with a 
				specific unicast address will be flooded in the 
				event that it has not been learned.  It also 
				specifies the set of ports a specific unicast 
				address may be dynamically learnt on.  The 
				dot1qTpFdbTable will have an equivalent  entry 
				with a dot1qTpFdbPort value of '0' until this 
				address has been learnt, when it will be 
				updated with the port the address has been 
				seen on.  This only applies to ports that are 
				members of the VLAN, defined by 
				dot1qVlanCurrentEgressPorts.  The default value
				of this object is a string of ones of 
				appropriate length. 
				(dot1qStaticUnicastAllowedToGoTo)	
	invalid|perm|delReset|delTimeout (keyword)
		invalid
				Removes the corresponding entry.
		perm
				This entry is currently in use and will remain 
				so after the next reset of the bridge.
		delReset
				This entry is currently in use and will remain 
				so until the next reset of the bridge.
		delTimeout
				This entry is currently in use and will remain 
				so until it is aged out.
				(dot1qStaticUnicastStatus)
				
vlanCreate vlanID name egress forbid static
vlanModify vlanID name egress forbid static
				Create or modify a VLAN.

	vlanID (integer)
				Specifies the VLAN ID number.
	name (text)
				Specifies the VLAN name.
	egress (mask)
				The set of ports which are permanently assigned
				to the egress list for this VLAN by management.
				Changes to a bit in this object affect the 
				per-port per-VLAN Registrar control for 
				Registration Fixed for the relevant GVRP state 
				machine on each port.  A port may not be added 
				in this set if it is already a member of the 
				set of ports in dot1qVlanForbiddenEgressPorts.
				The default value of this object is a string of
				zeros of appropriate length, indicating not 
				fixed. (dot1qVlanStaticEgressPorts)
	forbid (mask)
				The set of ports which are prohibited by 
				management from being included in the egress 
				list for this VLAN.  Changes to this object 
				that cause a port to be included or excluded 
				affect the per-port per-VLAN Registrar control 
				for Registration Forbidden for the relevant 
				GVRP state machine on each port.  A port may 
				not be added in this set if it is already a 
				member of the set of ports in 
				dot1qVlanStaticEgressPorts.
				The default value of  this object is a string 
				of zeros of appropriate length, excluding all 
				ports from the forbidden set. 
				(dot1qVlanForbiddenEgressPorts)
	static (mask)
				The set of ports which should transmit egress 
				packets for this VLAN as untagged.  The default
				value of this object for the default VLAN 
				(dot1qVlanIndex = 1) is a string of appropriate
				length including all ports.  There is no 
				specified default for other VLANs.  If a device
				agent cannot support the set of ports being set
				then it will reject the set operation with an 
				error. An example might be if a manager 
				attempts to set more than one VLAN to be 
				untagged on egress where the device does not 
				support this IEEE 802.1Q option. 
				(dot1qVlanForbiddenEgressPorts)

vlanDelete vlanID
				Delete a VLAN.
	vlanID (integer)
				Specifies the VLAN ID.

vlanMgmt vlanID
				Specify which is the "management" VLAN, 
				containing the switch processor. 
				(swL2DevCtrlManagementVlanId)
	vlanID (integer)
				Specifies the VLAN.

vlanPort port# vlanID all|tag discard|accept enable_gvrp|disable_gvrp
				Manage ports in a VLAN.
	port# (integer)
				Specifies the port number.
	vlanID (integer)
				Specifies the VLAN ID number. (dot1qPvid)
	all | tag (keyword)
				When this is "tag", the device will discard 
				untagged frames or Priority-Tagged frames 
				received on this port.  When "all", untagged 
				frames or Priority-Tagged frames received on 
				this port will be accepted and assigned to the 
				PVID for this port. This control does not 
				affect VLAN independent BPDU frames, such as 
				GVRP and STP.  It does affect VLAN dependent 
				BPDU frames, such as GMRP. 
				(dot1qPortAcceptingFrameTypes)
	discard | accept (keyword)
				When this is "discard" the device will discard 
				incoming frames for VLANs which do not include 
				this Port in its Member set.  When "accept", 
				the port will accept all incoming frames. This 
				control does not affect VLAN independent BPDU 
				frames, such as GVRP and STP.  It does affect 
				VLAN dependent BPDU frames, such as GMRP. 
				(dot1qPortIngressFiltering)
	enable_gvrp|disable_gvrp (keyword)
				The state of GVRP operation on this port.  The 
				value enabled(1) indicates that GVRP is enabled
				on this port, as long as dot1qGvrpStatus is 
				also enabled for this device.  When disabled(2) 
				but dot1qGvrpStatus is still enabled for the 
				device, GVRP is disabled on this port: any 
				GVRP packets received will be silently 
				discarded and no GVRP registrations will be 
				propagated from other ports.  This object 
				affects all GVRP Applicant and Registrar state 
				machines on this port.  A transition from 
				disabled(2) to enabled(1) will cause a reset of
				all GVRP state machines on this port. (
				dot1qPortGvrpStatus)
		


DEVICE HANDLER DESCRIPTION:

In order to minimize the effort to support future devices, the device-specific 
interface knowledge (e.g. SNMP MIB) is located outside of cpqswcfg in a 
device handler.  For the Win32 release, a DOS "batch" file (cpqpgbe.bat)  is 
included to interface with the p-Class GbE and e-Class GbE Interconnect 
Switch.  For Linux, the equivalent shell (sh(1)) script is included (cpqpgbe). 
cpqswcfg will invoke the handler specified with the -d option.  For example, 
"cpqswcfg -d cpqpgbe" would cause the invocation of "cpqpgbe.bat" on Win32 
machines.

The syntax of device handlers is:

	handler IPaddr community_string function function_args [-y]

The syntax of the functions is the same as for cpqswcfg.

The cpqswcfg "-o other args" are device-specific and not in the scope of this 
document, but would replace the function and function_args.

The -y option causes the handler to pause for user input before exiting, to 
allow results to be read.

For Win32 environments, the handler sets ERRORLEVEL to "1" on error, otherwise 
"0".  The Linux version exits with a value of "1" on error, otherwise "0".  
Exit value "2" is used internally by cpqswcfg to signify an exec error, so the 
handler must not use exit value "2".  Win32 cpqswcfg will not examine 
ERRORLEVEL, but the Linux command line mode will exit with the exit value of 
the handler.  An "Error" or "Success" message is displayed on handler exit.


CPQSNMP DESCRIPTION:

This tool is provided for those (Win32) device handlers which use SNMP to 
communicate with the switch.  It provides a simple, general purpose, SNMP 
command line interface and may be used for access to all SNMP variables 
supported by the switch.   It may also be invoked for any other purpose.


Usage: cpqsnmp [-rt] {get|getnext} agent community oid [oid] [...]
       cpqsnmp [-rt] set agent community oid type value [oid type value] [...]
       cpqsnmp [-inrtx] poll agent community oid [oid] [...]
       spqsnmp [-lrt] walk agent community oid
       cpqsnmp [-inp] trap
       cpqsnmp @file

       Options with arguments are:
         -t <request time out in milliseconds>
         -r <request retries attempts before timing out>
         -i <polling interval in milliseconds>
         -n <number of polling requests>

       Valid 'type' are:
         1 = INTEGER            5 = Counter
         2 = OCTET STRING       6 = Gauge
         3 = OBJECT IDENTIFIER  7 = TimeTicks
         4 = IpAddress          8 = Opaque

Setting an "OCTET STRING" to a 4-byte binary value is accomplished by preceding
the input value with "0x" (e.g. 0xF0000000).


Here is example output of getting "sysObjId".  
The command was:

	cpqsnmp get 10.90.90.90 public 1.3.6.1.2.1.1.2.0

The output was:

ErrorStatus: 0 (No Error)
 ErrorIndex: 0
  varbind 1: 
       Name: system.sysObjectID.0 
        OID: 1.3.6.1.2.1.1.2.0 
       Type: OBJECT IDENTIFIER
     Length: 11
      Value: 1.3.6.1.4.1.232.161.1.36 


==============================================================================
Example Switch Configuration Scripts (Templates)
------------------------------------------------

The Switch Configuration Template feature provides a set of (Win32 and Linux)
scripts which can be invoked with the switch IP address as an argument and 
automatically configure the switch to a pre-defined state.

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

eGbE switch		pGbE switch
------------		-----------
cpqebcfr.bat		cpqpbcfr.bat
cpqebcfr1.bat		cpqpbcfr1.bat
CfgTmpEC.pdf		CfgTmpPC.pdf


Script usage example (eGbE):
----------------------------

cpqebcfr.bat  <switch IP address> <SNMP community string> NO_RESET
cpqebcfr1.bat <switch IP address> <SNMP community string> NO_RESET

If the NO_RESET argument is provided, the switch is configured
without a reset to factory defaults.

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.bat corresponds to 
switch A and the configuration generated by running cpqebcfr1.bat
corresponds to switch B in the document.


==============================================================================
SNMP MIBs
---------

These SNMP MIBs and the MIB errata file (mibInfo.txt) are included 
in the "mibs" subfolder:

	CIMTRAPS.mib
	cpqAgent.mib
	CPQHOST.MIB
	cpqIdRec.mib
	cpql2mgt.mib
	CPQRACK.MIB
	CPQSINFO.MIB
	mibInfo.txt
	RFC1213.MIB
	RFC1215.MIB
	RFC1493.MIB
	RFC1757.MIB
	rfc1907.mib
	rfc2233.mib
	rfc2358.mib
	rfc2674.mib
	rfc2737.mib
	vesubio.mib


==============================================================================
Switch firmware information tool, "swfwinfo"
--------------------------------------------

NAME
	swfwinfo - Display information about a Proliant BL e-Class/p-Class GbE 
	Switch firmware file

SYNOPSIS

	WIN32: SWFWINFO [drive:][path]filename 

	Linux: swfwinfo filename

DESCRIPTION

	Swfwinfo probes a Proliant BL e-Class/p-Class GbE Switch firmware file.
	If the filename provided is a valid and a readable Proliant BL 
	e-Class/p-Class GbE Switch firmware file, swfwinfo prints information 
	about the firmware file to STDOUT.  The printed information includes 
	the filename, the version ID, the build date and number, the firmware 
	manufacturer, and the type of firmware provided (e-Class or p-Class).  

	Upon successful completion, swfwinfo exits with an exit code of 0.  If 
	an error was encountered during processing (see ERROR CODES below), a 
	short description of the error is output to stderr and swfwinfo exits 
	with the appropriate error code.

OPTIONS

	None

ERROR CODES

	0	Normal.  Valid data is returned.
	1	An improper command syntax was provided. A Usage Error message 
		is printed on STDERR.
	2	The switch firmware file could not be found or read.  
	3	The checksum is invalid.
	4	The file signature is invalid.
	5	Unknown product ID.

There is a precedence for printing and returning error codes when the error 
involves the checksum, signature, or product ID of a firmware file that was 
found.  Only one of the errors is printed, in this precedence order:
  
	checksum error
	signature error
	product ID error


==============================================================================
Safe XML configuration example template for switch spares
---------------------------------------------------------

A safe mode XML switch configuration template and associated Readme may be 
found in  the "config scripts" subfolder.  Safe mode configuration files can 
be used to pre-configure switch spares.  See the Readme for more information.

 
==============================================================================
TFTP SERVER
-----------

The Win32 Interconnect Switch Utilities installation includes a public domain 
TFTP server.
  
The following files comprise this feature and are installed in the "tftpserver"
subfolder:
	tftpd32.exe	The server
	tftpd32.hlp	The help file
	file_id.diz	ID information

Please note the following if you are running the RDP TFTP server:
	The RDP PXE TFTP server must be stopped and a general purpose TFTP 
	server (such as the one included) should be started for TFTP operations
	to the switch to perform properly, since the RDP PXE TFTP server is 
	unidirectional (to switch) only.

==============================================================================
Interconnect Switch XML configuration file format example
---------------------------------------------------------

The XML configuration file tags and schema are defined in the following 
example. While this example is complete, it does not represent the switch 
defaults.

<?xml version="1.0" encoding="UTF-8"?>
  <!-- Any missing entries are left as previously configured -->
  <!-- An output of the current configuration file will have all configuration 
	parameters -->
<SWITCH_CONFIG>
    <IP_ADDRESS>
        <GET_IP_FROM VALUE="Manual"/>           <!-- Manual/BOOTP/DHCP -->
        <IP_ADDRESS VALUE="127.0.0.1"/>
        <SUBNET_MASK VALUE="255.255.255.0"/>
        <DEFAULT_GATEWAY VALUE="127.0.0.1"/>
        <MANAGEMENT_VID VALUE="1"/>
    </IP_ADDRESS>
    <SYSTEM_INFORMATION>
        <NAME VALUE="fred"/>
        <LOCATION VALUE="TOP FLOOR"/>
        <CONTACT VALUE="JOHN SMITH"/>
    </SYSTEM_INFORMATION>
    <ADVANCED_SETTINGS>
        <TELNET_CONSOLE_AUTO_LOGOUT_IN_MINUTES VALUE="Never"/>           
		<!-- Never/2/5/10/15 -->
        <WEB_AUTO_LOGOUT_IN_MINUTES VALUE="5"/>           <!-- 5 ~ 20 -->
        <MAC_ADDRESS_AGING_TIME_IN_SECONDS VALUE="300"/> <!-- 10 ~ 1000000 -->
        <IGMP_SNOOPING VALUE="Disabled"/>           <!-- Disabled/Enabled -->
        <GVRP_STATUS VALUE="Disabled"/>            <!-- Disabled/Enabled -->
        <TELNET_STATUS VALUE="Disabled"/>                                    
		<!-- Disabled/Enabled -->
        <WEB_STATUS VALUE="Enabled"/>                                         
		<!-- Disabled/Enabled -->
        <GROUP_ADDRESS_FILTER_MODE VALUE="Forward_all"/>
         <!-- Forward_all/Forward_all_Unregistered/Filter_all_Unregistered -->
        <COS_QUEUE_SCHEDULING VALUE="Strict"/>                             
		<!-- Strict/RoundRobin -->
        <TRUNK_LOAD_SHARING_ALGORITHM VALUE="Source_addr"/>
             <!-- Source_addr/Destination_addr/Source_and_Destination_addr -->
        <BACKPRESSURE VALUE="Disabled"/>   <!-- Disabled/Enabled -->
    </ADVANCED_SETTINGS>
    <TFTP_SETTINGS>
        <SERVER_PORT_NUMBER VALUE="69"/   <!-- Decimal 69, 1024 ~ 65535 -->
        <SERVER_IP VALUE=0.0.0.0/>
        <FIRMWARE_FILE_PATH VALUE=/>
        <HISTORY_LOG_FILE_PATH VALUE=/>
        <CONFIGURATION_FILE_PATH VALUE=/> 
    </TFTP_SETTINGS>
    <TIME_SETTINGS>
        <SNTP_SETTINGS>
           <STATE VALUE="Enabled"/>               <!-- Disabled/Enabled -->
           <PRIMARY_SNTP_SERVER VALUE="0.0.0.0"/>
           <SECONDARY_SNTP_SERVER VALUE="0.0.0.0"/>
 <POLL_INTERVAL VALUE="64"/>                      <!-- 64 ~ 1024 -->
        </SNTP_SETTINGS>
        <TIME_ZONE VALUE="+">
<!-- + represent time forward from GMT, - represents backwards from GMT -->
                <HOUR VALUE="00"/>                <!-- 00 ~ 12  -->
                <MINUTE VALUE="00"/>              <!-- 00/30 -->
        </TIME_ZONE>
        <DAYLIGHT_SAVING_TIME STATE=Disabled>
            <OFFSET VALUE=60/>                 <!---DST OFFSET -?
            <REPEATING>
               <START_MONTH VALUE="April"/>       <!-- Janary ~ December -->
               <START_WHICH_DAY VALUE="First"/>   <!-- First ~ Fifth, Last -->
               <START_WEEKDAY VALUE="Monday"/>    <!-- Sunday ~ Saturday -->
               <START_HOUR VALUE=02/>           <!--- Hour to start DST --->
               <START_MINUTE VALUE=02/>         <!--- Hour to start DST --->
               <STOP_MONTH VALUE="October"/>      <!-- Janary ~ December -->
               <STOP_WHICH_DAY VALUE="Last"/>     <!-- First ~ Fifth, Last -->
               <STOP_WEEKDAY VALUE="Sunday"/>     <!-- Sunday ~ Saturday -->
               <STOP_HOUR VALUE=02/>            <!--- Hour to start DST --->
               <STOP_MINUTE VALUE=00/>          <!--- Hour to start DST --->
            </REPEATING>
            <ANNUAL>
               <START_MONTH VALUE="April"/>       <!-- Janary ~ December -->
               <START_DAY  VALUE="14"/>           <!-- First ~ Fifth, Last -->
               <START_HOUR VALUE=02/>           <!--- Hour to start DST --->
               <START_MINUTE VALUE=02/>         <!--- Hour to start DST --->
               <STOP_MONTH VALUE="October"/>      <!-- Janary ~ December -->
               <STOP_DAY  VALUE="Last"/>          <!-- First ~ Fifth, Last -->
               <STOP_HOUR VALUE=02/>            <!--- Hour to start DST --->
               <STOP_MINUTE VALUE=00/>          <!--- Hour to start DST --->
            </ANNUAL>
        </DAYLIGHT_SAVING_TIME>
    </TIME_SETTINGS>
    <!-- Configure all PORTS, using a value of 0 would set all of them 
		identically -->
    <PORT_CONFIGURATION_ARRAY SET_DEFAULTS="False">
        <!-- Set the STP and VLAN SETTINGS the same for all ports to start-->
        <!-- Port_List example 1,2,3-7,* -->
        <PORT_CONFIGURATION VALUE="0">
            <STP_PORT_SETTINGS>
                <PRIORITY VALUE="128"/>
                <COST VALUE="19"/>
                <BYPASS VALUE="Yes"/>
                <STATE VALUE="Enabled"/>
            </STP_PORT_SETTINGS>
            <PORT_VLAN>
                <PVID VALUE="1"/>
                <INGRESS VALUE="Off"/>             <!-- Off/On -->
                <GVRP VALUE="Off"/>                <!-- Off/On -->
            </PORT_VLAN>
        </PORT_CONFIGURATION>
    <!-- Configure specific PORT, using a value of non-zero as port ID -->
        <PORT_CONFIGURATION VALUE="1">
            <NAME VALUE="slot1 port 1"/>
            <STATE VALUE="Enabled"/>               <!-- Disabled/Enabled -->
            <FLOW_CONTROL VALUE="Enabled"/>        <!-- Disabled/Enabled -->
            <SPEED VALUE="Auto"/>  <!-- Auto/100full/100half/10full/10half -->
            <PRIORITY VALUE="0"/>                            <!-- 0 ~ 7 -->
            <RESTART_EGRESS_BANDWIDTH_IN_UNITS VALUE="1"/>   <!-- 0 ~ 127 -->
            <RESTART_INGRESS_BANDWIDTH_IN_UNITS VALUE="1"/>  <!-- 0 ~ 127 -->
            <STP_PORT_SETTINGS>
                <PRIORITY VALUE="128"/>      <!-- 0 ~ 255 -->
                <COST VALUE="19"/>           <!-- 1 ~ 65535 -->
                <BYPASS VALUE="Yes"/>        <!-- No/Yes -->
                <STATE VALUE="Enabled"/>     <!-- Disabled/Enabled -->
            </STP_PORT_SETTINGS>
            <PORT_VLAN>
                <PVID VALUE="1"/>
                <INGRESS VALUE="Off"/>       <!-- Off/On -->
                <GVRP VALUE="Off"/>          <!-- Off/On -->
            </PORT_VLAN>
            <SECURITY>
                <MAX_LEARNING_ADDRESS VALUE="1"/>   <!-- 0 ~ 10 -->
                <MODE VALUE="DeleteOnReset"/>
			<!-- DeleteOnReset/DeleteOnTimeout -->
                <STATE VALUE="Enabled"/>     <!-- Disabled/Enabled -->
            </SECURITY>
        </PORT_CONFIGURATION>
    </PORT_CONFIGURATION_ARRAY>


    <PORT_MIRRORING>
       <STATE VALUE="Enabled"/>            <!-- Disabled/Enabled -->
       <SOURCE VALUE="1"/>
       <TARGET VALUE="2"/>
       <DIRECTION VALUE="Ingress"/>        <!-- Ingress/Egress/Either -->
    </PORT_MIRRORING>


    <!-- Delete all TRUNKING if RESET is True, add 3 -->
    <!-- Port_List example 1,2,3-7,* -->
    <PORT_TRUNK_LIST RESET="True">         <!-- False/True -->
        <PORT_TRUNK_ITEM VALUE="1">
            <NAME VALUE="Xconnect"/>
            <PORT_MAP VALUE="<1-24"/>							
            <STATE VALUE="Enabled"/>       <!-- Disabled/Enabled -->
        </PORT_TRUNK_ITEM>
    </PORT_TRUNK_LIST>

    <!-- Delete all IGMP if RESET is True, add 2 -->
    <IGMP_SNOOPING_LIST RESET="True">
        <IGMP_SNOOPING_ENTRY VLAN_ID="2">
            <QUERY_INTERVAL VALUE="125"/>
            <MAX_RESPONSE VALUE="10"/>
            <ROBUSTNESS VALUE="2"/>
            <QUERIER_STATE VALUE="V1-QUERIER"/>
			<!-- V1-QUERIER/V2-QUERIER/non-QUERIER -->
            <STATE VALUE="Enabled"/>
        </IGMP_SNOOPING_ENTRY>
    </IGMP_SNOOPING_LIST>

    <STP_SETTINGS>
        <STATE VALUE="Enabled"/>           <!-- Disabled/Enabled -->
        <BRIDGE_MAX_AGE_IN_SECONDS VALUE="20"/>
        <BRIDGE_HELLO_TIME_IN_SECONDS VALUE="2"/>
        <BRIDGE_FORWARD_DELAY_IN_SECONDS VALUE="15"/>
        <PRIORITY VALUE="32768"/>
    </STP_SETTINGS>

    <!-- Delete all UNICAST ADDRESS FILTERS if RESET is True, add 1 -->
    <UNICAST_FILTERING_LIST RESET="True">
        <UNICAST_FILTERING_ITEM VID="1">
            <MAC VALUE="00:00:00:00:00"/>
            <ALLOW_PORT VALUE="0"/>
            <TYPE VALUE="Permanent"/>     <!-- Permanent/DeleteOnReset -->
        </UNICAST_FILTERING_ITEM>
    </UNICAST_FILTERING_LIST>

    <!-- Delete all MULTI ADDRESS FILTERS if RESET is True, add 1 -->
    <!-- Port_List example 1,2,3-7,* -->
    <MULTICAST_FILTER_LIST RESET="True">
        <MULTICAST_FILTER_ITEM VID="1">
            <MAC VALUE="00:00:00:00:00"/>
            <PORT_EGRESS VALUE="*"/>
            <TYPE VALUE="Permanent"/>      <!-- Permanent/DeleteOnReset -->
        </MULTICAST_FILTER_ITEM>
    </MULTICAST_FILTER_LIST>

    <STATIC_VLAN_LIST RESET="True">
        <!-- Port_List example 1,2,3-7,* -->
        <STATIC_VLAN_ITEM VID="2">
            <NAME VALUE="John"/>
            <EGRESS VALUE="8-16"/>
            <FORBID VALUE="1-8, 17-24"/>
            <TAG VALUE="1-24"/>
            <STATE VALUE="Active"/>            <!-- Active/InActive -->
        </STATIC_VLAN_ITEM>
    </STATIC_VLAN_LIST>

    <PRIORITY_MAC_LIST RESET="True">
        <PRIORITY_MAC>
            <VLAN_ID VALUE="2"/>
            <MAC VALUE="00:00:00:00:00"/>
            <PRIORITY VALUE="0"/>
            <LOOK_AT VALUE="Src. Addr"/>  <!-- Src. Addr/Dst. Addr/Either -->
        </PRIORITY_MAC>
    </PRIORITY_MAC_LIST>

    <BROADCAST_THRESHOLD>
        <BROADCAST_STORM VALUE="Disabled"/>    <!-- Disabled/Enabled -->
        <MULTICAST_STORM VALUE="Disabled"/>    <!-- Disabled/Enabled -->
        <DA_UNKNOWN VALUE="Disabled"/>         <!-- Disabled/Enabled -->
        <THRESHOLD_PKTS_SEC VALUE="500"/>
    </BROADCAST_THRESHOLD>

    <CLASS_OF_TRAFFIC>
        <PRIORITY VALUE="0" CLASS="0"/>
        <PRIORITY VALUE="1" CLASS="0"/>
        <PRIORITY VALUE="2" CLASS="1"/>
        <PRIORITY VALUE="3" CLASS="1"/>
        <PRIORITY VALUE="4" CLASS="2"/>
        <PRIORITY VALUE="5" CLASS="2"/>
        <PRIORITY VALUE="6" CLASS="3"/>
        <PRIORITY VALUE="7" CLASS="3"/>
    </CLASS_OF_TRAFFIC>

    <CLASS_OF_SERVICE>
        <CLASS VALUE="0" PACKETS="10" LATENCY="10"/>
        <CLASS VALUE="1" PACKETS="10" LATENCY="10"/>
        <CLASS VALUE="2" PACKETS="10" LATENCY="10"/>
        <CLASS VALUE="3" PACKETS="10" LATENCY="10"/>
    </CLASS_OF_SERVICE>

    <!-- SET IP ACCESS to BIOS DEFAULTS if RESET is True, add 1 -->
    <SECURITY_IP_ACCESS_LIST RESET="True">
        <IPACCESS VALUE="127.0.0.3"/>
    </SECURITY_IP_ACCESS_LIST>

    <!-- SET SNMP ACCESS to BIOS DEFAULTS if RESET is True, add 2 -->
    <SNMP_ACCESS_LIST RESET="True">
        <SNMP_ACCESS_ITEM COMMUNITY="public">
            <TYPE VALUE="RO"/>                <!-- RO/RW -->
            <STATUS VALUE="Invalid"/>         <!-- Valid/Invalid -->
        </SNMP_ACCESS_ITEM>
    </SNMP_ACCESS_LIST>

    <!-- Delete all TRAP DESTINATIONS if RESET = True, add 2 -->
    <SNMP_TRAP_DESTINATIONS RESET="True">
        <TRAP_DESINATION_ITEM DESTINATION="127.0.0.1">
            <COMMUNITY VALUE="Public"/>
            <STATUS VALUE="Valid"/>          <!-- Valid/Invalid -->
        </TRAP_DESINATION_ITEM>
    </SNMP_TRAP_DESTINATIONS>

    <!-- SET USER ACCOUNTS to BIOS DEFAULTS if RESET is True, add 2 -->
    <!--- <USER_ACCOUNTS_LIST RESET="True">          ->
    <!---     <USER_ACCOUNT_ITEM USER="yourUser">     ->
    <!---         <PASSWORD VALUE="yourPassword"/>     ->
    <!---         <ACCESS VALUE="User"/>                  ->                                          
                   <!-- Root/User+/User                     -->    
    <!---     </USER_ACCOUNT_ITEM >                        ->
    <!--- </USER_ACCOUNTS_LIST>                           ->
  
    <!-- SET Serial Port Parameters, for Vanilla ONLY -->
    <SERIAL_PORT VALUE="Console">               <!-- Console/SLIP -->
        <BAUD VALUE="38400"/>        <!-- 2400/9600/19200/38400/115200 -->
        <DATA_BITS VALUE="8"/>                  <!-- 8, 7 -->
        <STOP_BITS VALUE="2"/>                  <!-- 1, 2 -->
        <PARITY VALUE="Odd"/>                   <!-- None/Odd/Even -->
        <SLIP_SETTINGS>
            <LOCAL_IP VALUE="0.0.0.0"/>
            <REMOTE_IP VALUE="0.0.0.0"/>
            <MTU VALUE="1006"/>                 <!-- 1006/1500 -->
        </SLIP_SETTINGS>
    </SERIAL_PORT>
    <SWITCH_INFORMATION>
<SWITCH_IDENTIFICATION>
   <SERIAL_NUMBER VALUE=XXXX/>
   <!----   For each of the following entries, printed if known and set --->
   <RACK_NAME VALUE=XXXX/>
   <ENCLOSURE_NAME VALUE=XXXX/>
   <RACK_UID VALUE=XXXX/>
   <ENCLOSURE_SERIAL_NUMBER VALUE=XXXX/>
   <SLOT_ID=XXXX/>
</SWITCH_IDENTIFICATION>
        <CONFIGURATION_LAST_SAVED_TIME VALUE=29 Jul 2002-15:13:12/>
    </SWITCH_INFORMATION>
    <!---The following setting are used for the command line interface ->
    <TELNET_RS232_SETTINGS>
         <DEFAULT_MODE VALUE=CLI/>            <!--- CLI or MENU  ->
         <PROMPT VALUE=a:/>                     <!--- Set the CLI prompt ->
    </TELNET_RS232_SETTINGS>
</SWITCH_CONFIG>


NOTES:

1.	The SWITCH_INFORMATION object will be uploaded, but will be ignored 
	if downloaded.

2.	The complete XML file need not be downloaded.  Unspecified attributes 
	are left unchanged.  Upper level object structures from the specified 
	objects must be maintained or an error and log message will occur.

3.  	The 'reset="True"' ARGUMENT on USER_ACCOUNTS will not remove or change 
	the user named root or its password.  If the user root is not 
	defined, the system will be open to any user/password combination. 
 
4.  	The deletion (or change) of the account used to start the TFTP 
	download will not affect the correct completion of the XML file 
	processing.  This may mean that the deletion or change of the 
	"account in use" may need to be delayed until everything else in the 
	XML file is processed.	The new user account will take effect on 
	next login.

----------------------------------------------------------------------------

Hewlett-Packard Company shall not be liable for technical or editorial errors
or omissions contained herein. The information in this document is provided 
"as is" without warranty of any kind and is subject to change without notice.
The warranties for HP products are set forth in the express limited warranty 
statements accompanying such products. Nothing herein should be construed as 
constituting an additional warranty.

(c) 2002, 2003 Hewlett-Packard Development Company, L.P.
