NAME
	hpecm - HP Ethernet Connectivity Mapper

	Display the mapping between ProLiant BL blade server NIC names 
	(as chosen by the OS) and interconnect switch or patch panel ports, 
	and provide enclosure configuration validation.

SYNOPSIS

	WIN32: hpecm 

DESCRIPTION

	hpecm is a graphical tool which collects information about the 
	contents of a ProLiant BL blade enclosure, including enclosure type, 
	blade type, and blade operating system (OS).  It then displays the 
	mapping between the switch or patch panel ports and the OS 
	enumeration (naming order) of the blade network interface controller 
	(NIC) ports.  Configuration validation is performed as items are 
	selected, so hpecm may also be used as an aid to configuration and/or
	deployment planning.

	Since different operating systems (such as Linux or Windows) 
	enumerate the NICs in differing order for different server types, an 
	OS selection field will appear for most blade types.  The "Default OS"
	selection field defines what OS is selected by default.
	
	The following OS enumerations are supported in this version of hpecm,
	depending on enclosure type:

		Select "Windows" as the OS for servers running:
			MS Windows 2000 Server
			MS Windows Server 2003

		Select "Windows 64-bit" as the OS for servers running:
			MS Windows Server 2003 (64-bit)

		Select the appropriate "Red Hat" (or "RH") version as the OS for 
		servers running:
			Red Hat Enterprise Linux (x86)

		Select the appropriate "SLES" version as the OS for servers 
		running:
			SuSE Linux Enterprise Server (x86)

		Select "VMware" as the OS for (p-Class) servers running:
			VMware VI3
			VMware ESX 2.5.x

	There are two p-Class enclosures: "standard" and "enhanced".  The 
	enhanced (also termed "high density" or "dedicated iLO") enclosure 
	routes the Integrated Lights Out (iLO) NIC to the enhanced 
	enclosure's dedicated (aggregated) iLO port.  The standard enclosure 
	routes the iLO NIC to a switch or patch panel port.  Some newer blade
	server types require that an "enclosure upgrade kit" be installed 
	before the blade may be deployed in a standard (older) enclosure.
	The enclosure upgrade kit makes a standard enclosure functionally
	equivalent to an enhanced enclosure for the purposes of this tool.
	Some blade types (e.g., BL20p-G3) are supported only in an
	enhanced enclosure, even though they may be used in a standard
	enclosure with reduced functionality, such as loss of use of a 
	blade NIC.

	Selecting the c-Class enclosure ("c7000") allows the server's mezzanine
	Ethernet network interface card (NIC) type to be specified, similarly 
	to specifying the OS.  Currently, only one NIC type may be specified
	per server.  The enumerations depend upon many factors including NIC
	type, placement, presence, installation order with intervening OS boots
	(and subsequent "discovery" by the OS), etc.  Therefore, in some cases
	the actual NIC enumerations by the OS may differ from the display.

	The NIC enumeration is displayed as a switch/patch panel identifier 
	(S1-S8 for c-Class and A or B for p-Class), a switch/patch panel port 
	number (1-16), and an OS-enumerated NIC device name (LAC 1, eth0, etc.).  
	For example, "S1-4, LAC 2" in the column under Bay 2 would signify that 
	switch 1, port 4 is connected to the second NIC in the blade server, as 
	enumerated by the Windows OS.  The Linux device names are of the
	format "eth0, eth1", etc.  Note that since Linux device names may
	be manually specified, the actual device names may differ from 
	those displayed.  For Rapid Deployment Pack (RDP) use, the default PXE
	port is denoted by "PXE".

	NOTE: When running some versions of Linux (e.g., Red Hat) and using 
	the /proc/net/nicinfo/eth*.info files to determine link status, 
	be aware that the file name on a BL20p-G3 blade server (containing 
	4 nics, eth0-eth3) does not always correspond to the device of the 
	same name.  For instance, the eth2.info file may actually contain 
	link status (as well as other status) for the fourth NIC device, eth3.
		
	The "Fill With Same" button fully populates the enclosure with the 
	top left-most selected blade and OS (and NIC type).

	The "Reset" button erases all selections and calculated information
	and returns hpecm to the startup state.

	The "Cancel" button may be used to exit the tool.

OPTIONS

	None

ERROR CODES

	None
