Disable automatic rescan of HBAs initiated by vCenter Server
search cancel

Disable automatic rescan of HBAs initiated by vCenter Server

book

Article ID: 332751

calendar_today

Updated On:

Products

VMware vCenter Server

Issue/Introduction

When you create, expand, extent, or delete a datastore, a rescan of your HBAs is automatically initiated. However, this rescan may result in a “rescan storm” when you are building a new environment and may result in issues such as packet drops and poor performance. In such cases, you may want to disable auto-rescan.
 
This article provides the steps to disable auto-rescan.
 
Note: Auto-rescan enables other hosts in the cluster to recognize and use a newly created datastore immediately. Disabling auto-rescan may create issues when the hosts are unable to recognize datastores. For example, during vMotion, the destination host may reject the request because it is unable to recognize the datastore created by the source host. VMware recommends you to disable auto-rescan only when building a new environment.

Environment

  • VMware vCenter Server 5.1.x
  • VMware vCenter Server 5.0.x
  • VMware vCenter Server 5.5.x
  • VMware vCenter Server 6.7.x
  • VMware vCenter Server 4.1.x
  • VMware vCenter Server 4.0.x
  • VMware vCenter Server 6.5.x
  • VMware VirtualCenter 2.5.x
  • VMware vCenter Server 6.0.x

Resolution

To disable auto-rescan from vSphere Client:
  1. Open the vSphere Client.
  2. Go to Administration > vCenter Server Settings.
  3. Click Advanced Settings.
  4. If the config.vpxd.filter.hostRescanFilter key is not available, add the key and set it to False.

To disable auto-rescan from vSphere Web Client:

  1. Browse to vCenter Servers > vCenter in the vSphere Web Client object navigator.
  2. Click the Manage tab.
  3. Click Settings.
  4. Click Advanced Settings.
  5. Click Edit.
  6. If the config.vpxd.filter.hostRescanFilter key is not available, add the key and set it to False.

Notes:

  • You do not need to restart vCenter Server for the change to take effect.
  • If you turn off the Host Rescan Filter, your hosts continue to perform a rescan each time you present a new LUN to a host or a cluster. This can be seen in the Task and Events pane.

Additional Information

Ensure to set the config.vpxd.filter.hostRescanFilter key to True immediately after building your environment.
 
vCenter Server may display an error if you try to reset the value using the GUI. In such a case,you must manually edit the vpxd.cfg file to enable auto-rescan.
 
To enable auto-rescan by manually editing the vpxd.cfg file:
  1. Open the vpxd.cfg file using a text editor.
  2. Locate the <hostRescanFilter> entry.
  3. Set the entry to true:

    <filter>
    <hostRescanFilter>true</hostRescanFilter>
    </filter>
  4. Restart the VMware VirtualCenter Server service.
For more information, see: Storage Filtering