background image

The OneCommand Utility User Manual

Page 71

Viewing LUN Information      

The LUN Information tab contains information about the selected logical unit number (LUN). The type of 
information that is displayed depends on the type of adapter you select, Fibre Channel or iSCSI.     

Viewing Fibre Channel LUN Information

When you select a LUN associated with a Fibre Channel adapter from the discovery-tree, the LUN tab 
displays information associated with that LUN.

To view the LUN information:

1.

Select  Host, Fabric or Virtual Port view.

2.

From the discovery-tree, select a Fibre Channel port.

Note: LUNs that are associated with a manageable COMSTAR port do not appear in the 

discovery-tree and cannot be configured using the OneCommand Manager 
application or hbacmd utilities. To view the LUNs using the OneCommand Manager 
application, you must view the COMSTAR port as a target. 

Note: LUNs are discovered each time you click on the “+” symbol next to a target in the 

discovery-tree. If an added LUN is not appearing below the target, click the “-” symbol 
next to the target to collapse the LUN nodes and then click the “+” to expand the 
LUNs again. The new LUN should be displayed.

Note: On Linux systems, to make LUNs that are newly added to a storage array appear on 

the host, the following script must run from the command shell:

/usr/sbin/lpfc/lun_scan all

This is prevents you from having to reboot. If the host machine is rebooted after the 
LUN is added to the target array, you do not need to run the script.

Summary of Contents for OneCommand Manager 5.0

Page 1: ...OneCommand Manager Application Version 5 0 User Manual One Network One Company P004343 01A Rev A Connect with Emulex...

Page 2: ...ompanies or organizations Emulex provides this manual as is without any warranty of any kind either expressed or implied including but not limited to the implied warranties of merchantability or fitne...

Page 3: ...Linux System with an Existing HBAnyware CLI Kit InstalledI 12 Uninstalling Older HBAnyware Kits on Linux 12 In Solaris SFS 13 Prerequisites 13 Procedures 13 Upgrading from the OneCommand Manager Appli...

Page 4: ...Targets 37 Viewing Target Sessions 37 Logging out of Target Sessions 37 Viewing Discovery Information 40 Viewing Host Information 41 Viewing Adapter Information 43 Viewing Fibre Channel Adapter Inform...

Page 5: ...ynamic Parameter Values Linux 8 2 83 Changing Non dynamic Parameter Values VMware ESX 84 Creating a Batch Mode Driver Parameters File 84 Assigning Batch Mode Parameters 85 Configuring CEE Converged En...

Page 6: ...s 8 9 and 10 134 Configuring Boot from SAN 134 Boot Types 135 Boot Device Parameters 135 Configuring Advanced Settings Boot from SAN 139 Exporting SAN Information 143 Diagnostics 144 Fibre Channel Dia...

Page 7: ...ands 182 LUN Masking Commands 183 Miscellaneous Commands 184 Persistent Binding Commands 188 TCP IP Management Host File Commands 190 VPort Commands 190 WWN Management Commands 192 iSCSI Commands 193...

Page 8: ...is supported by your operating system Discover local and remote hosts adapters targets virtual ports virtual machines and Logical Unit Numbers LUNs Enable local and FC discovery of Emulex and OEM bran...

Page 9: ...res are supported across all operating systems The following table lists the OneCommand Manager application features and their operating system support Table 1 The OneCommand Manager application Featu...

Page 10: ...e x86 BootBIOS EFI or OpenBoot X X X X Run diagnostic tests on adapters X X X X Manage local adapters X X X X Manage FC remote and TCP IP accessed adapters X X X X Locate adapters using beaconing X X...

Page 11: ...ation If the HBAnyware utility OneCommand Manager Core or OneCommand Manager Enterprise applications or the Solaris SFS driver utilities are already present on the system the install script attempts t...

Page 12: ...el tgz For SLES 11 type tar zxvf elxocm sles11 apps_ver rel tgz 7 Change use cd command to the elxocm directory created in step 6 For RHEL 5 and SLES 10 type cd elxocm rhel5 sles10 apps_ver rel For SL...

Page 13: ...nager application Command Line Inter face is also located in this directory Installing the OneCommand Manager Application Web Launch Interface Prerequisites In addition to the driver and OneCommand Ma...

Page 14: ...configured to handle the JNLP MIME file type The following MIME file type file extension must be added to your server configuration MIME type application x java jnlp file File Extension jnlp The HTTP...

Page 15: ...s of host on which you installed the OneCommand Manager application Web Launch service and PORT_NUM is the TCP port number of the listening host s Web server The standard OneCommand Manager applicatio...

Page 16: ...Interface Supported Platforms Driver Architecture Operating System Storport Miniport Driver Intel x86 x64 and IA64 Note Intel IA64 supported for Fibre Channel adapters only Windows Server 2003 Service...

Page 17: ...ion arch rpm Where NN is 35 for an ESX 3 5 system Uninstalling Older HBAnyware Kits on VMware To uninstall an older HBAnyware Kit on VMware 1 Log into the ESX Server Host COS 2 Type rpm qa grep elx an...

Page 18: ...sion must be installed Procedures To install the OneCommand Manager application CLI 1 Copy the applications kit tar file to a directory on the installation machine 2 Change use cd command to the direc...

Page 19: ...s to remove the enterprise kit Or Run the uninstall script located in the tar file to remove the enterprise kit If the HBAnyware Security Configurator is installed it must be uninstalled before uninst...

Page 20: ...ile c Extract the tar file using the tar xvf command d Change to the newly created directory e Uninstall any previously installed versions Type uninstall In Solaris SFS Prerequisites The Solaris SFS 2...

Page 21: ...an enterprise kit In Solaris SFS To upgrade from the OneCommand Manager application CLI to the full featured OneCommand Manager application enterprise kit 1 Download the OneCommand Manager applicatio...

Page 22: ...m the system 4 Select Emulex OCManager version and click Remove or Uninstall The uninstallation is complete In Solaris SFS 1 Log on as root 2 Run the OneCommand Manager uninstall script opt HBAnyware...

Page 23: ...to continue In Solaris SFS and Linux 1 Log on as root 2 Execute the uninstallation script Solaris SFS opt HBAnyware wsuninstall Linux usr sbin hbanyware wsuninstall This script stops the OneCommand Ma...

Page 24: ...on Web Launch Interface software installed and running http IP_ADDR PORT_NUM ocmanager jnlp where IP_ADDR is the IP address of the host on which you installed the OneCommand Manager Web Launch Service...

Page 25: ...or higher OneCommand Manager application icons use 256 colors If the display is set for 16 color mode OneCommand Manager application icons are not displayed Note The element you select in the discove...

Page 26: ...in use Discovery Refresh button Initiates a discovery refresh cycle Reset button Resets the selected adapter The View Buttons on the Toolbar The View buttons on the toolbar enable you to view SAN elem...

Page 27: ...by its alias Figure 4 Discovery tree Fabric View button Displays the fabrics in the SAN with their fabric IDs Displays the ports under each switch If targets are present displays each WWPN Multiple a...

Page 28: ...rt icon with a red X indicates the port is down If all discovered ports are down the adapter icon changes to red Note Multiport adapters are represented in the discovery tree with separate port icons...

Page 29: ...e three types of host adapter management Strictly Local Management This setting only allows management of adapters on this host Management of adapters on this host from other hosts is not allowed Loca...

Page 30: ...SFS 1 Run the following script opt HBAnyware set_operating_mode 2 Choose the management type and read only mode you want In Linux 1 Stop the OneCommand Manager application 2 Run the following script u...

Page 31: ...ty User Manual Page 24 Printing Help Information To print help information 1 Select the help information you want to print 2 From the browser menu select File Print 3 From the Print dialog box check S...

Page 32: ...host on which they reside Since adapters can exist on a host but not be a part of a FC network they do not appear during normal FC discovery Thus TCP IP access enlarges the number of adapters that ca...

Page 33: ...y of the following operations Adding a single host from the Add Remote Host window If the host is discovered the OneCommand Manager application adds its IP address and name to the host file Scanning a...

Page 34: ...overy server only needs the IP address to discover the host Each line in the file can be up to 1023 characters although this is longer than is needed for a host IP address and host name A line longer...

Page 35: ...t 1 From the Discovery menu select TCP IP Add Host The Add Remote TCP IP Host dialog box appears Figure 7 Add Remote TCP IP Host dialog box 2 Enter the name or the IP address of the host to be added 3...

Page 36: ...of Hosts Find the TCP IP accessed manageable hosts by searching a range of IP addresses The Add Range of TCP IP Hosts dialog box enables you to build the initial list of TCP IP accessed manageable hos...

Page 37: ...t be installed on all remote hosts Procedure To add a range of remote hosts 1 From the Discovery menu select TCP IP Add Range of Hosts The Add Range of TCP IP Hosts dialog box appears 2 Enter the comp...

Page 38: ...ly currently undiscovered hosts 2 From the Remove Hosts dialog box select the hosts you want to remove You can select all the displayed hosts by clicking Select All 3 Click Remove to remove the select...

Page 39: ...he port number or the Enable TCP IP Management checkbox is changed a set of warning messages may appear before changes are made Click Yes on the warning message to con tinue with the change 4 If the I...

Page 40: ...settings you want to configure 2 Select the iSCSI Target Discovery tab Target Discovery Field Definitions Target Portals The Target Portals table contains all target portals that are queried for targe...

Page 41: ...lly force a complete rediscovery of the targets querying all configured iSNS servers and target portals Adding Target Portals To add a target portal 1 From the iSCSI Target Discovery dialog box click...

Page 42: ...he Add Target Portal dialog box appears 2 Enter the required information and click Advanced Login Options The Advanced Login Options dialog box appears 3 Specify the portal login parameters you want 4...

Page 43: ...er the reboot is complete 3 Configure Advanced Login Options if you want See Specifying Portal Specific Login Options on page 34 for more information 4 Click OK If the target was successfully logged i...

Page 44: ...arget Sessions The Target Sessions dialog box enables you to log out of active sessions for a currently connected target To logout of active sessions for a connected target 1 From the iSCSI Target Dis...

Page 45: ...ed in login in progress login failed recovery unknown ISID The initiator session identifier unique for each session ISID Qualifier The first two bytes of the ISID unique for each session TSIH The targ...

Page 46: ...time in seconds to reassign a connection after the initial wait that is indicated in DefaultTime2Wait has elapsed The initiator and target negotiate to determine this value ErrorRecoveryLevel The oper...

Page 47: ...ected by a CRC32C checksum Data Digest When set to CRC32C the integrity of an iSCSI PDU s data segments is protected by a CRC32C checksum TCPMSS The maximum segment size for this connection The driver...

Page 48: ...mber of Target Ports The total number of unique discovered targets on the SAN In the discovery tree the same target can appear under more than one adapter Number of Virtual Ports The number of discove...

Page 49: ...rics The number of fabrics to which this host is attached Not supported on VMware ESX servers being managed through the CIM interface Number of Virtual Machines The number of virtual machines that can...

Page 50: ...tab Fibre Channel Adapter Information Field Definitions Model The complete model name of the adapter Serial Number The manufacturer s serial number for the selected adapter Hardware Version The board...

Page 51: ...issues include clogged air filters inoperable fans and air conditioning problems that cause high ambient air temperatures After the system overheating issue is resolved and the adapter has cooled dow...

Page 52: ...mation associated with the selected adapter port The Port information that is displayed depends upon the type of adapter you select Fibre Channel FCoE iSCSI or NIC Only Viewing Fibre Channel Port Info...

Page 53: ...vers being managed through the CIM interface Boot Version The version of boot code installed on the selected adapter port If the boot code is disabled the field displays Disabled Port FC ID The Fibre...

Page 54: ...Status The status of the link on the selected adapter port Port Speed The current port speed of the selected adapter port Loop Map Table Definitions The loop map shows the different ports present in t...

Page 55: ...CIM interface Boot Version The version of boot code installed on the selected adapter port If the boot code is disabled the field displays Disabled Port FC ID The FCoE ID for the selected adapter por...

Page 56: ...delivery Supported FC4 Types A 256 bit 8 word map of the FC 4 protocol types supported by the port containing the selected adapter Port Status Area Field Definitions Link Status The status of the link...

Page 57: ...CSI function PCI Function The PCI function number assigned to the iSCSI function LDTO Link Down Time Out The amount of time in seconds that the iSCSI driver delays reporting a link down error to the o...

Page 58: ...apable Port Information Buttons Not available in read only mode Modify Enables you to change TCP IP settings for the selected port You can change the port s VLAN tag priority IP address and more See M...

Page 59: ...current transmission unit for iSCSI traffic Interface Name The interface assigned to this port by the host operating system Link Status The status of the link on the selected adapter port Bandwidth L...

Page 60: ...he type of adapter you select Fibre Channel iSCSI or NIC Only Viewing Fibre Channel Port Statistics When you select a Fibre Channel adapter from the discovery tree the Port Statistics tab contains sta...

Page 61: ...is not supported if the topology is not arbitrated loop Loop initialization consists of the following Temporarily suspending loop operations Determining whether loop capable ports are connected to the...

Page 62: ...counter is incremented whenever there is any type of protocol error Invalid CRCs The number of frames received that contain CRC failures Ex Count Resp The number of FC exchange responses made by this...

Page 63: ...ator from the discovery tree the iSCSI Statistics tab contains statistics associated with the selected initiator To view iSCSI port statistics 1 Select Host view 2 Select an iSCSI initiator node in th...

Page 64: ...e target that most recently failed Login Accept Responses The count of Login Response PDUs received by this initiator that were accepted Login Other Fail Responses The count of Login Response PDUs rec...

Page 65: ...of hosts discovered in the SAN Number of Fabrics The total number of fabrics discovered in the SAN Number of Adapters The total number of adapters discovered in the SAN Number of Adapter Ports The tot...

Page 66: ...hosts discovered or seen by this host on the selected fabric Number of Fabrics The number fabrics identified during discovery Number of Adapters The number of adapters discovered by this host on the s...

Page 67: ...hannel Transceiver Information When you select a Fibre Channel adapter from the discovery tree the Transceiver Data tab contains information associated with the selected Fibre Channel port To view Fib...

Page 68: ...part number provided by the SFP vendor Revision The vendor revision level Diagnostic Data Area Temperature The internally measured module temperature Supply Voltage The internally measured supply volt...

Page 69: ...Wavelength The nominal transmitter output wavelength at room temperature OUI The vendor s Organizationally Unique Identifier It is also known as the IEEE Company Identifier for the vendor Date The ve...

Page 70: ...PN Part Number The adapter s part number SN Serial Number The adapter s serial number VO Vendor unique data V indicates a vendor specific field An adapter may have none one or more of these fields de...

Page 71: ...rea Current Version The Emulex firmware version number for this model of adapter Initial Load The firmware version stub responsible for installing SLI code into its proper slot Not available on VMware...

Page 72: ...nction with the Change WWN button Displays the World Wide Port Name you assigned for the selected adapter port but the system must be rebooted for these changes to take effect and appear under the Cur...

Page 73: ...2 Select an FCoE adapter port in the discovery tree 3 Select the Maintenance tab Figure 32 FCoE Maintenance tab Maintenance Tab Field Definitions Firmware Area Firmware Version on Flash Specifies the...

Page 74: ...re information Maintenance Tab Buttons Not available in read only mode Configure Boot Click Configure Boot to configure boot from SAN See Configuring Boot from SAN on page 134 for more information Not...

Page 75: ...ot code version currently being used by the adapter BIOS Version The version of the BIOS currently being used by the adapter Firmware Tab Buttons Not available in read only mode Update Firmware Click...

Page 76: ...The FC ID for the target assigned automatically in the firmware SCSI Bus Number The SCSI bus number to which the target is mapped SCSI Target Number The target s identifier on the SCSI bus Node WWN A...

Page 77: ...lue The ETO for the target The driver will ensure that I Os are not timed out until this time has expired from the time the target stopped responding You can change this value if you want Target Porta...

Page 78: ...not appear in the discovery tree and cannot be configured using the OneCommand Manager application or hbacmd utilities To view the LUNs using the OneCommand Manager application you must view the COMST...

Page 79: ...The OneCommand Utility User Manual Page 72 3 Select the LUN whose information you want to view The LUN Information tab appears Figure 36 Fibre Channel LUN Information tab...

Page 80: ...ea Capacity The capacity of the LUN in megabytes Block Size The length of a logical unit block in bytes LUN Masking Area Current Mask Status Possible states are masked or unmasked Viewing iSCSI LUN In...

Page 81: ...k Size The length of a logical unit block in bytes Viewing Fibre Channel Target Mapping Windows and Solaris SFS The Target Mapping tab enables you to view current target mapping and to set up persiste...

Page 82: ...apping tab Change Settings Click to enable or disable automapping choose a bind type and enable or disable LUN mapping and unmasking Not available on VMware ESX servers being managed through the CIM i...

Page 83: ...about the selected NIC or iSCSI function The type of information that is displayed depends on the type of function you select Fibre Channel iSCSI or NIC only See Viewing the PCI Registers on page 146...

Page 84: ...C PCI Registers The NIC PCI Registers tab displays base PCI registers Figure 40 iSCSI PCI Registers tab To view NIC PCI registers 1 From the discovery tree select the NIC function whose PCI informatio...

Page 85: ...The Host Driver Parameters tab enables you to view and edit the adapter driver parameter settings contained in a specific host The host driver parameters are global values and apply to all adapters i...

Page 86: ...fic information is displayed in this area This can include value range default activation requirements and description Driver Parameters Tab Buttons Not available in read only mode Restore If you chan...

Page 87: ...se parameters you wish to change 3 Select the Driver Parameters tab The parameter values for the selected adapter are displayed Note The Linux 2 6 kernel only supports setting some of the driver param...

Page 88: ...and displayed as 0xff10 6 If you want the change to be temporary causing the parameter to revert to its last permanent setting when the system is rebooted check the Make change temporary box This opti...

Page 89: ...r application can then use the Batch Driver Parameter Update function to apply these saved settings to any or all compatible adapters on the SAN Setting Driver Parameters for All Adapters in a Host To...

Page 90: ...oted check Make changes temporary This option is available only for dynamic parameters 7 To make changes to multiple parameters check Make all changes temporary Only dynamic parameters can be made tem...

Page 91: ...Reboot the system Creating a Batch Mode Driver Parameters File You can apply driver parameters for one adapter to other adapters in the system using the Driver Parameters tab When you define parameter...

Page 92: ...Update Driver Parameters You do not need to select any discovery tree elements at this time 2 When the Batch Driver Parameter Update dialog box appears click Browse 3 The Driver Parameter File Select...

Page 93: ...45 Batch Driver Parameters Update dialog box for Windows 4 Make your selections and click Start Update The OneCommand Manager Application Batch Driver Parameter Update dialog box shows the current st...

Page 94: ...oE parameters for Fibre Channel adapters 1 From the discovery tree select a Fibre Channel CEE adapter such as an LP21000 2 Select the CEE FCoE tab 3 Make any setting changes you want 4 Click Apply Cha...

Page 95: ...iority The available values for the FCoE Priority parameter Possible drop down values are 0 to 7 CEE FCoE Tab Buttons Update Firmware Enables you to update CEE firmware on the selected adapter See Upd...

Page 96: ...s For the DCBX protocol to operate correctly both LLDP Rx and Tx must be enabled If either Rx or Tx is disabled DCBX is disabled LLDP Receive State DCBX uses LLDP to exchange parameters between two li...

Page 97: ...e indicated whether an error has occurred during the configuration exchange with the peer Error is also set to YES when the Compatible method for the feature fails Active Groups PG The Priority Group...

Page 98: ...values are used DCBX Mode The DCBX mode can be set to CEE or CIN Changes to the DCBX mode require a reboot of the host Operating Version Operating version of the DCBX protocol The system adjusts as ne...

Page 99: ...Configured Priorities The priorities that are configured but might not yet be active FCoE Priority Area Active Priority The active FCoE priority Configured Priority The configured FCoE priority Prior...

Page 100: ...roperties you want to view 2 Select the CEE tab Figure 49 CEE tab for iSCSI adapter ports CEE Tab Field Definitions DCBX State The current DCBX Data Center discovery and Capability exchange protocol s...

Page 101: ...during the configuration exchange with the peer Error is also set to TRUE when the Compatible method for the feature fails Active Groups PG The Priority Group number It can be 0 to 7 Priorities The pr...

Page 102: ...or CIN Changes to the DCBX mode require a reboot of the host Operating Version The operating version of the DCBX protocol The system adjusts as needed to operate at the highest version supported by bo...

Page 103: ...different priorities that are assigned to the various Priority Groups This is the currently active configuration Bandwidth The bandwidths that are assigned to different Priority Groups This is the cur...

Page 104: ...i e all 0xFFs then connection to any switch name is allowed VLAN ID Determines the VLAN where the adapter FCoE services are available It can have a value from 0 4095 and supports wild card values if...

Page 105: ...value field The 24 most significant bits are reserved The 24 least significant bits contain a FC MAP Of these least significant bits the least significant 8 bits alone can be set VLAN ID Determines t...

Page 106: ...e name you want to change 2 Do one of the following Select Use Default Name from the Port menu From the discovery tree right click the port whose name you want to change and select Restore Default Nam...

Page 107: ...rogress When the reset is finished the status bar shows Reset Com pleted Modifying TCP IP iSCSI Port Configuration The Modify TCP IP Configuration dialog box allows you to enable or disable VLANs assi...

Page 108: ...dialog box To modify TCP IP configurations for iSCSI ports 1 From the discovery tree select the iSCSI port whose configuration you want to modify 2 Select the iSCSI Port Info tab and click Modify The...

Page 109: ...Click Advanced The Advanced TCP IP Configuration dialog box appears 4 From the Route Table or ARP Table sections click Add Entry 5 Enter the Route Table or ARP Table information and click OK The entr...

Page 110: ...over the server using DHCP Figure 55 iSCSI SNS tab To add a server 1 Click Update iSNS Server The Update iSNS Server dialog box appears 2 Enter the server address and port and click OK The new iSNS se...

Page 111: ...lick Enable Port or Disable Port Enabling and Disabling Physical Ports OneConnect Adapters Only Using the Physical Port Info tab you can enable or disable the physical port When you disable a physical...

Page 112: ...Login Options dialog box Initiator Login Options Tab Field Definitions Initiator iSCSI Name The iSCSI qualified name of the initiator Initiator Alias An optional non unique string used to identify th...

Page 113: ...numbers The minimum length of the secret is 12 characters and maximum length is 16 characters Initiator CHAP Name The iSCSI login name sent by the target to the initiator for authentication This param...

Page 114: ...ator attempts to reconnect or reassign a connection or task that has been dropped after an unexpected connection termination or reset The initiator and target negotiate to determine this value Default...

Page 115: ...fect Volatile WWN changes are lost on systems that power cycle the adapters during the reboot To change a port s WWPN or WWNN 1 Do one of the following From the View menu click Group Adapters by Host...

Page 116: ...The OneCommand Utility User Manual Page 109 3 Select the Maintenance tab Figure 58 Maintenance tab 4 Click Change WWN The following warning appears Figure 59 Warning About Changing WWN...

Page 117: ...on Volatile WWN settings to the New WWPN and WWNN settings These values can then be modified if desired and saved to volatile or non volatile memory You can edit the data returned from the button 7 Ch...

Page 118: ...Storport Miniport system the SLIMode driver parameter must also be set to 0 or 3 For Solaris enable npiv For Linux 8 2 lpfc_enable_npiv See Configuring the Fibre Channel or FCoE Adapter Driver on page...

Page 119: ...name and enter a unique WWPN you want to use You can create as many virtual ports as you want A valid port name must have one of the following formats 10 00 xx xx xx xx xx xx 2x xx xx xx xx xx xx xx...

Page 120: ...port 1 Do one of the following From the View menu select Group Adapters by Virtual Ports From the toolbar click Group Adapters by Virtual Ports 2 From the discovery tree select the virtual port you w...

Page 121: ...The OneCommand Utility User Manual Page 114 Figure 62 Virtual Port tab 3 Click Remove Virtual Port The Delete Virtual Port Warning dialog box appears...

Page 122: ...per the FC SP standard to the switch A FLOGI can also be caused by bringing the link between the switch and adapter down and then up Not available in read only mode Authentication must be enabled at...

Page 123: ...orts are placed into an error state When the daemon is started the driver should discover the daemon and reset the adapter to enable the driver to perform authentication To test if this daemon is runn...

Page 124: ...DHCHAP tab enables you to configure authentication Figure 64 DHCHAP tab DHCHAP Tab Field Definitions Source The WWPN of the adapter port Destination The fabric switch Configuration Area Mode The mode...

Page 125: ...led Changing Authentication Configuration To view or change authentication configuration 1 In the discovery tree select the adapter whose configuration you want to view or change 2 Select the DHCHAP t...

Page 126: ...ter the new password 7 Select alpha numeric or hex format 8 Click OK Viewing the Error and Event Log For Solaris and Linux systems a simple shell script checks the var adm messages and var log message...

Page 127: ...a local drive If the adapter is already connected to a boot device the system must be in a state in which this type of maintenance can be performed I O activity on the bus has been stopped Cluster sof...

Page 128: ...you can perform a batch update the firmware file must be downloaded from the Emulex Web site and extracted to a directory on your local drive To update firmware for multiple adapters 1 From the Batch...

Page 129: ...Checkboxes next to the host and adapter entries are used to select or deselect an entry Checking an adapter selects or removes that adapter checking a host removes or selects all eligible adapters fo...

Page 130: ...inished you can click Save Log File to save copy of the activity log 6 Click Close to exit the batch procedure Updating CEE Firmware for a Single Adapter LP21000 Series Adapters Only To support config...

Page 131: ...r Fabric view 2 In the discovery tree select the LP21000 or LP21002 port whose firmware you want to update 3 Select the CEE FCoE tab Figure 68 CEE FCoE Tab 4 Click Update Firmware The CEE Firmware Dow...

Page 132: ...l path and filename of the firmware image file If the firmware file is located in the OneCommand Manager application repository type only the filename The OneCommand Manager application repository can...

Page 133: ...irmware loading is restricted to a single firmware file and to all accessible adapters for which the file is compatible Not available in read only mode Before you can perform a batch update the firmwa...

Page 134: ...rs showing all adapters and their corresponding hosts for which the selected firmware file is compatible Checkboxes next to the host and adapter entries are used to select or deselect an entry Checkin...

Page 135: ...green If the download fails the entry is changed to red Figure 73 Download Complete screen 5 When downloading is finished you can click Save Log File to save a copy of the activity log 6 Click Close...

Page 136: ...Function Default Description Window Globally Automap All Targets Enabled Emulex driver detects all FC devices attached to the Emulex adapters Global Automap Globally Automap All LUNs Enabled Assigns a...

Page 137: ...or a specific LUN the states reported in the On Reboot and Current column are identical However there can be times where these do not match For example the hbacmd utility can be used to change only th...

Page 138: ...ing system boot When you create a persistent binding the OneCommand Manager application tries to make that binding dynamic However the binding must meet all of the following criteria to be dynamic The...

Page 139: ...Target Settings dialog box appears You can enable or disable auto mapping and change the active bind type Click OK 6 Reboot the system for changes to take effect Adding a Persistent Binding To add a...

Page 140: ...ab All targets are displayed 4 Click Bind New The Bind New Target dialog box is displayed Note Automapped targets have entries only in the second column of the Targets Table Persistently bound targets...

Page 141: ...ame sd parent lpfc target 18 lun 10 name sd parent lpfc target 19 lun 15 2 Save the file and exit the text editor Configuring Boot from SAN You can use the OneCommand Manager application to configure...

Page 142: ...N You must select which LUN type to configure For OpenBoot you must also provide a Target ID parameter The OneCommand Manager application runs on a running OS so you must boot the host to configure bo...

Page 143: ...FCoE adapter port on which you want to enable boot from SAN 3 Select the Maintenance tab check enable adapter boot and click Configure Boot The Boot from SAN Configuration dialog box appears Note You...

Page 144: ...able Boot from SAN and set the Topology and Link Speed Topology options are Auto Loop First default Note x86 and OpenBoot share the same configuration memory space You cannot configure an adapter for...

Page 145: ...k OK Select Target D_ID type the numbers and click OK Select Target LUN type the number and click OK For EFIBoot and OpenBoot type in an 8 byte LUN hex and a target ID for the LUN Also you must enter...

Page 146: ...o take effect Configuring Advanced Settings Boot from SAN The OneCommand Manager application provides advanced settings for each boot type From the Boot from SAN Configuration dialog box click Advance...

Page 147: ...he SCSI start unit command You must know the specific LUN to issue Enable EDD 3 0 Enables the Enhanced Disk Drive EDD option shows the path to the boot device Available on Intel Itanium servers only E...

Page 148: ...ending on the option you select Only this device is the boot device and it is the only device exported to the Multi boot menu Auto Scan is available only if none of the eight boot entries is configure...

Page 149: ...to the FC port Discovery can take a long time on large SANs None EFIBootFCScanLevel NVRAM Targets and EFIBootFCScanLevel Discovered Targets Allows 3rd party software to toggle between Boot Path from...

Page 150: ...hex Sets the default AL_PA The range is 0 to 0xEF The default is 0 Enable the Software Foundation Suite SFS Check to enable the Software Foundation Suite SFS driver the emlxs driver The default is th...

Page 151: ...nal Loopback see page 149 Power On Self Test POST see page 147 Echo End to End see page 151 Quick Test see page 146 Perform a diagnostic dump see page 147 Not available in read only mode Control adapt...

Page 152: ...information and flash memory contents The information is read only and is depicted below Figure 83 PCI Registers and Flash Contents of the Diagnostics tab Viewing Flash Contents If you check the Show...

Page 153: ...CI Registers The PCI Registers appear directly on the Diagnostics tab Running a Quick Test The Diagnostics tab enables you to run a quick diagnostics test on a selected adapter The Quick Test consists...

Page 154: ...r health status for 8 seconds When the 8 seconds are up the adapter returns to beaconing mode This cycle repeats indefinitely until you disable this feature or you reset the adapter To enable or disab...

Page 155: ...te Time txt Running Advanced Diagnostic Tests The Advanced Diagnostics feature gives you greater control than the Quick Test over the type of diagnostics tests that run Through Advanced Diagnostics yo...

Page 156: ...CI Loopback Test A firmware controlled diagnostic test in which a random data pattern is routed through the PCI Bus without being sent to an adapter link port The returned data is subsequently validat...

Page 157: ...you manually click Stop Test by selecting the Infinite radio button Test Pattern Enter a custom test pattern to be used in tests that transfer data The test pattern can be up to 8 hexadecimal bytes Te...

Page 158: ...an ECHO command response sequence between an adapter port and a target port Not available in read only mode To run end to end echo tests 1 From the discovery tree select the adapter port from which t...

Page 159: ...le You can save the test log to a log file for later viewing or printing When new data is written to a saved file the data is appended to the end of the file Each entry has a two line header that cont...

Page 160: ...Select Diagnostic Log file Name dialog box appears The default name of a saved file is DiagTest log 2 Browse to the desired directory change the log file name if you want and click Save iSCSI FCoE an...

Page 161: ...except the DMA loopback test are run on the currently selected port The DMA loopback test is run across the entire adapter The same diagnostic is therefore executed regardless of the currently select...

Page 162: ...est by selecting the Infinite radio button Test Pattern Enter a custom test pattern to be used in tests that transfer data The test pattern can be up to 8 hexadecimal bytes Test Status The Test Status...

Page 163: ...Each entry has a two line header that contains the identifier of the adapter being tested and the date and time of the test Over time the data accumulates to form a chronological history of the diagn...

Page 164: ...following command to display the port attributes for the adapter with the specified WWPN hbacmd portattrib 10 00 00 00 c9 20 20 20 For iSCSI and NIC ports the MAC address must be specified For exampl...

Page 165: ...n Windows C Program Files Emulex Util HBAnyware hbacmd h 10 192 113 128 m cim u root p root n elxhbacmpi cimv2 listhba In Linux usr sbin hbanyware hbacmd h 10 192 113 128 m cim u root p root n elxhbac...

Page 166: ...Attributes for 10 00 00 00 c9 6b 62 2b Node WWN 20 00 00 00 c9 6b 62 2b Port WWN 10 00 00 00 c9 6b 62 2b Port Symname Port FCID 0000 Port Type Fabric Port State Unknown Port Service Type 12 Port Suppo...

Page 167: ...oveAllPersistentBinding RemovePersistentBinding SetBindingSupport SetLunMask and SetPersistentBind ing commands are not supported for VMware ESX Note The following hbacmd commands are supported using...

Page 168: ...GetPortStatistics GetDriverParams GetDriverParamsGlobal SetDriverParam SetDriverParamDefaults SaveConfig DriverConfig ExportSanInfo GetCEEParams SetCEEParam CEEDownload SetPGBW GetPGInfo SetCEEPGBW G...

Page 169: ...on ESX 3i U2 U3 via CIM Provider v 1 2 1 x Not Available on ESX 4 via CIM Provider v 2 0 22 1 or later Not Available on ESX 3i U4 via CIM Provider v 2 0 9 x listhbas Port WWN Node WWN Fabric Name X F...

Page 170: ...t State Port Service Type Port Supported FC4 Port Active FC4 Port Supported Speed Port Speed Max Frame Size OS Device Name X Num Discovered Ports X Fabric Name X serverattributes Host Name Table 4 Par...

Page 171: ...nt Tx Word Count Rx Word Count Tx KB Count Rx KB Count LIP Count NOS Count Error Frame Count Dumped Frame Count Link Failure Count Loss of Sync Count Loss of Signal Count Prim Seq Prot Err Count Inval...

Page 172: ...of the parameter The GetDriverParamsGlobal hbacmd command shows only permanent driver parameter values If temporary global values have been set for one or more driver parameters the SaveConfig hbacmd...

Page 173: ...Server Syntax hbacmd Help Boot Description Shows a list of all help commands for the boot commands Parameters None Help BootParams Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax h...

Page 174: ...ux and VMware ESX Server Syntax hbacmd PortStatistics WWPN Description Shows all port statistics for the adapter Parameters WWPN World Wide Port Name of the adapter whose port statistics you want to v...

Page 175: ...pported by Windows Solaris SFS and Linux Syntax hbacmd GetAuthConfig WWPN1 WWPN2 Description Retrieves the authentication configuration for the adapter Parameters WWPN1 World Wide Port Name of the ada...

Page 176: ...2 Hex binary 3 Password not yet defined Password Current password value Parameter Parameters include Mode Timeout Bi directional Hash priority DH priority Re authentication and Re authentication inter...

Page 177: ...ter Flag E Enable the boot code D Disable the boot code GetBootParams Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd GetBootParams WWPN Type Description Shows the boot para...

Page 178: ...rld Wide Port Name of the FCoE adapter port MAC MAC address of the NIC or iSCSI port SetCEEParam Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd SetCEEParam WWPN MAC Param V...

Page 179: ...0xff fcoepriority 0 7 fcoeformat 0 or 0x10000 Uifporttype 1 Access 2 Trunk OneConnect adapter parameters DCBXState 1 enabled 0 disabled DCBXMode 1 CEE 0 CIN PFCEnable 1 enabled 0 disabled PFCWilling...

Page 180: ...WWPN World Wide Port Name of the adapter BW0 Bandwidth percentage for the priority group 0 BW1 Bandwidth percentage for the priority group 1 BW2 Bandwidth percentage for the priority group 2 Example...

Page 181: ...Port Name of the FCoE adapter port for which you want to set CEE priority MAC MAC address of the NIC or iSCSI port for which you want to set CEE priority PFC Priorities These are the priorities that e...

Page 182: ...tFIPParams Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd GetFIPParams WWPN Description Show the FIP parameters of the FC port Parameters WWPN World Wide Port Name of the a...

Page 183: ...olaris SFS Linux and VMware ESX Server Syntax hbacmd GetBeacon WWPN MAC Description Shows the current beacon status for the adapter specified by the WWPN or MAC address Parameters WWPN World Wide Port...

Page 184: ...arameters WWPN World Wide Port Name of the FC or FCoE port on which you want to run the loopback test Max Address MAC address of the NIC or iSCSI port on which you want to run the loopback test Type 0...

Page 185: ...want to view MAC MAC address of the NIC or iSCSI port whose configuration data you want to view The OneCommand Manager application CLI has a command that displays wakeup parameter information much th...

Page 186: ...G Make change global all adapters on this host N Make change non global adapter specific Note Not supported for OneConnect adapters Note Supported for FC and FCoE ports only Note Driver Parameters tha...

Page 187: ...ified adapter s driver parameters to a file The resulting file contains a list of driver parameter definitions in ASCII file format with definitions delimited by a comma Each definition is of the form...

Page 188: ...s to the default for the adapter s Parameters WWPN World Wide Port Name of the adapter whose values you want to change to the default Flag1 L Make changes local for this adapter only G Make changes gl...

Page 189: ...SX Server Syntax hbacmd GetDumpDirectory WWPN Description Shows the dump file directory associated with the adapter Parameters WWPN World Wide Port Name of the adapter on which you want to view the du...

Page 190: ...r 1 Get information from configuration GetLunUnMaskbyHBA Supported by Windows and Solaris SFS Syntax hbacmd GetLunUnMaskByHBA HBA WWPN Option Description Queries for the presence of any unmasked LUNs...

Page 191: ...s HBA WWPN World Wide Port Name of the adapters Target WWPN World Wide Port Name of the target Option 0 Send information to the driver 1 Send information to configuration make persistent 2 Send inform...

Page 192: ...d indicates whether the port is a NIC or an iSCSI port Parameters None CnaGetEventlog Supported by Windows Linux and VMware ESX Server Syntax hbacmd cnageteventlog WWPN MAC Description Shows the CNA e...

Page 193: ...o complete especially for remote devices Once the reset command is completed the system command prompt is displayed Parameters WWPN World Wide Port Name of the adapter you want to reset TargetMapping...

Page 194: ...the VMware ESX server p password Login password of the VMware ESX server n namespace Namespace where the Emulex provider is registered in the sfcb CIMOM of VMware ESX server i e elxhbacmpi cimv2 o por...

Page 195: ...e binding support you want to view Source C Configuration support L Live support Note Supported for FC adapters only Note The PersistentBinding SetPersistentBinding RemovePersistentBinding Remove AllP...

Page 196: ...nding is immediate B Binding is both permanent and immediate BindType P Enable binding by WWPN N Enable binding by WWNN D Enable binding by D_ID TargetId Target WWPN if BindType P Target WWNN if BindT...

Page 197: ...Port Supported by Windows Solaris SFS and Linux Syntax hbacmd CreateVPort physical WWPN auto vname Or hbacmd CreateVPort physical WWPN virtual WWPN virtual WWNN vname Description Creates a virtual por...

Page 198: ...virtual machine name Parameters Physical WWPN World Wide Port Name of the adapter on which you want to list virtual ports VPortTargets Supported by Windows Solaris SFS Linux and VMware ESX Server Syn...

Page 199: ...ssages if a name duplication is detected It is strongly recommended that the activation requirement be fulfilled after each WWN change or restore When running with pending changes some diagnostic and...

Page 200: ..._Address must be passed to each command as the first argument The MAC address refers to the CNA port upon which the command will operate Some of the commands in this document require that values are s...

Page 201: ...properties for a specified Target If the iSCSI target name iscsi_target_name is not specified all targets and their associated properties are displayed If refreshtargets is specified in place of the i...

Page 202: ...ions other than the Target IP and Port are specified then no changes are made You must change at least one of the optional parameters in order for this command to make any changes to the target portal...

Page 203: ...ings should be enclosed in quotations to avoid mangling by the Windows Linux Solaris or VMware shell s parser If the Authentication Method is set to One Way CHAP value of 1 the Target CHAP Name and Ta...

Page 204: ...ns a target discovery once the SendTarget Portal is created This command requires that a valid portal IP address Target_IP and a valid port number Port are specified If the remaining options are not s...

Page 205: ...ortal value 1024 65535 AddTarget Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd h host_IP port hostname port AddTarget MAC_Address Target_IP Port iscsi_target_name InitialR...

Page 206: ...hbacmd h host_IP port hostname port SetTargetLoginProperties MAC_Address iscsi_target_name InitialR2T 0 1 ImmediateData 0 1 HeaderDigest 0 1 DataDigest 0 1 Auth 0 1 2 TgtCHAPName TgtSecret InitCHAPNam...

Page 207: ...12 16 RemoveTarget Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd h host_IP port hostname port RemoveTarget MAC_Address iscsi_target_name Description Removes the target wi...

Page 208: ...x and VMware ESX Server Syntax hbacmd h host_IP port hostname port CleariSNSServer MAC_Address Description Clears the configured iSNS server and disables iSNS target discovery If there is no iSNS serv...

Page 209: ...the CNA port AddRouteTableEntry Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd h host_IP port hostname port AddRouteTableEntry MAC_Address Dest_IP_Address Subnet_Mask Gatew...

Page 210: ...t be set to specify the initiator target CHAP name and secret strings These strings should be enclosed in quotations to avoid mangling by the Windows Linux Solaris or VMware shell s parser If the Auth...

Page 211: ...in quotes string length 11 255 GetSessionInfo Supported by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd h host_IP port hostname port GetSessionInfo MAC_Address iscsi_target_name TSIH...

Page 212: ..._ENABLED 0 Disabled 1 Enabled VLAN_ID VLAN ID of the interface value 0 4095 Priority VLAN priority of the interface value 0 7 DHCP 0 Disabled 1 Enabled IP_Address New IP address for example 10 192 1 1...

Page 213: ...ed by Windows Solaris SFS Linux and VMware ESX Server Syntax hbacmd h host_IP port hostname port iSCSIPing MAC_Address IP_Address Description Issues ICMP echo requests to a target Parameters MAC_Addre...

Page 214: ...esources Invalid Tag Invalid WWN Node Bind Reboot Node Bind Immediate Failed Set PBind Failed Bound to Diff SCSI ID Resource Allocation Wrong Bind Type SCSI ID Already Bound RSC Type Authenticate Fail...

Page 215: ...nvalid LUN Mask Move Configuration Failed LUN Mask Configuration Settings Unavailable LUN Mask Error Accessing configuration Settings LUN Mask Set Lun Mask Failed Bad Parameter Name Config Region Not...

Page 216: ...d Failure discovering targets Quality of Service version mismatch Quality of Service protocol mismatch CIM Error Connection between the client and CIM server is already established Specified address i...

Page 217: ...ngs or other factors may prevent this download from completing successfully resulting in this error To fix the problem manually update the JRE on your system to the version required by the OneCommand...

Page 218: ...d Manager application are subject to fabric zoning configuration Remote hosts to be discovered and managed by the OneCommand Manager application must be in the same zone The SAN management workstation...

Page 219: ...manual 3 Run lputil return to the Boot BIOS Maintenance menu 4 Enable BootBIOS rmmod fails to unload LPFC driver module due to ERROR Module LPFC is in use This message can appear when you attempt to r...

Page 220: ...er Type rmmod lpfc Driver install fails The lpfc install script fails to install the driver The install script may fail for the following reasons A previous version of the driver is installed Run the...

Page 221: ...ange the name of the ramdisk image to match either the Red Hat or SLES naming scheme depending on the distribution being used 2 Update any file links to the OneCommand Manager application ramdisk imag...

Page 222: ...ion If new LUNs are visible you are finished If that doesn t work try the following 1 Exit the OneCommand Manager application 2 Navigate to usr sbin hbanyware 3 Run stop_ocmanager to stop both the elx...

Page 223: ...ny that are preventing a virtual port from being created If there are no unsatisfied conditions yet VPort creation still fails contact Emulex technical support Virtual ports for unsupported adapter or...

Reviews: