| Message ID | 20231211173617.932990-1-kartilak@cisco.com (mailing list archive) |
|---|---|
| Headers | show |
| Series | Introduce support for multiqueue (MQ) in fnic | expand |
Karan, > This cover letter describes the feature: add support for multiqueue > (MQ) to fnic driver. Applied to 6.8/scsi-staging, thanks!
On Mon, 11 Dec 2023 09:36:04 -0800, Karan Tilak Kumar wrote: > This cover letter describes the feature: add support for multiqueue (MQ) > to fnic driver. > > Background: The Virtual Interface Card (VIC) firmware exposes several > queues that can be configured for sending IOs and receiving IO > responses. Unified Computing System Manager (UCSM) and Intersight > Manager (IMM) allows users to configure the number of queues to be > used for IOs. > > [...] Applied to 6.8/scsi-queue, thanks! [01/13] scsi: fnic: Modify definitions to sync with VIC firmware https://git.kernel.org/mkp/scsi/c/2cda90e6f649 [02/13] scsi: fnic: Add and use fnic number https://git.kernel.org/mkp/scsi/c/ca008aeeb02c [03/13] scsi: fnic: Add and improve log messages https://git.kernel.org/mkp/scsi/c/3df9dd0d51c2 [04/13] scsi: fnic: Rename wq_copy to hw_copy_wq https://git.kernel.org/mkp/scsi/c/86b86a7d2fda [05/13] scsi: fnic: Get copy workqueue count and interrupt mode from config https://git.kernel.org/mkp/scsi/c/8c2a6f815a18 [06/13] scsi: fnic: Refactor and redefine fnic.h for multiqueue https://git.kernel.org/mkp/scsi/c/554a14826020 [07/13] scsi: fnic: Modify ISRs to support multiqueue(MQ) https://git.kernel.org/mkp/scsi/c/8a8449ca5e33 [08/13] scsi: fnic: Define stats to track multiqueue (MQ) IOs https://git.kernel.org/mkp/scsi/c/b559b827716c [09/13] scsi: fnic: Remove usage of host_lock https://git.kernel.org/mkp/scsi/c/848d010ab934 [10/13] scsi: fnic: Add support for multiqueue (MQ) in fnic_main.c https://git.kernel.org/mkp/scsi/c/52f6e196e52e [11/13] scsi: fnic: Add support for multiqueue (MQ) in fnic driver https://git.kernel.org/mkp/scsi/c/c81df08cd294 [12/13] scsi: fnic: Improve logs and add support for multiqueue (MQ) https://git.kernel.org/mkp/scsi/c/55cf715244a7 [13/13] scsi: fnic: Increment driver version https://git.kernel.org/mkp/scsi/c/53021c192cc5
Hi Martin, reviewers, This cover letter describes the feature: add support for multiqueue (MQ) to fnic driver. Background: The Virtual Interface Card (VIC) firmware exposes several queues that can be configured for sending IOs and receiving IO responses. Unified Computing System Manager (UCSM) and Intersight Manager (IMM) allows users to configure the number of queues to be used for IOs. The number of IO queues to be used is stored in a configuration file by the VIC firmware. The fNIC driver reads the configuration file and sets the number of queues to be used. Previously, the driver was hard-coded to use only one queue. With this set of changes, the fNIC driver will configure itself to use multiple queues. This feature takes advantage of the block multiqueue layer to parallelize IOs being sent out of the VIC card. Here's a brief description of some of the salient patches: - vnic_scsi.h needs to be in sync with VIC firmware to be able to read the number of queues from the firmware config file. A patch has been created for this. - In an environment with many fnics (like we see in our customer environments), it is hard to distinguish which fnic is printing logs. Therefore, an fnic number has been included in the logs. - read the number of queues from the firmware config file. - include definitions in fnic.h to support multiqueue. - modify the interrupt service routines (ISRs) to read from the correct registers. The numbers that are used here come from discussions with the VIC firmware team. - track IO statistics for different queues. - remove usage of host_lock, and only use fnic_lock in the fnic driver. - use a hardware queue based spinlock to protect io_req. - replace the hard-coded zeroth queue with a hardware queue number. This presents a bulk of the changes. - modify the definition of fnic_queuecommand to accept multiqueue tags. - improve log messages, and indicate fnic number and multiqueue tags for effective debugging. Even though the patches have been made into a series, some patches are heavier than others. But, every effort has been made to keep the purpose of each patch as a single-purpose, and to compile cleanly. This patchset has been tested as a whole. Therefore, the tested-by fields have been added only to two patches in the set. All the individual patches compile cleanly. However, I've refrained from adding tested-by to most of the patches, so as to not mislead the reviewer/reader. A brief note on the unit tests: 1. Increase number of queues to 64. Load driver. Run IOs via Medusa. 12+ hour run successful. 2. Configure multipathing, and run link flaps on single link. IOs drop briefly, but pick up as expected. 3. Configure multipathing, and run link flaps on two links, with a 30 second delay in between. IOs drop briefly, but pick up as expected. Repeat the above tests with 1 queue and 32 queues. All tests were successful. Please consider this patch series for the next merge window. Changes between v1 and v2: Suppress a warning raised by a kernel test bot, Incorporate the following review comments from Bart: Remove outdated comment, Remove unnecessary out of range tag checks, Remove unnecessary local variable, Modify function name. Changes between v2 and v3: Incorporate review comment from Hannes: Modify FNIC_MAIN_DBG to prepend fnic number. Modify FNIC_MAIN_DBG definition to prepend function name and line number. Modify FNIC_FCS_DBG definition to prepend function name and line number. Replace FNIC_MAIN_DBG with FNIC_FCS_DBG in fnic_fcs.c Use fnic_num as an argument to FNIC_MAIN_DBG and FNIC_FCS_DBG. Host number is still used as an argument to FNIC_MAIN_DBG and FNIC_FCS_DBG since it in turn uses shost_printk. Replace cpy_wq_base with copy_wq_base. Incorporate the following review comments from Hannes: Replace cpy_wq_base with copy_wq_base. Remove C99 style comment. Extend review comments of FNIC_MAIN_DBG and FNIC_SCSI_DBG to FNIC_ISR_DBG: Use fnic_num as an argument to FNIC_ISR_DBG. Modify definition of FNIC_ISR_DBG. Host number is still used as an argument to FNIC_ISR_DBG since it in turn uses shost_printk. Removed reviewed by tag from Hannes due to additional modifications. Squash the following commits into one: scsi: fnic: Remove usage of host_lock scsi: fnic: Use fnic_lock to protect fnic structures in queuecommand Incorporate review comment from Hannes: Replace cpy_wq_base with copy_wq_base. Incorporate review comment from John Garry: Replace code in fnic_mq_map_queues_cpus with blk_mq_pci_map_queues. Replace shost_printk logs with FNIC_MAIN_DBG. Incorporate the following review comments from Hannes: Replace cpy_wq_base with copy_wq_base. Remove hwq as an argument to fnic_queuecommand_int. Suppress warning from kernel test robot. Replace new shost_printk comments with FNIC_SCSI_DBG. Replace fnic_queuecommand_int with fnic_queuecommand. Incorporate the following review comment from Hannes: Use fnic_num as an argument to FNIC_SCSI_DBG. Modify definition of FNIC_SCSI_DBG. Host number is still an argument since FNIC_SCSI_DBG in turn uses shost_printk. Create a separate patch to increment driver version. Increment driver version number to 1.7.0.0. Changes between v3 and v4: Incorporate review comments from Martin and Hannes: Undo the change to replace host number with fnic number in debugfs since kernel stack uses host number. Use ida_alloc to allocate ID for fnic number. Changes between v4 and v5: Incorporate review comments from Martin: Modify patch commits to include a "---" separator. Changes between v5 and v6: Incorporate comments from Martin: Rebase changes to 6.8/scsi-queue, Resolve merge conflicts. Thanks and regards, Karan Karan Tilak Kumar (13): scsi: fnic: Modify definitions to sync with VIC firmware scsi: fnic: Add and use fnic number scsi: fnic: Add and improve log messages scsi: fnic: Rename wq_copy to hw_copy_wq scsi: fnic: Get copy workqueue count and interrupt mode from config scsi: fnic: Refactor and redefine fnic.h for multiqueue scsi: fnic: Modify ISRs to support multiqueue(MQ) scsi: fnic: Define stats to track multiqueue (MQ) IOs scsi: fnic: Remove usage of host_lock scsi: fnic: Add support for multiqueue (MQ) in fnic_main.c scsi: fnic: Add support for multiqueue (MQ) in fnic driver scsi: fnic: Improve logs and add support for multiqueue (MQ) scsi: fnic: Increment driver version drivers/scsi/fnic/fnic.h | 68 ++- drivers/scsi/fnic/fnic_fcs.c | 63 +-- drivers/scsi/fnic/fnic_isr.c | 168 +++++-- drivers/scsi/fnic/fnic_main.c | 144 ++++-- drivers/scsi/fnic/fnic_res.c | 48 +- drivers/scsi/fnic/fnic_scsi.c | 868 ++++++++++++++++++--------------- drivers/scsi/fnic/fnic_stats.h | 3 + drivers/scsi/fnic/fnic_trace.c | 11 + drivers/scsi/fnic/vnic_dev.c | 4 + drivers/scsi/fnic/vnic_scsi.h | 13 +- 10 files changed, 847 insertions(+), 543 deletions(-)