FC ESX Command Line Interface (CLI) Plug-in Marvell Semiconductor Inc All rights reserved Table of Contents 1. Package Contents 2. Supported Adapters/Controllers 3. Supported Operating Systems 4. Installing the ESXCLI Plug-in 5. Additional Notes 6. Contacting Support 1. Package Contents The QLogic FC ESXCLI plug-in package, version 1.0.45, contains the following files: * QLG-esx-6.x.0-QLogic_FC_Esxcli_Plugin-1.0.45-offline_bundle-18395806.zip - The QLogic FC ESX command line interface plug-in installation package for ESXi 6.0/6.5/6.7. * readme-fcesxcli_plugin-ESXi6.x.txt - This document. * release_notes-fcesxcli_plugin-ESXi6.x.txt - The Release Notes document that lists changes, fixes, known issues, and release details. 2. Supported Adapters The following series of adapters are supported by ESXCLI Plug-in for VMware ESX/ESXi. 25xx/26xx/27xx/28xx FC Family of Adapters 3. Supported Operating Systems This section defines the supported operating systems for the three components. The FC ESXCLI runs on the following operating systems: * VMware ESX 5.5, 6.0, 6.5, 6.7 Intel 64, AMD64 4. Installing the FC ESXCLI Plug-in 4.1 Installing the FC ESXCLI Plug-in The FC ESXCLI Plug-in for VMware ESX was generated as a VIB (vSphere Installation Bundle) file. A VIB contains the complete set of files and binaries required to install the plug-in on VMware ESX/ESXi. The offline-bundle.zip file contains the VIB and the necessary metadata to install the plug-in on VMware ESX/ESXi. 4.1.1 Initial Installation To install the FC ESXCLI plug-in using esxcli command on ESXi systems: 1. Copy the zip file into a directory (for example /var/tmp) of the ESXi system. 2. Execute the "esxcli" commands as follows: # esxcli software vib install --maintenance-mode -d file:////.zip Note: is the directory (for example /var/tmp/) where the plug-in zip file was stored. 3. Reboot the system. 4.1.2 Subsequent Update Installation To update the FC ESXCLI plug-in after a prior installation: 1. Follow the instructions in section 5.3 to remove the existing plug-in. 2. Follow the instructions in section 4.1.1 to install the new plug-in. 5. Additional Notes 5.1 Operating the ESXCLI plug-in After installing the plug-in, you will need to reboot the system. 5.1.1 Operating the ESXCLI plug-in directly on the host To verify the plug-in is installed, execute the esxcli command without any parameters to view the list of namespaces available and check to see if the "qlfc" namespace is listed. 5.1.1.1 To view the list of QLogic adapters: # esxcli qlfc qcc adapter list The adapter Id will be in the form of "Adapter__". For example, "Adapter_QLE2784_QFD1829Y06078". Use this adapter Id for all other commands requiring an adapter Id. 5.1.1.2 To flash update a QLogic adapters: # esxcli qlfc qcc adapter update -i -m -f - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Adapter-Id | One of the Adapter Id from adapter list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Image-Type | Type of image to be updated (required) | | | | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Image-file-with-path | Image Filename with complete path (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - String values are case-sensitive. 5.1.1.3 To view information regarding a specific adapter: # esxcli qlfc qcc adapter info get -i The is one of the adapter Ids displayed in the "list" command. 5.1.1.4 To view personality information regarding a specific adapter: # esxcli qlfc qcc adapter personality get -i The is one of the adapter Ids displayed in the "list" command. 5.1.1.5 To set personality information of a specific adapter: # esxcli qlfc qcc adapter personality set -i -p The is one of the adapter Ids displayed in the "list" command. Note: Personality Change is supported only for ISP2031/ISP8031 based adapters. 5.1.1.6 To view flash information of a specific adapter: # esxcli qlfc qcc adapter flashinfo get -i The is one of the adapter Ids displayed in the "list" command. 5.1.1.7 To view the list of QLogic Ports: # esxcli qlfc qcc port list The Port-Id will be in the form of "FC_". For example, "FC_21-00-00-24-FF-7D-3C-47". Use this Port-Id for all other commands requiring a Port-Id. 5.1.1.8 To update NVRAM information of a specific port using NVRAM file: # esxcli qlfc qcc port updatenvram -i -f The is one of the Port-Ids displayed in the "list" command. 5.1.1.9 To view information regarding a specific port: # esxcli qlfc qcc port info get -i The is one of the Port-Ids displayed in the "list" command. 5.1.1.10 To view SFP DMI data of a specific port: # esxcli qlfc qcc port dmi get -i The is one of the port Ids displayed in the "list" command. 5.1.1.11 To view SFP DMI data of a specific port as Hex values: # esxcli qlfc qcc port dmi getraw -i The is one of the port Ids displayed in the "list" command. 5.1.1.12 To view FC Statistics of a specific port: # esxcli qlfc qcc port stats get -i The is one of the port Ids displayed in the "list" command. 5.1.1.13 To view FC VPD of a specific port: # esxcli qlfc qcc port vpd get -i The is one of the port Ids displayed in the "list" command. 5.1.1.14 To view HBA Parameters of a specific port: # esxcli qlfc qcc port hbaparams get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.15 To set HBA Parameters of a specific port in cache file: This command sets user provided data in temporary cache file. This cache file will be used by "set" command to save settings in flash. # esxcli qlfc qcc port hbaparams setFile -i -c -d -b -n -f -p -g -k -v -a -x -z -l -e -o -u -r -m -w -y -q Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Connection-Options | Port Connection Options (Optional) | | | | | | | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Rate | Speed to set (Optional) | | | | | | <32_Gbps, 64_Gbps> See Note 1 below | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-BIOS | Enable BIOS (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-Fabric-Assigned-WWN | Enable Fabric Assigned WWPN (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-FC-Tape | Enable FC Tape support (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-Hard-Loop-ID | Enable Hard Loop ID (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-Lip-Full-Login | Enable LIP Full Login (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-LR | Enable Long Range (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-Receive-Out-Of-Order-Frame | Enable Out-Of-Order Frames (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-Target-Reset | Enable Target Reset (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Execution-Throttle | Execution Throttle (Optional) <0 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Frame-Size | FC Frame Sixze (Optional) <512, 1024, 2048> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Hard-Loop-ID | Hard Loop ID (Optional) <0 - 125> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Interrupt-Delay-Timer | Interrupt Delay Timer in Seconds (Optional) <0 - 255> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Link-Down-Timeout | Link Down Timeout in Seconds (Optional) <0 - 240> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Login-Retry-Count | Login Retry Count (Optional) <0 - 255> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Loop-Reset-Delay | Loop Reset Delay (Optional) <0 -255> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Operation-Mode | Opearting Mode (Optional) | | | | | | | | | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Down-Retry-Count | Port Down Retry Count (Optional) <0 - 255> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | LUNs-Per-Target | Luns Per Target (Optional) | | | <0, 8, 16, 32, 64, 128, 256> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Enable-SCM | Enable SAN Congestion Mgmt (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - String values are case-sensitive. Note: 1. The Data Rate values are highest 3 speed values supported for the adapter. The maximum speed value is displyed in Port Info command. e.g: If maximum speed value is "32 Gbps", then Data Rate values supported are "Auto, 32_Gbps, 16_Gbps, 8_Gbps". 2. Enable BIOS paramter is also used for Boot From SAN settings. 5.1.1.16 To set HBA Parameters of a specific port in the flash: This command sets user provided data from temporary cache file to flash. This command will fail if cache file is not present. On successful completion of "set" command cache file will be deleted. # esxcli qlfc qcc port hbaparams set -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.17 To Restore Default values of HBA Parameters of a specific port in the flash: # esxcli qlfc qcc port hbaparams restoreDefaults -i Note: This command is not supported for NPIV Virtual Port. This command also clears Boot Config settings. The is one of the port Ids displayed in the "list" command. 5.1.1.18 To view Forward-Error-Correction (FEC) info of a specific port: # esxcli qlfc qcc port fec get -i Notes: 1. This command is not supported for NPIV Virtual Port. 2. FEC is enabled by default on MEZZ cards. 3. FEC is disabled on all cards when PortSpeed is < 16Gbps. 4. FEC is enabled on all cards when PortSpeed is >= 32Gbps. The is one of the port Ids displayed in the "list" command. 5.1.1.19 To set Forward-Error-Correction (FEC) info of a specific port: # esxcli qlfc qcc port fec set -i -f -r Notes: 1. This command is not supported for NPIV Virtual Port. 2. FEC is read-only for MEZZ cards. 3. FEC is read-only for all cards when PortSpeed is < 16Gbps. 4. FEC is read-only for all cards when PortSpeed is >= 32Gbps. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | FEC-Status | FEC Status (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Reset | Reset FEC Counters (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - String values are case-sensitive. 5.1.1.20 To view Buffer-to-Buffer Credits (BBCR) info of a specific port: # esxcli qlfc qcc port bbcr get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.21 To set Buffer-to-Buffer Credits (BBCR) info of a specific port in local cache file: This command sets user provided data in temporary cache file. This cache file will be used by "set" command to save settings in flash. # esxcli qlfc qcc port bbcr setFile -i -b -c Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | BBCR-Status | BBCR Status (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | BBCR-Configured | BBCR Configured value (Optional) <0 - 15> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - String values are case-sensitive. 5.1.1.22 To set Buffer-to-Buffer Credits (BBCR) info of a specific port in the flash: # esxcli qlfc qcc port bbcr set -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.23 To view Boot Configuration info of a specific port: # esxcli qlfc qcc port bootconfig get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.24 To set Boot Configuration info of a specific port in local cache file: This command sets user provided data in temporary cache file. This cache file will be used by "set" command to save settings in flash. # esxcli qlfc qcc port bootconfig setFile -i -d -f -p -x -y -z Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Boot-From-Selected-Device | Enable Boot From Selected Device (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Fabric-Assigned-Boot-LUN | Enable Fabric Assigned Boot LUN (Optional) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Primary-Boot-Target | Primary Boot Target and LUN (Optional) | | | "-" separated Target WWPN and ":" separated LUN | | | e.g.: "20-01-00-00-0E-14-45-2C:5" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Alternate-Boot-Target-1 | Alternate Boot Target 1 and LUN (Optional) | | | "-" separated Target WWPN and ":" separated LUN | | | e.g.: "20-01-00-00-0E-14-45-2D:4" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Alternate-Boot-Target-2 | Alternate Boot Target 2 and LUN (Optional) | | | "-" separated Target WWPN and ":" separated LUN | | | e.g.: "20-01-00-00-0E-14-45-2E:3" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Alternate-Boot-Target-3 | Alternate Boot Target 3 and LUN (Optional) | | | "-" separated Target WWPN and ":" separated LUN | | | e.g.: "20-01-00-00-0E-14-45-2F:2" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - String values are case-sensitive. 5.1.1.25 To set Boot Configuration info of a specific port in the flash: # esxcli qlfc qcc port bootconfig set -i Note: 1. This command is not supported for NPIV Virtual Port. 2. Enable Host HBA BIOS in HBA Params must be set for Boot From SAN. 3. Alternate-Boot-Target-2 and Alternate-Boot-Target-3 boot are not supported for Dell branded adapters. The is one of the port Ids displayed in the "list" command. 5.1.1.26 To get Firmware Dump info of a specific port in a binary file: # esxcli qlfc qcc port fwdump get -i -f Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.27 To get Beacon info of a specific port: # esxcli qlfc qcc port beacon get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.28 To set Beacon info of a specific port: # esxcli qlfc qcc port beacon set -i -b Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Beacon-State | Beacon state to be set (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.29 To view SAN Congestion Management (SCM) Statistics of a specific port: # esxcli qlfc qcc port scmstats get -i The is one of the port Ids displayed in the "list" command. 5.1.1.30 To clear SAN Congestion Management (SCM) Statistics of all the targets connected to a specific port: # esxcli qlfc qcc port scmstats clear -i The is one of the port Ids displayed in the "list" command. 5.1.1.31 To check SAN Congestion Management (SCM) Status of a specific port: # esxcli qlfc qcc port scmchk get -i The is one of the port Ids displayed in the "list" command. 5.1.1.32 To get Diagnostics Port (DPort) Status of a specific port: # esxcli qlfc qcc port dportdiag get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.33 To set Diagnostics Port (DPort) Status of a specific port: # esxcli qlfc qcc port dportdiag set -i -m Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | DPort-Mode | DPort Mode to be set (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.34 To run Diagnostics Port (DPort) test on a specific port: # esxcli qlfc qcc port dportdiag run -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.35 To run CT Diagnostics test on a specific port: # esxcli qlfc qcc port ctdiag run -i -p -n -e -t Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Test-Type | CTDiag Test Type (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Number-of-Tests | Number of tests (required) <1 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Stop-On-Error | Stop on error flag (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Target | Target WWPN to send CT Diag command (required) | | | "-" separated Target WWPN | | | e.g.: "20-01-00-00-0E-14-45-2F" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.36 To run FC Ping Diagnostics test on a specific port: # esxcli qlfc qcc port fcping run -i -n -e -t Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Number-of-Tests | Number of tests (required) <1 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Stop-On-Error | Stop on error flag (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Target | Target WWPN to send FC Ping command (required) | | | "-" separated Target WWPN | | | e.g.: "20-01-00-00-0E-14-45-2F" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.37 To run FC Echo ELS Diagnostics test on a specific port: # esxcli qlfc qcc port fcecho run -i -n -e -t Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Number-of-Tests | Number of tests (required) <1 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Stop-On-Error | Stop on error flag (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Target | Target WWPN to send FC Ping command (required) | | | "-" separated Target WWPN | | | e.g.: "20-01-00-00-0E-14-45-2F" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.38 To Read Diagnostics Parameter (RDP) test on a specific port: # esxcli qlfc qcc port rdp get -i Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. 5.1.1.39 To run Loopback test on a specific port: # esxcli qlfc qcc port loopback run -i -p -z -n -e -t -l -d Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Pattern-Type | Loopback Data Pattern Type (required) | | | | | | <01011010, 10100101, 10101010, 11111111, Custom> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Size | Data Size (required) | | | <8, 16, 32, 64, 128, 256, 512, 1024, 2048> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Number-of-Tests | Number of tests (required) <1 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Stop-On-Error | Stop on error flag (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Test-Increment | Test Increment (required) <1 - 65535> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Loopback-Type | Loopback Test Type (required) | | | | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Pattern | Data pattern for Custom type (Optional) | | | e.g.: "2-1-0-0-E-4-5-F" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.40 To run Read/Write Buffer test on a specific port: # esxcli qlfc qcc port rwbuffer run -i -p -z -n -e -t -d Note: This command is not supported for NPIV Virtual Port. The is one of the port Ids displayed in the "list" command. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Port-Id | One of the Port Id from port list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Pattern-Type | Loopback Data Pattern Type (required) | | | | | | <01011010, 10100101, 10101010, 11111111, Custom> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Size | Data Size (required) <8, 16, 32, 64, 128> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Number-of-Tests | Number of tests (required) <1 - 10000> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Stop-On-Error | Stop on error flag (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Test-Increment | Test Increment (required) <1 - 10000> | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Data-Pattern | Data pattern for Custom type (Optional) | | | e.g.: "2-1-0-0-E-4-5-F" | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5.1.1.41 To view the list of FC Targets detected through QLogic Ports: # esxcli qlfc qcc target list The Target-Id will be in the form of "FC__Target_". For example, "FC_21-00-00-24-FF-7D-3C-47_Target_51-00-00-42-3C-AB-67-5D". Use this Target-Id for all other commands requiring a Target-Id. 5.1.1.42 To view information regarding a specific target: # esxcli qlfc qcc target info get -i The is one of the Target-Ids displayed in the "list" command. 5.1.1.43 To view SAN Congestion Management (SCM) Statistics of a specific target: # esxcli qlfc qcc target scmstats get -i The is one of the Target-Ids displayed in the "list" command. 5.1.1.44 To check SAN Congestion Management (SCM) Status of a specific target: # esxcli qlfc qcc target scmchk get -i The is one of the Target-Ids displayed in the "list" command. 5.1.1.45 To view iiDMA speed of a specific target: # esxcli qlfc qcc target iidma get -i The is one of the Target-Ids displayed in the "list" command. 5.1.1.46 To set iiDMA speed of a specific target: # esxcli qlfc qcc target iidma set -i -s - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Parameter | Value | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Target-Id | One of the Target Id from target list command (required) | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - | Link-Speed | Speed to set (required) | | | <1_Gbps, 2_Gbps, 4_Gbps, 8_Gbps, 16_Gbps, > | | | <32_Gbps, 64_Gbps> See Note 1 below | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: 1. The Link Speed values are upto max speed supported for the adapter port. The maximum speed value is displyed in Port Info command. e.g: If maximum speed value is "32 Gbps", then Link Speed values supported are "1_Gbps, 2_Gbps, 4_Gbps, 8_Gbps, 16_Gbps, 32_Gbps". 5.1.1.47 To view the list of FC LUNs detected through QLogic Ports: # esxcli qlfc qcc lun list The LUN-Id will be in the form of "FC__Target__LUN_". For example, "FC_21-00-00-24-FF-7D-3C-47_Target_51-00-00-42-3C-AB-67-5D_LUN_11". Use this LUN-Id for all other commands requiring a LUN-Id. 5.1.1.48 To view information regarding a specific LUN: # esxcli qlfc qcc lun info get -i The is one of the LUN-Ids displayed in the "list" command. 5.1.2 Operating the ESXCLI plug-in remotely To operate the ESXCLI plug-in remotely, the vSphere Command Line Interface (CLI) from VMware must be installed on your local workstation. The local workstation must also be able to connect to the ESXi host. Once the vSphere CLI software is installed on the local workstation, esxcli commands may be executed through this software. The commands to view and configure the QLogic adapters are the same as the commands listed in section 5.2.1 with the exception that login information will be required to execute the command. For example, to view the list of QLogic adapters: # \esxcli -s -u -p qlfc qcc adapter list The is the path to the directory where the vSphere CLI was installed. The is the IP address of the ESXi host. The is the user name to use to log in to the ESXi host. The is the password to use to log in to the ESXi host. On Windows, for example, the command would look like: C:\> "C:\Program Files (x86)\VMware\VMware vSphere CLI\bin\esxcli" -s 192.168.1.27 -u root -p password qlfc qcc adapter list To update the firmware on an adapter remotely requires some additional steps in order to upload the firmware file to the ESXi host. Step 1: Find the name of the datastore to store the firmware file C:\> "C:\Program Files (x86)\VMware\VMware vSphere CLI\bin\esxcli" -s 192.168.1.27 -u root -p password storage vmfs extent list Step 2: Create a temporary directory to store the fimrware file using the "Volume Name" found in Step 1. C:\> "C:\Program Files (x86)\VMware\VMware vSphere CLI\bin\vifs.pl" --server 192.168.1.27 --username root --password password --mkdir "[datastore1 (3)] tmp" This will create a directory called "tmp" on the datastore "datastore1 (3)". Step 3: Upload the file to the ESXi host C:\> "C:\Program Files (x86)\VMware\VMware vSphere CLI\bin\vifs.pl" --server 192.168.1.27 --username root --password password --put "[datastore1 (3)] tmp/" This will upload the firmware file named on the ESXi host in the directory "tmp". Step 4: Execute the update command C:\> "C:\Program Files (x86)\VMware\VMware vSphere CLI\bin\esxcli" -s 192.168.1.27 -u root -p password qlfc qcc adapter update -i -f This will execute the firmware update command on the named adapter () using the file specified by the . The must be the file name specified following the following format: /vmfs/volumes/// The is the VMFS UUID that is listed in the table shown in Step 1 for the datastore that was used to store the firmware file. The is the directory that was created in Step 2 on the datastore. The is the name of the firmware file specified in Step 3. 5.2 Enabling/Disabling Debug in FC ESXCLI plug-in 5.2.1 Enabling Debug in FC ESXCLI plug-in 1. Enable ESXCLI-Plugin debugging # export QLFC_DEBUG_LEVEL=65535 2. Restart hostd # /etc/init.d/hostd restart 3. Run FC ESXCLI Plugin command # esxcli qlfc qcc adapter list # esxcli qlfc qcc adapter update -i -f Logs will get generated in following files: * /var/tmp/qfcesxcli.log * /var/tmp/quapi-output.log * /var/log/quapi.log 5.2.2 Disabling Debug in FC ESXCLI plug-in 1. Disable ESXCLI-Plugin debugging export QLFC_DEBUG_LEVEL=0 2. Restart hostd # /etc/init.d/hostd restart 5.3 Removing the FC ESXCLI plug-in To remove the FC ESXCLI plug-in, use esxcli command. 1. To view VIB list: # esxcli software vib list 2. To remove the ESXCLI plug-in: # esxcli software vib remove --vibname qlogic-fc-esxcli-plugin --maintenance-mode -f 5.4 Hardware Requirements This section defines the minimum hardware requirements. FC ESXCLI plug-in ------------------------------ The FC ESXCLI plug-in requires the following minimum hardware: * One or more QLogic Adapters. * Single-processor or multi-processor server or workstation. The server and workstation hardware must be compatible and capable of running the VMware ESXi 5.5/6.0 platform. Refer to the latest online "VMware Compatibility Guide" for your OS on the VMware Web site: http://www.vmware.com * About 5MB disk space 5.5 Software Requirements This section defines the minimum software requirements. FC ESXCLI plug-in ------------------------------ The FC ESXCLI plug-in requires the following minimum software: * Administrative privileges to perform management functions * One of the operating systems identified in the "3. OS Support" section. * (Optional) VMware vSphere CLI (Command Line Interface) for remote operation 6. Contacting Support Please feel free to contact Marvell QLogic Support at https://www.marvell.com/support.html for further assistance. (c) Copyright 2016-2021. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of Marvell Semiconductor Inc. All other brand and product names are trademarks or registered trademarks of their respective owners.