Skip to main content

Modify BranchCache configurations

Contributors netapp-forry netapp-thomi

You can modify the configuration of the BranchCache service on SVMs, including changing the hash store directory path, the hash store maximum directory size, the operating mode, and which BranchCache versions are supported. You can also increase the size of the volume that contains the hash store.

Steps
  1. Perform the appropriate action:

    If you want to…​ Enter the following…​

    Modify the hash store directory size

    vserver cifs branchcache modify -vserver vserver_name -hash-store-max-size {integer[KB|MB|GB|TB|PB]}

    Increase the size of the volume that contains the hash store

    volume size -vserver vserver_name -volume volume_name -new-size new_size[k|m|g|t] If the volume containing the hash store fills up, you might be able to increase the size of the volume. You can specify the new volume size as a number followed by a unit designation.

    Learn more about managing FlexVol volumes

    Modify the hash store directory path

    vserver cifs branchcache modify -vserver vserver_name -hash-store-path path -flush-hashes {true|false} If the SVM is an SVM disaster recovery source, the hash path cannot be on the root volume. This is because the root volume is not replicated to the disaster recovery destination.

    The BranchCache hash path can contain blanks and any valid file name characters.

    If you modify the hash path, -flush-hashes is a required parameter that specifies whether you want ONTAP to flush the hashes from the original hash store location. You can set the following values for the -flush-hashes parameter:

    • If you specify true, ONTAP deletes the hashes in the original location and creates new hashes in the new location as new requests are made by BranchCache-enabled clients.

    • If you specify false, the hashes are not flushed.

      In this case, you can choose to reuse the existing hashes later by changing the hash store path back to the original location.

    Change the operating mode

    vserver cifs branchcache modify -vserver vserver_name -operating-mode {per-share|all-shares|disable}

    You should be aware of the following when modifying the operating mode:

    • ONTAP advertises BranchCache support for a share when the SMB session is set up.

    • Clients that already have established sessions when BranchCache is enabled need to disconnect and reconnect to use cached content for this share.

    Change the BranchCache version support

    vserver cifs branchcache modify -vserver vserver_name -versions {v1-enable|v2-enable|enable-all}

  2. Verify the configuration changes by using the vserver cifs branchcache show command.