Skip to main content

Modifying BranchCache configurations

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.

  1. Perform the appropriate action:
    If you want to...Enter the following...
    Modify the hash store directory sizevserver 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 storevolume 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.

    See the Logical Storage Management Guide for more information about increasing volume size.

    Modify the hash store directory pathvserver 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 modevserver cifs branchcache modify -vserver vserver_name -operating-mode {per-share|all-shares|disable}
    Note
    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 supportvserver 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.