PRIMERGY BX600 10GbE I/O Module (PCIe)

Transcription

1 Reference Guide English PRIMERGY BX600 10GbE I/O Module (PCIe) Microsoft Windows Server 2003 iscsi Initiator SM-CLP Command Reference Guide Version 1.0 (V )

2 PRIMERGY BX600 10GbE LAN I/O Module (PCIe) Microsoft Windows Server 2003 iscsi Initiator SM-CLP Command Reference Guide (v ) Edition April 2008

3 COPYRIGHT NOTICE AND DISCLAIMER Copyright 2008 Fujitsu Siemens Computers GmbH All Rights Reserved. This document and the software described in this document are furnished under and are subject to the terms of a license agreement and constitute the confidential and proprietary information of Fujitsu Siemens Computers GmbH. Except as permitted in the license agreement, no part of this document may be reproduced in any form or by any means without the express written consent of Fujitsu Siemens Computers GmbH. This document is the copyrighted work of Fujitsu Siemens Computers GmbH and is owned by Fujitsu Siemens Computers GmbH. EXCEPT AS MAY BE EXPRESSLY SET FORTH IN THE LICENSE AGREEMENT, FUJITSU SIEMENS COMPUTERS GMBH PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FUJITSU SIEMENS COMPUTERS GMBH SHALL NOT BE LIABLE FOR ANY DAMAGE OR LOSS RESULTING FROM THE USE OF THIS DOCUMENT. This document may include technical inaccuracies or omissions or typographical errors and Fujitsu Siemens Computers GmbH shall not be liable for such inaccuracies, omissions or errors contained herein. Fujitsu Siemens Computers GmbH reserves the right to make changes to this document without prior notice. TRADEMARKS ServerEngines, the ServerEngines logo, BladeXchange, and BladeEngine are trademarks or registered trademarks of ServerEngines Corporation. Microsoft, Windows, Windows XP, and Windows 2003 are U.S. registered trademarks of Microsoft Corporation. Adobe and Acrobat are trademarks of Adobe Systems Incorporated. Other product names are the trademarks or registered trademarks of their respective owners.

4 Table of Contents Table of Contents 1. REVISION HISTORY INTRODUCTION GLOSSARY DOCUMENT CONVENTION HARDWARE AND SOFTWARE DEPENDENCIES USING THE COMMAND-LINE INTERFACE CONNECTING TO THE BLADEENGINE SERVER USING CLI INVOKING CLI ACCESSING HELP BASIC COMMANDS COMMON OPTIONS OUTPUT ARGUMENTS CD SHOW SET OEMSESAVECONFIG HELP VERSION EXIT OEMSE COMMANDS GROUP MAPS OEMSEERASECONFIGURATION OEMSEUPGRADEFLASHROM OEMSEENABLENIC OEMSEENABLEISCSI OEMSEDISABLENIC OEMSEDISABLEISCSI OEMSEADDROUTETABLEENTRY OEMSEDELETEROUTETABLEENTRY OEMSEADDARPTABLEENTRY OEMSEDELETEARPTABLEENTRY OEMSECONFIGUREIPADDRESS OEMSECONFIGUREDHCP OEMSEREFRESHNICCONFIG OEMSEPING OEMSEREFRESHEVENTLOG OEMSECLEAREVENTLOG OEMSETESTUNITREADY OEMSESTDINQUIRY OEMSEREADCAPACITY OEMSESCSIREAD OEMSESCSIWRITE OEMSESETPERSISTENT OEMSELOGIN OEMSELOGOUT OEMSEDELETEPERSISTENT OEMSERESCANLUNS OEMSEDISCOVERYISNSTHRUDHCP OEMSEADDISNSENTRY OEMSEDELETEISNSENTRY

5 Table of Contents OEMSEDISCOVERTARGETS OEMSEADDSENDTARGETPORTAL OEMSEDELETESENDTARGETPORTAL OEMSEREFRESHAVAILABLETARGETS OEMSEADDTARGET OEMSEDELETETARGET APPENDIX MILI_GROUPS ROOT BLADEENGINE LOGICALHBA NIC PHYSICALHBA PCI DRIVER QOS ISCSI INITIATORISCSINAME INITIATORDEFAULTLOGINOPTIONS INITIATORLOGINOPTIONS AUTHENTICATION PHYSICALHBA ROUTETABLE ROUTETABLEENTRY ARPTABLE ARPTABLEENTRY PCI DRIVER NETWORK DHCP TCPIPCONFIGURATION NICCONFIGURATION QOS EVENTLOG EVENTLOGENTRY SNMP TARGET TARGETPORTAL TARGETLOGINOPTIONS AUTHENTICATION SESSION SESSIONNEGOTIATEDLOGINOPTIONS SNMP CONNECTION CONNECTIONNEGOTIATEDLOGINOPTIONS LUN PERSISTENTLOGIN PERSISTENTLOGINPORTAL PERSISTENTLOGINOPTIONS AUTHENTICATION DISCOVERY SLP ISNS ISNSENTRY SENDTARGETPORTAL

6 Table of Contents SENDTARGETPORTALLOGINOPTIONS AUTHENTICATION MILI_PROPERTIES MANUFACTURER MODELNUMBER DESCRIPTION SERIALNUMBER ACTIVEFIRMWAREVERSION FIRMWAREVERSIONONFLASH BIOSVERSION BOOTCODEVERSION FIRMWARESTATUS ISCSIVERSIONMIN ISCSIVERSIONMAX MAXCDBLENGTH MAXMTUSIZE LDTO DEFAULTETO VLDCAPABLE VLDENABLED VENDORID DEVICEID SUBSYSDEVICEID SUBSYSVENDORID BUSNUMBER DEVICENUMBER FUNCTIONNUMBER DRIVERNAME DRIVERVERSION IFNAME MACADDRESS MAXBITSPERSECOND MAXPACKETSPERSECONDPERNIC INITIATORISCSINAME INITIATORALIAS DEFAULTISCSINAME INITIALR2T IMMEDIATEDATA MAXCONNECTIONS MAXOUTSTANDINGR2T FIRSTBURSTLENGTH MAXBURSTLENGTH DEFAULTTIME2WAIT DEFAULTTIME2RETAIN ERRORRECOVERYLEVEL DATAPDUINORDER DATASEQUENCEINORDER HEADERDIGEST DATADIGEST MAXRECVDATASEGMENTLENGTH TCPWINDOWSIZE INITIALR2T IMMEDIATEDATA AUTHENTICATIONMETHOD INITIATORCHAPNAME INITIATORSECRET

7 Table of Contents TARGETCHAPNAME TARGETSECRET HEADERDIGEST DATADIGEST IPADDRESS SUBNETMASK GATEWAY IPADDRESS MACADDRESS VENDORID DEVICEID SUBSYSDEVICEID SUBSYSVENDORID BUSNUMBER DEVICENUMBER FUNCTIONNUMBER DRIVERNAME DRIVERVERSION DHCPSERVERAVAILABLE DHCPOBTAINNEWIPADDRESS DHCPENABLED INITIATORIPADDRESS INITIATORSUBNETMASK DEFAULTGATEWAY IPVERSIONSUPPORTED VLANID PORTSPEED PORTMAXSPEED MAXFRAMESIZE LINKSTATUS ACTIVEPORT MACADDRESS MAXBYTESPERSECONDPERISCSI MAXIOSPERSECONDPERISCSI PORTROWSTATUS PORTALROLE PORTALPROTOCOL PORTALTAG SEQUENCENUMBER TIMESTAMP SEVERITY DESCRIPTION ERRORCODE NODEROLES PORTALCOUNT NODECOUNT SESSIONCOUNT SESSIONFAILURECOUNT LASTSESSIONFAILURETYPE LASTSESSIONRMTNODENAME SESSIONDIGESTERRORS SESSIONCONNECTIONTIMEOUT SESSIONFORMATERRORS LOGINFAILURES LASTFAILURETIME LASTFAILURETYPE

8 Table of Contents LASTTGTFAILURENAME LASTTGTFAILUREADDR LOGINACCEPTRSPS LOGINOTHERFAILRSPS LOGINREDIRECTRSPS LOGINAUTHFAILRSPS LOGINAUTHFAILS LOGINNEGOFAILS LOGOUTNORMALS LOGOUTOTHERS ETO TARGETIPADDRESS TARGETPORTNUMBER PORTALGROUPTAG INITIALR2T IMMEDIATEDATA AUTHENTICATIONMETHOD INITIATORCHAPNAME INITIATORSECRET TARGETCHAPNAME TARGETSECRET HEADERDIGEST DATADIGEST INITIALR2T IMMEDIATEDATA MAXCONNECTIONS MAXOUTSTANDINGR2T FIRSTBURSTLENGTH MAXBURSTLENGTH DEFAULTTIME2WAIT DEFAULTTIME2RETAIN ERRORRECOVERYLEVEL DATAPDUINORDER DATASEQINORDER SESSIONDIRECTION CMDPDUS RSPPDUS TXDATAOCTETSHIGH RXDATAOCTETSHIGH DIGESTERRORS CXNTIMEOUTERRORS SESSIONTARGETALIAS AUTHENTICATIONMETHOD HEADERDIGEST DATADIGEST MAXRECVDATASEGMENTLENGTH TCPWINDOWSIZE TCPMSS ISCSICONNECTIONID STATUS SOURCEPORTNUMBER DESTINATIONPORTNUMBER SOURCEIPADDRESS DESTINATIONIPADDRESS REDIRECTEDDESTINATIONPORT REDIRECTEDDESTINATIONIPADDRESS

9 Table of Contents SESSIONTSIH SESSIONISID SESSIONINITIATORNAME SESSIONSTATUS ISCSIBOOT LUNNUMBER LUNSIZE DEVICEVENDORNAME DEVICEMODELNUMBER IPADDRESS PORTNUMBER INITIALR2T IMMEDIATEDATA AUTHENTICATIONMETHOD INITIATORCHAPNAME INITIATORSECRET TARGETCHAPNAME TARGETSECRET PORTIDENTIFIER ISCSIBOOT TARGETNAME TARGETISCSINAME TARGETALIAS DEFAULTLOGINPORTAL DEFAULTINTRPORT SLPSCOPES SLPQUERYLIST IPADDRESS PORTNUMBER INITIALR2T IMMEDIATEDATA INITIATORCHAPNAME INITIATORSECRET TARGETCHAPNAME TARGETSECRET AUTHENTICATIONMETHOD HEADERDIGEST DATADIGEST IPADDRESS PORTNUMBER PORTIDENTIFIER PORTMACADDRESS SLPENABLED ISNSENABLED DEFAULTINITIATORPORT DATA TYPES COMMON ERROR MESSAGES

10 1. Revision History 1. Revision History May 2008 First Release 11

11

12 2. Introduction 2.1. Glossary 2. Introduction 2.1. Glossary This section describes the meaning of some of the product and protocol specific terms that are used in this document. : An entity in the BladeEngine software that has a value associated with it. A property can be either read-only or read-write. A property can be one of the data type listed in Data Types section in Appendix section. Verb : It is a command to the CLI. All the verbs that are exported by BladeEngine software are termed as OEMSEVerbs. Group : A logical entity that holds all the related properties and verbs. There can be groups within groups (termed as sub-groups). Groups are organized heiracically in a tree format. sm-clp target : SM-CLP document uses the term target to refer to groups. To avoid confusion, this document uses sm-clp target or groups to refer the same. Initiator : A term used in iscsi protocol to represent the entity that issues SCSI commands. Target : A term used in iscsi protocol to represent the entity that services SCSI commands to an initiator. Data Types used in this document are listed with their description in the Appendix section Document Convention This document uses the following conventions to describe command syntax Convention < > [ ] Meaning Within syntax description, indicates values that an user specifies. For example, show < property > Within syntax description, indicates optional keywords that can be used with the command. For example, show [-d < target >] Within syntax descriptions, the pipe symbol represents a choice to select one keyword or variable to the left or right of the symbol. (The keyword or variable can be either optional or required.) For example, show [-d < targets > -l < n all >] Table 1: Document Convention 2.3. Hardware and Software Dependencies The BladeEngine Software is required to be listening on a ssh or a telnet server. It should have a user account setup for the CLI to establish a ssh or a telnet session. 13

13

14 3. Using the Command-Line Interface 3.1. Connecting to the BladeEngine server using CLI 3. Using the Command-Line Interface This Chapter describes how to access BladeEngine sm-clp server using the CLI. Note that it is possible to connect to the sm-clp server by doing a telnet or SSH and use the same commands. The additional features that CLI would offer over a regular telnet or SSH sessions are: Scriptability Allows the execution of script files. Usability Allows tab completions on commands and parameters Command Line options Accepts command line options/arguments and additional command line parameters 3.1. Connecting to the BladeEngine server using CLI CLI uses SSH or telnet to connect to the server that is running BladeEngine Software. SSH is used as the default protocol to connect. CLI can be invoked by just typing CLI at the prompt. Username and Password will be prompted for connecting the server using ssh. Telnet can be used by providing a command line option. Username and password will be prompted for telnet session as well. CLI for using SSH CLI -t telnet for using Telnet 15

15 3. Using the Command-Line Interface 3.2. Invoking CLI 3.2. Invoking CLI CLI can be invoked by typing CLI on the command line as described below CLI Syntax: CLI [-t < transport >] [-u < username >] [-p < password >] [-o < output file >] [-s < IP Address > [: < Port >]] [-f < script file > "< command >"] Option -t takes in transport as argument. Valid transports are telnet and ssh takes username as argument for transport authentication. It is mandatory to provide username and password CLI Options for authentication. If these CLI options are not -u provided on the command line, then the CLI will prompt the user to input them before continuing to process the rest of the CLI options and CLI commands. -p takes password as argument for transport authentication -o takes output file name as argument. This output will be redirected to this file This option takes the IP address and an optional port number (default is 22 for ssh). If this -s option is not given then the CLI assumes that the SM-CLP server is running on the local machine and attempts to connect to it. takes script file as argument. The CLI program will exit gracefully upon execution of the -f script file. This option cannot be used along with a command as an argument. A basic command or a OEMSE command can be given as a command line argument. The command entire command must be within double quotes. This argument cannot be used along with -f option. Table 2: CLI Options CLI commands can be run in three different modes as listed below: Immediate In Immediate mode the CLI command is given as a CLI option with the required parameters. The CLI will exit the program after executing the command. If the command did not execute for some reason or if there is a syntax error then the CLI terminates with the appropriate error message. Example: CLI "OEMSESaveTCPConfig" will execute the command OEMSESaveTCPConfig and exit. Script A script file can be supplied followed by a "-f" CLI option. The CLI will execute all the CLI commands in the script file and exit. If exit is not provided at the end of the script file then it is automatically inserted. Script will be aborted if a command encounters with an error. Example: CLI -f < scriptfile > will execute all the CLI commands in scriptfile and exit. 16

16 3. Using the Command-Line Interface 3.2. Invoking CLI Interactive CLI will enter into an interactive mode, if neither CLI command nor script file is provided as an option. CLI will accept CLI commands and execute them in the interactive shell. CLI will remain in interactive mode until an exit command is given. CLI supports tab completions and command history in the interactive mode only if readline module (comes optionally with Python) is installed. Example: CLI will enter interactive mode. The Command Line Interface (CLI) for BladeEngine follows the specificiations as defined in SM-CLP Standard 1.0a. All the CLI commands and options are case insensitive Parameters that are decimal numbers will also accept hexadecimal values with a '0x' as prefix. For ex: 0xa for decimal 10 Quoted strings are treated as single parameter for the commands that accept character inputs regardless of the space in the string. For string parameters quotes are optional, unless there is a space in the string. Space is used as a string termination, unless it is within quotes. 17

17 3. Using the Command-Line Interface 3.3. Accessing Help 3.3. Accessing Help CLI provides generic help and context help. Help can be obtained by simply typing help at the interactive command prompt. To obtain a context help type the following at the command prompt: help < group > < property > to get help on a particular property -or- help < group > < verb > to get help on a particular command. If group name is not given it is assumed to be the current group. Refer to help command for details. 18

18 4. Basic Commands 4.1. common options 4. Basic Commands This chapter describes the basic commands that are provided by the CLI. The syntax that is provided in this chapter is for script file and interactive mode of operation. For Immediate mode of operation the same syntax can be provided as command line argument within double quotes common options The following are the common options that can be used with any of the commands Parameter -x -examin Examines and reports whether the command can be executed. -h -help Provides help on the command -o -output < output_arguments > Takes the output file format. See "output_arguments" below for supported arguments. -v -version Displays the SM CLP version number used by the CLI 4.2. output arguments The following are the arguments for -o or -output option. If more than one arguments are used then they should be separated by commas with no spaces. Parameter format=< value > terse verbose error language=< value > begin order=< value > count=< value > Format controls the structure of the output text. The only < value > supported format is "text" Selects the level of detail included in the output to terse. This option cannot be used in conjunction with verbose. Selects the level of detail included in the output to verbose. This option cannot be used in conjunction with terse. The option to select the level of detail included in the output to error is not supported. Language selects the translation of text. < value > is a 3-character string identifier of language are specified in ISO The only < value > supported is "eng" (for English). When multiple items are returned in the output begin/end control where to start in the list. "end" is not supported. When multiple items are returned in the output order controls the order of those items. The only < value > supported is "default". "reverse" is not supported. When multiple items are returned in the output number controls the number of items returned. Default < value > is "all" which is supported. Any other value is not supported. Examples The following are some examples of usage of output arguments: To select the level of detail included in the output to verbose: client "OEMSESaveTCPConfig -o verbose" will execute OEMSESaveTCPConfig verb and display detailed output message. To do the same in the interactive shell of Command Line Interface: OEMSESaveTCPConfig -o verbose 19

19 4. Basic Commands 4.3. cd 4.3. cd Command cd This command sets the current group to the value provided in the parameter. If no parameter is given it displays the current working group. Syntax cd [common_options] [ -default] [SM-CLP target] Options [common_options] Parameter -default SM-CLP target takes the current working group to default which is root Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 20

20 4. Basic Commands 4.4. show 4.4. show Command show This command shows the property value for the property provided in the string. If no option is given then it displays the list of all the groups and properties available under the current group. Syntax show [common_options] [ -default] [ -d] [ -l] [SM-CLP target] Options [common_options] Parameter -default function is not defined in SM-CLP 1.0a document This option accepts a filter that is used to display the output. Valid values for Filters are -d targets Displays all the SM-CLP targets properties Displays all the properties verbs Displays all the verbs (commands) properties=< property name > Displays the property by the given < property name >. properties=< property name >==< value > Displays the property by name < property name > and that has value given in < value >. For example properties=linkstate==0 will display all the ports whose link is down (linkstate=0). < value > string is case sensitive. Use double quotes around the < value > string if there is a space in it. -l SM-CLP target This option specifies the level of subgroups the show command has to traverse to display. The default value is 1 which displays just the current group. The possible values for this option are 1 to n Displays the given levels of sub-groups. "n" should be an integer. all Displays all the sub-groups recursively. Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 21

21 4. Basic Commands 4.5. set 4.5. set Command set This command sets the given property with the given value. These values will be persistent unless the user performs an OEMSEEraseConfiguration command in SM-CLP or clears the configuration in iscsiselect. Any exception to this will be listed in the help. Set command will fail on read-only properties. Syntax set [common_options] [SM-CLP target] [< property > ] = [< value > ] Options [common_options] Parameter SM-CLP target < property > < value > Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. The property to be set. Type "show -d properties -l all" at the root group to get a list of all properties. Type "show -d properties" to see properties within current group only. The value is specific to the given command. Please type "help [property]" for applicable values. Required Parameters Optional Parameters Possible Error Messages Common Error Messages Read only property 22

22 4. Basic Commands 4.6. OEMSESaveConfig 4.6. OEMSESaveConfig Command OEMSESaveConfig This command saves the BladeEngine controller configuration to the given file name as an SM-CLP script. The SM-CLP script can be used to restore the BladeEngine controller configuration using the ServerEngines client application. Execute the client utility with the - f option. It is important to note that CHAP secrets will be stored in clear text in the SM-CLP script file. Hence, adequate precautions must be taken to protect this information when storing and using the script file. Also note that the SM-CLP script cannot be used to enable DHCP as a reboot is required when enabled DHCP via SM-CLP. Therefore enable DHCP using iscsiselect or SM-CLP prior to executing the script. Syntax OEMSESaveConfig [common_options] -OEMSEparams File="< value >" Options [common_options] Parameter - OEMSEparams takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default File String N/A N/A N/A string input that contains the filename with fully qualified path where the configuration will be saved. Optional Parameters Possible Error Messages Common Error Messages 23

23 4. Basic Commands 4.7. help 4.7. help Command help This command displays generic help and context help on a particular SM-CLP target property or verb. help command without a parameter will display generic help on how to use help. Syntax help [common_options] [group] [property verb] Options [common_options] Parameter group property verb The SM-CLP target for which the property or verb belongs. The valid list of SM-CLP targets are listed in the group table. Context help will be displayed for the given property or verb. The valid list of properties and verbs are listed in the property table and verb table of the document. The properties list can be obtained online by typing "show -d properties -l all". The verb list can be obtained online by typing "show -d verbs -l all". Required Parameters Optional Parameters Possible Error Messages Common Error Messages 24

24 4. Basic Commands 4.8. version 4.8. version Command version This command will display the SM-CLP version number. This command does not take in any parameters. Syntax version [common_options] Options [common_options] Required Parameters Optional Parameters Possible Error Messages Common Error Messages 25

25 4. Basic Commands 4.9. exit 4.9. exit Command exit This command exits the interactive mode (or the script if running in the script mode). It does all the clean up required to do a graceful exit. Syntax exit [common_options] Options [common_options] Required Parameters Optional Parameters Possible Error Messages Common Error Messages 26

26 5. OEMSE Commands 5.1. Group Maps 5. OEMSE Commands This chapter describes the OEMSE commands (verbs) for BladeEngine Software that are provided by the CLI. The commands has to be run in the particular group (smclp-target). To go the particular group use 'cd' command. CLI allows to execute the OEMSE command from any other group, provide the context (smclp-target) is given as an input to the command (as shown in the syntax of the OEMSE commands). The group (smclp-target) map tree is shown in the Group Maps chapter Group Maps The following tree represents the SM-CLP targets, properties and verbs with their associations to each other. Convention Meaning *! OEMSECommand [< n > - < m >] Multi-instance group starting with 'n'-th instance and with max of 'm' instances (< parameter >) Mandatory parameter to the action ([< parameter >]) Optional parameter to the action ROOT -> BladeEngine[0-7] -> *Manufacturer () -> *ModelNumber () -> * () -> *SerialNumber () -> *ActiveFirmwareVersion () -> *FirmwareVersionOnFlash () -> *BIOSVersion () -> *BootCodeVersion () -> *FirmwareStatus () -> *iscsiversionmin () -> *iscsiversionmax () -> *MaxCDBLength () -> *MaxMTUSize () -> *LDTO () -> *DefaultETO () -> *VLDCapable () -> *VLDEnabled ->!OEMSEEraseConfiguration ( ) ->!OEMSEUpgradeFlashROM ( UFIFileName ) -> LogicalHBA[0-31] ->!OEMSEEnableNIC ( PhysicalHBANumber ) ->!OEMSEEnableiSCSI ( PhysicalHBANumber ) ->!OEMSEDisableNIC ( PhysicalHBANumber ) ->!OEMSEDisableiSCSI ( PhysicalHBANumber ) -> NIC -> PhysicalHBA[0-7] -> PCI -> *VendorID () -> *DeviceID () -> *SubsysDeviceID () -> *SubsysVendorID () -> *BusNumber () -> *DeviceNumber () -> *FunctionNumber () -> Driver -> *DriverName () -> *DriverVersion () 27

27 5. OEMSE Commands 5.1. Group Maps -> *IfName () -> *MACAddress -> QOS -> *MaxBitsPerSecond -> *MaxPacketsPerSecondPerNIC -> iscsi -> InitiatoriSCSIName -> *InitiatoriSCSIName -> *InitiatorAlias -> *DefaultiSCSIName () -> InitiatorDefaultLoginOptions -> *InitialR2T () -> *ImmediateData () -> *MaxConnections () -> *MaxOutstandingR2T () -> *FirstBurstLength () -> *MaxBurstLength () -> *DefaultTime2Wait () -> *DefaultTime2Retain () -> *ErrorRecoveryLevel () -> *DataPDUInOrder () -> *DataSequenceInOrder () -> *HeaderDigest () -> *DataDigest () -> *MaxRecvDataSegmentLength () -> *TCPWindowSize () -> InitiatorLoginOptions -> *InitialR2T -> *ImmediateData -> Authentication -> *AuthenticationMethod -> *InitiatorCHAPName -> *InitiatorSecret -> *TargetCHAPName -> *TargetSecret -> *HeaderDigest -> *DataDigest -> PhysicalHBA[0-7] -> RouteTable -> RouteTableEntry[0-15] -> *IPAddress () -> *SubnetMask () -> *Gateway () ->!OEMSEAddRouteTableEntry ( IPAddress SubnetMask Gateway ) ->!OEMSEDeleteRouteTableEntry ( InstanceNumber ) -> ARPTable -> ARPTableEntry[0-63] -> *IPAddress () -> *MACAddress () ->!OEMSEAddARPTableEntry ( IPAddress MACAddress ) ->!OEMSEDeleteARPTableEntry ( InstanceNumber ) -> PCI -> *VendorID () -> *DeviceID () -> *SubsysDeviceID () -> *SubsysVendorID () -> *BusNumber () -> *DeviceNumber () -> *FunctionNumber () -> Driver -> *DriverName () -> *DriverVersion () 28

28 5. OEMSE Commands 5.1. Group Maps -> Network -> DHCP -> *DHCPServerAvailable () -> *DHCPObtainNewIPAddress () -> TCPIPConfiguration -> *DHCPEnabled () -> *InitiatorIPAddress () -> *InitiatorSubnetMask () -> *DefaultGateway () -> *IPVersionSupported () -> *VLANID () ->!OEMSEConfigureIPAddress ( IPAddress SubnetMask [Gateway] [VLANID] ) ->!OEMSEConfigureDHCP ( EnableDHCP ) -> NICConfiguration -> *PortSpeed () -> *PortMaxSpeed () -> *MaxFrameSize () -> *LinkStatus () -> *ActivePort () -> *MACAddress () ->!OEMSERefreshNICConfig ( ) -> QOS -> *MaxBytesPerSecondPeriSCSI -> *MaxIosPerSecondPeriSCSI -> *PortRowStatus () -> *PortalRole () -> *PortalProtocol () -> *PortalTag () ->!OEMSEPing ( IPAddress ) -> EventLog -> EventLogEntry[0-1023] -> *SequenceNumber () -> *TimeStamp () -> *Severity () -> * () -> *ErrorCode () ->!OEMSERefreshEventLog ( ) ->!OEMSEClearEventLog ( ) -> SNMP -> *NodeRoles () -> *PortalCount () -> *NodeCount () -> *SessionCount () -> *SessionFailureCount () -> *LastSessionFailureType () -> *LastSessionRmtNodeName () -> *SessionDigestErrors () -> *SessionConnectionTimeout () -> *SessionFormatErrors () -> *LoginFailures () -> *LastFailureTime () -> *LastFailureType () -> *LastTgtFailureName () -> *LastTgtFailureAddr () -> *LoginAcceptRsps () -> *LoginOtherFailRsps () -> *LoginRedirectRsps () -> *LoginAuthFailRsps () -> *LoginAuthFails () -> *LoginNegoFails () -> *LogoutNormals () -> *LogoutOthers () 29

29 5. OEMSE Commands 5.1. Group Maps Only) -> Target[0-63] -> *ETO -> TargetPortal[0-63] -> *TargetIPAddress () -> *TargetPortNumber () -> *PortalGroupTag () -> TargetLoginOptions -> *InitialR2T -> *ImmediateData -> Authentication -> *AuthenticationMethod -> *InitiatorCHAPName -> *InitiatorSecret -> *TargetCHAPName -> *TargetSecret -> *HeaderDigest -> *DataDigest -> Session[0-63] -> SessionNegotiatedLoginOptions -> *InitialR2T () -> *ImmediateData () -> *MaxConnections () -> *MaxOutstandingR2T () -> *FirstBurstLength () -> *MaxBurstLength () -> *DefaultTime2Wait () -> *DefaultTime2Retain () -> *ErrorRecoveryLevel () -> *DataPDUInOrder () -> *DataSeqInOrder () -> SNMP -> *SessionDirection () -> *CmdPdus () -> *RspPdus () -> *TxDataOctetsHigh () -> *RxDataOctetsHigh () -> *DigestErrors () -> *CxnTimeoutErrors () -> *SessionTargetAlias () -> Connection[0-3] -> ConnectionNegotiatedLoginOptions -> *AuthenticationMethod () -> *HeaderDigest () -> *DataDigest () -> *MaxRecvDataSegmentLength (Read- -> *TCPWindowSize () -> *TCPMSS () -> *iscsiconnectionid () -> *Status () -> *SourcePortNumber () -> *DestinationPortNumber () -> *SourceIPAddress () -> *DestinationIPAddress () -> *RedirectedDestinationPort () -> *RedirectedDestinationIPAddress () -> *SessionTSIH () -> *SessionISID () -> *SessionInitiatorName () -> *SessionStatus () -> *iscsiboot () -> LUN[0-511] -> *LUNNumber () 30

30 5. OEMSE Commands 5.1. Group Maps -> *LUNSize () -> *DeviceVendorName () -> *DeviceModelNumber () ->!OEMSETestUnitReady ( ) ->!OEMSEStdInquiry ( ) ->!OEMSEReadCapacity ( ) ->!OEMSESCSIRead ( StartBlockAddress Count ) ->!OEMSESCSIWrite ( StartBlockAddress Count ) -> PersistentLogin[0-127] -> PersistentLoginPortal -> *IPAddress () -> *PortNumber () -> PersistentLoginOptions -> *InitialR2T -> *ImmediateData -> Authentication -> *AuthenticationMethod () -> *InitiatorCHAPName () -> *InitiatorSecret () -> *TargetCHAPName () -> *TargetSecret () -> *PortIdentifier () -> *iscsiboot -> *TargetName () -> *TargetISCSIName () -> *TargetAlias () -> *DefaultLoginPortal -> *DefaultIntrPort ->!OEMSESetPersistent ( [IPAddress] [PortNumber] [PhysicalHBAInstanceNumber] [LogicalHBAInstanceNumber] ) ->!OEMSELogin ( [IPAddress] [PortNumber] [PhysicalHBAInstanceNumber] [LogicalHBAInstanceNumber] [SessionInitiatorName] ) ->!OEMSELogout ( [InstanceNumber] ) ->!OEMSEDeletePersistent ( InstanceNumber ) ->!OEMSEReScanLUNS ( ) -> Discovery -> SLP -> *SlpScopes -> *SlpQueryList -> isns -> isnsentry[0-3] -> *IPAddress () -> *PortNumber () ->!OEMSEDiscoveryiSNSThruDHCP ( ) ->!OEMSEAddiSNSEntry ( IPAddress PortNum ) ->!OEMSEDeleteiSNSEntry ( InstanceNumber ) -> SendTargetPortal[0-9] -> SendTargetPortalLoginOptions -> *InitialR2T -> *ImmediateData -> Authentication -> *InitiatorCHAPName -> *InitiatorSecret -> *TargetCHAPName -> *TargetSecret -> *AuthenticationMethod -> *HeaderDigest -> *DataDigest -> *IPAddress () -> *PortNumber () -> *PortIdentifier () -> *PortMacAddress () ->!OEMSEDiscoverTargets ( ) 31

31 5. OEMSE Commands 5.2. OEMSEEraseConfiguration ) -> *SLPEnabled -> *isnsenabled -> *DefaultInitiatorPort ->!OEMSEAddSendTargetPortal ( IPAddress PortNumber [PortIdentifier] ->!OEMSEDeleteSendTargetPortal ( InstanceNumber ) ->!OEMSERefreshAvailableTargets ( ) ->!OEMSEAddTarget ( TargetName IPAddress PortNumber ) ->!OEMSEDeleteTarget ( InstanceNumber ) 5.2. OEMSEEraseConfiguration Command OEMSEEraseConfiguration This command resets the BladeEngine configuration to factory default settings. Upon successful completion of this command, all user configured settings are lost. No reboot is required for these changes to take effect. Syntax OEMSEEraseConfiguration [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages Active session(s) present. Please log out of all sessions before clearing configuration. For systems booting from an iscsi target, configuration can only be cleared using the iscsi Select Utility., 32

32 5. OEMSE Commands 5.3. OEMSEUpgradeFlashROM 5.3. OEMSEUpgradeFlashROM Command OEMSEUpgradeFlashROM This command updates the BladeEngine firmware version stored in non-volatile memory. You must restart the system for the updated firmware to become the active firmware version on the BladeEngine controller. Example: OEMSEUpgradeFlashROM -OEMSEparams UFIFileName="flash.ufi" Syntax OEMSEUpgradeFlashROM [common_options] -OEMSEparams UFIFileName="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default UFIFileName string The path to the UFI file that will be used to upgrade the BladeEngine firmware. Optional Parameters Possible Error Messages Common Error Messages Cannot open the specified file, Invalid UFI file format, BladeEngine firmware has been updated. Please reboot your system for the changes to take effect., 33

33 5. OEMSE Commands 5.4. OEMSEEnableNIC 5.4. OEMSEEnableNIC Command OEMSEEnableNIC Enables NIC for the BladeEngine controller instance for the domain. Syntax OEMSEEnableNIC [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default PhysicalHBANumber integer The instance number of the BladeEngine Controller for which the NIC is to be enabled on this domain. Optional Parameters Possible Error Messages Common Error Messages 34

34 5. OEMSE Commands 5.5. OEMSEEnableiSCSI 5.5. OEMSEEnableiSCSI Command OEMSEEnableiSCSI This command enables iscsi for the BladeEngine controller instance for the domain. Specify the instance number of the BladeEngine controller for which iscsi is to be enabled. Example: OEMSEEnableiSCSI -OEMSEparams PhyscialHBANumber="2" Syntax OEMSEEnableiSCSI [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type PhysicalHBANumber integer Min Max Default The instance number of the BladeEngine Controller for which iscsi is to be enabled on this domain. Optional Parameters Possible Error Messages Common Error Messages Memory allocation failed, 35

35 5. OEMSE Commands 5.6. OEMSEDisableNIC 5.6. OEMSEDisableNIC Command OEMSEDisableNIC Disables NIC for the BladeEngine controller instance for the domain. Syntax OEMSEDisableNIC [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default PhysicalHBANumber integer The instance number of the BladeEngine Controller for which the NIC interface is to be disabled on this domain. Specify the instance number of the BladeEngine controller for which the NIC interface is to be disabled. Example OEMDisableNIC - OEMSEparams PhyscialHBANumber="2" Optional Parameters Possible Error Messages Common Error Messages 36

36 5. OEMSE Commands 5.7. OEMSEDisableiSCSI 5.7. OEMSEDisableiSCSI Command OEMSEDisableiSCSI This command disables iscsi for the BladeEngine controller instance for the domain. Syntax OEMSEDisableiSCSI [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default PhysicalHBANumber integer The instance number of the BladeEngine Controller for which ISCSI is to be disabled on this domain. Specify the instance number of the BladeEngine controller for which iscsi is to be disabled. Example OEMDisableiSCSI - OEMSEparams PhyscialHBANumber="2" Optional Parameters Possible Error Messages Common Error Messages 37

37 5. OEMSE Commands 5.8. OEMSEAddRouteTableEntry 5.8. OEMSEAddRouteTableEntry Command OEMSEAddRouteTableEntry This command adds a user specified entry to the BladeEngine iscsi initiator route table. Specify an IPAddress, Subnet mask, and Gateway address as required parameters. Example: OEMSEAddRouteTableEntry -OEMSEparams IPAddress=" ",SubnetMask=" ",Gateway=" " Syntax OEMSEAddRouteTableEntry [common_options] -OEMSEparams IPAddress="< value >",SubnetMask="< value >",Gateway="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress SubnetMask subnetmask Gateway ipaddress The IP address of the entry to be entered in the route table. The Subnet mask of the entry to be entered in the route table. The Gateway address of the entry to be entered in the route table. Optional Parameters Possible Error Messages Common Error Messages Invalid value, 38

38 5. OEMSE Commands 5.9. OEMSEDeleteRouteTableEntry 5.9. OEMSEDeleteRouteTableEntry Command OEMSEDeleteRouteTableEntry This command deletes entries from the route table of the BladeEngine iscsi initiator. The command can delete all entries in the route table or a specific entry. Specify the entry number to be deleted or enter an asterisk (*) to delete all entries. Example: OEMSEDeleteRouteTableEntry -OEMparams InstanceNumber="5" Syntax OEMSEDeleteRouteTableEntry [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string Specify the number of the route table entry to be deleted. To delete all entries from the route table, use an asterisk (*) in place of a route table entry number. Optional Parameters Possible Error Messages Common Error Messages 39

39 5. OEMSE Commands OEMSEAddARPTableEntry OEMSEAddARPTableEntry Command OEMSEAddARPTableEntry This command will add an entry into the ARP table of the BladeEngine iscsi Initiator. Syntax OEMSEAddARPTableEntry [common_options] -OEMSEparams IPAddress="< value >",MACAddress="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress IP address of the entry to be added to the ARP table. MACAddress string The MAC address of the entry to be added to the ARP table. Optional Parameters Possible Error Messages Common Error Messages Invalid value, 40

40 5. OEMSE Commands OEMSEDeleteARPTableEntry OEMSEDeleteARPTableEntry Command OEMSEDeleteARPTableEntry This command will delete the given ARP table entry. Syntax OEMSEDeleteARPTableEntry [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to an equivalent number and uses that as an instance number. Use an asterisk '*' in place of an instance number to indicate all instances. Optional Parameters Possible Error Messages Common Error Messages 41

41 5. OEMSE Commands OEMSEConfigureIPAddress OEMSEConfigureIPAddress Command OEMSEConfigureIPAddress This command is used to manually configure the IPAddress. Specify the mandatory options of the IPAddress and the SubnetMask to be configured for the Port. Example: OEMSEConfigureIPAddress -OEMSEparams IPAddress=" ",SubnetMask=" ". The command will fail if DHCP is enabled. To disable DHCP, use the OEMSEConfigureDHCP command with a mandatory parameter and value of EnableDHCP="False". Syntax OEMSEConfigureIPAddress [common_options] -OEMSEparams IPAddress="< value >",SubnetMask="< value >",[Gateway="< value >"],[VLANID="< value >"] [SM-CLPtarget] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IP Address to be configured for the port. SubnetMask subnetmask The Subnet mask to be configured for the port. Optional Parameters Parameter Name Data Type Min Max Default Gateway ipaddress The Default Gateway to be configured for the port. VLANID integer The VLANID to be configured for the port. Possible Error Messages Common Error Messages Invalid value, Failed to configure IP address as DHCP is Enabled. Please disable DHCP to configure IP address, The IP address settings for the BladeEngine iscsi initiator can not be modified when there is an active iscsi boot session. Please use the iscsiselect configuration utility to modify the IP address settings. No configuration changes were made to the BladeEngine 42

42 5. OEMSE Commands OEMSEConfigureDHCP iscsi initiator., Warning: An active boot session is present. TCP/IP configuration changes will take effect after next reboot., The IP address settings match the existing configuration. No changes have been made to the configuration., OEMSEConfigureDHCP Command OEMSEConfigureDHCP This command is used to enable or disable DHCP. Use the mandatory parameter EnableDHCP and specify the value True to enable DHCP or False to disable DHCP. Example: OEMSEConfigureDHCP -OEMSEparams EnableDHCP="True". When enabled, the command will obtain a new IPAddress, Subnetmask and Default Gateway. When disabled, the IPAddress, Subnetmask and Default Gateway are reset to all zeros. After disabling DHCP, the IPAddress can be manually configured using the OEMSEConfigureIPAddress command. Syntax OEMSEConfigureDHCP [common_options] -OEMSEparams EnableDHCP="< value >" [SM- CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default EnableDHCP list 4 5 False The mandatory parameter to configure DHCP settings. Optional Parameters Possible Error Messages Common Error Messages The IP address settings for the BladeEngine iscsi initiator can not be modified when there is an active iscsi boot session. Please use the iscsiselect configuration utility to modify the IP address settings. No configuration changes were made to the BladeEngine iscsi initiator., DHCP will be enabled after the next reboot., 43

43 5. OEMSE Commands OEMSERefreshNICConfig The DHCP settings match the existing configure. No changes have been made to the configuration., OEMSERefreshNICConfig Command OEMSERefreshNICConfig This command displays the current NIC configuration properties. Syntax OEMSERefreshNICConfig [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 44

44 5. OEMSE Commands OEMSEPing OEMSEPing Command OEMSEPing This command will send an ICMP ping request to the specified IPv4 address. Syntax OEMSEPing [common_options] -OEMSEparams IPAddress="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IPv4 address to which the ICMP ping request will be sent. Optional Parameters Possible Error Messages Common Error Messages Invalid value, 45

45 5. OEMSE Commands OEMSERefreshEventLog OEMSERefreshEventLog Command OEMSERefreshEventLog This command retrieves the current event log entries from the BladeEngine firmware. Syntax OEMSERefreshEventLog [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages Memory allocation failed, 46

46 5. OEMSE Commands OEMSEClearEventLog OEMSEClearEventLog Command OEMSEClearEventLog This command clears the event log entries stored in the BladeEngine firmware. All entries will be discarded and will not be available to view via SM-CLP. Syntax OEMSEClearEventLog [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages Memory allocation failed, 47

47 5. OEMSE Commands OEMSETestUnitReady OEMSETestUnitReady Command OEMSETestUnitReady This command enables protocol validation by issuing a Test Unit Ready to the LUN instance number input by the user for the target and reporting status back to the application. Syntax OEMSETestUnitReady [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 48

48 5. OEMSE Commands OEMSEStdInquiry OEMSEStdInquiry Command OEMSEStdInquiry This command is used for protocol validation by issuing Standard inquiry on the selected LUN instance and updates the VendorId and ProductId properties. Syntax OEMSEStdInquiry [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 49

49 5. OEMSE Commands OEMSEReadCapacity OEMSEReadCapacity Command OEMSEReadCapacity This command enables protocol validation by issuing a Read Capacity to the LUN instance number input by the user for the target and reporting the status back to the application. Syntax OEMSEReadCapacity [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 50

50 5. OEMSE Commands OEMSESCSIRead OEMSESCSIRead Command OEMSESCSIRead This command enables protocol validation by issuing SCSI READ commands to the LUN (device). Syntax OEMSESCSIRead [common_options] -OEMSEparams StartBlockAddress="< value >",Count="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default StartBlockAddress integer This parameter indicates the first block address from where to begin the SCSI Read/Write. Count integer This parameter accepts count of number of blocks to be transferred to the device. Optional Parameters Possible Error Messages Common Error Messages 51

51 5. OEMSE Commands OEMSESCSIWrite OEMSESCSIWrite Command OEMSESCSIWrite This command enables protocol validation by issuing SCSI WRITE commands to the LUN (device). Syntax OEMSESCSIWrite [common_options] -OEMSEparams StartBlockAddress="< value >",Count="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default StartBlockAddress integer This parameter indicates the first block address from where to begin the SCSI Read/Write. Count integer This parameter accepts count of number of blocks to be transferred to the device. Optional Parameters Possible Error Messages Common Error Messages 52

52 5. OEMSE Commands OEMSESetPersistent OEMSESetPersistent Command OEMSESetPersistent Execute this command to create a Persistent Login for the target. By setting a login as persistent, the connection will automatically be restored upon reboot. This action takes the following parameters: IP Address of the portal, Port number of the portal, Instance number of the BladeEngine controller (Physical HBA) and finally the instance number of the port (Logical HBA). Syntax OEMSESetPersistent [common_options] [-OEMSEparams] [IPAddress="< value >"],[PortNumber="< value >"],[PhysicalHBAInstanceNumber="< value >"],[LogicalHBAInstanceNumber="< value >"] [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Optional Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IP address of the target to be made persistent. PortNumber integer The Port number of the target to be made persistent. PhysicalHBAInstanceNumber integer A string input that gives the BladeEngine controller instance number. LogicalHBAInstanceNumber integer A string input that gives the logical HBA instance number. Note that each port of the controller is mapped to one logical HBA. Possible Error Messages Common Error Messages 53

53 5. OEMSE Commands OEMSELogin OEMSELogin Command OEMSELogin This action allows the initiator to login to a target with its current set of login parameters. This action takes the following parameters: IP Address of the portal, Port number of the portal, Instance number of the controller (Physical HBA), and finally the instance number of the port (Logical HBA). The last 2 parameters can be defaulted to the value of the 'DefaultIntrPort' property, which tells what initiator port number to use. The first 2 parameters can be defaulted to the value of the 'DefaultLoginPortal', which tells which portal under the Target will be logged into. Syntax OEMSELogin [common_options] [-OEMSEparams] [IPAddress="< value >"],[PortNumber="< value >"],[PhysicalHBAInstanceNumber="< value >"],[LogicalHBAInstanceNumber="< value >"],[SessionInitiatorName="< value >"] [SM- CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Optional Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IP address of the target portal to login. PortNumber integer The Port number of the target to login. PhysicalHBAInstanceNumber integer A string input that gives the BladeEngine controller instance number. LogicalHBAInstanceNumber integer A string input that gives the logical HBA instance number. Note that each port of the controller is mapped to one logical HBA. SessionInitiatorName string iqn.se The initiator iscsi Name for the session to login. Possible Error Messages 54

54 5. OEMSE Commands OEMSELogout Common Error Messages Setting ETO failed, The BladeEngine iscsi initiator TCP/IP settings are not configured. Please configure the TCP/IP settings before issuing this command., Error OEMSELogout Command OEMSELogout This action sends a Logout request to this target. SM-CLP will not allow logout of BootSessions. Syntax OEMSELogout [common_options] [-OEMSEparams] [InstanceNumber="< value >"] [SM- CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Optional Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to an equivalent number and uses that as an instance number. Specify an asterisk '*' instead of an instance number to indicate all instances. Possible Error Messages Common Error Messages 55

55 5. OEMSE Commands OEMSEDeletePersistent OEMSEDeletePersistent Command OEMSEDeletePersistent This command deletes the specified instance of the persistent Login or deletes all the persistent login's for the target if * is specified. Syntax OEMSEDeletePersistent [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to an equivalent number and uses that as an instance number. Specify an asterisk '*' instead of an instance number to indicate all instances. Optional Parameters Possible Error Messages Common Error Messages 56

56 5. OEMSE Commands OEMSEReScanLUNS OEMSEReScanLUNS Command OEMSEReScanLUNS This command reports the LUNs on the system. Syntax OEMSEReScanLUNS [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages No session available to this target, 57

57 5. OEMSE Commands OEMSEDiscoveryiSNSThruDHCP OEMSEDiscoveryiSNSThruDHCP Command OEMSEDiscoveryiSNSThruDHCP This command discovers any isns Servers through DHCP and adds isns entries (if any) to the target. Syntax OEMSEDiscoveryiSNSThruDHCP [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages 58

58 5. OEMSE Commands OEMSEAddiSNSEntry OEMSEAddiSNSEntry Command OEMSEAddiSNSEntry This command adds the given isns server to the BladeEngine controller. Specify the isns server IP Address as the first required option and the port number as the second. This command will return a successful message if communication with the specified isns server is completed. If not successful, check your network configuration. Example: OEMSEAddiSNSEntry -OEMSEparams IPAddress=" ",PortNum="3205" Syntax OEMSEAddiSNSEntry [common_options] -OEMSEparams IPAddress="< value >",PortNum="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IP address of the server to be added into the table. The isns server table will be used by the firmware for discovering targets. PortNum integer The Port number of the isns server. Optional Parameters Possible Error Messages Common Error Messages Invalid value, 59

59 5. OEMSE Commands OEMSEDeleteiSNSEntry OEMSEDeleteiSNSEntry Command OEMSEDeleteiSNSEntry This command deletes the isns server entry to the BladeEngine controller specified as the argument. Specify * to delete all the isns server entries from the BladeEngine controller. Example: OEMSEDeleteiSNSEntry -OEMSEparams InstanceNumber="1" Syntax OEMSEDeleteiSNSEntry [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to equivalent number and use that as instance number. Specify an asterisk '*' instead of an instance number to indicate all instances. Optional Parameters Possible Error Messages Common Error Messages 60

60 5. OEMSE Commands OEMSEDiscoverTargets OEMSEDiscoverTargets Command OEMSEDiscoverTargets The command is used to initiate discovery sessions. A discovery login will be sent to the IP address and port number specified in the OEMSEAddSendTargetPortal command. If discovery is successful, the iscsi target will return its iscsi name, allowing login just as a manually configured target. To login to the target, issue the command OEMSELogin in the newly created Target group. This group is found in the /LogicalHBA(x)/iSCSI group. Syntax OEMSEDiscoverTargets [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages The BladeEngine iscsi initiator TCP/IP settings are not configured. Please configure the TCP/IP settings before issuing this command., 61

61 5. OEMSE Commands OEMSEAddSendTargetPortal OEMSEAddSendTargetPortal Command OEMSEAddSendTargetPortal This command creates a SendTarget Portal. The iscsi Sendtargets mechanism is used to discover a target name using the IP address and port number of the target. Specify the IP address of the target portal as the first required option, and the target port number as the second. Example: OEMSEAddSendTargetPortal -OEMSEparams IPAddress=" ",PortNum="3205". After the Sendtarget portal is created, cd into the newly created Sendtargetportal group and issue the command: OEMSEDiscoverTargets. This will issue the Discovery login. If successful, the target will return it's iscsi name, allowing login just as with a manually configured target. Syntax OEMSEAddSendTargetPortal [common_options] -OEMSEparams IPAddress="< value >",PortNumber="< value >",[PortIdentifier="< value >"] [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default IPAddress ipaddress The IP address of the sendtarget portal. PortNumber integer The Port Number of the SendTargetPortal. Optional Parameters Parameter Name Data Type Min Max Default PortIdentifier integer A unique port identifier of the Initiator from which you can perform sendtargets discovery. The default value is 0. Possible Error Messages Common Error Messages 62

62 5. OEMSE Commands OEMSEDeleteSendTargetPortal OEMSEDeleteSendTargetPortal Command OEMSEDeleteSendTargetPortal This command deletes the specified SendTarget Portal from the BladeEngine controller. Specify * to delete all the SendTarget Portals. Example: OEMSEDeleteSendTargetPortal - OEMSEparams InstanceNumber="3" Syntax OEMSEDeleteSendTargetPortal [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to equivalent number and use that as instance number. Specify an asterisk '*' instead of an instance number to indicate all instances. Optional Parameters Possible Error Messages Common Error Messages 63

63 5. OEMSE Commands OEMSERefreshAvailableTargets OEMSERefreshAvailableTargets Command OEMSERefreshAvailableTargets This command performs a rescan and detects any newly discovered targets. You can view the updated list of targets present by executing the show command. The target groups (if manually added or discovered) are found under the /LogicalHBA(x)/iSCSI group. Syntax OEMSERefreshAvailableTargets [common_options] [SM-CLP-target] Options [common_options] Parameter SM-CLPtarget Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. Required Parameters Optional Parameters Possible Error Messages Common Error Messages Memory allocation failed, The BladeEngine iscsi initiator TCP/IP settings are not configured. Please configure the TCP/IP settings before issuing this command., 64

64 5. OEMSE Commands OEMSEAddTarget OEMSEAddTarget Command OEMSEAddTarget This command adds a target manually to the list of targets for the initiator. Specify the iscsi name, IP Address, and Port number for the target. Example: OEMSEAddTarget - OEMSEparams TargetName="iqn com.serverengines:tgt1",IPAddress=" ",PortNumber="3205" Syntax OEMSEAddTarget [common_options] -OEMSEparams TargetName="< value >",IPAddress="< value >",PortNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default TargetName string Fully qualified iscsi name of the target to be added. Adding target will not login. An explicit login has to be done on this target. IPAddress ipaddress The IP address of the target to be added. PortNumber integer The Port number of the target to be added. Optional Parameters Possible Error Messages Common Error Messages 65

65 5. OEMSE Commands OEMSEDeleteTarget OEMSEDeleteTarget Command OEMSEDeleteTarget Use this command to manually delete a target from the list of targets. Syntax OEMSEDeleteTarget [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target] Options [common_options] Parameter SM-CLP-target - OEMSEParams Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group. takes in additional parameters as arguments as listed below in the Parameters table of this section. The parameters has to be entered in a key=value format. Required Parameters Parameter Name Data Type Min Max Default InstanceNumber string This parameter accepts string input and converts it to an equivalent number and uses that as an instance number. Specify an asterisk '*' instead of an instance number to indicate all instances. Optional Parameters Possible Error Messages Common Error Messages 66

66 6. Appendix 6.1. MILI_Groups 6. Appendix 6.1. MILI_Groups This chapter contains all the groups map for Storage Blade. Each group is described in a table with a brief description and its identification name (refered to as "StringIdentifier), (access permissions), Multi-instance (yes or no) along with its adjacent groups, properties and OEMSECommands ROOT Group MultiInstance MaxInstance Subgroups ROOT Root Group static No N/A ROOT 1. BladeEngine 2. LogicalHBA Properties for the group OEMSECommands for the group Table 3: ROOT BladeEngine BladeEngine Group This group instance corresponds to a single BladeEngine controller in this host. dynamic MultiInstance Yes MaxInstance 8 ROOT Subgroups 1. Manufacturer 2. ModelNumber SerialNumber 5. ActiveFirmwareVersion 6. FirmwareVersionOnFlash 7. BIOSVersion 8. BootCodeVersion Properties for the group 9. FirmwareStatus 10. iscsiversionmin 11. iscsiversionmax 12. MaxCDBLength 13. MaxMTUSize 14. LDTO 15. DefaultETO 16. VLDCapable 17. VLDEnabled OEMSECommands for the group 1. OEMSEEraseConfiguration 67

67 6. Appendix 6.1. MILI_Groups 2. OEMSEUpgradeFlashROM Table 4: BladeEngine LogicalHBA LogicalHBA Group This group instance corresponds to a single port of a BladeEngine controller functioning as an iscsi Initiator. dynamic MultiInstance Yes MaxInstance 32 ROOT Subgroups 1. iscsi Properties for the group OEMSECommands for the group 1. OEMSEEnableiSCSI 2. OEMSEDisableiSCSI Table 5: LogicalHBA NIC Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group NIC This group contains the properties of the NIC interface for this domain of BladeEngine Controller. It allows the user to create virtual interfaces and configure the NIC QoS parameters. static No N/A LogicalHBA Table 6: NIC PhysicalHBA PhysicalHBA Group PhysicalHBA group that corresponds to NIC for this domain. dynamic MultiInstance Yes MaxInstance 8 NIC Subgroups Properties for the group OEMSECommands for the group Table 7: PhysicalHBA 68

68 6. Appendix 6.1. MILI_Groups 69

69 6. Appendix 6.1. MILI_Groups PCI Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group PCI This group contains the PCI properties of the BladeEngine controller. static No N/A PhysicalHBA Table 8: PCI Driver Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group Driver This group corresponds to information about the iscsi initiator driver. static No N/A PhysicalHBA Table 9: Driver QOS Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group QOS TBD group static No N/A PhysicalHBA Table 10: QOS 70

70 6. Appendix 6.1. MILI_Groups iscsi Group MultiInstance MaxInstance Subgroups iscsi This represents an iscsi initiator node and is uniquely identified by its iscsi name (IQN name). static No N/A LogicalHBA 1. InitiatoriSCSIName 2. InitiatorDefaultLoginOptions 3. InitiatorLoginOptions 4. PhysicalHBA 5. Target 6. Discovery Properties for the group OEMSECommands for the group 1. OEMSEAddTarget 2. OEMSEDeleteTarget Table 11: iscsi InitiatoriSCSIName Group MultiInstance MaxInstance Subgroups Properties for the group InitiatoriSCSIName This group contains iscsi name configuration details for the initiator node. static No N/A iscsi 1. InitiatoriSCSIName 2. InitiatorAlias 3. DefaultiSCSIName OEMSECommands for the group Table 12: InitiatoriSCSIName 71

71 6. Appendix 6.1. MILI_Groups InitiatorDefaultLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group InitiatorDefaultLoginOptions This group contains the default login options for the iscsi initiator node. static No N/A iscsi 1. InitialR2T 2. ImmediateData 3. MaxConnections 4. MaxOutstandingR2T 5. FirstBurstLength 6. MaxBurstLength 7. DefaultTime2Wait 8. DefaultTime2Retain 9. ErrorRecoveryLevel 10. DataPDUInOrder 11. DataSequenceInOrder 12. HeaderDigest 13. DataDigest 14. MaxRecvDataSegmentLength 15. TCPWindowSize OEMSECommands for the group Table 13: InitiatorDefaultLoginOptions InitiatorLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group InitiatorLoginOptions This group contains the configured login options for the iscsi Initiator node. static No N/A iscsi 1. Authentication 1. InitialR2T 2. ImmediateData 3. HeaderDigest 4. DataDigest OEMSECommands for the group Table 14: InitiatorLoginOptions 72

72 6. Appendix 6.1. MILI_Groups Authentication Group MultiInstance MaxInstance Subgroups Properties for the group Authentication This group contains the configured connection authentication related login options for the iscsi Initiator node. static No N/A InitiatorLoginOptions 1. AuthenticationMethod 2. InitiatorCHAPName 3. InitiatorSecret 4. TargetCHAPName 5. TargetSecret OEMSECommands for the group Table 15: Authentication PhysicalHBA PhysicalHBA Group This represents properties of the BladeEngine controller instance under this domain. dynamic MultiInstance Yes MaxInstance 8 iscsi 1. RouteTable 2. ARPTable 3. PCI Subgroups 4. Driver 5. Network 6. EventLog 7. SNMP Properties for the group OEMSECommands for the group 1. OEMSEPing Table 16: PhysicalHBA RouteTable Group MultiInstance MaxInstance Subgroups RouteTable This group contains the route table entries for the BladeEngine iscsi initiator firmware. static No N/A PhysicalHBA 1. RouteTableEntry 73

73 6. Appendix 6.1. MILI_Groups Properties for the group OEMSECommands for the group 1. OEMSEAddRouteTableEntry 2. OEMSEDeleteRouteTableEntry Table 17: RouteTable RouteTableEntry RouteTableEntry Group A route table entry in the BladeEngine iscsi initiator firmware. dynamic MultiInstance Yes MaxInstance 16 RouteTable Subgroups 1. IPAddress Properties for the group 2. SubnetMask 3. Gateway OEMSECommands for the group Table 18: RouteTableEntry ARPTable Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group ARPTable This group contains the ARP table entries for the BladeEngine iscsi initiator firmware. static No N/A PhysicalHBA 1. ARPTableEntry 1. OEMSEAddARPTableEntry 2. OEMSEDeleteARPTableEntry Table 19: ARPTable ARPTableEntry ARPTableEntry Group This group instance corresponds to a ARP Table Entry for the BladeEngine iscsi initiator firmware. dynamic MultiInstance Yes MaxInstance 64 ARPTable Subgroups Properties for the group 1. IPAddress 74

74 6. Appendix 6.1. MILI_Groups 2. MACAddress OEMSECommands for the group Table 20: ARPTableEntry 75

75 6. Appendix 6.1. MILI_Groups PCI Group MultiInstance MaxInstance Subgroups Properties for the group PCI This group contains the PCI properties for the BladeEngine controller. static No N/A PhysicalHBA 1. VendorID 2. DeviceID 3. SubsysDeviceID 4. SubsysVendorID 5. BusNumber 6. DeviceNumber 7. FunctionNumber OEMSECommands for the group Table 21: PCI Driver Group MultiInstance MaxInstance Subgroups Properties for the group Driver This group contains information about the host operating system's BladeEngine iscsi initiator driver. static No N/A PhysicalHBA 1. DriverName 2. DriverVersion OEMSECommands for the group Table 22: Driver 76

76 6. Appendix 6.1. MILI_Groups Network Group MultiInstance MaxInstance Subgroups Network This group consists of the TCP/NIC configuration of the Network Port static No N/A PhysicalHBA 1. DHCP 2. TCPIPConfiguration 3. NICConfiguration 4. QOS Properties for the group 1. PortRowStatus 2. PortalRole 3. PortalProtocol 4. PortalTag OEMSECommands for the group Table 23: Network DHCP Group MultiInstance MaxInstance Subgroups Properties for the group DHCP This group contains the DHCP settings and related actions static No N/A Network 1. DHCPServerAvailable 2. DHCPObtainNewIPAddress OEMSECommands for the group Table 24: DHCP 77

77 6. Appendix 6.1. MILI_Groups TCPIPConfiguration Group MultiInstance MaxInstance Subgroups Properties for the group TCPIPConfiguration This group consists of the TCP configuration of the Network port. static No N/A Network 1. DHCPEnabled 2. InitiatorIPAddress 3. InitiatorSubnetMask 4. DefaultGateway 5. IPVersionSupported 6. VLANID OEMSECommands for the group 1. OEMSEConfigureIPAddress 2. OEMSEConfigureDHCP Table 25: TCPIPConfiguration NICConfiguration Group MultiInstance MaxInstance Subgroups Properties for the group NICConfiguration This group consists of the NIC configuration of the Network port static No N/A Network 1. PortSpeed 2. PortMaxSpeed 3. MaxFrameSize 4. LinkStatus 5. ActivePort 6. MACAddress OEMSECommands for the group 1. OEMSERefreshNICConfig Table 26: NICConfiguration QOS QOS Group This group contains the properties of QoS. static MultiInstance No MaxInstance N/A Network Subgroups Properties for the group 1. MaxBytesPerSecondPeriSCSI 78

78 6. Appendix 6.1. MILI_Groups 2. MaxIosPerSecondPeriSCSI OEMSECommands for the group Table 27: QOS EventLog Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group EventLog This group contains the BladeEngine firmware event log entries and actions. static No N/A PhysicalHBA 1. EventLogEntry 1. OEMSERefreshEventLog 2. OEMSEClearEventLog Table 28: EventLog EventLogEntry EventLogEntry Group An event log entry from the BladeEngine firmware. dynamic MultiInstance Yes MaxInstance 1024 EventLog Subgroups 1. SequenceNumber 2. TimeStamp Properties for the group 3. Severity ErrorCode OEMSECommands for the group Table 29: EventLogEntry 79

79 6. Appendix 6.1. MILI_Groups SNMP Group MultiInstance MaxInstance Subgroups Properties for the group SNMP This group contains all the SNMP properties. static No N/A PhysicalHBA 1. NodeRoles 2. PortalCount 3. NodeCount 4. SessionCount 5. SessionFailureCount 6. LastSessionFailureType 7. LastSessionRmtNodeName 8. SessionDigestErrors 9. SessionConnectionTimeout 10. SessionFormatErrors 11. LoginFailures 12. LastFailureTime 13. LastFailureType 14. LastTgtFailureName 15. LastTgtFailureAddr 16. LoginAcceptRsps 17. LoginOtherFailRsps 18. LoginRedirectRsps 19. LoginAuthFailRsps 20. LoginAuthFails 21. LoginNegoFails 22. LogoutNormals 23. LogoutOthers OEMSECommands for the group Table 30: SNMP 80

80 6. Appendix 6.1. MILI_Groups Target Target Group This group represents the information about the targets that are available in the network. dynamic MultiInstance Yes MaxInstance 64 iscsi 1. TargetPortal 2. TargetLoginOptions Subgroups 3. Session 4. LUN 5. PersistentLogin Properties for the group 1. ETO 2. TargetISCSIName 3. TargetAlias 4. DefaultLoginPortal 5. DefaultIntrPort OEMSECommands for the group 1. OEMSESetPersistent 2. OEMSELogin 3. OEMSELogout 4. OEMSEDeletePersistent 5. OEMSEReScanLUNS Table 31: Target TargetPortal TargetPortal Group This group instance corresponds to a portal of the target identified by its IP address and port number. dynamic MultiInstance Yes MaxInstance 64 Target Subgroups 1. TargetIPAddress Properties for the group 2. TargetPortNumber 3. PortalGroupTag OEMSECommands for the group Table 32: TargetPortal 81

81 6. Appendix 6.1. MILI_Groups TargetLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group TargetLoginOptions This group consists of the set of login options used to login to the target. static No N/A Target 1. Authentication 1. InitialR2T 2. ImmediateData 3. HeaderDigest 4. DataDigest OEMSECommands for the group Table 33: TargetLoginOptions Authentication Group MultiInstance MaxInstance Subgroups Properties for the group Authentication This group consists of the set of connection authentication related login options used to create an iscsi session with the target. static No N/A TargetLoginOptions 1. AuthenticationMethod 2. InitiatorCHAPName 3. InitiatorSecret 4. TargetCHAPName 5. TargetSecret OEMSECommands for the group Table 34: Authentication 82

82 6. Appendix 6.1. MILI_Groups Session Session Group This group instance corresponds to an active session with the target. dynamic MultiInstance Yes MaxInstance 64 Target 1. SessionNegotiatedLoginOptions Subgroups 2. SNMP 3. Connection Properties for the group 1. SessionTSIH 2. SessionISID 3. SessionInitiatorName 4. SessionStatus 5. iscsiboot OEMSECommands for the group Table 35: Session SessionNegotiatedLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group SessionNegotiatedLoginOptions This group stores the negotiated login options when the session was created. static No N/A Session 1. InitialR2T 2. ImmediateData 3. MaxConnections 4. MaxOutstandingR2T 5. FirstBurstLength 6. MaxBurstLength 7. DefaultTime2Wait 8. DefaultTime2Retain 9. ErrorRecoveryLevel 10. DataPDUInOrder 11. DataSeqInOrder OEMSECommands for the group Table 36: SessionNegotiatedLoginOptions 83

83 6. Appendix 6.1. MILI_Groups SNMP Group MultiInstance MaxInstance Subgroups Properties for the group SNMP This group instance corresponds to the SNMP properties under this particular session. static No N/A Session 1. SessionDirection 2. CmdPdus 3. RspPdus 4. TxDataOctetsHigh 5. RxDataOctetsHigh 6. DigestErrors 7. CxnTimeoutErrors 8. SessionTargetAlias OEMSECommands for the group Table 37: SNMP Connection Connection Group This group instance corresponds to a connection for a session. A session can have a maximum of four connections. dynamic MultiInstance Yes MaxInstance 4 Session Subgroups 1. ConnectionNegotiatedLoginOptions Properties for the group 1. iscsiconnectionid 2. Status 3. SourcePortNumber 4. DestinationPortNumber 5. SourceIPAddress 6. DestinationIPAddress 7. RedirectedDestinationPort 8. RedirectedDestinationIPAddress OEMSECommands for the group Table 38: Connection 84

84 6. Appendix 6.1. MILI_Groups ConnectionNegotiatedLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group ConnectionNegotiatedLoginOptions This group consists of the negotiated connection login options. static No N/A Connection 1. AuthenticationMethod 2. HeaderDigest 3. DataDigest 4. MaxRecvDataSegmentLength 5. TCPWindowSize 6. TCPMSS OEMSECommands for the group Table 39: ConnectionNegotiatedLoginOptions LUN LUN Group This group instance corresponds to a LUN available behind this target. dynamic MultiInstance Yes MaxInstance 512 Target Subgroups 1. LUNNumber 2. LUNSize Properties for the group 3. DeviceVendorName 4. DeviceModelNumber OEMSECommands for the group 1. OEMSETestUnitReady 2. OEMSEStdInquiry 3. OEMSEReadCapacity 4. OEMSESCSIRead 5. OEMSESCSIWrite Table 40: LUN 85

85 6. Appendix 6.1. MILI_Groups PersistentLogin PersistentLogin Group This group instance corresponds to persistent login information for the target. dynamic MultiInstance Yes MaxInstance 128 Target 1. PersistentLoginPortal Subgroups 2. PersistentLoginOptions Properties for the group 1. PortIdentifier 2. iscsiboot 3. TargetName OEMSECommands for the group Table 41: PersistentLogin PersistentLoginPortal Group MultiInstance MaxInstance Subgroups Properties for the group PersistentLoginPortal This group instance stores information about the portal involved in the leading connection with the target. static No N/A PersistentLogin 1. IPAddress 2. PortNumber OEMSECommands for the group Table 42: PersistentLoginPortal PersistentLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group PersistentLoginOptions This group instance stores the login options to be used to create a persistent session with this target. static No N/A PersistentLogin 1. Authentication 1. InitialR2T 2. ImmediateData OEMSECommands for the 86

86 6. Appendix 6.1. MILI_Groups group Table 43: PersistentLoginOptions Authentication Group MultiInstance MaxInstance Subgroups Properties for the group Authentication This group consists of the set of connection authentication related login options used to create a iscsi session with the persistent session. static No N/A PersistentLoginOptions 1. AuthenticationMethod 2. InitiatorCHAPName 3. InitiatorSecret 4. TargetCHAPName 5. TargetSecret OEMSECommands for the group Table 44: Authentication Discovery Group MultiInstance MaxInstance Subgroups Discovery This group stores the discovery parameters configured for the Initiator node. static No N/A iscsi 1. SLP 2. isns 3. SendTargetPortal Properties for the group 1. SLPEnabled 2. isnsenabled 3. DefaultInitiatorPort OEMSECommands for the group 1. OEMSEAddSendTargetPortal 2. OEMSEDeleteSendTargetPortal 3. OEMSERefreshAvailableTargets Table 45: Discovery SLP Group MultiInstance SLP This group stores the SLP discovery parameters static No 87

87 6. Appendix 6.1. MILI_Groups MaxInstance Subgroups Properties for the group N/A Discovery 1. SlpScopes 2. SlpQueryList OEMSECommands for the group Table 46: SLP isns Group MultiInstance MaxInstance Subgroups Properties for the group OEMSECommands for the group isns This group stores the isns discovery parameters. static No N/A Discovery 1. isnsentry 1. OEMSEDiscoveryiSNSThruDHCP 2. OEMSEAddiSNSEntry 3. OEMSEDeleteiSNSEntry Table 47: isns isnsentry isnsentry Group This group instance corresponds to an isns Server entry. dynamic MultiInstance Yes MaxInstance 4 isns Subgroups 1. IPAddress Properties for the group 2. PortNumber OEMSECommands for the group Table 48: isnsentry SendTargetPortal SendTargetPortal Group This group instance corresponds to a SendTarget Portal for discovering targets. dynamic MultiInstance Yes MaxInstance 10 Discovery 88

88 6. Appendix 6.1. MILI_Groups Subgroups Properties for the group 1. SendTargetPortalLoginOptions 1. IPAddress 2. PortNumber 3. PortIdentifier 4. PortMacAddress OEMSECommands for the group 1. OEMSEDiscoverTargets Table 49: SendTargetPortal SendTargetPortalLoginOptions Group MultiInstance MaxInstance Subgroups Properties for the group SendTargetPortalLoginOptions This group consists of the login options used to create a discovery session with the SendTarget Portal. static No N/A SendTargetPortal 1. Authentication 1. InitialR2T 2. ImmediateData 3. HeaderDigest 4. DataDigest OEMSECommands for the group Table 50: SendTargetPortalLoginOptions Authentication Group MultiInstance MaxInstance Subgroups Properties for the group Authentication This group consists of the authentication options used to create a discovery session with the SendTarget Portal. static No N/A SendTargetPortalLoginOptions 1. InitiatorCHAPName 2. InitiatorSecret 3. TargetCHAPName 4. TargetSecret 5. AuthenticationMethod OEMSECommands for the group Table 51: Authentication 89

89 6. Appendix 6.2. MILI_Properties 6.2. MILI_Properties This chapter contains all the properties in all the groups of Storage Blade. Each property is described in a table with a brief description and its identification name (refered to as "StringIdentifier), (access permissions), Min/Max/Default values and its parent group Manufacturer Manufacturer The manufacturer of the BladeEngine controller. max Value 32 default Value 0 BladeEngine Table 52: Manufacturer ModelNumber ModelNumber The model number of the BladeEngine controller. min Value 1 max Value 32 default Value 1 BladeEngine Table 53: ModelNumber of the BladeEngine controller. max Value 64 default Value 0 BladeEngine Table 54: SerialNumber min Value 1 max Value 32 default Value 1 SerialNumber The serial number of the BladeEngine controller. The serial number is typically one of the MAC addresses assocated with BladeEngine. 90

90 6. Appendix 6.2. MILI_Properties BladeEngine Table 55: SerialNumber ActiveFirmwareVersion min Value 5 max Value 32 default Value 5 BladeEngine ActiveFirmwareVersion The firmware version which is currently operational on the BladeEngine controller. Table 56: ActiveFirmwareVersion 91

91 6. Appendix 6.2. MILI_Properties FirmwareVersionOnFlash min Value 5 max Value 32 default Value 5 BladeEngine FirmwareVersionOnFlash The firmware version stored on BladeEngine's non-volatile storage. The next time the system restarts, this version will become the active firmware version. Table 57: FirmwareVersionOnFlash BIOSVersion BIOSVersion The BIOS version which is currently operational on the BladeEngine controller. min Value 5 max Value 32 default Value 5 BladeEngine Table 58: BIOSVersion BootCodeVersion BootCodeVersion The boot code version which is currently operational on the BladeEngine controller. min Value 5 max Value 32 default Value 5 BladeEngine Table 59: BootCodeVersion FirmwareStatus FirmwareStatus This property indicates the status of the BladeEngine firmware. This field will return Ready if the firmware is in a properly operating state. max Value 3 default Value 2 BladeEngine Table 60: FirmwareStatus 92

92 6. Appendix 6.2. MILI_Properties iscsiversionmin min Value 1 max Value 3 default Value 1 BladeEngine iscsiversionmin This field corresponds to the iscsi RFC 3720 field iscsiversionmin. A value of 1 for this property indicates support for the RFC3720 specification. Table 61: iscsiversionmin iscsiversionmax min Value 1 max Value 3 default Value 1 BladeEngine iscsiversionmax This field corresponds to the iscsi RFC 3720 field iscsiversionmax. A value of 1 for this property indicates support for the RFC3720 specification. Table 62: iscsiversionmax MaxCDBLength MaxCDBLength This property indicates the maximum CDB length supported by this BladeEngine controller. max Value 16 default Value 16 BladeEngine Table 63: MaxCDBLength MaxMTUSize MaxMTUSize This property shows the maximum MTU supported for both iscsi and NIC/TOE traffic for this BladeEngine controller. max Value 8342 default Value 0 BladeEngine 93

93 6. Appendix 6.2. MILI_Properties Table 64: MaxMTUSize 94

94 6. Appendix 6.2. MILI_Properties LDTO String Identifier LDTO max Value 8342 default Value -1 BladeEngine This property corresponds to the Link Down Time Out (LDTO) value for this BladeEngine controller. The LDTO specifies the amount of time in seconds that BladeEngine iscsi drivers will delay reporting an error to the operating system. Table 65: LDTO DefaultETO DefaultETO This property corresponds to the Default Extended Time Out (ETO) value for this BladeEngine controller. max Value default Value -1 BladeEngine Table 66: DefaultETO VLDCapable String Identifier VLDCapable min Value 1 max Value 4 default Value No BladeEngine VLD is the Virtual Link Down (VLD) feature for BladeEngine. This property indicates if this BladeEngine controller includes the VLD feature. If this property is set to No, then VLD cannot be enabled. Table 67: VLDCapable 95

95 6. Appendix 6.2. MILI_Properties VLDEnabled String Identifier VLDEnabled min Value 2 max Value 3 default Value No BladeEngine VLD is the Virtual Link Down (VLD) feature for BladeEngine. Use this property to enable or disable VLD for this BladeEngine controller using the set command. Valid values are Yes and No. To enable, set the value to Yes. The default is No. Read-Write Table 68: VLDEnabled VendorID VendorID The PCI Vendor ID. min Value 1 max Value 255 default Value 1 PCI Table 69: VendorID DeviceID DeviceID This property displays the PCI Device ID. min Value 1 max Value 255 default Value 1 PCI Table 70: DeviceID SubsysDeviceID SubsysDeviceID The PCI Subsystem Device ID. min Value 1 max Value 255 default Value 1 PCI Table 71: SubsysDeviceID 96

96 6. Appendix 6.2. MILI_Properties SubsysVendorID SubsysVendorID This property displays the PCI Subsystem Vendor ID. min Value 1 max Value 255 default Value 1 PCI Table 72: SubsysVendorID BusNumber BusNumber This property displays the PCI Bus Number. max Value 255 default Value 0 PCI Table 73: BusNumber DeviceNumber DeviceNumber This property displays the PCI Device Number. max Value 32 default Value 0 PCI Table 74: DeviceNumber FunctionNumber FunctionNumber This property displays the PCI Function number for the NIC function. max Value 8 default Value 0 PCI Table 75: FunctionNumber 97

97 6. Appendix 6.2. MILI_Properties DriverName DriverName This property displays the name of the driver. min Value 2 max Value 10 default Value BENIC Driver Table 76: DriverName DriverVersion DriverVersion This property displays the current version of the driver. min Value 2 max Value 6 default Value 2 Driver Table 77: DriverVersion IfName IfName This property displays the Interface name string for this virtual NIC interface. min Value 1 max Value 32 default Value 1 PhysicalHBA Table 78: IfName MACAddress MACAddress This property displays the MAC address for this virtual NIC interface. Read-Write min Value 17 max Value 17 default Value PhysicalHBA Table 79: MACAddress 98

98 6. Appendix 6.2. MILI_Properties MaxBitsPerSecond max Value 255 default Value 1 QOS MaxBitsPerSecond MaxBitsPerSecond number for this virtual NIC interface. The number 'n' indicates 'n*10mbps' throughput on this interface. Read-Write Table 80: MaxBitsPerSecond MaxPacketsPerSecondPerNIC String Identifier max Value 255 default Value 1 QOS MaxPacketsPerSecondPerNIC Maximum number of packets per second of NIC traffic allowed for this domain specified in 1Kpps multiples. A value of 0 indicates no QOS was set and allows all available bandwidth for this domain. Read-Write Table 81: MaxPacketsPerSecondPerNIC InitiatoriSCSIName String Identifier InitiatoriSCSIName The iscsi name (IQN or iscsi Qualified Name) configured for the initiator node. This name is used to identify the Initiator (to an iscsi target, for example). Use this property to set the desired iscsi name for this Initiator using the set command. For example; set InitiatoriSCSIName="iqn com.serverengines;init1". Read-Write min Value 1 max Value 224 default Value iqn.se InitiatoriSCSIName Table 82: InitiatoriSCSIName 99

99 6. Appendix 6.2. MILI_Properties InitiatorAlias String Identifier InitiatorAlias The initiator alias allows an organization to associate a user-friendly name with the iscsi Name (IQN or iscsi Qualified Name) of the Initiator. Use this property to set the desired iscsi alias for this Initiator using the set command. For example; set InitiatorAlias="init1". Read-Write max Value 32 default Value se InitiatoriSCSIName Table 83: InitiatorAlias DefaultiSCSIName DefaultiSCSIName The default iscsi name (IQN name) specified for the initiator node. min Value 1 max Value 224 default Value iqn com.serverengines InitiatoriSCSIName Table 84: DefaultiSCSIName InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. max Value 3 default Value Yes InitiatorDefaultLoginOptions Table 85: InitialR2T ImmediateData max Value 3 default Value Yes ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. 100

100 6. Appendix 6.2. MILI_Properties InitiatorDefaultLoginOptions Table 86: ImmediateData MaxConnections MaxConnections The iscsi Login Parameter for the Target. min Value 1 max Value 1 default Value 1 InitiatorDefaultLoginOptions Table 87: MaxConnections MaxOutstandingR2T MaxOutstandingR2T The iscsi Login Parameter for the Target. min Value 1 max Value 255 default Value 1 InitiatorDefaultLoginOptions Table 88: MaxOutstandingR2T FirstBurstLength FirstBurstLength The iscsi Login Parameter for the Target. max Value 8192 default Value 8192 InitiatorDefaultLoginOptions Table 89: FirstBurstLength MaxBurstLength MaxBurstLength The iscsi Login Parameter for the Target. max Value default Value InitiatorDefaultLoginOptions Table 90: MaxBurstLength 101

101 6. Appendix 6.2. MILI_Properties 102

102 6. Appendix 6.2. MILI_Properties DefaultTime2Wait DefaultTime2Wait The iscsi Login Parameter for the Target. max Value 2 default Value 2 InitiatorDefaultLoginOptions Table 91: DefaultTime2Wait DefaultTime2Retain DefaultTime2Retain The iscsi Login Parameter for the Target. max Value 20 default Value 20 InitiatorDefaultLoginOptions Table 92: DefaultTime2Retain ErrorRecoveryLevel ErrorRecoveryLevel The iscsi Login Parameter for the Target. max Value 255 default Value 0 InitiatorDefaultLoginOptions Table 93: ErrorRecoveryLevel DataPDUInOrder DataPDUInOrder The iscsi Login Parameter for the Target. max Value 1 default Value 1 InitiatorDefaultLoginOptions Table 94: DataPDUInOrder 103

103 6. Appendix 6.2. MILI_Properties DataSequenceInOrder DataSequenceInOrder The iscsi Login Parameter for the Target. max Value 1 default Value 1 InitiatorDefaultLoginOptions Table 95: DataSequenceInOrder HeaderDigest String Identifier HeaderDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's header segments will be protected by a CRC32C checksum. The default is. min Value 4 max Value 6 default Value InitiatorDefaultLoginOptions Table 96: HeaderDigest DataDigest String Identifier DataDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's data segment will be protected by a CRC32C checksum. The default is. min Value 4 max Value 6 default Value InitiatorDefaultLoginOptions Table 97: DataDigest MaxRecvDataSegmentLength MaxRecvDataSegmentLength The iscsi Login Parameter for the Target. max Value default Value InitiatorDefaultLoginOptions 104

104 6. Appendix 6.2. MILI_Properties Table 98: MaxRecvDataSegmentLength 105

105 6. Appendix 6.2. MILI_Properties TCPWindowSize TCPWindowSize The iscsi Login Parameter for the Target. min Value 16 max Value 255 default Value InitiatorDefaultLoginOptions Table 99: TCPWindowSize InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. Read-Write max Value 3 default Value Yes InitiatorLoginOptions Table 100: InitialR2T ImmediateData ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. Read-Write max Value 3 default Value Yes InitiatorLoginOptions Table 101: ImmediateData AuthenticationMethod min Value 4 max Value 12 default Value Authentication AuthenticationMethod Use this property to specify an authentication method using the set command. Valid CHAP values are, Mutual CHAP, and One-Way CHAP. is the default. Read-Write 106

106 6. Appendix 6.2. MILI_Properties Table 102: AuthenticationMethod 107

107 6. Appendix 6.2. MILI_Properties InitiatorCHAPName String Identifier InitiatorCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This parameter is optional and only required for Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the InitiatorCHAPName. The InitiatorCHAPName can be any name or sequence of numbers. Read-Write Table 103: InitiatorCHAPName InitiatorSecret String Identifier InitiatorSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is an optional parameter and only required for Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the InitiatorSecret. The InitiatorSecret can be any name or sequence of numbers. Read-Write Table 104: InitiatorSecret TargetCHAPName String Identifier TargetCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the Target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the TargetCHAPName. The TargetCHAPName can be any name or sequence of numbers. Read-Write Table 105: TargetCHAPName 108

108 6. Appendix 6.2. MILI_Properties TargetSecret String Identifier TargetSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the TargetSecret. The TargetSecret can be any name or sequence of numbers. Read-Write Table 106: TargetSecret HeaderDigest String Identifier HeaderDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's header segments will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value InitiatorLoginOptions Table 107: HeaderDigest DataDigest String Identifier DataDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's data segment will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value InitiatorLoginOptions Table 108: DataDigest 109

109 6. Appendix 6.2. MILI_Properties IPAddress IPAddress The destination IP Address of the route table entry. max Value 16 default Value RouteTableEntry Table 109: IPAddress SubnetMask SubnetMask The Subnet mask of the route table entry. max Value 255 default Value RouteTableEntry Table 110: SubnetMask Gateway Gateway The Gateway specified in the route table entry. min Value 1 max Value 64 default Value 1 RouteTableEntry Table 111: Gateway IPAddress IPAddress The IP address of the ARP table entry. max Value 16 default Value ARPTableEntry Table 112: IPAddress 110

110 6. Appendix 6.2. MILI_Properties MACAddress MACAddress The MAC address of the ARP table entry. min Value 17 max Value 17 default Value ARPTableEntry Table 113: MACAddress VendorID min Value 1 max Value 255 default Value 1 PCI VendorID This property displays the PCI vendor ID of the BladeEngine controller's iscsi function. Table 114: VendorID DeviceID min Value 1 max Value 255 default Value 1 PCI DeviceID This property displays the PCI device ID of the BladeEngine controller's iscsi function. Table 115: DeviceID SubsysDeviceID min Value 1 max Value 255 default Value 1 PCI SubsysDeviceID This property displays the PCI subsystem device ID of the BladeEngine controller's iscsi function. Table 116: SubsysDeviceID 111

111 6. Appendix 6.2. MILI_Properties SubsysVendorID min Value 1 max Value 255 default Value 1 PCI SubsysVendorID This property displays the PCI subsystem vendor ID of the BladeEngine controller's iscsi function. Table 117: SubsysVendorID BusNumber max Value 255 default Value 0 PCI BusNumber This property displays the PCI bus number of the BladeEngine controller's iscsi function. Table 118: BusNumber DeviceNumber max Value 32 default Value 0 PCI DeviceNumber This property displays the PCI device number of the BladeEngine controller's iscsi function. Table 119: DeviceNumber FunctionNumber max Value 8 default Value 0 PCI FunctionNumber This property displays the PCI function number of the BladeEngine controller's iscsi function. Table 120: FunctionNumber 112

112 6. Appendix 6.2. MILI_Properties DriverName min Value 2 max Value 10 default Value BEISCSI Driver DriverName This property displays the name of the iscsi driver in the host operating system. Table 121: DriverName DriverVersion DriverVersion This property displays the version number of the iscsi driver currently active in the host operating system. min Value 2 max Value 6 default Value 2 Driver Table 122: DriverVersion DHCPServerAvailable max Value 1 default Value 0 DHCP DHCPServerAvailable This property indicates whether the DHCP Server is available. A value of 1 indicates a server is available and a value of 0 indicates that there is no server available. Table 123: DHCPServerAvailable DHCPObtainNewIPAddress String Identifier max Value 1 default Value 0 DHCP DHCPObtainNewIPAddress This property indicates whether you can obtain a new IP Address from the DHCP Server. A value of 1 indicates that an IP address is obtained from the DHCP server and a value of 0 indicates that an IP address is not obtained. 113

113 6. Appendix 6.2. MILI_Properties Table 124: DHCPObtainNewIPAddress DHCPEnabled String Identifier DHCPEnabled This property indicates the current DHCP setting. Using the OEMSEConfigureDHCP command with a mandatory parameter EnableDHCP will configure DHCP. If the parameter is "True", it will enable DHCP and initiate a DHCP request. If the parameter is "False", it will disable DHCP. min Value 4 max Value 5 default Value False TCPIPConfiguration Table 125: DHCPEnabled InitiatorIPAddress InitiatorIPAddress The IP Address assigned to the port. max Value 16 default Value TCPIPConfiguration Table 126: InitiatorIPAddress InitiatorSubnetMask InitiatorSubnetMask The Subnet mask for the port. max Value 255 default Value TCPIPConfiguration Table 127: InitiatorSubnetMask DefaultGateway DefaultGateway The Default Gateway specified for the port. max Value 16 default Value

114 6. Appendix 6.2. MILI_Properties TCPIPConfiguration Table 128: DefaultGateway 115

115 6. Appendix 6.2. MILI_Properties IPVersionSupported IPVersionSupported The version of IP Protocol supported. The value can be IPv4 or IPv6. min Value 1 max Value 4 default Value IPv4 TCPIPConfiguration Table 129: IPVersionSupported VLANID VLANID Specifies the current vlan id used. max Value 4095 default Value 0 TCPIPConfiguration Table 130: VLANID PortSpeed PortSpeed This property specifies the port speed settings. The only Values allowed are 2 for 100baseT and 3 for GigaBit. Everything else would be an invalid argument. max Value 4 default Value 4 NICConfiguration Table 131: PortSpeed PortMaxSpeed PortMaxSpeed This property specifies the maximum port speed. max Value 4 default Value 4 NICConfiguration Table 132: PortMaxSpeed 116

116 6. Appendix 6.2. MILI_Properties MaxFrameSize MaxFrameSize This property specifies the maximum frame size used by the port. min Value 16 max Value default Value NICConfiguration Table 133: MaxFrameSize LinkStatus LinkStatus This property indicates whether the link is up or down. max Value 3 default Value 2 NICConfiguration Table 134: LinkStatus ActivePort ActivePort This property indicates the active port on the BladeEngine controller. max Value 26 default Value Port 0 NICConfiguration Table 135: ActivePort MACAddress MACAddress This property displays MAC Address of the network port. min Value 17 max Value 17 default Value NICConfiguration Table 136: MACAddress 117

117 6. Appendix 6.2. MILI_Properties MaxBytesPerSecondPeriSCSI String Identifier max Value default Value 0 QOS MaxBytesPerSecondPeriSCSI The maximum iscsi throughput for this domain, specified in 1KBps multiples. A value of 0 indicates no QOS was set and allows all available bandwidth for this domain. Read-Write Table 137: MaxBytesPerSecondPeriSCSI MaxIosPerSecondPeriSCSI String Identifier max Value 255 default Value 0 QOS MaxIosPerSecondPeriSCSI The maximum number of I/Os per second of iscsi traffic for this domain, specified in 1KIOPs multiples. A value of 0 indicates no QOS was set and allows all available bandwidth for this domain. Read-Write Table 138: MaxIosPerSecondPeriSCSI PortRowStatus max Value 3 default Value 2 Network PortRowStatus This field allows entries to be dynamically added and removed from this table via SNMP. Table 139: PortRowStatus PortalRole min Value 1 max Value 2 default Value 1 PortalRole A portal can operate in one or both of two roles as a target portal and/or an initiator portal. 118

118 6. Appendix 6.2. MILI_Properties Network Table 140: PortalRole PortalProtocol PortalProtocol The portal's transport protocol. min Value 1 max Value 2 default Value 1 Network Table 141: PortalProtocol PortalTag PortalTag The portals aggregation tag when the portal is used as an initiator. min Value 1 max Value default Value 1 Network Table 142: PortalTag SequenceNumber SequenceNumber A Sequence number of the event log entry. min Value 1 max Value 255 default Value 1 EventLogEntry Table 143: SequenceNumber TimeStamp TimeStamp The Time stamp of the event log entry. min Value 1 max Value 255 default Value 1 EventLogEntry Table 144: TimeStamp 119

119 6. Appendix 6.2. MILI_Properties Severity Severity The severity associated with the event log entry. min Value 1 max Value 255 default Value 1 EventLogEntry Table 145: Severity The text description of the event log entry. max Value 255 default Value 0 EventLogEntry Table 146: ErrorCode ErrorCode The numeric error code associated with the event log entry. min Value 1 max Value 255 default Value 1 EventLogEntry Table 147: ErrorCode NodeRoles NodeRoles The node role for this iscsi Initiator. min Value 1 max Value 255 default Value 1 SNMP Table 148: NodeRoles 120

120 6. Appendix 6.2. MILI_Properties PortalCount min Value 1 max Value 5 default Value 1 SNMP PortalCount The number of rows in the iscsiportaltypetable which are currently associated with this iscsi instance. Table 149: PortalCount NodeCount min Value 1 max Value 5 default Value 1 SNMP NodeCount The number of rows in the iscsinodetypetable which are currently associated with this iscsi instance. Table 150: NodeCount SessionCount SessionCount The number of rows in the iscsisessiontypetable which are currently associated with this iscsi instance. min Value 1 max Value 5 default Value 1 SNMP Table 151: SessionCount SessionFailureCount SessionFailureCount The number of times a session belonging to this instance has failed. min Value 1 max Value 255 default Value 1 SNMP Table 152: SessionFailureCount 121

121 6. Appendix 6.2. MILI_Properties 122

122 6. Appendix 6.2. MILI_Properties LastSessionFailureType LastSessionFailureType The type of failure encountered in the last session failure. min Value 1 max Value 255 default Value 1 SNMP Table 153: LastSessionFailureType LastSessionRmtNodeName LastSessionRmtNodeName The iscsi name of the remote node from the failed session. min Value 1 max Value 224 default Value iqn.se SNMP Table 154: LastSessionRmtNodeName SessionDigestErrors SessionDigestErrors The count of sessions which failed due to receipt of a PDU containing header or data digest errors. min Value 4 max Value 0 default Value 4 SNMP Table 155: SessionDigestErrors SessionConnectionTimeout SessionConnectionTimeout The count of sessions which failed due to a sequence exceeding a time limit. min Value 4 max Value 0 default Value 4 SNMP Table 156: SessionConnectionTimeout 123

123 6. Appendix 6.2. MILI_Properties SessionFormatErrors min Value 4 max Value 0 default Value 4 SNMP SessionFormatErrors The count of sessions which failed due to receipt of an iscsi PDU that contained a format error. Table 157: SessionFormatErrors LoginFailures LoginFailures The number of times a login from this initiator failed. min Value 4 max Value 0 default Value 4 SNMP Table 158: LoginFailures LastFailureTime LastFailureTime The timestamp of the most recent failure of a login attempt from this initiator. A value of zero indicates that no failures have occurred. max Value 32 default Value 0 SNMP Table 159: LastFailureTime LastFailureType LastFailureType The failure type for the most recent login failure on this initiator. max Value 0 default Value 0 SNMP Table 160: LastFailureType 124

124 6. Appendix 6.2. MILI_Properties LastTgtFailureName min Value 1 max Value 224 default Value iqn.se SNMP LastTgtFailureName The UTF-8 string name of the target that most recently failed a login request from this initiator. Table 161: LastTgtFailureName LastTgtFailureAddr LastTgtFailureAddr An Internet Network Address of the type specified by the object iscsiintrlasttgtfailureaddrtype. max Value 0 default Value 0 SNMP Table 162: LastTgtFailureAddr LoginAcceptRsps min Value 4 max Value 0 default Value 4 SNMP LoginAcceptRsps The count of Login Response PDUs received by this initiator that were accepted. Table 163: LoginAcceptRsps LoginOtherFailRsps min Value 4 max Value 0 default Value 4 SNMP LoginOtherFailRsps The count of Login Response PDUs received by this initiator with any status code not counted by the other objects as defined for this MIB. Table 164: LoginOtherFailRsps 125

125 6. Appendix 6.2. MILI_Properties 126

126 6. Appendix 6.2. MILI_Properties LoginRedirectRsps min Value 4 max Value 0 default Value 4 SNMP LoginRedirectRsps The count of Login Response PDUs received by the initiator with status class Redirection. Table 165: LoginRedirectRsps LoginAuthFailRsps LoginAuthFailRsps The count of Login Response PDUs with status class 0x201 Authentication Failed received by this initiator. min Value 4 max Value 0 default Value 4 SNMP Table 166: LoginAuthFailRsps LoginAuthFails min Value 4 max Value 0 default Value 4 SNMP LoginAuthFails The number of times the initiator has aborted a login because the target could not be authenticated. Table 167: LoginAuthFails LoginNegoFails LoginNegoFails The number of times the initiator has aborted a login because parameter negotiation with the target failed. min Value 4 max Value 0 default Value 4 SNMP 127

127 6. Appendix 6.2. MILI_Properties Table 168: LoginNegoFails 128

128 6. Appendix 6.2. MILI_Properties LogoutNormals min Value 4 max Value 0 default Value 4 SNMP LogoutNormals The count of Logout Command PDUs generated by this initiator with reason code normal. Table 169: LogoutNormals LogoutOthers LogoutOthers The count of Logout Command PDUs generated by this initiator with any status code other than normal. min Value 4 max Value 0 default Value 4 SNMP Table 170: LogoutOthers ETO max Value default Value -1 Target ETO The Extended TimeOut(ETO) configured for the target. The driver will ensure that the I/Os are not errored back until this time has expired (from the time the target stopped responding). Read-Write Table 171: ETO TargetIPAddress TargetIPAddress The IP Address of the target portal. max Value 0 default Value TargetPortal Table 172: TargetIPAddress 129

129 6. Appendix 6.2. MILI_Properties 130

130 6. Appendix 6.2. MILI_Properties TargetPortNumber TargetPortNumber The Port number of the target portal. min Value 1 max Value default Value 1036 TargetPortal Table 173: TargetPortNumber PortalGroupTag PortalGroupTag The tag associated with the Portal Group. max Value 255 default Value 0 TargetPortal Table 174: PortalGroupTag InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. Read-Write max Value 3 default Value Yes TargetLoginOptions Table 175: InitialR2T ImmediateData ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. Read-Write max Value 3 default Value Yes TargetLoginOptions Table 176: ImmediateData 131

131 6. Appendix 6.2. MILI_Properties 132

132 6. Appendix 6.2. MILI_Properties AuthenticationMethod min Value 4 max Value 12 default Value Authentication AuthenticationMethod Use this property to specify an authentication method using the set command. Valid CHAP values are, Mutual CHAP, and One-Way CHAP. is the default. Read-Write Table 177: AuthenticationMethod InitiatorCHAPName String Identifier InitiatorCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This parameter is optional and only required for Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the InitiatorCHAPName. The InitiatorCHAPName can be any name or sequence of numbers. Read-Write Table 178: InitiatorCHAPName InitiatorSecret String Identifier InitiatorSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is an optional parameter and only required for Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the InitiatorSecret. The InitiatorSecret can be any name or sequence of numbers. Read-Write Table 179: InitiatorSecret 133

133 6. Appendix 6.2. MILI_Properties TargetCHAPName String Identifier TargetCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the Target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the TargetCHAPName. The TargetCHAPName can be any name or sequence of numbers. Read-Write Table 180: TargetCHAPName TargetSecret String Identifier TargetSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the TargetSecret. The TargetSecret can be any name or sequence of numbers. Read-Write Table 181: TargetSecret HeaderDigest String Identifier HeaderDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's header segments will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value TargetLoginOptions Table 182: HeaderDigest 134

134 6. Appendix 6.2. MILI_Properties DataDigest String Identifier DataDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's data segment will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value TargetLoginOptions Table 183: DataDigest InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. max Value 3 default Value Yes SessionNegotiatedLoginOptions Table 184: InitialR2T ImmediateData ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. max Value 3 default Value Yes SessionNegotiatedLoginOptions Table 185: ImmediateData MaxConnections MaxConnections ISCSI Login Parameter for the Target. min Value 1 max Value 1 default Value 1 135

135 6. Appendix 6.2. MILI_Properties SessionNegotiatedLoginOptions Table 186: MaxConnections MaxOutstandingR2T MaxOutstandingR2T ISCSI Login Parameter for the Target. min Value 1 max Value 0 default Value 1 SessionNegotiatedLoginOptions Table 187: MaxOutstandingR2T FirstBurstLength FirstBurstLength ISCSI Login Parameter for the Target. max Value 8192 default Value 8192 SessionNegotiatedLoginOptions Table 188: FirstBurstLength MaxBurstLength MaxBurstLength ISCSI Login Parameter for the Target. max Value default Value SessionNegotiatedLoginOptions Table 189: MaxBurstLength DefaultTime2Wait DefaultTime2Wait ISCSI Login Parameter for the Target. max Value 2 default Value 2 SessionNegotiatedLoginOptions Table 190: DefaultTime2Wait 136

136 6. Appendix 6.2. MILI_Properties DefaultTime2Retain DefaultTime2Retain ISCSI Login Parameter for the Target. max Value 20 default Value 20 SessionNegotiatedLoginOptions Table 191: DefaultTime2Retain ErrorRecoveryLevel ErrorRecoveryLevel ISCSI Login Parameter for the Target. max Value 0 default Value 0 SessionNegotiatedLoginOptions Table 192: ErrorRecoveryLevel DataPDUInOrder DataPDUInOrder ISCSI Login Parameter for the Target. max Value 1 default Value 1 SessionNegotiatedLoginOptions Table 193: DataPDUInOrder DataSeqInOrder DataSeqInOrder ISCSI Login Parameter for the Target. max Value 1 default Value 1 SessionNegotiatedLoginOptions Table 194: DataSeqInOrder 137

137 6. Appendix 6.2. MILI_Properties SessionDirection SessionDirection The direction of iscsi session InboundSession and OutboundSession. max Value 0 default Value 0 SNMP Table 195: SessionDirection CmdPdus CmdPdus The count of Command PDUs transferred on this session. max Value 0 default Value 0 SNMP Table 196: CmdPdus RspPdus RspPdus The count of Response PDUs transferred on this session. max Value 0 default Value 0 SNMP Table 197: RspPdus TxDataOctetsHigh max Value 0 default Value 0 SNMP TxDataOctetsHigh The count of data octets that were transmitted bythe local iscsi node on this session. Table 198: TxDataOctetsHigh 138

138 6. Appendix 6.2. MILI_Properties RxDataOctetsHigh max Value 0 default Value 0 SNMP RxDataOctetsHigh The count of data octets that were received by the local iscsi node on this session. Table 199: RxDataOctetsHigh DigestErrors DigestErrors The count of PDUs which were received on the session and contained header or data digest errors. max Value 0 default Value 0 SNMP Table 200: DigestErrors CxnTimeoutErrors max Value 0 default Value 0 SNMP CxnTimeoutErrors The count of connections within this session which have been terminated due to a timeout. Table 201: CxnTimeoutErrors SessionTargetAlias max Value 0 default Value 0 SNMP SessionTargetAlias The count of PDUs which were received on the session and contained header or data digest errors. Table 202: SessionTargetAlias 139

139 6. Appendix 6.2. MILI_Properties 140

140 6. Appendix 6.2. MILI_Properties AuthenticationMethod String Identifier AuthenticationMethod Use this property to specify an authentication method using the set command. Valid CHAP values are, Mutual CHAP, and One-Way CHAP. is the default. min Value 4 max Value 12 default Value ConnectionNegotiatedLoginOptions Table 203: AuthenticationMethod HeaderDigest String Identifier HeaderDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's header segments will be protected by a CRC32C checksum. The default is. min Value 4 max Value 6 default Value ConnectionNegotiatedLoginOptions Table 204: HeaderDigest DataDigest String Identifier DataDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's data segment will be protected by a CRC32C checksum. The default is. min Value 4 max Value 6 default Value ConnectionNegotiatedLoginOptions Table 205: DataDigest MaxRecvDataSegmentLength MaxRecvDataSegmentLength ISCSI Login Parameter for the Target. max Value 1 141

141 6. Appendix 6.2. MILI_Properties default Value 0 ConnectionNegotiatedLoginOptions Table 206: MaxRecvDataSegmentLength TCPWindowSize TCPWindowSize ISCSI Login Parameter for the Target. min Value 16 max Value 255 default Value ConnectionNegotiatedLoginOptions Table 207: TCPWindowSize TCPMSS String Identifier TCPMSS The MSS for this connection. The Host driver uses this to determine size of data PDU whenever the BladeEngine is required to transmit the entire PDU with a single iscsi header. min Value 1514 max Value 9216 default Value 1514 ConnectionNegotiatedLoginOptions Table 208: TCPMSS iscsiconnectionid iscsiconnectionid The iscsi Connection ID assigned to the Connection. min Value 1 max Value 32 default Value 1 Connection Table 209: iscsiconnectionid Status Status The status of the connection. max Value 32 default Value Connection Status Unknown 142

142 6. Appendix 6.2. MILI_Properties Connection Table 210: Status 143

143 6. Appendix 6.2. MILI_Properties SourcePortNumber SourcePortNumber The source port number for the connection. min Value 1024 max Value default Value 1024 Connection Table 211: SourcePortNumber DestinationPortNumber DestinationPortNumber The destination port number for the connection. min Value 1024 max Value default Value 1024 Connection Table 212: DestinationPortNumber SourceIPAddress SourceIPAddress The source IP Address for the connection. max Value 0 default Value Connection Table 213: SourceIPAddress DestinationIPAddress DestinationIPAddress The destination IP Address for the connection. max Value 0 default Value Connection Table 214: DestinationIPAddress 144

144 6. Appendix 6.2. MILI_Properties RedirectedDestinationPort RedirectedDestinationPort The Redirected target TCP port number. max Value 0 default Value 0 Connection Table 215: RedirectedDestinationPort RedirectedDestinationIPAddress RedirectedDestinationIPAddress The Redirected target IP address. max Value 0 default Value 0 Connection Table 216: RedirectedDestinationIPAddress SessionTSIH SessionTSIH Session TSIH assigned to the session. A value of 0 indicates that there is no session assigned. max Value 0 default Value 0 Session Table 217: SessionTSIH SessionISID SessionISID Session ISID assigned to the session. This needs to be unique for every session. max Value 0 default Value 0 Session Table 218: SessionISID 145

145 6. Appendix 6.2. MILI_Properties SessionInitiatorName SessionInitiatorName The iscsi Name configured for the session. min Value 1 max Value 224 default Value iqn.se Session Table 219: SessionInitiatorName SessionStatus SessionStatus This property indicates the status of the session. max Value 32 default Value Unknown Session Table 220: SessionStatus iscsiboot String Identifier iscsiboot max Value 1 default Value 0 Session This property indicates whether the iscsi session is marked for use as a boot session. A value of 1 indicates a boot session and 0 is a non-boot session. Note that you cannot log out of a boot session via SM-CLP. Table 221: iscsiboot LUNNumber LUNNumber Logical unit number of the LUN. max Value 0 default Value 0 LUN Table 222: LUNNumber 146

146 6. Appendix 6.2. MILI_Properties LUNSize LUNSize The size of the LUN in bytes. max Value 0 default Value 0 LUN Table 223: LUNSize DeviceVendorName DeviceVendorName The Device Vendor Identification. max Value 0 default Value 0 LUN Table 224: DeviceVendorName DeviceModelNumber DeviceModelNumber The Device Product Identification. max Value 0 default Value 0 LUN Table 225: DeviceModelNumber IPAddress IPAddress The IP address of the Portal used for the leading connection. max Value 0 default Value PersistentLoginPortal Table 226: IPAddress 147

147 6. Appendix 6.2. MILI_Properties PortNumber PortNumber The Port number of the Portal used for the leading connection. min Value 1024 max Value default Value 1024 PersistentLoginPortal Table 227: PortNumber InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. Read-Write max Value 3 default Value Yes PersistentLoginOptions Table 228: InitialR2T ImmediateData ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. Read-Write max Value 3 default Value Yes PersistentLoginOptions Table 229: ImmediateData AuthenticationMethod min Value 4 max Value 12 default Value Authentication AuthenticationMethod Use this property to specify an authentication method using the set command. Valid CHAP values are, Mutual CHAP, and One-Way CHAP. is the default. 148

148 6. Appendix 6.2. MILI_Properties Table 230: AuthenticationMethod 149

149 6. Appendix 6.2. MILI_Properties InitiatorCHAPName String Identifier InitiatorCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This parameter is optional and only required for Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the InitiatorCHAPName. The InitiatorCHAPName can be any name or sequence of numbers. Table 231: InitiatorCHAPName InitiatorSecret String Identifier InitiatorSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is an optional parameter and only required for Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the InitiatorSecret. The InitiatorSecret can be any name or sequence of numbers. Table 232: InitiatorSecret TargetCHAPName String Identifier TargetCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the Target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the TargetCHAPName. The TargetCHAPName can be any name or sequence of numbers. Table 233: TargetCHAPName 150

150 6. Appendix 6.2. MILI_Properties TargetSecret String Identifier TargetSecret min Value 12 max Value 16 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the TargetSecret. The TargetSecret can be any name or sequence of numbers. Table 234: TargetSecret PortIdentifier PortIdentifier The unique port identifier for the port/logical HBA used for the persistent Login. max Value 1 default Value 0 PersistentLogin Table 235: PortIdentifier iscsiboot max Value 1 default Value 0 PersistentLogin iscsiboot Use this property to set a boot target. A value of 1 marks it is a boot target, a 0 indicates it is not a boot target. Example; set iscsiboot="1" Read-Write Table 236: iscsiboot TargetName TargetName The iscsi name of the target for the persistent login. min Value 6 max Value 10 default Value 6 PersistentLogin 151

151 6. Appendix 6.2. MILI_Properties Table 237: TargetName 152

152 6. Appendix 6.2. MILI_Properties TargetISCSIName TargetISCSIName The iscsi Name of the target. min Value 11 max Value 255 default Value 11 Target Table 238: TargetISCSIName TargetAlias TargetAlias The alias name given to the Target node. max Value 0 default Value 0 Target Table 239: TargetAlias DefaultLoginPortal DefaultLoginPortal This property indicates the default portal of the target to use to login. Read-Write min Value 1 max Value 128 default Value 0 Target Table 240: DefaultLoginPortal DefaultIntrPort DefaultIntrPort This property indicates the default port of the initiator to use for login. Read-Write min Value 1 max Value 16 default Value 0 Target Table 241: DefaultIntrPort 153

153 6. Appendix 6.2. MILI_Properties SlpScopes SlpScopes The only SLP scope string that is supported is default. Read-Write max Value 256 default Value 0 SLP Table 242: SlpScopes SlpQueryList min Value 1 max Value 255 default Value 0 SLP SlpQueryList This property indicates whether an iscsi name is to be used as the query string or not. Read-Write Table 243: SlpQueryList IPAddress IPAddress The IP Address of the isns Server. max Value 0 default Value isnsentry Table 244: IPAddress PortNumber PortNumber The Port number of the isns Server. min Value 1024 max Value 3205 default Value 1024 isnsentry Table 245: PortNumber 154

154 6. Appendix 6.2. MILI_Properties InitialR2T String Identifier InitialR2T The valid values for this property are Yes or No. If set to Yes, the initiator has to wait for the target to solicit SCSI data before sending it. Setting it to No allows the initiator to send a burst of FirstBurstLength bytes unsolicited. The default is Yes. Read-Write max Value 3 default Value Yes SendTargetPortalLoginOptions Table 246: InitialR2T ImmediateData ImmediateData This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No. Read-Write max Value 3 default Value Yes SendTargetPortalLoginOptions Table 247: ImmediateData InitiatorCHAPName String Identifier InitiatorCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This parameter is optional and only required for Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the InitiatorCHAPName. The InitiatorCHAPName can be any name or sequence of numbers. Read-Write Table 248: InitiatorCHAPName 155

155 6. Appendix 6.2. MILI_Properties InitiatorSecret String Identifier InitiatorSecret min Value 1 max Value 24 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is an optional parameter and only required for Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the InitiatorSecret. The InitiatorSecret can be any name or sequence of numbers. Read-Write Table 249: InitiatorSecret TargetCHAPName String Identifier TargetCHAPName min Value 1 max Value 256 default Value Authentication This property is an iscsi authentication login parameter sent to the Target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. Some implementations refer to this as a Username. Use the set command with this property to specify the TargetCHAPName. The TargetCHAPName can be any name or sequence of numbers. Read-Write Table 250: TargetCHAPName TargetSecret String Identifier TargetSecret min Value 1 max Value 24 default Value Authentication This property is an iscsi authentication login parameter sent to the target. This is a required parameter for both One-Way CHAP and Mutual CHAP authentication. The secret will be displayed as plain text (and not obfuscated); both while keying and displaying. Use the set command with this property to specify the TargetSecret. The TargetSecret can be any name or sequence of numbers. Read-Write Table 251: TargetSecret 156

156 6. Appendix 6.2. MILI_Properties AuthenticationMethod min Value 4 max Value 12 default Value Authentication AuthenticationMethod Use this property to specify an authentication method using the set command. Valid CHAP values are, Mutual CHAP, and One-Way CHAP. is the default. Read-Write Table 252: AuthenticationMethod HeaderDigest String Identifier HeaderDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's header segments will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value SendTargetPortalLoginOptions Table 253: HeaderDigest DataDigest String Identifier DataDigest The valid values for this property are CRC32C or. If set to CRC32C and the initiator is configured accordingly, the integrity of an iscsi PDU's data segment will be protected by a CRC32C checksum. The default is. Read-Write min Value 4 max Value 6 default Value SendTargetPortalLoginOptions Table 254: DataDigest IPAddress IPAddress The IP Address specified for the SendTarget Portal. max Value 0 default Value

157 6. Appendix 6.2. MILI_Properties SendTargetPortal Table 255: IPAddress PortNumber PortNumber The Port Number specified for the SendTarget Portal. min Value 1024 max Value default Value 1024 SendTargetPortal Table 256: PortNumber PortIdentifier PortIdentifier The port identifier of the logical HBA/port the Sendtarget Portal is added to. max Value 1 default Value 0 SendTargetPortal Table 257: PortIdentifier PortMacAddress PortMacAddress The mac address of the port the SendTarget portal is added to. min Value 17 max Value 17 default Value SendTargetPortal Table 258: PortMacAddress SLPEnabled min Value 1 max Value 3 default Value No Discovery SLPEnabled Use this property to enable or disable SLP using the set command. Valid values are Yes and No. To enable SLP, set the value to Yes. The default is No. Read-Write 158

158 6. Appendix 6.2. MILI_Properties Table 259: SLPEnabled 159

159 6. Appendix 6.3. Data Types isnsenabled min Value 1 max Value 3 default Value No Discovery isnsenabled Use this property to enable or disable isns using the set command. Valid values are Yes and No. To enable isns, set the value to Yes. The default is No. Read-Write Table 260: isnsenabled DefaultInitiatorPort max Value 256 default Value 0 Discovery DefaultInitiatorPort This property indicates the default initiator port that will be used for any discovery. Read-Write 6.3. Data Types Table 261: DefaultInitiatorPort Data Type U8 U16 U32 BOOLEAN STRING IP_ADDRESS 8 bit unsigned integer 16 bit unsigned integer 32 bit unsigned integer TRUE or FALSE character string with a null termination Dotted quad integers. Each value in the dotted quad integer can range from 0 to 255. Certain combinations (even though with the range) are reserved and cannot be used as IP address. Set operations on such IP addresses will fail with "Invalid Parameter" return status. Table 262: Data Types 160

160 6. Appendix 6.4. Common Error Messages 6.4. Common Error Messages The following are common error messages for all command returning from SM-CLP: Failed Version mismatch Not Implemented Resource Busy Unknown Error Invalid Value Invalid Value for parameter Value out of range Invalid number of characters Invalid value Parameter Missing Array length small 161

161 Information on this document On April 1, 2009, Fujitsu became the sole owner of Fujitsu Siemens Computers. This new subsidiary of Fujitsu has been renamed Fujitsu Technology Solutions. This document from the document archive refers to a product version which was released a considerable time ago or which is no longer marketed. Please note that all company references and copyrights in this document have been legally transferred to Fujitsu Technology Solutions. Contact and support addresses will now be offered by Fujitsu Technology Solutions and have the The Internet pages of Fujitsu Technology Solutions are available at and the user documentation at Copyright Fujitsu Technology Solutions, 2009 Hinweise zum vorliegenden Dokument Zum 1. April 2009 ist Fujitsu Siemens Computers in den alleinigen Besitz von Fujitsu übergegangen. Diese neue Tochtergesellschaft von Fujitsu trägt seitdem den Namen Fujitsu Technology Solutions. Das vorliegende Dokument aus dem Dokumentenarchiv bezieht sich auf eine bereits vor längerer Zeit freigegebene oder nicht mehr im Vertrieb befindliche Produktversion. Bitte beachten Sie, dass alle Firmenbezüge und Copyrights im vorliegenden Dokument rechtlich auf Fujitsu Technology Solutions übergegangen sind. Kontakt- und Supportadressen werden nun von Fujitsu Technology Solutions angeboten und haben die Die Internetseiten von Fujitsu Technology Solutions finden Sie unter und unter finden Sie die Benutzerdokumentation. Copyright Fujitsu Technology Solutions, 2009