#Copyright 2006 Hewlett-Packard Development Company, L.P.
HP EV Update Utility for Setting iSCSI Boot Parameters 

The ev.exe utility runs under DOS from a bootable diskette or USB drive.

To install, copy the ev.exe utility and the sample evinput.txt file to the DOS
diskette or USB drive.

Boot the DOS diskette or USB drive.

1. Use a text editor to customize the evinput.txt file for your iSCSI boot
   configuration. The configuration file contains the boot path that the
   iSCSI Initiator needs to connect to the iSCSI targets from which it will
   boot. This information includes the names of the initiator and target,
   IP addresses, and so on. Create a customized file by executing
   the following command on the DOS booted system.

	edit evinput.txt


2. Define iSCSI boot path variables. Enter the following variables and values
   in the evinputi.txt file using this format: "<variable>=<value>". Variable
   names and values are case sensitive. Comments can be prefixed with a "#"
   character.

	Variable name		Description
	-------------		------------
	InitiatorName		The name to be used for the iSCSI initiator
				on the booting system.

	TargetName		The name of the target from which to boot.

	InitiatorNetmask	The IP network mask to be used by the iSCSI
				initiator. This value is in dotted decimal
				format.

	InitiatorRoute		The default IP route to be used by the iSCSI
				initiator. This value is in dotted decimal
				format.

	LAA			The Locally Assigned Address (MAC address) to
				be used by the iSCSI initiator.	The value is
				specified as 12 hex digits. A value of all
				zeros indicates that the initiator should use
				the MAC address assigned to the hardware.

	LUN			The logical unit number for the target. Some
				targets do not start numbering iSCSI target
				data LUNs at 0.

	ForceBoot		This value specifies that the iSCSI initiator
				should override	the IPL boot order for disk
				controllers and install itself as the boot
				disk. "True", "TRUE", "true", or "1" indicates
				that the iSCSI boot option ROM should install
				itself as the handler for the boot device.
				Any other value is equivalent to "False".

	AuthMethod		The authentication method to use. The
				initiator and target must agree on a mutually
				agreeable authentication method or the iSCSI
				initiator will not be able to log in to the
				target. The AuthMethod values are None,
				CHAP, and MutualCHAP. If CHAP is
				specified, the target may still select None
				as the authentication method. If CHAP is
				specified as the AuthMethod value, CHAPUsername
				and CHAPSecret must also be specified. If
				MutualCHAP is specified as the AuthMethod
				value, CHAPUsername, CHAPSecret and CHAPMSecret
				must also be specified.

	CHAPUsername		The username for CHAP authentication.

	CHAPSecret		The secret (password) for CHAP authentication.
				Specified either as a string or a long hex
				value (starting with "0x"). This value must
				be at least 96 bits(12 bytes, 24 hex digits)long.

	CHAPMSecret		The secret (password) for mutual (reverse) CHAP
				authentication.	Specified either as a string or
				a long hex value (starting with "0x").
				This value must be at least 96 bits (12 byte,
				24 hex digits) long.

	VLAN			The VLAN number that the iSCSI initiator
				should use for all packets sent and received.
				This is specified either as the VLAN number
				or "Disabled" if no VLAN is used.

The following is a sample configuration file.

# Copyright 2006 Hewlett-Packard Development Company, L.P.
# All Rights Reserved
# 06/15/06 
#
# Consult the IETF iSP iSCSI for details of these items.
#
##
# Name of the iSCSI Target. Must match what the target offers.
# Hard coded Target IP .. No DNS support
#
TargetName=iqn.2003-05.com.hp1510i:Target01
TargetIP=10.10.10.13
#
# local name the iSCSI client will present to the Target
# and local IP settings. No DNS or DHCP support
#
InitiatorName=iqn.client01
InitiatorIP=10.10.10.02
InitiatorNetmask=255.255.255.0
InitiatorRoute=10.10.10.1
TargetPort=3260
## Locally Admin Address (MAC address) and VLAN (Enabled/Disabled)
#
LAA=000000000000
VLAN=Disabled
## LUN Mapping. This should match what the target LUN offers.
#
LUN=0
## Make this persistent BIOS int 13 IPL routine. Replaces Embedded 
## HD C:\ (if present).
#.
ForceBoot=True
## Digest (CheckSum) data or Headers. Must match target setting.
#
DataDigest=False
HeaderDigest=False
## Account Login information
# . The AuthMethod values are: None,CHAP, and (TwoWay) MutualCHAP,
#
AuthMethod=None
##
# If AuthMethod is None, These are ignored.
CHAPUsername=iqn.1991-05.com.microsoft:comfort.txn.cpqcorp.net
CHAPSecret=Some12day123
CHAPMSecret=BetterThanThat



3. After completing the edit of the evinput.txt file, write the boot
   path to the target server. The boot path configuration file may
   be written to the target server with the ev.exe DOS utility.

   ev -c <evinput.txt

The information can also be displayed by entering the ev command
as follows:

   ev -p

After the ev command is executed and the iSCSI Option ROM firmware
has been installed on the Multifunction Adaptor, the Option ROM
should be able to connect to the target and the Operating System can
then be installed on the target.


