PRIMERGY BX600 10GbE I/O Module (PCIe) - Fujitsumanuals.ts.fujitsu.com/file/3634/bx-10gbe-sm-clp-reference.pdf · PRIMERGY BX600 10GbE I/O Module ... iSCSI Initiator SM-CLP Command

Reference Guide

PRIMERGY BX600 10GbE I/O Module (PCIe)Microsoft Windows Server 2003

iSCSI Initiator SM-CLP Command Reference Guide Version 1.0 (V1.0.748.0)

English

Edition April 2008

PRIMERGY BX600 10GbE LAN I/O Module (PCIe) Microsoft Windows Server 2003

iSCSI Initiator SM-CLP Command Reference Guide (v1.0.748.0)

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.

Table of Contents

5

Table of Contents 1. REVISION HISTORY ................................................................................................... 11

2. INTRODUCTION ........................................................................................................... 13 2.1. GLOSSARY...................................................................................................................... 13 2.2. DOCUMENT CONVENTION............................................................................................ 13 2.3. HARDWARE AND SOFTWARE DEPENDENCIES......................................................... 13

3. USING THE COMMAND-LINE INTERFACE...................................................................... 15 3.1. CONNECTING TO THE BLADEENGINE SERVER USING CLI ..................................... 15 3.2. INVOKING CLI ................................................................................................................. 16 3.3. ACCESSING HELP.......................................................................................................... 18

4. BASIC COMMANDS........................................................................................................... 19 4.1. COMMON OPTIONS........................................................................................................ 19 4.2. OUTPUT ARGUMENTS................................................................................................... 19 4.3. CD..................................................................................................................................... 20 4.4. SHOW............................................................................................................................... 21 4.5. SET................................................................................................................................... 22 4.6. OEMSESAVECONFIG ..................................................................................................... 23 4.7. HELP ................................................................................................................................ 24 4.8. VERSION.......................................................................................................................... 25 4.9. EXIT.................................................................................................................................. 26

5. OEMSE COMMANDS ......................................................................................................... 27 5.1. GROUP MAPS ................................................................................................................. 27 5.2. OEMSEERASECONFIGURATION .................................................................................. 32 5.3. OEMSEUPGRADEFLASHROM....................................................................................... 33 5.4. OEMSEENABLENIC ........................................................................................................ 34 5.5. OEMSEENABLEISCSI ..................................................................................................... 35 5.6. OEMSEDISABLENIC ....................................................................................................... 36 5.7. OEMSEDISABLEISCSI .................................................................................................... 37 5.8. OEMSEADDROUTETABLEENTRY................................................................................. 38 5.9. OEMSEDELETEROUTETABLEENTRY .......................................................................... 39 5.10. OEMSEADDARPTABLEENTRY.................................................................................... 40 5.11. OEMSEDELETEARPTABLEENTRY ............................................................................. 41 5.12. OEMSECONFIGUREIPADDRESS ................................................................................ 42 5.13. OEMSECONFIGUREDHCP........................................................................................... 43 5.14. OEMSEREFRESHNICCONFIG ..................................................................................... 44 5.15. OEMSEPING.................................................................................................................. 45 5.16. OEMSEREFRESHEVENTLOG...................................................................................... 46 5.17. OEMSECLEAREVENTLOG........................................................................................... 47 5.18. OEMSETESTUNITREADY............................................................................................. 48 5.19. OEMSESTDINQUIRY .................................................................................................... 49 5.20. OEMSEREADCAPACITY............................................................................................... 50 5.21. OEMSESCSIREAD ........................................................................................................ 51 5.22. OEMSESCSIWRITE....................................................................................................... 52 5.23. OEMSESETPERSISTENT............................................................................................. 53 5.24. OEMSELOGIN ............................................................................................................... 54 5.25. OEMSELOGOUT ........................................................................................................... 55 5.26. OEMSEDELETEPERSISTENT...................................................................................... 56 5.27. OEMSERESCANLUNS.................................................................................................. 57 5.28. OEMSEDISCOVERYISNSTHRUDHCP......................................................................... 58 5.29. OEMSEADDISNSENTRY .............................................................................................. 59 5.30. OEMSEDELETEISNSENTRY........................................................................................ 60

Table of Contents

6

5.31. OEMSEDISCOVERTARGETS....................................................................................... 61 5.32. OEMSEADDSENDTARGETPORTAL............................................................................ 62 5.33. OEMSEDELETESENDTARGETPORTAL ..................................................................... 63 5.34. OEMSEREFRESHAVAILABLETARGETS..................................................................... 64 5.35. OEMSEADDTARGET .................................................................................................... 65 5.36. OEMSEDELETETARGET.............................................................................................. 66

6. APPENDIX .......................................................................................................................... 67 6.1. MILI_GROUPS ................................................................................................................. 67 6.1.1. ROOT .......................................................................................................................... 67 6.1.2. BLADEENGINE .......................................................................................................... 67 6.1.3. LOGICALHBA ............................................................................................................. 68 6.1.4. NIC .............................................................................................................................. 68 6.1.5. PHYSICALHBA ........................................................................................................... 68 6.1.6. PCI............................................................................................................................... 70 6.1.7. DRIVER....................................................................................................................... 70 6.1.8. QOS............................................................................................................................. 70 6.1.9. ISCSI .......................................................................................................................... 71 6.1.10. INITIATORISCSINAME.......................................................................................... 71 6.1.11. INITIATORDEFAULTLOGINOPTIONS.................................................................. 72 6.1.12. INITIATORLOGINOPTIONS .................................................................................. 72 6.1.13. AUTHENTICATION ................................................................................................. 73 6.1.14. PHYSICALHBA ........................................................................................................... 73 6.1.15. ROUTETABLE .......................................................................................................... 73 6.1.16. ROUTETABLEENTRY .............................................................................................. 74 6.1.17. ARPTABLE................................................................................................................ 74 6.1.18. ARPTABLEENTRY.................................................................................................... 74 6.1.19. PCI ............................................................................................................................ 76 6.1.20. DRIVER .................................................................................................................... 76 6.1.21. NETWORK................................................................................................................ 77 6.1.22. DHCP ........................................................................................................................ 77 6.1.23. TCPIPCONFIGURATION ........................................................................................ 78 6.1.24. NICCONFIGURATION ............................................................................................ 78 6.1.25. QOS .......................................................................................................................... 78 6.1.26. EVENTLOG............................................................................................................... 79 6.1.27. EVENTLOGENTRY................................................................................................... 79 6.1.28. SNMP ........................................................................................................................ 80 6.1.29. TARGET .................................................................................................................... 81 6.1.30. TARGETPORTAL...................................................................................................... 81 6.1.31. TARGETLOGINOPTIONS ....................................................................................... 82 6.1.32. AUTHENTICATION ................................................................................................. 82 6.1.33. SESSION.................................................................................................................. 83 6.1.34. SESSIONNEGOTIATEDLOGINOPTIONS............................................................. 83 6.1.35. SNMP ........................................................................................................................ 84 6.1.36. CONNECTION.......................................................................................................... 84 6.1.37. CONNECTIONNEGOTIATEDLOGINOPTIONS..................................................... 85 6.1.38. LUN ........................................................................................................................... 85 6.1.39. PERSISTENTLOGIN................................................................................................ 86 6.1.40. PERSISTENTLOGINPORTAL ................................................................................. 86 6.1.41. PERSISTENTLOGINOPTIONS............................................................................... 86 6.1.42. AUTHENTICATION ................................................................................................. 87 6.1.43. DISCOVERY............................................................................................................. 87 6.1.44. SLP............................................................................................................................ 87 6.1.45. ISNS ......................................................................................................................... 88 6.1.46. ISNSENTRY ............................................................................................................. 88 6.1.47. SENDTARGETPORTAL ........................................................................................... 88

Table of Contents

7

6.1.48. SENDTARGETPORTALLOGINOPTIONS............................................................... 89 6.1.49. AUTHENTICATION ................................................................................................. 89 6.2. MILI_PROPERTIES ......................................................................................................... 90 6.2.1. MANUFACTURER....................................................................................................... 90 6.2.2. MODELNUMBER ........................................................................................................ 90 6.2.3. DESCRIPTION ........................................................................................................... 90 6.2.4. SERIALNUMBER........................................................................................................ 90 6.2.5. ACTIVEFIRMWAREVERSION .................................................................................. 91 6.2.6. FIRMWAREVERSIONONFLASH............................................................................... 92 6.2.7. BIOSVERSION........................................................................................................... 92 6.2.8. BOOTCODEVERSION ............................................................................................... 92 6.2.9. FIRMWARESTATUS .................................................................................................. 92 6.2.10. ISCSIVERSIONMIN................................................................................................ 93 6.2.11. ISCSIVERSIONMAX ............................................................................................... 93 6.2.12. MAXCDBLENGTH .................................................................................................... 93 6.2.13. MAXMTUSIZE.......................................................................................................... 93 6.2.14. LDTO......................................................................................................................... 95 6.2.15. DEFAULTETO........................................................................................................... 95 6.2.16. VLDCAPABLE........................................................................................................... 95 6.2.17. VLDENABLED .......................................................................................................... 96 6.2.18. VENDORID............................................................................................................... 96 6.2.19. DEVICEID ................................................................................................................ 96 6.2.20. SUBSYSDEVICEID ................................................................................................. 96 6.2.21. SUBSYSVENDORID................................................................................................ 97 6.2.22. BUSNUMBER ........................................................................................................... 97 6.2.23. DEVICENUMBER..................................................................................................... 97 6.2.24. FUNCTIONNUMBER ............................................................................................... 97 6.2.25. DRIVERNAME.......................................................................................................... 98 6.2.26. DRIVERVERSION ................................................................................................... 98 6.2.27. IFNAME .................................................................................................................... 98 6.2.28. MACADDRESS......................................................................................................... 98 6.2.29. MAXBITSPERSECOND ........................................................................................... 99 6.2.30. MAXPACKETSPERSECONDPERNIC ..................................................................... 99 6.2.31. INITIATORISCSINAME.......................................................................................... 99 6.2.32. INITIATORALIAS .................................................................................................. 100 6.2.33. DEFAULTISCSINAME ........................................................................................... 100 6.2.34. INITIALR2T ........................................................................................................... 100 6.2.35. IMMEDIATEDATA ................................................................................................. 100 6.2.36. MAXCONNECTIONS ............................................................................................. 101 6.2.37. MAXOUTSTANDINGR2T ...................................................................................... 101 6.2.38. FIRSTBURSTLENGTH .......................................................................................... 101 6.2.39. MAXBURSTLENGTH ............................................................................................. 101 6.2.40. DEFAULTTIME2WAIT........................................................................................... 103 6.2.41. DEFAULTTIME2RETAIN....................................................................................... 103 6.2.42. ERRORRECOVERYLEVEL ..................................................................................... 103 6.2.43. DATAPDUINORDER.............................................................................................. 103 6.2.44. DATASEQUENCEINORDER ................................................................................. 104 6.2.45. HEADERDIGEST ................................................................................................... 104 6.2.46. DATADIGEST ........................................................................................................ 104 6.2.47. MAXRECVDATASEGMENTLENGTH .................................................................... 104 6.2.48. TCPWINDOWSIZE................................................................................................ 106 6.2.49. INITIALR2T ........................................................................................................... 106 6.2.50. IMMEDIATEDATA ................................................................................................. 106 6.2.51. AUTHENTICATIONMETHOD ............................................................................... 106 6.2.52. INITIATORCHAPNAME ........................................................................................ 108 6.2.53. INITIATORSECRET............................................................................................... 108

Table of Contents

8

6.2.54. TARGETCHAPNAME ............................................................................................. 108 6.2.55. TARGETSECRET.................................................................................................... 109 6.2.56. HEADERDIGEST ................................................................................................... 109 6.2.57. DATADIGEST ........................................................................................................ 109 6.2.58. IPADDRESS ........................................................................................................... 110 6.2.59. SUBNETMASK ....................................................................................................... 110 6.2.60. GATEWAY .............................................................................................................. 110 6.2.61. IPADDRESS ........................................................................................................... 110 6.2.62. MACADDRESS....................................................................................................... 111 6.2.63. VENDORID............................................................................................................. 111 6.2.64. DEVICEID .............................................................................................................. 111 6.2.65. SUBSYSDEVICEID ............................................................................................... 111 6.2.66. SUBSYSVENDORID.............................................................................................. 112 6.2.67. BUSNUMBER ......................................................................................................... 112 6.2.68. DEVICENUMBER................................................................................................... 112 6.2.69. FUNCTIONNUMBER ............................................................................................. 112 6.2.70. DRIVERNAME........................................................................................................ 113 6.2.71. DRIVERVERSION ................................................................................................. 113 6.2.72. DHCPSERVERAVAILABLE ................................................................................... 113 6.2.73. DHCPOBTAINNEWIPADDRESS.......................................................................... 113 6.2.74. DHCPENABLED ..................................................................................................... 114 6.2.75. INITIATORIPADDRESS ....................................................................................... 114 6.2.76. INITIATORSUBNETMASK ................................................................................... 114 6.2.77. DEFAULTGATEWAY.............................................................................................. 114 6.2.78. IPVERSIONSUPPORTED...................................................................................... 116 6.2.79. VLANID .................................................................................................................. 116 6.2.80. PORTSPEED........................................................................................................... 116 6.2.81. PORTMAXSPEED................................................................................................... 116 6.2.82. MAXFRAMESIZE ................................................................................................... 117 6.2.83. LINKSTATUS ......................................................................................................... 117 6.2.84. ACTIVEPORT ......................................................................................................... 117 6.2.85. MACADDRESS....................................................................................................... 117 6.2.86. MAXBYTESPERSECONDPERISCSI..................................................................... 118 6.2.87. MAXIOSPERSECONDPERISCSI ......................................................................... 118 6.2.88. PORTROWSTATUS ............................................................................................... 118 6.2.89. PORTALROLE ........................................................................................................ 118 6.2.90. PORTALPROTOCOL .............................................................................................. 119 6.2.91. PORTALTAG........................................................................................................... 119 6.2.92. SEQUENCENUMBER............................................................................................. 119 6.2.93. TIMESTAMP ........................................................................................................... 119 6.2.94. SEVERITY .............................................................................................................. 120 6.2.95. DESCRIPTION....................................................................................................... 120 6.2.96. ERRORCODE ......................................................................................................... 120 6.2.97. NODEROLES.......................................................................................................... 120 6.2.98. PORTALCOUNT ..................................................................................................... 121 6.2.99. NODECOUNT......................................................................................................... 121 6.2.100. SESSIONCOUNT ................................................................................................ 121 6.2.101. SESSIONFAILURECOUNT................................................................................. 121 6.2.102. LASTSESSIONFAILURETYPE............................................................................ 123 6.2.103. LASTSESSIONRMTNODENAME ....................................................................... 123 6.2.104. SESSIONDIGESTERRORS ................................................................................ 123 6.2.105. SESSIONCONNECTIONTIMEOUT.................................................................... 123 6.2.106. SESSIONFORMATERRORS ............................................................................... 124 6.2.107. LOGINFAILURES ................................................................................................ 124 6.2.108. LASTFAILURETIME ............................................................................................ 124 6.2.109. LASTFAILURETYPE ............................................................................................ 124

Table of Contents

9

6.2.110. LASTTGTFAILURENAME.................................................................................... 125 6.2.111. LASTTGTFAILUREADDR.................................................................................... 125 6.2.112. LOGINACCEPTRSPS .......................................................................................... 125 6.2.113. LOGINOTHERFAILRSPS .................................................................................... 125 6.2.114. LOGINREDIRECTRSPS ...................................................................................... 127 6.2.115. LOGINAUTHFAILRSPS ...................................................................................... 127 6.2.116. LOGINAUTHFAILS.............................................................................................. 127 6.2.117. LOGINNEGOFAILS ............................................................................................. 127 6.2.118. LOGOUTNORMALS............................................................................................. 129 6.2.119. LOGOUTOTHERS................................................................................................ 129 6.2.120. ETO....................................................................................................................... 129 6.2.121. TARGETIPADDRESS .......................................................................................... 129 6.2.122. TARGETPORTNUMBER ...................................................................................... 131 6.2.123. PORTALGROUPTAG ........................................................................................... 131 6.2.124. INITIALR2T ......................................................................................................... 131 6.2.125. IMMEDIATEDATA ............................................................................................... 131 6.2.126. AUTHENTICATIONMETHOD ............................................................................. 133 6.2.127. INITIATORCHAPNAME ...................................................................................... 133 6.2.128. INITIATORSECRET ............................................................................................ 133 6.2.129. TARGETCHAPNAME ........................................................................................... 134 6.2.130. TARGETSECRET ................................................................................................. 134 6.2.131. HEADERDIGEST ................................................................................................. 134 6.2.132. DATADIGEST ...................................................................................................... 135 6.2.133. INITIALR2T ......................................................................................................... 135 6.2.134. IMMEDIATEDATA ............................................................................................... 135 6.2.135. MAXCONNECTIONS........................................................................................... 135 6.2.136. MAXOUTSTANDINGR2T.................................................................................... 136 6.2.137. FIRSTBURSTLENGTH ........................................................................................ 136 6.2.138. MAXBURSTLENGTH ........................................................................................... 136 6.2.139. DEFAULTTIME2WAIT ........................................................................................ 136 6.2.140. DEFAULTTIME2RETAIN .................................................................................... 137 6.2.141. ERRORRECOVERYLEVEL................................................................................... 137 6.2.142. DATAPDUINORDER ........................................................................................... 137 6.2.143. DATASEQINORDER ........................................................................................... 137 6.2.144. SESSIONDIRECTION ........................................................................................ 138 6.2.145. CMDPDUS............................................................................................................ 138 6.2.146. RSPPDUS ............................................................................................................. 138 6.2.147. TXDATAOCTETSHIGH ....................................................................................... 138 6.2.148. RXDATAOCTETSHIGH....................................................................................... 139 6.2.149. DIGESTERRORS................................................................................................. 139 6.2.150. CXNTIMEOUTERRORS ...................................................................................... 139 6.2.151. SESSIONTARGETALIAS.................................................................................... 139 6.2.152. AUTHENTICATIONMETHOD ............................................................................. 141 6.2.153. HEADERDIGEST ................................................................................................. 141 6.2.154. DATADIGEST ...................................................................................................... 141 6.2.155. MAXRECVDATASEGMENTLENGTH.................................................................. 141 6.2.156. TCPWINDOWSIZE ............................................................................................. 142 6.2.157. TCPMSS ............................................................................................................... 142 6.2.158. ISCSICONNECTIONID ...................................................................................... 142 6.2.159. STATUS................................................................................................................ 142 6.2.160. SOURCEPORTNUMBER ..................................................................................... 144 6.2.161. DESTINATIONPORTNUMBER........................................................................... 144 6.2.162. SOURCEIPADDRESS ......................................................................................... 144 6.2.163. DESTINATIONIPADDRESS............................................................................... 144 6.2.164. REDIRECTEDDESTINATIONPORT................................................................... 145 6.2.165. REDIRECTEDDESTINATIONIPADDRESS ....................................................... 145

Table of Contents

10

6.2.166. SESSIONTSIH .................................................................................................... 145 6.2.167. SESSIONISID ..................................................................................................... 145 6.2.168. SESSIONINITIATORNAME ............................................................................... 146 6.2.169. SESSIONSTATUS............................................................................................... 146 6.2.170. ISCSIBOOT ......................................................................................................... 146 6.2.171. LUNNUMBER ....................................................................................................... 146 6.2.172. LUNSIZE .............................................................................................................. 147 6.2.173. DEVICEVENDORNAME ...................................................................................... 147 6.2.174. DEVICEMODELNUMBER.................................................................................... 147 6.2.175. IPADDRESS......................................................................................................... 147 6.2.176. PORTNUMBER..................................................................................................... 148 6.2.177. INITIALR2T ......................................................................................................... 148 6.2.178. IMMEDIATEDATA ............................................................................................... 148 6.2.179. AUTHENTICATIONMETHOD ............................................................................. 148 6.2.180. INITIATORCHAPNAME ...................................................................................... 150 6.2.181. INITIATORSECRET ............................................................................................ 150 6.2.182. TARGETCHAPNAME ........................................................................................... 150 6.2.183. TARGETSECRET ................................................................................................. 151 6.2.184. PORTIDENTIFIER ............................................................................................... 151 6.2.185. ISCSIBOOT ......................................................................................................... 151 6.2.186. TARGETNAME ..................................................................................................... 151 6.2.187. TARGETISCSINAME........................................................................................... 153 6.2.188. TARGETALIAS..................................................................................................... 153 6.2.189. DEFAULTLOGINPORTAL ................................................................................... 153 6.2.190. DEFAULTINTRPORT........................................................................................... 153 6.2.191. SLPSCOPES......................................................................................................... 154 6.2.192. SLPQUERYLIST................................................................................................... 154 6.2.193. IPADDRESS......................................................................................................... 154 6.2.194. PORTNUMBER..................................................................................................... 154 6.2.195. INITIALR2T ......................................................................................................... 155 6.2.196. IMMEDIATEDATA ............................................................................................... 155 6.2.197. INITIATORCHAPNAME ...................................................................................... 155 6.2.198. INITIATORSECRET ............................................................................................ 156 6.2.199. TARGETCHAPNAME ........................................................................................... 156 6.2.200. TARGETSECRET ................................................................................................. 156 6.2.201. AUTHENTICATIONMETHOD ............................................................................. 157 6.2.202. HEADERDIGEST ................................................................................................. 157 6.2.203. DATADIGEST ...................................................................................................... 157 6.2.204. IPADDRESS......................................................................................................... 157 6.2.205. PORTNUMBER..................................................................................................... 158 6.2.206. PORTIDENTIFIER ............................................................................................... 158 6.2.207. PORTMACADDRESS .......................................................................................... 158 6.2.208. SLPENABLED ...................................................................................................... 158 6.2.209. ISNSENABLED .................................................................................................... 160 6.2.210. DEFAULTINITIATORPORT ................................................................................ 160 6.3. DATA TYPES ................................................................................................................. 160 6.4. COMMON ERROR MESSAGES ................................................................................... 161

1. Revision History

11

1. Revision History May 2008 First Release

2. Introduction 2.1. Glossary

13

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.

Property : 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.

2.2. 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.

3. Using the Command-Line Interface 3.1. Connecting to the BladeEngine server using CLI

15

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

3. Using the Command-Line Interface 3.2. Invoking CLI

16

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 Description -t takes in transport as argument. Valid transports are telnet and ssh

-u

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 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

-s This option takes the IP address and an optional port number (default is 22 for ssh). If this 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.

-f takes script file as argument. The CLI program will exit gracefully upon execution of the script file. This option cannot be used along with a command as an argument.

command A basic command or a OEMSE command can be given as a command line argument. The 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.

3. Using the Command-Line Interface 3.2. Invoking CLI

17

• 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.

3. Using the Command-Line Interface 3.3. Accessing Help

18

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.

4. Basic Commands 4.1. common options

19

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.

4.1. common options

The following are the common options that can be used with any of the commands

Parameter Description -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 Description format=< value >

Format controls the structure of the output text. The only < value > supported format is "text"

terse Selects the level of detail included in the output to terse. This option cannot be used in conjunction with verbose.

verbose Selects the level of detail included in the output to verbose. This option cannot be used in conjunction with terse.

error The option to select the level of detail included in the output to error is not supported.

language=< value >

Language selects the translation of text. < value > is a 3-character string identifier of language are specified in ISO 639.2. The only < value > supported is "eng" (for English).

begin When multiple items are returned in the output begin/end control where to start in the list. "end" is not supported.

order=< value >

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.

count=< value >

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

4. Basic Commands 4.3. cd

20

4.3. cd

Command

cd

Description

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 Description -default takes the current working group to default which is root SM-CLP target

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

None

Optional Parameters

None

Possible Error Messages

Common Error Messages

4. Basic Commands 4.4. show

21

4.4. show

Command

show

Description

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 Description -default function is not defined in SM-CLP 1.0a document

-d

This option accepts a filter that is used to display the output. Valid values for Filters are

• 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

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.

SM-CLP target


Required Parameters

None

Optional Parameters

None



4. Basic Commands 4.5. set

22

4.5. set

Command

set

Description

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 Description SM-CLP target


< property > 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.

< value > The value is specific to the given command. Please type "help [property]" for applicable values.

Required Parameters

None

Optional Parameters

None


Common Error Messages Read only property

4. Basic Commands 4.6. OEMSESaveConfig

23

4.6. OEMSESaveConfig

Command

OEMSESaveConfig

Description

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 Description -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 Description

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

None



4. Basic Commands 4.7. help

24

4.7. help

Command

help

Description

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 Description

group The SM-CLP target for which the property or verb belongs. The valid list of SM-CLP targets are listed in the group table.

property | verb

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

None

Optional Parameters

None



4. Basic Commands 4.8. version

25

4.8. version

Command

version

Description

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

None

Optional Parameters

None



4. Basic Commands 4.9. exit

26

4.9. exit

Command

exit

Description

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

None

Optional Parameters

None



5. OEMSE Commands 5.1. Group Maps

27

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.

5.1. Group Maps

The following tree represents the SM-CLP targets, properties and verbs with their associations to each other. Convention Meaning * Property ! 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 (Read-Only) | |-> *ModelNumber (Read-Only) | |-> *Description (Read-Only) | |-> *SerialNumber (Read-Only) | |-> *ActiveFirmwareVersion (Read-Only) | |-> *FirmwareVersionOnFlash (Read-Only) | |-> *BIOSVersion (Read-Only) | |-> *BootCodeVersion (Read-Only) | |-> *FirmwareStatus (Read-Only) | |-> *iSCSIVersionMin (Read-Only) | |-> *iSCSIVersionMax (Read-Only) | |-> *MaxCDBLength (Read-Only) | |-> *MaxMTUSize (Read-Only) | |-> *LDTO (Read-Only) | |-> *DefaultETO (Read-Only) | |-> *VLDCapable (Read-Only) | |-> *VLDEnabled | |-> !OEMSEEraseConfiguration ( ) | |-> !OEMSEUpgradeFlashROM ( UFIFileName ) |-> LogicalHBA[0-31] |-> !OEMSEEnableNIC ( PhysicalHBANumber ) |-> !OEMSEEnableiSCSI ( PhysicalHBANumber ) |-> !OEMSEDisableNIC ( PhysicalHBANumber ) |-> !OEMSEDisableiSCSI ( PhysicalHBANumber ) |-> NIC | |-> PhysicalHBA[0-7] | |-> PCI | | |-> *VendorID (Read-Only) | | |-> *DeviceID (Read-Only) | | |-> *SubsysDeviceID (Read-Only) | | |-> *SubsysVendorID (Read-Only) | | |-> *BusNumber (Read-Only) | | |-> *DeviceNumber (Read-Only) | | |-> *FunctionNumber (Read-Only) | |-> Driver | | |-> *DriverName (Read-Only) | | |-> *DriverVersion (Read-Only)


28

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


29

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


30

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


31

| | |-> *LUNSize (Read-Only) | | |-> *DeviceVendorName (Read-Only) | | |-> *DeviceModelNumber (Read-Only) | | |-> !OEMSETestUnitReady ( ) | | |-> !OEMSEStdInquiry ( ) | | |-> !OEMSEReadCapacity ( ) | | |-> !OEMSESCSIRead ( StartBlockAddress Count ) | | |-> !OEMSESCSIWrite ( StartBlockAddress Count ) | |-> PersistentLogin[0-127] | | |-> PersistentLoginPortal | | | |-> *IPAddress (Read-Only) | | | |-> *PortNumber (Read-Only) | | |-> PersistentLoginOptions | | | |-> *InitialR2T | | | |-> *ImmediateData | | | |-> Authentication | | | | |-> *AuthenticationMethod (Read-Only) | | | | |-> *InitiatorCHAPName (Read-Only) | | | | |-> *InitiatorSecret (Read-Only) | | | | |-> *TargetCHAPName (Read-Only) | | | | |-> *TargetSecret (Read-Only) | | |-> *PortIdentifier (Read-Only) | | |-> *iSCSIBoot | | |-> *TargetName (Read-Only) | |-> *TargetISCSIName (Read-Only) | |-> *TargetAlias (Read-Only) | |-> *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 (Read-Only) | | | |-> *PortNumber (Read-Only) | | |-> !OEMSEDiscoveryiSNSThruDHCP ( ) | | |-> !OEMSEAddiSNSEntry ( IPAddress PortNum ) | | |-> !OEMSEDeleteiSNSEntry ( InstanceNumber ) | |-> SendTargetPortal[0-9] | | |-> SendTargetPortalLoginOptions | | | |-> *InitialR2T | | | |-> *ImmediateData | | | |-> Authentication | | | | |-> *InitiatorCHAPName | | | | |-> *InitiatorSecret | | | | |-> *TargetCHAPName | | | | |-> *TargetSecret | | | | |-> *AuthenticationMethod | | | |-> *HeaderDigest | | | |-> *DataDigest | | |-> *IPAddress (Read-Only) | | |-> *PortNumber (Read-Only) | | |-> *PortIdentifier (Read-Only) | | |-> *PortMacAddress (Read-Only) | | |-> !OEMSEDiscoverTargets ( )

5. OEMSE Commands 5.2. OEMSEEraseConfiguration

32

| |-> *SLPEnabled | |-> *iSNSEnabled | |-> *DefaultInitiatorPort | |-> !OEMSEAddSendTargetPortal ( IPAddress PortNumber [PortIdentifier] ) | |-> !OEMSEDeleteSendTargetPortal ( InstanceNumber ) | |-> !OEMSERefreshAvailableTargets ( ) |-> !OEMSEAddTarget ( TargetName IPAddress PortNumber ) |-> !OEMSEDeleteTarget ( InstanceNumber )

5.2. OEMSEEraseConfiguration

Command

OEMSEEraseConfiguration

Description

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 Description SM-CLP-target


Required Parameters

None

Optional Parameters

None


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.,

5. OEMSE Commands 5.3. OEMSEUpgradeFlashROM

33

5.3. OEMSEUpgradeFlashROM

Command

OEMSEUpgradeFlashROM

Description

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]


SM-CLP-target Optional input that indicates the SM-CLP target group for the given command. This overrides the current group. ".." indcates parent group. "/" indicates root group.

-OEMSEParams


Required Parameters

Parameter Name

Data Type


UFIFileName string 3 255 3 The path to the UFI file that will be used to upgrade the BladeEngine firmware.

Optional Parameters

None


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.,

5. OEMSE Commands 5.4. OEMSEEnableNIC

34

5.4. OEMSEEnableNIC

Command

OEMSEEnableNIC

Description

Enables NIC for the BladeEngine controller instance for the domain.

Syntax

OEMSEEnableNIC [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name Data Type


PhysicalHBANumber integer 0 7 0 The instance number of the BladeEngine Controller for which the NIC is to be enabled on this domain.

Optional Parameters

None



5. OEMSE Commands 5.5. OEMSEEnableiSCSI

35

5.5. OEMSEEnableiSCSI

Command

OEMSEEnableiSCSI

Description

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]



-OEMSEParams


Required Parameters



PhysicalHBANumber integer 0 7 0 The instance number of the BladeEngine Controller for which iSCSI is to be enabled on this domain.

Optional Parameters

None


Common Error Messages Memory allocation failed,

5. OEMSE Commands 5.6. OEMSEDisableNIC

36

5.6. OEMSEDisableNIC

Command

OEMSEDisableNIC

Description

Disables NIC for the BladeEngine controller instance for the domain.

Syntax

OEMSEDisableNIC [common_options] -OEMSEparams PhysicalHBANumber="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters



PhysicalHBANumber integer 0 7 0

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

None



5. OEMSE Commands 5.7. OEMSEDisableiSCSI

37

5.7. OEMSEDisableiSCSI

Command

OEMSEDisableiSCSI

Description

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]



-OEMSEParams


Required Parameters



PhysicalHBANumber integer 0 7 0

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

None



5. OEMSE Commands 5.8. OEMSEAddRouteTableEntry

38

5.8. OEMSEAddRouteTableEntry

Command

OEMSEAddRouteTableEntry

Description

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="10.12.0.1",SubnetMask="255.255.255.0",Gateway="10.12.2.62"

Syntax

OEMSEAddRouteTableEntry [common_options] -OEMSEparams IPAddress="< value >",SubnetMask="< value >",Gateway="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name

Data Type Min Max Default Description

IPAddress ipaddress 0 16 0.0.0.0 The IP address of the entry to be entered in the route table.

SubnetMask subnetmask 0 255 255.255.255.0 The Subnet mask of the entry to be entered in the route table.

Gateway ipaddress 1 64 1 The Gateway address of the entry to be entered in the route table.

Optional Parameters

None


Common Error Messages Invalid value,

5. OEMSE Commands 5.9. OEMSEDeleteRouteTableEntry

39

5.9. OEMSEDeleteRouteTableEntry

Command

OEMSEDeleteRouteTableEntry

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


InstanceNumber string 0 15 0

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

None



5. OEMSE Commands 5.10. OEMSEAddARPTableEntry

40

5.10. OEMSEAddARPTableEntry

Command

OEMSEAddARPTableEntry

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


IPAddress ipaddress 0 16 0.0.0.0 IP address of the entry to be added to the ARP table.

MACAddress string 17 17 00-00-00-00-00-00

The MAC address of the entry to be added to the ARP table.

Optional Parameters

None



5. OEMSE Commands 5.11. OEMSEDeleteARPTableEntry

41

5.11. OEMSEDeleteARPTableEntry

Command

OEMSEDeleteARPTableEntry

Description

This command will delete the given ARP table entry.

Syntax

OEMSEDeleteARPTableEntry [common_options] -OEMSEparams InstanceNumber="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name

Data Type



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

None



5. OEMSE Commands 5.12. OEMSEConfigureIPAddress

42

5.12. OEMSEConfigureIPAddress

Command

OEMSEConfigureIPAddress

Description

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="172.20.14.1",SubnetMask="255.255.255.0". 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-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name

Data Type Min Max Default Description

IPAddress ipaddress 0 0 0.0.0.0 The IP Address to be configured for the port.

SubnetMask subnetmask 0 255 255.255.255.0 The Subnet mask to be configured for the port.

Optional Parameters

Parameter Name

Data Type


Gateway ipaddress 0 0 0.0.0.0 The Default Gateway to be configured for the port.

VLANID integer 0 4095 0 The VLANID to be configured for the port.


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

5. OEMSE Commands 5.13. OEMSEConfigureDHCP

43

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.,

5.13. OEMSEConfigureDHCP

Command

OEMSEConfigureDHCP

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


EnableDHCP list 4 5 False The mandatory parameter to configure DHCP settings.

Optional Parameters

None


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.,

5. OEMSE Commands 5.14. OEMSERefreshNICConfig

44

The DHCP settings match the existing configure. No changes have been made to the configuration.,

5.14. OEMSERefreshNICConfig

Command

OEMSERefreshNICConfig

Description

This command displays the current NIC configuration properties.

Syntax

OEMSERefreshNICConfig [common_options] [SM-CLP-target]

Options

[common_options]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.15. OEMSEPing

45

5.15. OEMSEPing

Command

OEMSEPing

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


IPAddress ipaddress 0 0 0.0.0.0 The IPv4 address to which the ICMP ping request will be sent.

Optional Parameters

None



5. OEMSE Commands 5.16. OEMSERefreshEventLog

46

5.16. OEMSERefreshEventLog

Command

OEMSERefreshEventLog

Description

This command retrieves the current event log entries from the BladeEngine firmware.

Syntax

OEMSERefreshEventLog [common_options] [SM-CLP-target]

Options

[common_options]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.17. OEMSEClearEventLog

47

5.17. OEMSEClearEventLog

Command

OEMSEClearEventLog

Description

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]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.18. OEMSETestUnitReady

48

5.18. OEMSETestUnitReady

Command

OEMSETestUnitReady

Description

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]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.19. OEMSEStdInquiry

49

5.19. OEMSEStdInquiry

Command

OEMSEStdInquiry

Description

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]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.20. OEMSEReadCapacity

50

5.20. OEMSEReadCapacity

Command

OEMSEReadCapacity

Description

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]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.21. OEMSESCSIRead

51

5.21. OEMSESCSIRead

Command

OEMSESCSIRead

Description

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]



-OEMSEParams


Required Parameters



StartBlockAddress integer 0 65535 0 This parameter indicates the first block address from where to begin the SCSI Read/Write.

Count integer 1 65535 1 This parameter accepts count of number of blocks to be transferred to the device.

Optional Parameters

None



5. OEMSE Commands 5.22. OEMSESCSIWrite

52

5.22. OEMSESCSIWrite

Command

OEMSESCSIWrite

Description

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]



-OEMSEParams


Required Parameters



StartBlockAddress integer 0 65535 0 This parameter indicates the first block address from where to begin the SCSI Read/Write.

Count integer 1 65535 1 This parameter accepts count of number of blocks to be transferred to the device.

Optional Parameters

None



5. OEMSE Commands 5.23. OEMSESetPersistent

53

5.23. OEMSESetPersistent

Command

OEMSESetPersistent

Description

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]



-OEMSEParams


Required Parameters

None

Optional Parameters



IPAddress ipaddress 0 0 0.0.0.0 The IP address of the target to be made persistent.

PortNumber integer 1024 65535 1024 The Port number of the target to be made persistent.

PhysicalHBAInstanceNumber integer 0 255 0 A string input that gives the BladeEngine controller instance number.

LogicalHBAInstanceNumber integer 0 1 0

A string input that gives the logical HBA instance number. Note that each port of the controller is mapped to one logical HBA.



5. OEMSE Commands 5.24. OEMSELogin

54

5.24. OEMSELogin

Command

OEMSELogin

Description

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]



-OEMSEParams


Required Parameters

None

Optional Parameters



IPAddress ipaddress 0 0 0.0.0.0 The IP address of the target portal to login.

PortNumber integer 1024 65535 1024 The Port number of the target to login.

PhysicalHBAInstanceNumber integer 0 255 0 A string input that gives the BladeEngine controller instance number.

LogicalHBAInstanceNumber integer 0 1 0

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 1 224 iqn.se The initiator iSCSI Name for the session to login.


5. OEMSE Commands 5.25. OEMSELogout

55

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

5.25. OEMSELogout

Command

OEMSELogout

Description

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]



-OEMSEParams


Required Parameters

None

Optional Parameters

Parameter Name

Data Type



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.



5. OEMSE Commands 5.26. OEMSEDeletePersistent

56

5.26. OEMSEDeletePersistent

Command

OEMSEDeletePersistent

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type




Optional Parameters

None



5. OEMSE Commands 5.27. OEMSEReScanLUNS

57

5.27. OEMSEReScanLUNS

Command

OEMSEReScanLUNS

Description

This command reports the LUNs on the system.

Syntax

OEMSEReScanLUNS [common_options] [SM-CLP-target]

Options

[common_options]



Required Parameters

None

Optional Parameters

None


Common Error Messages No session available to this target,

5. OEMSE Commands 5.28. OEMSEDiscoveryiSNSThruDHCP

58

5.28. OEMSEDiscoveryiSNSThruDHCP

Command

OEMSEDiscoveryiSNSThruDHCP

Description

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]



Required Parameters

None

Optional Parameters

None



5. OEMSE Commands 5.29. OEMSEAddiSNSEntry

59

5.29. OEMSEAddiSNSEntry

Command

OEMSEAddiSNSEntry

Description

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="172.40.2.1",PortNum="3205"

Syntax

OEMSEAddiSNSEntry [common_options] -OEMSEparams IPAddress="< value >",PortNum="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


IPAddress ipaddress 0 0 0.0.0.0 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 1024 65535 1024 The Port number of the iSNS server.

Optional Parameters

None



5. OEMSE Commands 5.30. OEMSEDeleteiSNSEntry

60

5.30. OEMSEDeleteiSNSEntry

Command

OEMSEDeleteiSNSEntry

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type



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

None



5. OEMSE Commands 5.31. OEMSEDiscoverTargets

61

5.31. OEMSEDiscoverTargets

Command

OEMSEDiscoverTargets

Description

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]



Required Parameters

None

Optional Parameters

None


Common Error Messages The BladeEngine iSCSI initiator TCP/IP settings are not configured. Please configure the TCP/IP settings before issuing this command.,

5. OEMSE Commands 5.32. OEMSEAddSendTargetPortal

62

5.32. OEMSEAddSendTargetPortal

Command

OEMSEAddSendTargetPortal

Description

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="172.40.2.1",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]



-OEMSEParams


Required Parameters

Parameter Name Data Type Min Max Default Description IPAddress ipaddress 0 0 0.0.0.0 The IP address of the sendtarget portal. PortNumber integer 1024 65535 1024 The Port Number of the SendTargetPortal.

Optional Parameters

Parameter Name

Data Type


PortIdentifier integer 0 1 0 A unique port identifier of the Initiator from which you can perform sendtargets discovery. The default value is 0.



5. OEMSE Commands 5.33. OEMSEDeleteSendTargetPortal

63

5.33. OEMSEDeleteSendTargetPortal

Command

OEMSEDeleteSendTargetPortal

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type



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

None



5. OEMSE Commands 5.34. OEMSERefreshAvailableTargets

64

5.34. OEMSERefreshAvailableTargets

Command

OEMSERefreshAvailableTargets

Description

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]



Required Parameters

None

Optional Parameters

None


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.,

5. OEMSE Commands 5.35. OEMSEAddTarget

65

5.35. OEMSEAddTarget

Command

OEMSEAddTarget

Description

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.2003-07.com.serverengines:tgt1",IPAddress="17.2.21.15",PortNumber="3205"

Syntax

OEMSEAddTarget [common_options] -OEMSEparams TargetName="< value >",IPAddress="< value >",PortNumber="< value >" [SM-CLP-target]

Options

[common_options]



-OEMSEParams


Required Parameters

Parameter Name

Data Type


TargetName string 6 255 6 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 0 0 0.0.0.0 The IP address of the target to be added. PortNumber integer 1024 65535 1024 The Port number of the target to be added.

Optional Parameters

None



5. OEMSE Commands 5.36. OEMSEDeleteTarget

66

5.36. OEMSEDeleteTarget

Command

OEMSEDeleteTarget

Description

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]



-OEMSEParams


Required Parameters

Parameter Name

Data Type




Optional Parameters

None



6. Appendix 6.1. MILI_Groups

67

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), Attributes (access permissions), Multi-instance (yes or no) along with its adjacent groups, properties and OEMSECommands.

6.1.1. ROOT

String Identifier ROOT

Group Description Root Group

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName ROOT

Subgroups 1. BladeEngine 2. LogicalHBA

Properties for the group None

OEMSECommands for the group None

Table 3: ROOT

6.1.2. BladeEngine

String Identifier BladeEngine

Group Description This group instance corresponds to a single BladeEngine controller in this host.

Attributes dynamic

MultiInstance Yes

MaxInstance 8


Subgroups None

Properties for the group

1. Manufacturer 2. ModelNumber 3. Description 4. SerialNumber 5. ActiveFirmwareVersion 6. FirmwareVersionOnFlash 7. BIOSVersion 8. BootCodeVersion 9. FirmwareStatus 10. iSCSIVersionMin 11. iSCSIVersionMax 12. MaxCDBLength 13. MaxMTUSize 14. LDTO 15. DefaultETO 16. VLDCapable 17. VLDEnabled

OEMSECommands for the group

1. OEMSEEraseConfiguration


68

2. OEMSEUpgradeFlashROM

Table 4: BladeEngine

6.1.3. LogicalHBA

String Identifier LogicalHBA

Group Description This group instance corresponds to a single port of a BladeEngine controller functioning as an iSCSI Initiator.

Attributes dynamic

MultiInstance Yes

MaxInstance 32


Subgroups 1. iSCSI



1. OEMSEEnableiSCSI 2. OEMSEDisableiSCSI

Table 5: LogicalHBA

6.1.4. NIC

String Identifier NIC

Group Description 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.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName LogicalHBA

Subgroups None



None

Table 6: NIC

6.1.5. PhysicalHBA

String Identifier PhysicalHBA

Group Description PhysicalHBA group that corresponds to NIC for this domain.

Attributes dynamic

MultiInstance Yes

MaxInstance 8

Parent GroupName NIC

Subgroups None



Table 7: PhysicalHBA


69


70

6.1.6. PCI

String Identifier PCI

Group Description This group contains the PCI properties of the BladeEngine controller.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName PhysicalHBA

Subgroups None



None

Table 8: PCI

6.1.7. Driver

String Identifier Driver

Group Description This group corresponds to information about the iSCSI initiator driver.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None



None

Table 9: Driver

6.1.8. QOS

String Identifier QOS

Group Description TBD group

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None



Table 10: QOS


71

6.1.9. iSCSI

String Identifier iSCSI

Group Description This represents an iSCSI initiator node and is uniquely identified by its iSCSI name (IQN name).

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName LogicalHBA

Subgroups

1. InitiatoriSCSIName 2. InitiatorDefaultLoginOptions 3. InitiatorLoginOptions 4. PhysicalHBA 5. Target 6. Discovery



1. OEMSEAddTarget 2. OEMSEDeleteTarget

Table 11: iSCSI

6.1.10. InitiatoriSCSIName

String Identifier InitiatoriSCSIName

Group Description This group contains iSCSI name configuration details for the initiator node.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName iSCSI

Subgroups None


1. InitiatoriSCSIName 2. InitiatorAlias 3. DefaultiSCSIName


None

Table 12: InitiatoriSCSIName


72

6.1.11. InitiatorDefaultLoginOptions

String Identifier InitiatorDefaultLoginOptions

Group Description This group contains the default login options for the iSCSI initiator node.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


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


None

Table 13: InitiatorDefaultLoginOptions

6.1.12. InitiatorLoginOptions

String Identifier InitiatorLoginOptions

Group Description This group contains the configured login options for the iSCSI Initiator node.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups 1. Authentication


1. InitialR2T 2. ImmediateData 3. HeaderDigest 4. DataDigest


None

Table 14: InitiatorLoginOptions


73

6.1.13. Authentication

String Identifier Authentication

Group Description This group contains the configured connection authentication related login options for the iSCSI Initiator node.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName InitiatorLoginOptions

Subgroups None


1. AuthenticationMethod 2. InitiatorCHAPName 3. InitiatorSecret 4. TargetCHAPName 5. TargetSecret


None

Table 15: Authentication

6.1.14. PhysicalHBA

String Identifier PhysicalHBA

Group Description This represents properties of the BladeEngine controller instance under this domain.

Attributes dynamic

MultiInstance Yes

MaxInstance 8


Subgroups

1. RouteTable 2. ARPTable 3. PCI 4. Driver 5. Network 6. EventLog 7. SNMP



1. OEMSEPing

Table 16: PhysicalHBA

6.1.15. RouteTable

String Identifier RouteTable

Group Description This group contains the route table entries for the BladeEngine iSCSI initiator firmware.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups 1. RouteTableEntry


74



1. OEMSEAddRouteTableEntry 2. OEMSEDeleteRouteTableEntry

Table 17: RouteTable

6.1.16. RouteTableEntry

String Identifier RouteTableEntry

Group Description A route table entry in the BladeEngine iSCSI initiator firmware.

Attributes dynamic

MultiInstance Yes

MaxInstance 16

Parent GroupName RouteTable

Subgroups None


1. IPAddress 2. SubnetMask 3. Gateway


Table 18: RouteTableEntry

6.1.17. ARPTable

String Identifier ARPTable

Group Description This group contains the ARP table entries for the BladeEngine iSCSI initiator firmware.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups 1. ARPTableEntry



1. OEMSEAddARPTableEntry 2. OEMSEDeleteARPTableEntry

Table 19: ARPTable

6.1.18. ARPTableEntry

String Identifier ARPTableEntry

Group Description This group instance corresponds to a ARP Table Entry for the BladeEngine iSCSI initiator firmware.

Attributes dynamic

MultiInstance Yes

MaxInstance 64

Parent GroupName ARPTable

Subgroups None

Properties for the group 1. IPAddress


75

2. MACAddress


None

Table 20: ARPTableEntry


76

6.1.19. PCI

String Identifier PCI

Group Description This group contains the PCI properties for the BladeEngine controller.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


1. VendorID 2. DeviceID 3. SubsysDeviceID 4. SubsysVendorID 5. BusNumber 6. DeviceNumber 7. FunctionNumber


None

Table 21: PCI

6.1.20. Driver

String Identifier Driver

Group Description This group contains information about the host operating system's BladeEngine iSCSI initiator driver.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None

Properties for the group 1. DriverName 2. DriverVersion


None

Table 22: Driver


77

6.1.21. Network

String Identifier Network

Group Description This group consists of the TCP/NIC configuration of the Network Port

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups

1. DHCP 2. TCPIPConfiguration 3. NICConfiguration 4. QOS


1. PortRowStatus 2. PortalRole 3. PortalProtocol 4. PortalTag


None

Table 23: Network

6.1.22. DHCP

String Identifier DHCP

Group Description This group contains the DHCP settings and related actions

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName Network

Subgroups None

Properties for the group 1. DHCPServerAvailable 2. DHCPObtainNewIPAddress


Table 24: DHCP


78

6.1.23. TCPIPConfiguration

String Identifier TCPIPConfiguration

Group Description This group consists of the TCP configuration of the Network port.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


1. DHCPEnabled 2. InitiatorIPAddress 3. InitiatorSubnetMask 4. DefaultGateway 5. IPVersionSupported 6. VLANID

OEMSECommands for the group 1. OEMSEConfigureIPAddress 2. OEMSEConfigureDHCP

Table 25: TCPIPConfiguration

6.1.24. NICConfiguration

String Identifier NICConfiguration

Group Description This group consists of the NIC configuration of the Network port

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


1. PortSpeed 2. PortMaxSpeed 3. MaxFrameSize 4. LinkStatus 5. ActivePort 6. MACAddress

OEMSECommands for the group 1. OEMSERefreshNICConfig

Table 26: NICConfiguration

6.1.25. QOS

String Identifier QOS

Group Description This group contains the properties of QoS.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None

Properties for the group 1. MaxBytesPerSecondPeriSCSI


79

2. MaxIosPerSecondPeriSCSI


Table 27: QOS

6.1.26. EventLog

String Identifier EventLog

Group Description This group contains the BladeEngine firmware event log entries and actions.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups 1. EventLogEntry



1. OEMSERefreshEventLog 2. OEMSEClearEventLog

Table 28: EventLog

6.1.27. EventLogEntry

String Identifier EventLogEntry

Group Description An event log entry from the BladeEngine firmware.

Attributes dynamic

MultiInstance Yes

MaxInstance 1024

Parent GroupName EventLog

Subgroups None


1. SequenceNumber 2. TimeStamp 3. Severity 4. Description 5. ErrorCode


Table 29: EventLogEntry


80

6.1.28. SNMP

String Identifier SNMP

Group Description This group contains all the SNMP properties.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


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


Table 30: SNMP


81

6.1.29. Target

String Identifier Target

Group Description This group represents the information about the targets that are available in the network.

Attributes dynamic

MultiInstance Yes

MaxInstance 64


Subgroups

1. TargetPortal 2. TargetLoginOptions 3. Session 4. LUN 5. PersistentLogin


1. ETO 2. TargetISCSIName 3. TargetAlias 4. DefaultLoginPortal 5. DefaultIntrPort


1. OEMSESetPersistent 2. OEMSELogin 3. OEMSELogout 4. OEMSEDeletePersistent 5. OEMSEReScanLUNS

Table 31: Target

6.1.30. TargetPortal

String Identifier TargetPortal

Group Description This group instance corresponds to a portal of the target identified by its IP address and port number.

Attributes dynamic

MultiInstance Yes

MaxInstance 64

Parent GroupName Target

Subgroups None


1. TargetIPAddress 2. TargetPortNumber 3. PortalGroupTag


None

Table 32: TargetPortal


82

6.1.31. TargetLoginOptions

String Identifier TargetLoginOptions

Group Description This group consists of the set of login options used to login to the target.

Attributes static

MultiInstance No

MaxInstance N/A






None

Table 33: TargetLoginOptions



Group Description This group consists of the set of connection authentication related login options used to create an iSCSI session with the target.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName TargetLoginOptions

Subgroups None




None



83

6.1.33. Session

String Identifier Session

Group Description This group instance corresponds to an active session with the target.

Attributes dynamic

MultiInstance Yes

MaxInstance 64


Subgroups

1. SessionNegotiatedLoginOptions 2. SNMP 3. Connection


1. SessionTSIH 2. SessionISID 3. SessionInitiatorName 4. SessionStatus 5. iSCSIBoot


None

Table 35: Session

6.1.34. SessionNegotiatedLoginOptions

String Identifier SessionNegotiatedLoginOptions

Group Description This group stores the negotiated login options when the session was created.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName Session

Subgroups None


1. InitialR2T 2. ImmediateData 3. MaxConnections 4. MaxOutstandingR2T 5. FirstBurstLength 6. MaxBurstLength 7. DefaultTime2Wait 8. DefaultTime2Retain 9. ErrorRecoveryLevel 10. DataPDUInOrder 11. DataSeqInOrder


None

Table 36: SessionNegotiatedLoginOptions


84

6.1.35. SNMP

String Identifier SNMP

Group Description This group instance corresponds to the SNMP properties under this particular session.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups None


1. SessionDirection 2. CmdPdus 3. RspPdus 4. TxDataOctetsHigh 5. RxDataOctetsHigh 6. DigestErrors 7. CxnTimeoutErrors 8. SessionTargetAlias


None

Table 37: SNMP

6.1.36. Connection

String Identifier Connection

Group Description This group instance corresponds to a connection for a session. A session can have a maximum of four connections.

Attributes dynamic

MultiInstance Yes

MaxInstance 4


Subgroups 1. ConnectionNegotiatedLoginOptions


1. iSCSIConnectionID 2. Status 3. SourcePortNumber 4. DestinationPortNumber 5. SourceIPAddress 6. DestinationIPAddress 7. RedirectedDestinationPort 8. RedirectedDestinationIPAddress


None

Table 38: Connection


85

6.1.37. ConnectionNegotiatedLoginOptions

String Identifier ConnectionNegotiatedLoginOptions

Group Description This group consists of the negotiated connection login options.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName Connection

Subgroups None


1. AuthenticationMethod 2. HeaderDigest 3. DataDigest 4. MaxRecvDataSegmentLength 5. TCPWindowSize 6. TCPMSS


Table 39: ConnectionNegotiatedLoginOptions

6.1.38. LUN

String Identifier LUN

Group Description This group instance corresponds to a LUN available behind this target.

Attributes dynamic

MultiInstance Yes

MaxInstance 512


Subgroups None


1. LUNNumber 2. LUNSize 3. DeviceVendorName 4. DeviceModelNumber


1. OEMSETestUnitReady 2. OEMSEStdInquiry 3. OEMSEReadCapacity 4. OEMSESCSIRead 5. OEMSESCSIWrite

Table 40: LUN


86

6.1.39. PersistentLogin

String Identifier PersistentLogin

Group Description This group instance corresponds to persistent login information for the target.

Attributes dynamic

MultiInstance Yes

MaxInstance 128


Subgroups 1. PersistentLoginPortal 2. PersistentLoginOptions


1. PortIdentifier 2. iSCSIBoot 3. TargetName


None

Table 41: PersistentLogin

6.1.40. PersistentLoginPortal

String Identifier PersistentLoginPortal

Group Description This group instance stores information about the portal involved in the leading connection with the target.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName PersistentLogin

Subgroups None

Properties for the group 1. IPAddress 2. PortNumber


None

Table 42: PersistentLoginPortal

6.1.41. PersistentLoginOptions

String Identifier PersistentLoginOptions

Group Description This group instance stores the login options to be used to create a persistent session with this target.

Attributes static

MultiInstance No

MaxInstance N/A



Properties for the group 1. InitialR2T 2. ImmediateData

OEMSECommands for the None


87

group

Table 43: PersistentLoginOptions



Group Description This group consists of the set of connection authentication related login options used to create a iSCSI session with the persistent session.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName PersistentLoginOptions

Subgroups None




None


6.1.43. Discovery

String Identifier Discovery

Group Description This group stores the discovery parameters configured for the Initiator node.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups

1. SLP 2. iSNS 3. SendTargetPortal


1. SLPEnabled 2. iSNSEnabled 3. DefaultInitiatorPort


1. OEMSEAddSendTargetPortal 2. OEMSEDeleteSendTargetPortal 3. OEMSERefreshAvailableTargets

Table 45: Discovery

6.1.44. SLP

String Identifier SLP

Group Description This group stores the SLP discovery parameters

Attributes static

MultiInstance No


88

MaxInstance N/A

Parent GroupName Discovery

Subgroups None

Properties for the group 1. SlpScopes 2. SlpQueryList


Table 46: SLP

6.1.45. iSNS

String Identifier iSNS

Group Description This group stores the iSNS discovery parameters.

Attributes static

MultiInstance No

MaxInstance N/A


Subgroups 1. iSNSEntry



1. OEMSEDiscoveryiSNSThruDHCP 2. OEMSEAddiSNSEntry 3. OEMSEDeleteiSNSEntry

Table 47: iSNS

6.1.46. iSNSEntry

String Identifier iSNSEntry

Group Description This group instance corresponds to an iSNS Server entry.

Attributes dynamic

MultiInstance Yes

MaxInstance 4

Parent GroupName iSNS

Subgroups None

Properties for the group 1. IPAddress 2. PortNumber


Table 48: iSNSEntry

6.1.47. SendTargetPortal

String Identifier SendTargetPortal

Group Description This group instance corresponds to a SendTarget Portal for discovering targets.

Attributes dynamic

MultiInstance Yes

MaxInstance 10



89

Subgroups 1. SendTargetPortalLoginOptions


1. IPAddress 2. PortNumber 3. PortIdentifier 4. PortMacAddress


1. OEMSEDiscoverTargets

Table 49: SendTargetPortal

6.1.48. SendTargetPortalLoginOptions

String Identifier SendTargetPortalLoginOptions

Group Description This group consists of the login options used to create a discovery session with the SendTarget Portal.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName SendTargetPortal





None

Table 50: SendTargetPortalLoginOptions



Group Description This group consists of the authentication options used to create a discovery session with the SendTarget Portal.

Attributes static

MultiInstance No

MaxInstance N/A

Parent GroupName SendTargetPortalLoginOptions

Subgroups None


1. InitiatorCHAPName 2. InitiatorSecret 3. TargetCHAPName 4. TargetSecret 5. AuthenticationMethod


None


6. Appendix 6.2. MILI_Properties

90

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), Attributes (access permissions), Min/Max/Default values and its parent group.

6.2.1. Manufacturer

String Identifier Manufacturer

Property Description The manufacturer of the BladeEngine controller.

Attributes Read-Only

min Value 0

max Value 32

default Value 0

Parent GroupName BladeEngine

Table 52: Manufacturer

6.2.2. ModelNumber

String Identifier ModelNumber

Property Description The model number of the BladeEngine controller.


min Value 1

max Value 32

default Value 1


Table 53: ModelNumber

6.2.3. Description

String Identifier Description

Property Description Description of the BladeEngine controller.


min Value 0

max Value 64

default Value 0


Table 54: Description

6.2.4. SerialNumber

String Identifier SerialNumber

Property Description

The serial number of the BladeEngine controller. The serial number is typically one of the MAC addresses assocated with BladeEngine.


min Value 1

max Value 32

default Value 1


91

Parent GroupName

BladeEngine

Table 55: SerialNumber

6.2.5. ActiveFirmwareVersion

String Identifier ActiveFirmwareVersion


The firmware version which is currently operational on the BladeEngine controller.


min Value 5

max Value 32

default Value 5


Table 56: ActiveFirmwareVersion


92

6.2.6. FirmwareVersionOnFlash

String Identifier 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.


min Value 5

max Value 32

default Value 5

Parent GroupName

BladeEngine

Table 57: FirmwareVersionOnFlash

6.2.7. BIOSVersion

String Identifier BIOSVersion

Property Description The BIOS version which is currently operational on the BladeEngine controller.


min Value 5

max Value 32

default Value 5


Table 58: BIOSVersion

6.2.8. BootCodeVersion

String Identifier BootCodeVersion


The boot code version which is currently operational on the BladeEngine controller.


min Value 5

max Value 32

default Value 5


Table 59: BootCodeVersion

6.2.9. FirmwareStatus

String Identifier FirmwareStatus


This property indicates the status of the BladeEngine firmware. This field will return Ready if the firmware is in a properly operating state.


min Value 0

max Value 3

default Value 2

Parent GroupName

BladeEngine

Table 60: FirmwareStatus


93

6.2.10. iSCSIVersionMin

String Identifier iSCSIVersionMin


This field corresponds to the iSCSI RFC 3720 field iSCSIVersionMin. A value of 1 for this property indicates support for the RFC3720 specification.


min Value 1

max Value 3

default Value 1

Parent GroupName

BladeEngine

Table 61: iSCSIVersionMin

6.2.11. iSCSIVersionMax

String Identifier iSCSIVersionMax


This field corresponds to the iSCSI RFC 3720 field iSCSIVersionMax. A value of 1 for this property indicates support for the RFC3720 specification.


min Value 1

max Value 3

default Value 1

Parent GroupName

BladeEngine

Table 62: iSCSIVersionMax

6.2.12. MaxCDBLength

String Identifier MaxCDBLength


This property indicates the maximum CDB length supported by this BladeEngine controller.


min Value 0

max Value 16

default Value 16


Table 63: MaxCDBLength

6.2.13. MaxMTUSize

String Identifier MaxMTUSize


This property shows the maximum MTU supported for both iSCSI and NIC/TOE traffic for this BladeEngine controller.


min Value 0

max Value 8342

default Value 0

Parent GroupName

BladeEngine


94

Table 64: MaxMTUSize


95

6.2.14. LDTO

String Identifier

LDTO


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.


min Value 0

max Value 8342

default Value -1

Parent GroupName

BladeEngine

Table 65: LDTO

6.2.15. DefaultETO

String Identifier DefaultETO


This property corresponds to the Default Extended Time Out (ETO) value for this BladeEngine controller.


min Value 0

max Value 4294967295

default Value -1

Parent GroupName

BladeEngine

Table 66: DefaultETO

6.2.16. VLDCapable

String Identifier

VLDCapable


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.


min Value 1

max Value 4

default Value No

Parent GroupName

BladeEngine

Table 67: VLDCapable


96

6.2.17. VLDEnabled

String Identifier

VLDEnabled


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.

Attributes Read-Write

min Value 2

max Value 3

default Value No

Parent GroupName

BladeEngine

Table 68: VLDEnabled

6.2.18. VendorID

String Identifier VendorID

Property Description The PCI Vendor ID.


min Value 1

max Value 255

default Value 1

Parent GroupName PCI

Table 69: VendorID

6.2.19. DeviceID

String Identifier DeviceID

Property Description This property displays the PCI Device ID.


min Value 1

max Value 255

default Value 1


Table 70: DeviceID

6.2.20. SubsysDeviceID

String Identifier SubsysDeviceID

Property Description The PCI Subsystem Device ID.


min Value 1

max Value 255

default Value 1


Table 71: SubsysDeviceID


97

6.2.21. SubsysVendorID

String Identifier SubsysVendorID

Property Description This property displays the PCI Subsystem Vendor ID.


min Value 1

max Value 255

default Value 1


Table 72: SubsysVendorID

6.2.22. BusNumber

String Identifier BusNumber

Property Description This property displays the PCI Bus Number.


min Value 0

max Value 255

default Value 0


Table 73: BusNumber

6.2.23. DeviceNumber

String Identifier DeviceNumber

Property Description This property displays the PCI Device Number.


min Value 0

max Value 32

default Value 0


Table 74: DeviceNumber

6.2.24. FunctionNumber

String Identifier FunctionNumber

Property Description This property displays the PCI Function number for the NIC function.


min Value 0

max Value 8

default Value 0


Table 75: FunctionNumber


98

6.2.25. DriverName

String Identifier DriverName

Property Description This property displays the name of the driver.


min Value 2

max Value 10

default Value BENIC

Parent GroupName Driver

Table 76: DriverName

6.2.26. DriverVersion

String Identifier DriverVersion

Property Description This property displays the current version of the driver.


min Value 2

max Value 6

default Value 2


Table 77: DriverVersion

6.2.27. IfName

String Identifier IfName

Property Description This property displays the Interface name string for this virtual NIC interface.


min Value 1

max Value 32

default Value 1


Table 78: IfName

6.2.28. MACAddress

String Identifier MACAddress

Property Description This property displays the MAC address for this virtual NIC interface.


min Value 17

max Value 17

default Value 00-00-00-00-00-00


Table 79: MACAddress


99

6.2.29. MaxBitsPerSecond

String Identifier MaxBitsPerSecond


MaxBitsPerSecond number for this virtual NIC interface. The number 'n' indicates 'n*10Mbps' throughput on this interface.


min Value 0

max Value 255

default Value 1

Parent GroupName

QOS

Table 80: MaxBitsPerSecond

6.2.30. MaxPacketsPerSecondPerNIC

String Identifier

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.


min Value 0

max Value 255

default Value 1

Parent GroupName

QOS

Table 81: MaxPacketsPerSecondPerNIC

6.2.31. 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.2003-07.com.serverengines;init1".


min Value 1

max Value 224

default Value iqn.se

Parent GroupName

InitiatoriSCSIName

Table 82: InitiatoriSCSIName


100

6.2.32. 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".


min Value 0

max Value 32

default Value se

Parent GroupName

InitiatoriSCSIName

Table 83: InitiatorAlias

6.2.33. DefaultiSCSIName

String Identifier DefaultiSCSIName

Property Description The default iSCSI name (IQN name) specified for the initiator node.


min Value 1

max Value 224

default Value iqn.2003-07.com.serverengines

Parent GroupName InitiatoriSCSIName

Table 84: DefaultiSCSIName

6.2.34. 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.


min Value 0

max Value 3

default Value Yes

Parent GroupName

InitiatorDefaultLoginOptions

Table 85: InitialR2T

6.2.35. ImmediateData

String Identifier ImmediateData


This property allows the initiator to append unsolicited data to a command. The valid values are Yes or No. The default is No.


min Value 0

max Value 3

default Value Yes


101

Parent GroupName


Table 86: ImmediateData

6.2.36. MaxConnections

String Identifier MaxConnections

Property Description The iSCSI Login Parameter for the Target.


min Value 1

max Value 1

default Value 1

Parent GroupName InitiatorDefaultLoginOptions

Table 87: MaxConnections

6.2.37. MaxOutstandingR2T

String Identifier MaxOutstandingR2T



min Value 1

max Value 255

default Value 1


Table 88: MaxOutstandingR2T

6.2.38. FirstBurstLength

String Identifier FirstBurstLength



min Value 0

max Value 8192

default Value 8192


Table 89: FirstBurstLength

6.2.39. MaxBurstLength

String Identifier MaxBurstLength



min Value 0

max Value 262144

default Value 262144


Table 90: MaxBurstLength


102


103

6.2.40. DefaultTime2Wait

String Identifier DefaultTime2Wait



min Value 0

max Value 2

default Value 2


Table 91: DefaultTime2Wait

6.2.41. DefaultTime2Retain

String Identifier DefaultTime2Retain



min Value 0

max Value 20

default Value 20


Table 92: DefaultTime2Retain

6.2.42. ErrorRecoveryLevel

String Identifier ErrorRecoveryLevel



min Value 0

max Value 255

default Value 0


Table 93: ErrorRecoveryLevel

6.2.43. DataPDUInOrder

String Identifier DataPDUInOrder



min Value 0

max Value 1

default Value 1


Table 94: DataPDUInOrder


104

6.2.44. DataSequenceInOrder

String Identifier DataSequenceInOrder



min Value 0

max Value 1

default Value 1


Table 95: DataSequenceInOrder

6.2.45. HeaderDigest

String Identifier

HeaderDigest


The valid values for this property are CRC32C or None. 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 None.


min Value 4

max Value 6

default Value None

Parent GroupName


Table 96: HeaderDigest

6.2.46. DataDigest

String Identifier

DataDigest


The valid values for this property are CRC32C or None. 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 None.


min Value 4

max Value 6

default Value None

Parent GroupName


Table 97: DataDigest

6.2.47. MaxRecvDataSegmentLength

String Identifier MaxRecvDataSegmentLength



min Value 0

max Value 65536

default Value 65536



105

Table 98: MaxRecvDataSegmentLength


106

6.2.48. TCPWindowSize

String Identifier TCPWindowSize



min Value 16

max Value 255

default Value 16000


Table 99: TCPWindowSize

6.2.49. InitialR2T

String Identifier

InitialR2T




min Value 0

max Value 3

default Value Yes

Parent GroupName

InitiatorLoginOptions







min Value 0

max Value 3

default Value Yes

Parent GroupName



6.2.51. AuthenticationMethod

String Identifier AuthenticationMethod


Use this property to specify an authentication method using the set command. Valid CHAP values are None, Mutual CHAP, and One-Way CHAP. None is the default.


min Value 4

max Value 12

default Value None

Parent GroupName

Authentication


107

Table 102: AuthenticationMethod


108

6.2.52. InitiatorCHAPName

String Identifier

InitiatorCHAPName


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.


min Value 1

max Value 256

default Value

Parent GroupName

Authentication

Table 103: InitiatorCHAPName

6.2.53. InitiatorSecret

String Identifier

InitiatorSecret


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.


min Value 12

max Value 16

default Value

Parent GroupName

Authentication

Table 104: InitiatorSecret

6.2.54. TargetCHAPName

String Identifier

TargetCHAPName


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.


min Value 1

max Value 256

default Value

Parent GroupName

Authentication

Table 105: TargetCHAPName


109

6.2.55. TargetSecret

String Identifier

TargetSecret


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.


min Value 12

max Value 16

default Value

Parent GroupName

Authentication

Table 106: TargetSecret


String Identifier

HeaderDigest




min Value 4

max Value 6

default Value None

Parent GroupName



6.2.57. DataDigest

String Identifier

DataDigest




min Value 4

max Value 6

default Value None

Parent GroupName




110

6.2.58. IPAddress

String Identifier IPAddress

Property Description The destination IP Address of the route table entry.


min Value 0

max Value 16

default Value 0.0.0.0

Parent GroupName RouteTableEntry

Table 109: IPAddress

6.2.59. SubnetMask

String Identifier SubnetMask

Property Description The Subnet mask of the route table entry.


min Value 0

max Value 255



Table 110: SubnetMask

6.2.60. Gateway

String Identifier Gateway

Property Description The Gateway specified in the route table entry.


min Value 1

max Value 64

default Value 1


Table 111: Gateway

6.2.61. IPAddress


Property Description The IP address of the ARP table entry.


min Value 0

max Value 16


Parent GroupName ARPTableEntry



111

6.2.62. MACAddress


Property Description The MAC address of the ARP table entry.


min Value 17

max Value 17

default Value 00-00-00-00-00-00

Parent GroupName ARPTableEntry


6.2.63. VendorID

String Identifier VendorID


This property displays the PCI vendor ID of the BladeEngine controller's iSCSI function.


min Value 1

max Value 255

default Value 1


Table 114: VendorID

6.2.64. DeviceID

String Identifier DeviceID


This property displays the PCI device ID of the BladeEngine controller's iSCSI function.


min Value 1

max Value 255

default Value 1


Table 115: DeviceID

6.2.65. SubsysDeviceID

String Identifier SubsysDeviceID


This property displays the PCI subsystem device ID of the BladeEngine controller's iSCSI function.


min Value 1

max Value 255

default Value 1

Parent GroupName

PCI

Table 116: SubsysDeviceID


112

6.2.66. SubsysVendorID

String Identifier SubsysVendorID


This property displays the PCI subsystem vendor ID of the BladeEngine controller's iSCSI function.


min Value 1

max Value 255

default Value 1

Parent GroupName

PCI

Table 117: SubsysVendorID

6.2.67. BusNumber

String Identifier BusNumber


This property displays the PCI bus number of the BladeEngine controller's iSCSI function.


min Value 0

max Value 255

default Value 0


Table 118: BusNumber

6.2.68. DeviceNumber

String Identifier DeviceNumber


This property displays the PCI device number of the BladeEngine controller's iSCSI function.


min Value 0

max Value 32

default Value 0


Table 119: DeviceNumber

6.2.69. FunctionNumber

String Identifier FunctionNumber


This property displays the PCI function number of the BladeEngine controller's iSCSI function.


min Value 0

max Value 8

default Value 0


Table 120: FunctionNumber


113

6.2.70. DriverName

String Identifier DriverName


This property displays the name of the iSCSI driver in the host operating system.


min Value 2

max Value 10

default Value BEISCSI


Table 121: DriverName

6.2.71. DriverVersion

String Identifier 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

Parent GroupName

Driver

Table 122: DriverVersion

6.2.72. DHCPServerAvailable

String Identifier 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.


min Value 0

max Value 1

default Value 0

Parent GroupName

DHCP

Table 123: DHCPServerAvailable

6.2.73. DHCPObtainNewIPAddress

String Identifier

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.


min Value 0

max Value 1

default Value 0

Parent DHCP


114

GroupName

Table 124: DHCPObtainNewIPAddress

6.2.74. 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

Parent GroupName

TCPIPConfiguration

Table 125: DHCPEnabled

6.2.75. InitiatorIPAddress

String Identifier InitiatorIPAddress

Property Description The IP Address assigned to the port.


min Value 0

max Value 16


Parent GroupName TCPIPConfiguration

Table 126: InitiatorIPAddress

6.2.76. InitiatorSubnetMask

String Identifier InitiatorSubnetMask

Property Description The Subnet mask for the port.


min Value 0

max Value 255



Table 127: InitiatorSubnetMask

6.2.77. DefaultGateway

String Identifier DefaultGateway

Property Description The Default Gateway specified for the port.


min Value 0

max Value 16



115


Table 128: DefaultGateway


116

6.2.78. IPVersionSupported

String Identifier IPVersionSupported

Property Description The version of IP Protocol supported. The value can be IPv4 or IPv6.


min Value 1

max Value 4

default Value IPv4


Table 129: IPVersionSupported

6.2.79. VLANID

String Identifier VLANID

Property Description Specifies the current vlan id used.


min Value 0

max Value 4095

default Value 0


Table 130: VLANID

6.2.80. PortSpeed

String Identifier 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.


min Value 0

max Value 4

default Value 4

Parent GroupName

NICConfiguration

Table 131: PortSpeed

6.2.81. PortMaxSpeed

String Identifier PortMaxSpeed

Property Description This property specifies the maximum port speed.


min Value 0

max Value 4

default Value 4

Parent GroupName NICConfiguration

Table 132: PortMaxSpeed


117

6.2.82. MaxFrameSize

String Identifier MaxFrameSize

Property Description This property specifies the maximum frame size used by the port.


min Value 16

max Value 32000

default Value 16000


Table 133: MaxFrameSize

6.2.83. LinkStatus

String Identifier LinkStatus

Property Description This property indicates whether the link is up or down.


min Value 0

max Value 3

default Value 2


Table 134: LinkStatus

6.2.84. ActivePort

String Identifier ActivePort

Property Description This property indicates the active port on the BladeEngine controller.


min Value 0

max Value 26

default Value Port 0


Table 135: ActivePort

6.2.85. MACAddress


Property Description This property displays MAC Address of the network port.


min Value 17

max Value 17

default Value 00-00-00-00-00-00




118

6.2.86. MaxBytesPerSecondPeriSCSI

String Identifier

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.


min Value 0

max Value 10485760

default Value 0

Parent GroupName

QOS

Table 137: MaxBytesPerSecondPeriSCSI

6.2.87. MaxIosPerSecondPeriSCSI

String Identifier

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.


min Value 0

max Value 255

default Value 0

Parent GroupName

QOS

Table 138: MaxIosPerSecondPeriSCSI

6.2.88. PortRowStatus

String Identifier PortRowStatus


This field allows entries to be dynamically added and removed from this table via SNMP.


min Value 0

max Value 3

default Value 2


Table 139: PortRowStatus

6.2.89. PortalRole

String Identifier PortalRole


A portal can operate in one or both of two roles as a target portal and/or an initiator portal.


min Value 1

max Value 2

default Value 1


119


Table 140: PortalRole

6.2.90. PortalProtocol

String Identifier PortalProtocol

Property Description The portal's transport protocol.


min Value 1

max Value 2

default Value 1


Table 141: PortalProtocol

6.2.91. PortalTag

String Identifier PortalTag

Property Description The portals aggregation tag when the portal is used as an initiator.


min Value 1

max Value 65535

default Value 1


Table 142: PortalTag

6.2.92. SequenceNumber

String Identifier SequenceNumber

Property Description A Sequence number of the event log entry.


min Value 1

max Value 255

default Value 1

Parent GroupName EventLogEntry

Table 143: SequenceNumber

6.2.93. TimeStamp

String Identifier TimeStamp

Property Description The Time stamp of the event log entry.


min Value 1

max Value 255

default Value 1


Table 144: TimeStamp


120

6.2.94. Severity

String Identifier Severity

Property Description The severity associated with the event log entry.


min Value 1

max Value 255

default Value 1


Table 145: Severity

6.2.95. Description

String Identifier Description

Property Description The text description of the event log entry.


min Value 0

max Value 255

default Value 0


Table 146: Description

6.2.96. ErrorCode

String Identifier ErrorCode

Property Description The numeric error code associated with the event log entry.


min Value 1

max Value 255

default Value 1


Table 147: ErrorCode

6.2.97. NodeRoles

String Identifier NodeRoles

Property Description The node role for this iSCSI Initiator.


min Value 1

max Value 255

default Value 1

Parent GroupName SNMP

Table 148: NodeRoles


121

6.2.98. PortalCount

String Identifier PortalCount


The number of rows in the iscsiPortaltypeTable which are currently associated with this iSCSI instance.


min Value 1

max Value 5

default Value 1

Parent GroupName

SNMP

Table 149: PortalCount

6.2.99. NodeCount

String Identifier NodeCount


The number of rows in the iscsiNodetypeTable which are currently associated with this iSCSI instance.


min Value 1

max Value 5

default Value 1

Parent GroupName

SNMP

Table 150: NodeCount

6.2.100. SessionCount

String Identifier 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

Parent GroupName

SNMP

Table 151: SessionCount

6.2.101. SessionFailureCount

String Identifier SessionFailureCount

Property Description The number of times a session belonging to this instance has failed.


min Value 1

max Value 255

default Value 1


Table 152: SessionFailureCount


122


123

6.2.102. LastSessionFailureType

String Identifier LastSessionFailureType

Property Description The type of failure encountered in the last session failure.


min Value 1

max Value 255

default Value 1


Table 153: LastSessionFailureType

6.2.103. LastSessionRmtNodeName

String Identifier LastSessionRmtNodeName

Property Description The iSCSI name of the remote node from the failed session.


min Value 1

max Value 224



Table 154: LastSessionRmtNodeName

6.2.104. SessionDigestErrors

String Identifier 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

Parent GroupName

SNMP

Table 155: SessionDigestErrors

6.2.105. SessionConnectionTimeout

String Identifier SessionConnectionTimeout

Property Description The count of sessions which failed due to a sequence exceeding a time limit.


min Value 4

max Value 0

default Value 4


Table 156: SessionConnectionTimeout


124

6.2.106. SessionFormatErrors

String Identifier SessionFormatErrors


The count of sessions which failed due to receipt of an iSCSI PDU that contained a format error.


min Value 4

max Value 0

default Value 4

Parent GroupName

SNMP

Table 157: SessionFormatErrors

6.2.107. LoginFailures

String Identifier LoginFailures

Property Description The number of times a login from this initiator failed.


min Value 4

max Value 0

default Value 4


Table 158: LoginFailures

6.2.108. LastFailureTime

String Identifier 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.


min Value 0

max Value 32

default Value 0

Parent GroupName

SNMP

Table 159: LastFailureTime

6.2.109. LastFailureType

String Identifier LastFailureType

Property Description The failure type for the most recent login failure on this initiator.


min Value 0

max Value 0

default Value 0


Table 160: LastFailureType


125

6.2.110. LastTgtFailureName

String Identifier LastTgtFailureName


The UTF-8 string name of the target that most recently failed a login request from this initiator.


min Value 1

max Value 224



Table 161: LastTgtFailureName

6.2.111. LastTgtFailureAddr

String Identifier LastTgtFailureAddr


An Internet Network Address of the type specified by the object iscsiIntrLastTgtFailureAddrType.


min Value 0

max Value 0

default Value 0

Parent GroupName

SNMP

Table 162: LastTgtFailureAddr

6.2.112. LoginAcceptRsps

String Identifier LoginAcceptRsps


The count of Login Response PDUs received by this initiator that were accepted.


min Value 4

max Value 0

default Value 4


Table 163: LoginAcceptRsps

6.2.113. LoginOtherFailRsps

String Identifier 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.


min Value 4

max Value 0

default Value 4

Parent GroupName

SNMP

Table 164: LoginOtherFailRsps


126


127

6.2.114. LoginRedirectRsps

String Identifier LoginRedirectRsps


The count of Login Response PDUs received by the initiator with status class Redirection.


min Value 4

max Value 0

default Value 4


Table 165: LoginRedirectRsps

6.2.115. LoginAuthFailRsps

String Identifier 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

Parent GroupName

SNMP

Table 166: LoginAuthFailRsps

6.2.116. LoginAuthFails

String Identifier LoginAuthFails


The number of times the initiator has aborted a login because the target could not be authenticated.


min Value 4

max Value 0

default Value 4

Parent GroupName

SNMP

Table 167: LoginAuthFails

6.2.117. LoginNegoFails

String Identifier 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

Parent GroupName

SNMP


128

Table 168: LoginNegoFails


129

6.2.118. LogoutNormals

String Identifier LogoutNormals


The count of Logout Command PDUs generated by this initiator with reason code normal.


min Value 4

max Value 0

default Value 4


Table 169: LogoutNormals

6.2.119. LogoutOthers

String Identifier 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

Parent GroupName

SNMP

Table 170: LogoutOthers

6.2.120. ETO

String Identifier 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).


min Value 0

max Value 4294967295

default Value -1

Parent GroupName

Target

Table 171: ETO

6.2.121. TargetIPAddress

String Identifier TargetIPAddress

Property Description The IP Address of the target portal.


min Value 0

max Value 0


Parent GroupName TargetPortal

Table 172: TargetIPAddress


130


131

6.2.122. TargetPortNumber

String Identifier TargetPortNumber

Property Description The Port number of the target portal.


min Value 1

max Value 65535

default Value 1036


Table 173: TargetPortNumber

6.2.123. PortalGroupTag

String Identifier PortalGroupTag

Property Description The tag associated with the Portal Group.


min Value 0

max Value 255

default Value 0


Table 174: PortalGroupTag

6.2.124. InitialR2T

String Identifier

InitialR2T




min Value 0

max Value 3

default Value Yes

Parent GroupName

TargetLoginOptions







min Value 0

max Value 3

default Value Yes

Parent GroupName

TargetLoginOptions



132


133






min Value 4

max Value 12

default Value None

Parent GroupName

Authentication



String Identifier

InitiatorCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



String Identifier

InitiatorSecret




min Value 12

max Value 16

default Value

Parent GroupName

Authentication



134


String Identifier

TargetCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



String Identifier

TargetSecret




min Value 12

max Value 16

default Value

Parent GroupName

Authentication



String Identifier

HeaderDigest




min Value 4

max Value 6

default Value None

Parent GroupName

TargetLoginOptions



135

6.2.132. DataDigest

String Identifier

DataDigest




min Value 4

max Value 6

default Value None

Parent GroupName

TargetLoginOptions


6.2.133. InitialR2T

String Identifier

InitialR2T




min Value 0

max Value 3

default Value Yes

Parent GroupName

SessionNegotiatedLoginOptions







min Value 0

max Value 3

default Value Yes

Parent GroupName

SessionNegotiatedLoginOptions


6.2.135. MaxConnections

String Identifier MaxConnections

Property Description ISCSI Login Parameter for the Target.


min Value 1

max Value 1

default Value 1


136

Parent GroupName SessionNegotiatedLoginOptions

Table 186: MaxConnections

6.2.136. MaxOutstandingR2T

String Identifier MaxOutstandingR2T



min Value 1

max Value 0

default Value 1


Table 187: MaxOutstandingR2T

6.2.137. FirstBurstLength

String Identifier FirstBurstLength



min Value 0

max Value 8192

default Value 8192


Table 188: FirstBurstLength

6.2.138. MaxBurstLength

String Identifier MaxBurstLength



min Value 0

max Value 262144

default Value 262144


Table 189: MaxBurstLength

6.2.139. DefaultTime2Wait

String Identifier DefaultTime2Wait



min Value 0

max Value 2

default Value 2


Table 190: DefaultTime2Wait


137

6.2.140. DefaultTime2Retain

String Identifier DefaultTime2Retain



min Value 0

max Value 20

default Value 20


Table 191: DefaultTime2Retain

6.2.141. ErrorRecoveryLevel

String Identifier ErrorRecoveryLevel



min Value 0

max Value 0

default Value 0


Table 192: ErrorRecoveryLevel

6.2.142. DataPDUInOrder

String Identifier DataPDUInOrder



min Value 0

max Value 1

default Value 1


Table 193: DataPDUInOrder

6.2.143. DataSeqInOrder

String Identifier DataSeqInOrder



min Value 0

max Value 1

default Value 1


Table 194: DataSeqInOrder


138

6.2.144. SessionDirection

String Identifier SessionDirection

Property Description The direction of iSCSI session InboundSession and OutboundSession.


min Value 0

max Value 0

default Value 0


Table 195: SessionDirection

6.2.145. CmdPdus

String Identifier CmdPdus

Property Description The count of Command PDUs transferred on this session.


min Value 0

max Value 0

default Value 0


Table 196: CmdPdus

6.2.146. RspPdus

String Identifier RspPdus

Property Description The count of Response PDUs transferred on this session.


min Value 0

max Value 0

default Value 0


Table 197: RspPdus

6.2.147. TxDataOctetsHigh

String Identifier TxDataOctetsHigh


The count of data octets that were transmitted bythe local iSCSI node on this session.


min Value 0

max Value 0

default Value 0


Table 198: TxDataOctetsHigh


139

6.2.148. RxDataOctetsHigh

String Identifier RxDataOctetsHigh


The count of data octets that were received by the local iSCSI node on this session.


min Value 0

max Value 0

default Value 0


Table 199: RxDataOctetsHigh

6.2.149. DigestErrors

String Identifier DigestErrors


The count of PDUs which were received on the session and contained header or data digest errors.


min Value 0

max Value 0

default Value 0

Parent GroupName

SNMP

Table 200: DigestErrors

6.2.150. CxnTimeoutErrors

String Identifier CxnTimeoutErrors


The count of connections within this session which have been terminated due to a timeout.


min Value 0

max Value 0

default Value 0


Table 201: CxnTimeoutErrors

6.2.151. SessionTargetAlias

String Identifier SessionTargetAlias


The count of PDUs which were received on the session and contained header or data digest errors.


min Value 0

max Value 0

default Value 0

Parent GroupName

SNMP

Table 202: SessionTargetAlias


140


141


String Identifier

AuthenticationMethod




min Value 4

max Value 12

default Value None

Parent GroupName

ConnectionNegotiatedLoginOptions



String Identifier

HeaderDigest




min Value 4

max Value 6

default Value None

Parent GroupName



6.2.154. DataDigest

String Identifier

DataDigest




min Value 4

max Value 6

default Value None

Parent GroupName



6.2.155. MaxRecvDataSegmentLength

String Identifier MaxRecvDataSegmentLength



min Value 0

max Value 1


142

default Value 0

Parent GroupName ConnectionNegotiatedLoginOptions

Table 206: MaxRecvDataSegmentLength

6.2.156. TCPWindowSize

String Identifier TCPWindowSize



min Value 16

max Value 255

default Value 16000

Parent GroupName ConnectionNegotiatedLoginOptions

Table 207: TCPWindowSize

6.2.157. 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

Parent GroupName


Table 208: TCPMSS

6.2.158. iSCSIConnectionID

String Identifier iSCSIConnectionID

Property Description The iSCSI Connection ID assigned to the Connection.


min Value 1

max Value 32

default Value 1


Table 209: iSCSIConnectionID

6.2.159. Status

String Identifier Status

Property Description The status of the connection.


min Value 0

max Value 32

default Value Connection Status Unknown


143


Table 210: Status


144

6.2.160. SourcePortNumber

String Identifier SourcePortNumber

Property Description The source port number for the connection.


min Value 1024

max Value 65535

default Value 1024


Table 211: SourcePortNumber

6.2.161. DestinationPortNumber

String Identifier DestinationPortNumber

Property Description The destination port number for the connection.


min Value 1024

max Value 65535

default Value 1024


Table 212: DestinationPortNumber

6.2.162. SourceIPAddress

String Identifier SourceIPAddress

Property Description The source IP Address for the connection.


min Value 0

max Value 0



Table 213: SourceIPAddress

6.2.163. DestinationIPAddress

String Identifier DestinationIPAddress

Property Description The destination IP Address for the connection.


min Value 0

max Value 0



Table 214: DestinationIPAddress


145

6.2.164. RedirectedDestinationPort

String Identifier RedirectedDestinationPort

Property Description The Redirected target TCP port number.


min Value 0

max Value 0

default Value 0


Table 215: RedirectedDestinationPort

6.2.165. RedirectedDestinationIPAddress

String Identifier RedirectedDestinationIPAddress

Property Description The Redirected target IP address.


min Value 0

max Value 0

default Value 0


Table 216: RedirectedDestinationIPAddress

6.2.166. SessionTSIH

String Identifier SessionTSIH


Session TSIH assigned to the session. A value of 0 indicates that there is no session assigned.


min Value 0

max Value 0

default Value 0


Table 217: SessionTSIH

6.2.167. SessionISID

String Identifier SessionISID


Session ISID assigned to the session. This needs to be unique for every session.


min Value 0

max Value 0

default Value 0


Table 218: SessionISID


146

6.2.168. SessionInitiatorName

String Identifier SessionInitiatorName

Property Description The iSCSI Name configured for the session.


min Value 1

max Value 224



Table 219: SessionInitiatorName

6.2.169. SessionStatus

String Identifier SessionStatus

Property Description This property indicates the status of the session.


min Value 0

max Value 32

default Value Unknown


Table 220: SessionStatus

6.2.170. iSCSIBoot

String Identifier

iSCSIBoot


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.


min Value 0

max Value 1

default Value 0

Parent GroupName

Session

Table 221: iSCSIBoot

6.2.171. LUNNumber

String Identifier LUNNumber

Property Description Logical unit number of the LUN.


min Value 0

max Value 0

default Value 0

Parent GroupName LUN

Table 222: LUNNumber


147

6.2.172. LUNSize

String Identifier LUNSize

Property Description The size of the LUN in bytes.


min Value 0

max Value 0

default Value 0


Table 223: LUNSize

6.2.173. DeviceVendorName

String Identifier DeviceVendorName

Property Description The Device Vendor Identification.


min Value 0

max Value 0

default Value 0


Table 224: DeviceVendorName

6.2.174. DeviceModelNumber

String Identifier DeviceModelNumber

Property Description The Device Product Identification.


min Value 0

max Value 0

default Value 0


Table 225: DeviceModelNumber

6.2.175. IPAddress


Property Description The IP address of the Portal used for the leading connection.


min Value 0

max Value 0


Parent GroupName PersistentLoginPortal



148

6.2.176. PortNumber

String Identifier PortNumber

Property Description The Port number of the Portal used for the leading connection.


min Value 1024

max Value 65535

default Value 1024

Parent GroupName PersistentLoginPortal

Table 227: PortNumber

6.2.177. InitialR2T

String Identifier

InitialR2T




min Value 0

max Value 3

default Value Yes

Parent GroupName

PersistentLoginOptions







min Value 0

max Value 3

default Value Yes

Parent GroupName

PersistentLoginOptions







min Value 4

max Value 12

default Value None

Parent GroupName

Authentication


149



150


String Identifier

InitiatorCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



String Identifier

InitiatorSecret




min Value 12

max Value 16

default Value

Parent GroupName

Authentication



String Identifier

TargetCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



151


String Identifier

TargetSecret




min Value 12

max Value 16

default Value

Parent GroupName

Authentication


6.2.184. PortIdentifier

String Identifier PortIdentifier

Property Description The unique port identifier for the port/logical HBA used for the persistent Login.


min Value 0

max Value 1

default Value 0


Table 235: PortIdentifier

6.2.185. iSCSIBoot

String Identifier 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"


min Value 0

max Value 1

default Value 0

Parent GroupName

PersistentLogin

Table 236: iSCSIBoot

6.2.186. TargetName

String Identifier TargetName

Property Description The iSCSI name of the target for the persistent login.


min Value 6

max Value 10

default Value 6



152

Table 237: TargetName


153

6.2.187. TargetISCSIName

String Identifier TargetISCSIName

Property Description The iSCSI Name of the target.


min Value 11

max Value 255

default Value 11


Table 238: TargetISCSIName

6.2.188. TargetAlias

String Identifier TargetAlias

Property Description The alias name given to the Target node.


min Value 0

max Value 0

default Value 0


Table 239: TargetAlias

6.2.189. DefaultLoginPortal

String Identifier DefaultLoginPortal

Property Description This property indicates the default portal of the target to use to login.


min Value 1

max Value 128

default Value 0


Table 240: DefaultLoginPortal

6.2.190. DefaultIntrPort

String Identifier DefaultIntrPort

Property Description This property indicates the default port of the initiator to use for login.


min Value 1

max Value 16

default Value 0


Table 241: DefaultIntrPort


154

6.2.191. SlpScopes

String Identifier SlpScopes

Property Description The only SLP scope string that is supported is default.


min Value 0

max Value 256

default Value 0

Parent GroupName SLP

Table 242: SlpScopes

6.2.192. SlpQueryList

String Identifier SlpQueryList


This property indicates whether an iSCSI name is to be used as the query string or not.


min Value 1

max Value 255

default Value 0

Parent GroupName SLP

Table 243: SlpQueryList

6.2.193. IPAddress


Property Description The IP Address of the iSNS Server.


min Value 0

max Value 0


Parent GroupName iSNSEntry


6.2.194. PortNumber


Property Description The Port number of the iSNS Server.


min Value 1024

max Value 3205

default Value 1024

Parent GroupName iSNSEntry



155

6.2.195. InitialR2T

String Identifier

InitialR2T




min Value 0

max Value 3

default Value Yes

Parent GroupName

SendTargetPortalLoginOptions







min Value 0

max Value 3

default Value Yes

Parent GroupName




String Identifier

InitiatorCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



156


String Identifier

InitiatorSecret




min Value 1

max Value 24

default Value

Parent GroupName

Authentication



String Identifier

TargetCHAPName




min Value 1

max Value 256

default Value

Parent GroupName

Authentication



String Identifier

TargetSecret




min Value 1

max Value 24

default Value

Parent GroupName

Authentication



157






min Value 4

max Value 12

default Value None

Parent GroupName

Authentication



String Identifier

HeaderDigest




min Value 4

max Value 6

default Value None

Parent GroupName



6.2.203. DataDigest

String Identifier

DataDigest




min Value 4

max Value 6

default Value None

Parent GroupName



6.2.204. IPAddress


Property Description The IP Address specified for the SendTarget Portal.


min Value 0

max Value 0



158



6.2.205. PortNumber


Property Description The Port Number specified for the SendTarget Portal.


min Value 1024

max Value 65535

default Value 1024



6.2.206. PortIdentifier

String Identifier PortIdentifier

Property Description The port identifier of the logical HBA/port the Sendtarget Portal is added to.


min Value 0

max Value 1

default Value 0


Table 257: PortIdentifier

6.2.207. PortMacAddress

String Identifier PortMacAddress

Property Description The mac address of the port the SendTarget portal is added to.


min Value 17

max Value 17

default Value 00-00-00-00-00-00


Table 258: PortMacAddress

6.2.208. SLPEnabled

String Identifier 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.


min Value 1

max Value 3

default Value No

Parent GroupName

Discovery


159

Table 259: SLPEnabled

6. Appendix 6.3. Data Types

160

6.2.209. iSNSEnabled

String Identifier 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.


min Value 1

max Value 3

default Value No

Parent GroupName

Discovery

Table 260: iSNSEnabled

6.2.210. DefaultInitiatorPort

String Identifier DefaultInitiatorPort


This property indicates the default initiator port that will be used for any discovery.


min Value 0

max Value 256

default Value 0


Table 261: DefaultInitiatorPort

6.3. Data Types

Data Type Description U8 8 bit unsigned integer U16 16 bit unsigned integer U32 32 bit unsigned integer BOOLEAN TRUE or FALSE STRING character string with a null termination

IP_ADDRESS

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

6. Appendix 6.4. Common Error Messages

161

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

Information on this document On April 1, 2009, Fujitsu became the sole owner of Fujitsu Siemens Compu-ters. This new subsidiary of Fujitsu has been renamed Fujitsu Technology So-lutions.

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 So-lutions and have the format …@ts.fujitsu.com.

The Internet pages of Fujitsu Technology Solutions are available at http://ts.fujitsu.com/... and the user documentation at http://manuals.ts.fujitsu.com.

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 seit-dem 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 Form …@ts.fujitsu.com.

Die Internetseiten von Fujitsu Technology Solutions finden Sie unter http://de.ts.fujitsu.com/..., und unter http://manuals.ts.fujitsu.com finden Sie die Benutzerdokumentation.

Copyright Fujitsu Technology Solutions, 2009

Documents

PRIMERGY BX600 10GbE I/O Module (PCIe) - Fujitsumanuals.ts.fujitsu.com/file/3634/bx-10gbe-sm-clp-reference.pdf · PRIMERGY BX600 10GbE I/O Module ... iSCSI Initiator SM-CLP Command