Manual Pages


Table of Contents

NAME

na_cifs_branchcache - Display CIFS BranchCache statistics and set BranchCache server secret key

SYNOPSIS

cifs branchcache hash stat [ -flush ] [ -size ]

cifs branchcache set key pass-phrase

DESCRIPTION

Displaying BranchCache statistics
To display BranchCache statistics, use the command cifs branchcache hash stat.

If you specify the "-flush" option, it reports the number of hashes that were flushed in multiples of 5-minute intervals. If hashes are getting flushed frequently then increase the hash timeout value using the option "cifs.smb2_1.branch_cache.hash_time_out".

If you specify the "-size" option, it reports the number of files in various sizes ranges for which hashes were requested for. File size ranges are <10K, 11K-100K, 101K-250K, 251K-1M, 1.1M-10M, 11M-100M, and >100M. BranchCache is based on Peer Content Caching and Retrieval framework. It provides information about BranchCache deployment.

If you specify without arguments, it reports the cumulative output of the "-flush" and "-size" options. The command reports the number of hashes that were flushed in multiples of 5-minute intervals and the number of file size ranges for which hashes were requested for. If hashes are getting flushed frequently then either increase the hash timeout value using the option "cifs.smb2_1.branch_cache.hash_time_out" or adjust the client side configurations to use BranchCache for smaller file sizes.

Setting BranchCache server secret key
To set the BranchCache server secret key, use the command cifs branchcache set key pass-phrase.

pass-phrase
A string that provides cryptographic data used by the BranchCache content server to generate hashes. Content servers that are serving the same data and are expected to provide the same hash values must use the same key. After changing this value, any existing cached content will be identified as stale and retrieved from the content server again.

EXAMPLES

The following example displays the number of hashes that were flushed by Data ONTAP in the last few hours:

storage_system>cifs branchcache hash stat -flush

Number of hashes flushed in duration of 600 seconds = 5
Number of hashes flushed in duration of 900 seconds = 8
Number of hashes flushed in duration of 1200 seconds = 11
Number of hashes flushed in duration of 1500 seconds = 14
Number of hashes flushed in duration of more than 1800 seconds = 22

The following example displays the number of files for which hashes were requested for organized by file size range:

storage_system>cifs branchcache hash stat -size

Number of files (size <= 10KB) for which hashes were asked for = 5
Number of files (10KB < size <= 100KB) for which hashes were asked for = 7
Number of files (100KB < size <= 250k) for which hashes were asked for = 120
Number of files (250KB < size <= 1MB) for which hashes were asked for = 9
Number of files (1MB < size <= 10MB) for which hashes were asked for = 1245
Number of files (10MB < size <= 100MB) for which hashes were asked for = 9
Number of files (size > 100MB) for which hashes were asked for = 27

The following example displays the output for both the -flush and -size parameters:

storage_system>cifs branchcache hash stat

Number of hashes flushed in duration of 600 seconds = 5
Number of hashes flushed in duration of 900 seconds = 8
Number of hashes flushed in duration of 1200 seconds = 11
Number of hashes flushed in duration of 1500 seconds = 14
Number of hashes flushed in duration of more than 1800 seconds = 22
Number of files (size <= 10KB) for which hashes were asked for = 5
Number of files (10KB < size <= 100KB) for which hashes were asked for = 7
Number of files (100KB < size <= 250k) for which hashes were asked for = 120
Number of files (250KB < size <= 1MB) for which hashes were asked for = 9
Number of files (1MB < size <= 10MB) for which hashes were asked for = 1245
Number of files (10MB < size <= 100MB) for which hashes were asked for = 9
Number of files (size > 100MB) for which hashes were asked for = 28

The following example sets the BranchCache server secret key to my secret server key phrase :

storage_system>cifs branchcache set key "my secret server key phrase"

EFFECTIVE

PERSISTENCE

Changes are persistent across system reboots.

SEE ALSO

na_options(1).


Table of Contents