About the Cisco VIC fNIC fctool Utility for Windows
You can display Cisco VIC fNIC parameters using the Cisco command-line tool for Windows called fctool.exe. This tool has traditionally been available only from the Cisco Technical Assistance Center (TAC) as a troubleshooting tool. Cisco currently does not support this tool, but you can download and use it at your own risk.
Cisco VIC fNIC parameter values such as LUN Queue Depth and I/O Throttle Count can be displayed from the Windows command line.
Please see the Cisco UCS fNIC Tunables White Paper for a complete overview located at this link:
https://www.cisco.com/c/dam/en/us/solutions/collateral/data-center-virtualization/unified-computing/guide-c07-730811.pdf
Requirements:
- fctool.exe Utility
- Microsoft Visual C++ redistributable VCRUNTIME140.dll dynamic link library
The fctool.exe tool requires the Microsoft Visual C++ redistributable VCRUNTIME140.dll dynamic link library, which is available from Microsoft within the vc_redist.x64.exe package. When fctool.exe is run, if there is a missing DLL file error, please download and install the latest Microsoft Visual C++ Redistributable from this link:
https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170
Tool Usage:
To display the fNIC LUN Queue Depth value, at a Windows CMD prompt from which fctool.exe is accessible, run the following command to list the fNICs and their port numbers:
> fctool -list
fnic [04] --> vnic [16] maca [0025b5fa0008]
node_wwn 20000025b5ff0008 port_wwn 20000025b5fa0008
maxdatafieldsize 2112 edtov 2000 ratov 10000
drv fnic2k12.sys (fre) version 4.0.0.1
svc fnic2k12
PCI bus 27 slot 32
fnic [05] --> vnic [17] maca [0025b5fb0008]
node_wwn 20000025b5ff0008 port_wwn 20000025b5fb0008
maxdatafieldsize 2112 edtov 2000 ratov 10000
drv fnic2k12.sys (fre) version 4.0.0.1
svc fnic2k12
PCI bus 27 slot 64
The port number for fnic[04] is 4 and the port number for fnic[05] is 5. The number in the bracket following fnic denotes the port number. To display the LUN Queue Depth value of the fNIC at port 4, run the following command:
> fctool -p 4 -res
fnic --> fnic resources
node_wwn: 20000025b5ff0008
port_wwn: 20000025b5fa0008
.
.
LUN Queue Depth: 128
To display the fNIC I/O Throttle Count value, at a Windows CMD prompt from which fctool.exe is accessible, run the following command to list the fNICs and their port numbers:
> fctool -list
fnic [04] --> vnic [16] maca [0025b5fa0008]
node_wwn 20000025b5ff0008 port_wwn 20000025b5fa0008
maxdatafieldsize 2112 edtov 2000 ratov 10000
drv fnic2k12.sys (fre) version 4.0.0.1
svc fnic2k12
PCI bus 27 slot 32
fnic [05] --> vnic [17] maca [0025b5fb0008]
node_wwn 20000025b5ff0008 port_wwn 20000025b5fb0008
maxdatafieldsize 2112 edtov 2000 ratov 10000
drv fnic2k12.sys (fre) version 4.0.0.1
svc fnic2k12
PCI bus 27 slot 64
The port number for fnic[04] is 4 and the port number for fnic[05] is 5. The number in the bracket following fnic denotes the port number. To display the I/O Throttle Count value of the fNIC at port 4, run the following command:
> fctool -p 4 -res
fnic --> fnic resources
node_wwn: 20000025b5ff0008
port_wwn: 20000025b5fa0008
.
.
throttle cnt: 256
