### systemctl start blobfuse2.service Source: https://github.com/azure/azure-storage-fuse/blob/main/setup/readme.md Starts the blobfuse2 service. ```bash systemctl start blobfuse2.service ``` -------------------------------- ### Install dependencies on Ubuntu Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install required dependencies on Ubuntu using apt. ```bash sudo apt-get install pkg-config libfuse-dev cmake libcurl4-gnutls-dev libgnutls28-dev uuid-dev libgcrypt20-dev libboost-all-dev gcc g++ -y ``` -------------------------------- ### Install blobfuse2 on SUSE Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Install blobfuse2 on SUSE using zypper. ```bash sudo zypper install fuse3 blobfuse2 ``` -------------------------------- ### Install blobfuse2 on Ubuntu 20.04+ Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Install blobfuse2 on Ubuntu 20.04 and above using apt-get. ```bash sudo apt-get install fuse3 blobfuse2 ``` -------------------------------- ### Install blobfuse on Ubuntu Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install blobfuse and fuse on Ubuntu using apt. ```bash sudo apt-get install blobfuse fuse ``` -------------------------------- ### Install blobfuse2 on RHEL Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Install blobfuse2 on RHEL by downloading and installing the RPM package. Replace and with your versions. ```bash sudo rpm -Uvh https://packages.microsoft.com/rhel//prod/blobfuse2--RHEL--x86_64.rpm ``` -------------------------------- ### blobfuse2 secure get example with flags Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_get.md Example usage of blobfuse2 secure get with the --config-file, --passphrase, and --key flags to retrieve the value of the logging.log_level key from an encrypted config file. ```bash blobfuse2 secure get --config-file=config.yaml --passphrase=PASSPHRASE --key=logging.log_level ``` -------------------------------- ### Install blobfuse2 on RedHat/CentOS Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Install blobfuse2 on RedHat/CentOS using yum. ```bash sudo yum install fuse3 blobfuse2 ``` -------------------------------- ### Install dependencies for SUSE Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install fuse3 dependencies for building from source on SUSE. ```bash sudo zypper install fuse3 libfuse3-dev ``` -------------------------------- ### Install dependencies on CentOS Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install required dependencies on CentOS. First install epel-release, then the build dependencies. ```bash sudo yum -y install epel-release sudo yum install git cmake3 fuse-devel libcurl-devel gcc gcc-c++ gnutls-devel libgcrypt-devel libuuid-devel boost-devel fuse -y ``` -------------------------------- ### Install blobfuse2 on Ubuntu 18.04 Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Install blobfuse2 on Ubuntu 18.04 using apt-get. ```bash sudo apt-get install fuse blobfuse2 ``` -------------------------------- ### Clone azure-storage-fuse repository Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Clone the azure-storage-fuse repository. If git is not installed, install it with 'sudo apt-get install git'. ```bash git clone https://github.com/Azure/azure-storage-fuse/ ``` -------------------------------- ### Install tools and build Blobfuse2 Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Installs required packages, FIO, and builds Blobfuse2. Verifies FIO version is 3.36 and Blobfuse2 version. Sets file descriptor limit. ```bash sudo apt-get update sudo apt-get install -y fuse3 libfuse3-dev gcc jq python3 bc libaio-dev \ \tbuild-essential curl git iproute2 ./tools/install_fio.sh fio --version # must be fio-3.36 ./build.sh ./blobfuse2 --version ulimit -n 65536 ``` -------------------------------- ### Install blobfuse2 and fuse on CentOS/RedHat Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install blobfuse2 and fuse3 on CentOS / RedHat. ```bash sudo yum install fuse3 fuse3-libs blobfuse2 ``` -------------------------------- ### systemctl enable blobfuse2.service Source: https://github.com/azure/azure-storage-fuse/blob/main/setup/readme.md Enables the blobfuse2 service to start automatically with the system. ```bash systemctl enable blobfuse2.service ``` -------------------------------- ### Install dependencies on RedHat Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install required dependencies on RedHat using yum. ```bash sudo yum install git cmake fuse-devel libcurl-devel gcc gcc-c++ gnutls-devel libgcrypt-devel libuuid-devel boost-devel fuse -y ``` -------------------------------- ### Install dependencies for CentOS/RedHat Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install fuse3 dependencies for building from source on CentOS / RedHat. ```bash sudo yum install fuse3 fuse3-devel ``` -------------------------------- ### Simulate Pages migration locally Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Creates a dry-run site from the real benchmarks branch, runs the publish script, verifies expected files and absence of legacy directories, and starts a local HTTP server for inspection. ```bash DRY_RUN_SITE=/tmp/blobfuse-benchmark-migration rm -rf "$DRY_RUN_SITE" mkdir -p "$DRY_RUN_SITE" git archive origin/benchmarks | tar -x -C "$DRY_RUN_SITE" python3 perf_testing/scripts/publish_benchmarks.py \ --results-dir benchmark-artifacts \ --site-dir "$DRY_RUN_SITE" test -f "$DRY_RUN_SITE/index.html" test -f "$DRY_RUN_SITE/developer/index.html" test -f "$DRY_RUN_SITE/data/public/history.json" test -f "$DRY_RUN_SITE/data/developer/history.json" test -d "$DRY_RUN_SITE/release" test -e "$DRY_RUN_SITE/issueMetric.txt" test ! -e "$DRY_RUN_SITE/X86" test ! -e "$DRY_RUN_SITE/ARM64" test ! -e "$DRY_RUN_SITE/legacy_runs" python3 -m http.server 8000 --directory "$DRY_RUN_SITE" ``` -------------------------------- ### Install blobfuse on RedHat/CentOS Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install blobfuse and fuse on RedHat/CentOS using yum. ```bash sudo yum install blobfuse fuse ``` -------------------------------- ### Install blobfuse2 and fuse on Mariner Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install blobfuse2 and fuse on Mariner. ```bash sudo tdnf install fuse fuse3 blobfuse2 ``` -------------------------------- ### blobfuse2 secure decrypt example with config-file and passphrase Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_decrypt.md Example usage that decrypts a configuration file using the --config-file and --passphrase flags. The passphrase can also be provided via the BLOBFUSE2_SECURE_CONFIG_PASSPHRASE environment variable. ```bash blobfuse2 secure decrypt --config-file=config.yaml --passphrase=PASSPHRASE ``` -------------------------------- ### Install dependencies for Ubuntu 20.04/22.04/Debian 11 Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install fuse3 dependencies for building from source on Ubuntu 20.04 / Ubuntu 22.04 / Debian 11. ```bash sudo apt-get install fuse3 libfuse3-dev ``` -------------------------------- ### Install fuse3 and libfuse3-dev Source: https://github.com/azure/azure-storage-fuse/blob/main/TSG.md Install fuse3 and libfuse3-dev on Debian/Ubuntu systems to ensure the required FUSE libraries are available for building. ```bash sudo apt-get install fuse3 libfuse3-dev -y ``` -------------------------------- ### Install build-essential for CMake CXX compiler error Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Troubleshoot-FAQ Installs g++ and other build tools to resolve the CMake error 'CMAKE_CXX_COMPILER-NOTFOUND'. Run in a terminal on the build machine. ```bash sudo apt-get update && sudo apt-get install build-essential ``` -------------------------------- ### Install dependencies for Mariner Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install fuse and fuse3 dependencies for building from source on Mariner. ```bash sudo tdnf install fuse libfuse-dev fuse3 libfuse3-dev ``` -------------------------------- ### Install build dependencies for fuse error Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install the required dependencies to resolve the build error. ```bash sudo apt-get install make cmake gcc g++ parallel ``` -------------------------------- ### Load or install bash completions for blobfuse2 Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_bash.md Load bash completions for the current session, or install them permanently for Linux or macOS. The Linux and macOS commands require a new shell to take effect. ```bash source <(blobfuse2 completion bash) ``` ```bash blobfuse2 completion bash > /etc/bash_completion.d/blobfuse2 ``` ```bash blobfuse2 completion bash > /usr/local/etc/bash_completion.d/blobfuse2 ``` -------------------------------- ### blobfuse2 secure get command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_get.md Shows the basic command syntax for retrieving a configuration value from an encrypted config file using blobfuse2 secure get. ```bash blobfuse2 secure get [flags] ``` -------------------------------- ### Mount BlobFuse in streaming mode with cache timeout Source: https://github.com/azure/azure-storage-fuse/wiki/Mount-Blobfuse Example CLI command for streaming mode with a custom attribute cache timeout. ```bash # blobfuse2 mount --streaming --attr-cache-timeout=120 ``` -------------------------------- ### Install dependencies for Ubuntu 18.04/Debian 9/10 Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Install fuse dependencies for building from source on Ubuntu 18.04 / Debian 9 / Debian 10. ```bash sudo apt-get install fuse libfuse-dev ``` -------------------------------- ### Install fuse package Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Troubleshoot-FAQ Installs the fuse package on CentOS, Fedora, RHEL to resolve mount errors. ```bash yum install fuse ``` -------------------------------- ### Syslog redirection setup commands Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Logging Steps to redirect blobfuse2 logs from /var/log/syslog to a separate file. Files are part of the package or found under 'systemd' directory. ```bash - copy setup/11-blobfuse2.conf to /etc/rsyslog.d/ - copy setup/blobfuse2-logrotate to /etc/logrotate.d/ - restart rsyslog service - $> service rsyslog restart ``` -------------------------------- ### Mount BlobFuse in caching mode with cache timeouts Source: https://github.com/azure/azure-storage-fuse/wiki/Mount-Blobfuse Example CLI command for caching mode with custom attribute and file cache timeouts. ```bash # blobfuse2 mount --tmp-path= --attr-cache-timeout=120 --file-cache-timeout=120 ``` -------------------------------- ### Blobfuse startup error messages Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Troubleshoot-FAQ Error messages that appear when blobfuse cannot start due to missing configuration or credentials. Check the config file or environment variables, and also consider network issues or firewall filters. ```text Unable to start blobfuse. No config file was specified and the AZURE_STORAGE_ACCOUNTenvironment variable was empty ``` ```text Unable to start blobfuse due to a lack of credentials. Please check the readme for valid auth setups. ``` -------------------------------- ### Install dependencies on SLES Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install required dependencies on SLES 11/12/15. The SUSEConnect step may not be needed for SUSE 15. ```bash SUSEConnect -p sle-sdk/12.4/x86_64 ( this step may not be needed for SUSE 15) zypper install git cmake fuse-devel libcurl-devel gcc gcc-c++ gnutls-devel libgcrypt-devel fuse libuuid-devel boost-devel ``` -------------------------------- ### Install blobfuse RPM for RHEL 7 Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Install the blobfuse RPM package for RHEL 7.8. For RHEL 7.5, replace 7.8 with 7.5. For the latest version, replace 1.4.1 with the intended blobfuse version. ```bash sudo rpm -Uvh https://packages.microsoft.com/rhel/7.8/prod/blobfuse-1.4.1-RHEL-7.8-x86_64.rpm For RHEL 7.5 replace 7.8 in above command with 7.5 For latest version replace 1.4.1 in above command with blobfuse version you intend to install ``` -------------------------------- ### Install fuse3 on Ubuntu Source: https://github.com/azure/azure-storage-fuse/blob/main/TSG.md Installs the fuse3 package on Ubuntu 20+ to resolve the 'fusermount: command not found' error. The fuse version (2 or 3) depends on the Linux distribution. ```bash sudo apt install fuse3 ``` -------------------------------- ### blobfuse2 secure set example with config-file, passphrase, key, and value Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_set.md Example usage of blobfuse2 secure set that updates the logging.log_level key to log_debug in the encrypted config.yaml file, using the provided passphrase. ```bash blobfuse2 secure set --config-file=config.yaml --passphrase=PASSPHRASE --key=logging.log_level --value=log_debug ``` -------------------------------- ### Mount error output Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Troubleshoot-FAQ Example error output when mounting via fstab fails, indicating missing fuse package. ```text mount: wrong fs type, bad option, bad superblock on /scripts/mount.sh, missing codepage or helper program, or other error In some cases useful info is found in syslog - try dmesg | tail or so. ``` -------------------------------- ### blobfuse2 secure get options Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_get.md Options available for the blobfuse2 secure get command, including the --key flag to specify the config key to search for in the encrypted config file. ```bash -h, --help help for get --key string Config key to be searched in encrypted config file ``` -------------------------------- ### Encrypt config with blobfuse2 secure Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure.md Example of encrypting a configuration file with a passphrase. The passphrase can also be provided via the BLOBFUSE2_SECURE_CONFIG_PASSPHRASE environment variable. ```bash blobfuse2 secure encrypt --config-file=config.yaml --passphrase=PASSPHRASE ``` -------------------------------- ### Add fstab entry using mount.sh Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Configuring-and-Running Add this line to /etc/fstab to persist the mount using mount.sh. Requires fuse package installed and connection.cfg updated. ```fstab //mount.sh fuse _netdev ``` -------------------------------- ### Combined Filters Example Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Blob-Filter Combines multiple filters using '&&' and '||' operators. Precedence using parentheses is not supported yet. ```plaintext --filter=name=^testfil.* && size>130000000 ``` -------------------------------- ### Options for blobfuse2 secure decrypt Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_decrypt.md Displays the help flag for the decrypt command. Use -h or --help to get command-specific help. ```bash -h, --help help for decrypt ``` -------------------------------- ### Enable SDK logging via config Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Logging Enable SDK logging to get detailed logs of REST calls for diagnosing issues in blobfuse, SDK, or service side. ```yaml azstorage.sdk-trace: true ``` -------------------------------- ### Configure Microsoft apt repository on Ubuntu Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Configure the apt repository for Microsoft products on Ubuntu. Replace with your Ubuntu version. ```bash wget https://packages.microsoft.com/config/ubuntu//packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb sudo apt-get update ``` -------------------------------- ### Render and serve results site locally Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Creates a temporary site directory, runs the publish script to generate the site from the full results, then serves it on port 8000. Use SSH or VS Code port forwarding instead of exposing the port. ```bash SITE_DIR=/tmp/blobfuse-benchmark-site rm -rf "$SITE_DIR" python3 perf_testing/scripts/publish_benchmarks.py \ --results-dir "$RESULT_ROOT/publish" \ --site-dir "$SITE_DIR" python3 -m http.server 8000 --directory "$SITE_DIR" ``` -------------------------------- ### Prepare public read fixtures Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Creates the immutable public read fixture files in the fixture directory. The commands verify the expected file sizes and counts. ```bash FIXTURE_DIR="${MOUNT_DIR}/.blobfuse-benchmark-fixtures/v4" mkdir -p "$FIXTURE_DIR" fio --directory="$FIXTURE_DIR" \ perf_testing/config/benchmark/setup/public_single_read.fio fio --directory="$FIXTURE_DIR" \ perf_testing/config/benchmark/setup/public_multi_read.fio test "$(stat -c %s "$FIXTURE_DIR/public-single-read.data")" -eq $((320 * 1024 * 1024 * 1024)) test "$(find "$FIXTURE_DIR" -maxdepth 1 -type f -name 'public-multi-read.*' | wc -l)" -eq 4 test -z "$(find "$FIXTURE_DIR" -maxdepth 1 -type f -name 'public-multi-read.*' \ ! -size $((80 * 1024 * 1024 * 1024))c -print -quit)" ``` -------------------------------- ### Verify host prerequisites Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Checks CPU count, architecture, VM size, disk space, FUSE device, and sudo access before running benchmarks. The X86 profile requires 96 online CPUs and the ARM profile requires 96 online CPUs with a different SKU. ```bash nproc lscpu | grep -E 'Architecture|CPU\(s\)|Model name|NUMA' curl -fsS -H Metadata:true \ \t'http://169.254.169.254/metadata/instance/compute?api-version=2021-02-01' | \ \tjq '{vmSize, location}' df -h test -c /dev/fuse sudo -v sudo -n true ``` -------------------------------- ### Build with health monitor Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Build the health monitor binary along with the main blobfuse2 binary. ```bash ./build.sh health ``` -------------------------------- ### Run mount.sh script Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Configuring-and-Running Runs the sample mount script to simplify mounting. The script is available at https://github.com/Azure/azure-storage-fuse/blob/master/mount.sh. ```bash ./mount.sh ``` -------------------------------- ### Build blobfuse from source Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Installation Run the build script located in the root folder of the repository. This builds the Azure Storage C++ Light library along with Blobfuse. ```bash ./build.sh ``` -------------------------------- ### Help flag for unmount all Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_unmount_all.md Displays help for the 'all' subcommand. ```bash -h, --help help for all ``` -------------------------------- ### blobfuse2 mount command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount.md Shows the basic command syntax for mounting an Azure container as a filesystem. ```bash blobfuse2 mount [path] [flags] ``` -------------------------------- ### Unmount, clear cache, remount, and run public reads Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Unmounts Blobfuse, clears kernel and local cache, remounts, and runs the public read FIO jobs against the prepared fixtures. ```bash ./blobfuse2 unmount "$MOUNT_DIR" sudo -n sh -c 'sync; echo 3 > /proc/sys/vm/drop_caches' find "${CACHE_DIR:?}" -mindepth 1 -maxdepth 1 -exec rm -rf -- {} + ./blobfuse2 mount "$MOUNT_DIR" --config-file="$CONFIG" fio --directory="$FIXTURE_DIR" \ perf_testing/config/benchmark/public/seq_read_single.fio fio --directory="$FIXTURE_DIR" \ perf_testing/config/benchmark/public/seq_read_multi.fio ``` -------------------------------- ### Run publishable public suite Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Runs the publishable five-trial public suite by omitting the --trials flag. ```bash python3 perf_testing/scripts/run_benchmark.py \ --binary ./blobfuse2 --config "$CONFIG" --suite public \ --mount-dir "$MOUNT_DIR" --cache-dir "$CACHE_DIR" \ --output-dir "$RESULT_ROOT/publish/public" \ --run-id "$RUN_ID" --label manual --commit "$COMMIT" --ref "$REF" \ --architecture X86 --account-type "$ACCOUNT_TYPE" --cache-mode block_cache ``` -------------------------------- ### Generate file-cache config and run benchmark Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Sets up a scratch directory, generates a file-cache YAML config with blobfuse2 gen-test-config, verifies direct-io is disabled, then runs the regression benchmark suite. The benchmark mounts Blobfuse, uses the file cache, and writes results to the specified output directory. ```bash FILE_CACHE_DIR="${SCRATCH_ROOT}/file-cache" FILE_CONFIG="${SCRATCH_ROOT}/file-cache.yaml" mkdir -p "$FILE_CACHE_DIR" ./blobfuse2 gen-test-config \ --config-file=azure_file_benchmark.yaml \ --container-name="$BENCH_CONTAINER" \ --temp-path="$FILE_CACHE_DIR" \ --output-file="$FILE_CONFIG" ! grep -q 'direct-io:' "$FILE_CONFIG" python3 perf_testing/scripts/run_benchmark.py \ --binary ./blobfuse2 --config "$FILE_CONFIG" --suite regression \ --mount-dir "$MOUNT_DIR" --cache-dir "$FILE_CACHE_DIR" \ --output-dir "$RESULT_ROOT/publish/regression-file" \ --run-id "$RUN_ID" --label manual --commit "$COMMIT" --ref "$REF" \ --architecture X86 --account-type "$ACCOUNT_TYPE" --cache-mode file_cache ``` -------------------------------- ### Set credentials and environment variables Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Prompts for storage account, key, and container without exposing the key in shell history. Exports environment variables and sets up directories for the benchmark run. ```bash read -r -p 'Storage account: ' AZURE_STORAGE_ACCOUNT read -r -s -p 'Storage key: ' AZURE_STORAGE_ACCESS_KEY; echo read -r -p 'Dedicated benchmark container: ' BENCH_CONTAINER export AZURE_STORAGE_ACCOUNT AZURE_STORAGE_ACCESS_KEY BENCH_CONTAINER ACCOUNT_TYPE=premium # or standard RUN_ID="manual-$(date -u +%Y%m%dT%H%M%SZ)" COMMIT="$(git rev-parse HEAD)" REF="$(git symbolic-ref --short -q HEAD || git rev-parse --short HEAD)" SCRATCH_ROOT=/mnt/localssd/blobfuse-benchmark # required dedicated blobfuse-* path MOUNT_DIR="/mnt/blobfuse-benchmark-${RUN_ID}" CACHE_DIR="${SCRATCH_ROOT}/cache" RESULT_ROOT="${SCRATCH_ROOT}/results/${RUN_ID}" CONFIG="${SCRATCH_ROOT}/block-cache.yaml" sudo mkdir -p "$SCRATCH_ROOT" sudo chown "$(id -u):$(id -g)" "$SCRATCH_ROOT" mkdir -p "$CACHE_DIR" "$RESULT_ROOT" ``` -------------------------------- ### blobfuse2 mount list command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount_list.md Shows the command syntax for listing all blobfuse2 mountpoints. The [flags] placeholder indicates that optional flags can be appended. ```bash blobfuse2 mount list [flags] ``` -------------------------------- ### View and configure updatedb.conf Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Troubleshoot-FAQ View the updatedb.conf file to configure mlocate to avoid scanning blobfuse mount directories. Add the mount path to PRUNEPATHS or add 'blobfuse' and 'fuse' to PRUNEFS to prevent high storage account list usage. ```bash cat /etc/updatedb.conf ``` ```text PRUNE_BIND_MOUNTS="yes" PRUNENAMES=".git .bzr .hg .svn" PRUNEPATHS="/tmp /var/spool /media /var/lib/os-prober /var/lib/ceph /home/.ecryptfs /var/lib/schroot" PRUNEFS="NFS nfs nfs4 rpc_pipefs afs binfmt_misc proc smbfs autofs iso9660 ncpfs coda devpts ftpfs devfs devtmpfs fuse.mfs shfs sysfs cifs lustre tmpfs usbfs udf fuse.glusterfs fuse.sshfs curlftpfs ceph fuse.ceph fuse.rozofs ecryptfs fusesmb" ``` -------------------------------- ### Size Based Filter Example Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Blob-Filter Restricts blobs by size in bytes. Supported operations are '<=', '>=', '!=', '<', '>', and '='. ```plaintext filter=size > 1000 ``` -------------------------------- ### Mount with v1 config using blobfuse2 mountv1 Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Mounts a blobfuse2 filesystem using a blobfuse v1 configuration file. Pass the same CLI parameters as you would to blobfuse. Optionally specify an output file for the generated blobfuse2 config. ```bash blobfuse2 mountv1 --config-file= --output-file= ``` -------------------------------- ### Run Blobfuse2 container instance Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Docker-Container Runs the Blobfuse2 container with required capabilities and environment variables for Azure Storage credentials. ```bash docker run -it --rm --cap-add=SYS_ADMIN --device=/dev/fuse --security-opt apparmor:unconfined -e AZURE_STORAGE_ACCOUNT -e AZURE_STORAGE_ACCESS_KEY -e AZURE_STORAGE_ACCOUNT_CONTAINER blobfuse2containers.azurecr.io/azure-blobfuse2.2.0.2 ``` -------------------------------- ### List all blobfuse2 mountpoints Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount_list.md Lists all blobfuse2 mountpoints. This is the basic usage of the command. ```bash blobfuse2 mount list ``` -------------------------------- ### Load fish completions for blobfuse2 Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_fish.md Load completions in the current fish session by piping the generated script to source. To persist completions for every new session, redirect the output to the fish completions directory; a new shell is required for the change to take effect. ```fish blobfuse2 completion fish | source ``` ```fish blobfuse2 completion fish > ~/.config/fish/completions/blobfuse2.fish ``` -------------------------------- ### Open Windows Explorer from WSL Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-WSL Run this command in the WSL prompt to open the Windows Explorer at the current directory. ```bash $ explorer.exe . ``` -------------------------------- ### Help flag for blobfuse2 mount list Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount_list.md Displays the help message for the 'blobfuse2 mount list' command. ```bash -h, --help help for list ``` -------------------------------- ### blobfuse2 mount options Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount.md Lists all available flags for the mount command, including cache timeouts, logging, and security options. ```bash --allow-other Allow other users to access this mount point. --attr-cache-timeout uint32 attribute cache timeout (default 120) --attr-timeout uint32 The attribute timeout in seconds --block-size-mb uint Size (in MB) of a block to be downloaded during streaming. --cache-size-mb uint32 max size in MB that file-cache can occupy on local disk for caching --config-file string Configures the path for the file where the account credentials are provided. Default is config.yaml in current directory. --container-name string Configures the name of the container to be mounted --disable-compression Disable transport layer compression. --disable-kernel-cache Disable the kernel cache while retaining Blobfuse2 caches. Required when blobs can be modified outside Blobfuse2; use --attr-cache-timeout to configure attribute freshness. --disable-writeback-cache Disallow libfuse to buffer write requests if you must strictly open files in O_WRONLY or O_APPEND mode. --entry-timeout uint32 The entry timeout in seconds. --file-cache-timeout uint32 file cache timeout (default 120) --foreground Mount the system in foreground mode. Default value false. -h, --help help for mount --high-disk-threshold uint32 percentage of cache utilization which kicks in early eviction (default 90) --ignore-open-flags Ignore unsupported open flags (APPEND, WRONLY) by blobfuse when writeback caching is enabled. (default true) --log-file-path string Configures the path for log files. Default is $HOME/.blobfuse2/blobfuse2.log (default "$HOME/.blobfuse2/blobfuse2.log") --log-level string Enables logs written to syslog. Set to LOG_WARNING by default. Allowed values are LOG_OFF|LOG_CRIT|LOG_ERR|LOG_WARNING|LOG_INFO|LOG_DEBUG (default "LOG_WARNING") --log-type string Type of logger to be used by the system. Set to syslog by default. Allowed values are silent|syslog|base. (default "syslog") --low-disk-threshold uint32 percentage of cache utilization which stops early eviction started by high-disk-threshold (default 80) --negative-timeout uint32 The negative entry timeout in seconds. --no-symlinks whether or not symlinks should be supported --passphrase string Key to decrypt config file. Can also be specified by env-variable BLOBFUSE2_SECURE_CONFIG_PASSPHRASE. Key length shall be 16 (AES-128), 24 (AES-192), or 32 (AES-256) bytes in length. --read-only Mount the system in read only mode. Default value false. --secure-config Encrypt auto generated config file for each container --subdirectory string Mount only this sub-directory from given container. --sync-to-flush Sync call on file will force a upload of the file. --tmp-path string configures the tmp location for the cache. Configure the fastest disk (SSD or ramdisk) for best performance. --virtual-directory Support virtual directories without existence of a special marker blob. --wait-for-mount duration Let parent process wait for given timeout before exit (default 5s) ``` -------------------------------- ### File Extension Filter Example Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Blob-Filter Restricts blobs by file extension. The extension is supplied as a string without a leading dot. Supported operations are '=' and '!='. ```plaintext --filter=format=pdf ``` -------------------------------- ### Enable zsh completion in .zshrc Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_zsh.md Run this command once to enable zsh completion by adding the compinit initialization to your ~/.zshrc file. ```bash echo "autoload -U compinit; compinit" >> ~/.zshrc ``` -------------------------------- ### Restart rsyslog service Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Logging Restart the rsyslog service after copying the configuration files to redirect blobfuse logs to a separate file. This is part of the syslog redirection setup. ```bash service rsyslog restart ``` -------------------------------- ### Options for blobfuse2 completion bash Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_bash.md Options for the bash completion command: -h/--help shows help, --no-descriptions disables completion descriptions. ```bash -h, --help help for bash --no-descriptions disable completion descriptions ``` -------------------------------- ### Blob Name Filter Example Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Blob-Filter Restricts visible blobs by name using a regex pattern. The operation must be '=' or '!=' and the name must be a valid regex expression. ```plaintext filter=name=^mine[0-1]\d{3}.* ``` -------------------------------- ### Last Modified Date Filter Example Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Blob-Filter Restricts blobs by last modified time. The date must be in RFC1123 format, e.g., 'Mon, 24 Jan 1982 13:00:00 UTC'. Supported operations are '<=', '>=', '<', '>', and '='. ```plaintext filter=modtime>Mon, 24 Jan 1982 13:00:00 UTC ``` -------------------------------- ### Mount with preload using blobfuse2 Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2‐Preload Enables preload with file-cache mode. The mount path is /mnt/blobfuse_mnt and the cache path is /home/temp_path. Preloading makes the mount read-only and prevents file eviction. ```bash blobfuse2 mount --preload /mnt/blobfuse_mnt --tmp-path=/home/temp_path ``` -------------------------------- ### Help flag for blobfuse2 secure encrypt Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_secure_encrypt.md Displays the help option for the encrypt command. ```bash -h, --help help for encrypt ``` -------------------------------- ### Verify site migration with curl and git Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Verifies the migrated GitHub Pages site and benchmark data after cutover. Checks that the root and /developer/ URLs return success, counts runs in both history files, and lists the latest release directory from the benchmarks branch. ```bash curl -fsS https://azure.github.io/azure-storage-fuse/ >/dev/null curl -fsS https://azure.github.io/azure-storage-fuse/developer/ >/dev/null curl -fsS https://azure.github.io/azure-storage-fuse/data/public/history.json | jq '.runs | length' curl -fsS https://azure.github.io/azure-storage-fuse/data/developer/history.json | jq '.runs | length' git fetch origin benchmarks git ls-tree --name-only origin/benchmarks:release/latest ``` -------------------------------- ### blobfuse2 completion fish options Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_fish.md Options specific to the fish completion command: -h/--help shows help, --no-descriptions disables completion descriptions. ```bash -h, --help help for fish --no-descriptions disable completion descriptions ``` -------------------------------- ### Enable libfuse logging via config Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Logging Enable libfuse verbose logging via config file. Alternatively, use the '-d' option in the mount command. ```yaml libfuse.fuse-trace: true ``` -------------------------------- ### blobfuse2 mount all command Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount_all.md Mounts all Azure blob containers for a given account as a filesystem. The [path] argument specifies the mount point, and flags can be used to configure the mount. ```bash blobfuse2 mount all [path] [flags] ``` -------------------------------- ### Mount blobfuse with container name (Option 2) Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Configuring-and-Running Mounts a container using --container-name. The container must exist prior to mounting. Requires absolute paths for mountpoint and tmp-path. ```bash blobfuse /path/to/desired/mountpoint --tmp-path=/mnt/blobfusetmp -o attr_timeout=240 -o entry_timeout=240 -o negative_timeout=120 --container-name=mycontainer --log-level=LOG_DEBUG --file-cache-timeout-in-seconds=120 ``` -------------------------------- ### Build error: lf.initFuse undefined Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Error encountered when building from source, indicating missing fuse dependencies. ```text lf.initFuse undefined (type *Libfuse has no field or method initFuse) lf.destroyFuse undefined (type *Libfuse has no field or method destroyFuse) ``` -------------------------------- ### blobfuse2 completion powershell command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_powershell.md Shows the usage syntax for the blobfuse2 completion powershell command. The [flags] placeholder indicates optional flags such as -h, --help, and --no-descriptions. ```bash blobfuse2 completion powershell [flags] ``` -------------------------------- ### Persist mount using mount.sh in /etc/fstab Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Add this line to /etc/fstab to persist the mount using mount.sh. Replace the placeholders with actual paths. ```text //mount.sh fuse3 defaults,_netdev 0 0 ``` -------------------------------- ### Configure Microsoft repository for SUSE / SLES Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Configure the Microsoft product repository for SUSE / SLES 15. ```bash sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpm sudo zypper refresh ``` -------------------------------- ### Create blobfuse cache directory Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Configuring-and-Running Creates the /mnt/blobfusetmp directory and changes its owner to the user that will mount blobfuse. blobfuse needs write access to this directory. ```bash sudo mkdir /mnt/blobfusetmp sudo chown /mnt/blobfusetmp ``` -------------------------------- ### Configure Microsoft repository for Mariner Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Configure the Microsoft product repository for Mariner 2.0. ```bash sudo tdnf install -y https://packages.microsoft.com/config/mariner/2.0/packages-microsoft-prod.rpm sudo tdnf repolist --refresh ``` -------------------------------- ### List and validate container image Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Docker-Container Lists Docker images to verify the image was built or downloaded. ```bash docker images ls ``` -------------------------------- ### Run public smoke test Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Runs a one-trial public smoke test. Fixture creation is automatic; the first run uploads 640 GiB of persistent read fixtures. ```bash python3 perf_testing/scripts/run_benchmark.py \ --binary ./blobfuse2 --config "$CONFIG" --suite public \ --mount-dir "$MOUNT_DIR" --cache-dir "$CACHE_DIR" \ --output-dir "$RESULT_ROOT/smoke-public" \ --run-id "$RUN_ID" --label manual --commit "$COMMIT" --ref "$REF" \ --architecture X86 --account-type "$ACCOUNT_TYPE" --cache-mode block_cache \ --trials 1 ``` -------------------------------- ### Mount blobfuse2 with config file Source: https://github.com/azure/azure-storage-fuse/blob/main/MIGRATION.md Mounts a blobfuse2 filesystem with a blobfuse2 configuration file. Additional CLI parameters can be passed and will override environment variables and config file settings. ```bash blobfuse2 mount --config-file= ``` -------------------------------- ### Inherited options for blobfuse2 mount list Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_mount_list.md Lists all options inherited from parent commands for blobfuse2 mount list. These flags configure mount behavior, caching, logging, and security. Defaults and allowed values are shown for many options. ```bash --allow-other Allow other users to access this mount point. --attr-cache-timeout uint32 attribute cache timeout (default 120) --attr-timeout uint32 The attribute timeout in seconds --block-size-mb uint Size (in MB) of a block to be downloaded during streaming. --cache-size-mb uint32 max size in MB that file-cache can occupy on local disk for caching --config-file string Configures the path for the file where the account credentials are provided. Default is config.yaml in current directory. --container-name string Configures the name of the container to be mounted --disable-compression Disable transport layer compression. --disable-kernel-cache Disable the kernel cache while retaining Blobfuse2 caches. Required when blobs can be modified outside Blobfuse2; use --attr-cache-timeout to configure attribute freshness. --disable-version-check To disable version check that is performed automatically --disable-writeback-cache Disallow libfuse to buffer write requests if you must strictly open files in O_WRONLY or O_APPEND mode. --entry-timeout uint32 The entry timeout in seconds. --file-cache-timeout uint32 file cache timeout (default 120) --foreground Mount the system in foreground mode. Default value false. --high-disk-threshold uint32 percentage of cache utilization which kicks in early eviction (default 90) --ignore-open-flags Ignore unsupported open flags (APPEND, WRONLY) by blobfuse when writeback caching is enabled. (default true) --log-file-path string Configures the path for log files. Default is $HOME/.blobfuse2/blobfuse2.log (default "$HOME/.blobfuse2/blobfuse2.log") --log-level string Enables logs written to syslog. Set to LOG_WARNING by default. Allowed values are LOG_OFF|LOG_CRIT|LOG_ERR|LOG_WARNING|LOG_INFO|LOG_DEBUG (default "LOG_WARNING") --log-type string Type of logger to be used by the system. Set to syslog by default. Allowed values are silent|syslog|base. (default "syslog") --low-disk-threshold uint32 percentage of cache utilization which stops early eviction started by high-disk-threshold (default 80) --negative-timeout uint32 The negative entry timeout in seconds. --no-symlinks whether or not symlinks should be supported --passphrase string Key to decrypt config file. Can also be specified by env-variable BLOBFUSE2_SECURE_CONFIG_PASSPHRASE. Key length shall be 16 (AES-128), 24 (AES-192), or 32 (AES-256) bytes in length. --read-only Mount the system in read only mode. Default value false. --secure-config Encrypt auto generated config file for each container --subdirectory string Mount only this sub-directory from given container. --sync-to-flush Sync call on file will force a upload of the file. --tmp-path string configures the tmp location for the cache. Configure the fastest disk (SSD or ramdisk) for best performance. --virtual-directory Support virtual directories without existence of a special marker blob. --wait-for-mount duration Let parent process wait for given timeout before exit (default 5s) ``` -------------------------------- ### blobfuse2 unmount command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_unmount.md Shows the basic usage of the blobfuse2 unmount command with a mount path and optional flags. ```bash blobfuse2 unmount [flags] ``` -------------------------------- ### blobfuse2 completion powershell options Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_powershell.md Lists the options available for the blobfuse2 completion powershell command. Use --no-descriptions to disable completion descriptions. ```bash -h, --help help for powershell --no-descriptions disable completion descriptions ``` -------------------------------- ### FIO benchmark commands for Blobfuse2 performance tests Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Performance-Improvements FIO commands used for performance testing. The first command performs a mixed read/write workload (rw=rw), while the second performs random read/write (readwrite=randrw). Both use 4k block size, iodepth 64, and a 4G test file. ```bash fio --randrepeat=1 --ioengine=libaio --gtod_reduce=1 --name=test--bs=4k --iodepth=64 --rw=rw --rwmixread=75 --size=4G --filename=testfile4G ``` ```bash fio --randrepeat=1 --ioengine=libaio --gtod_reduce=1 --name=test--bs=4k --iodepth=64 --readwrite=randrw --rwmixread=75 --size=4G --filename=testfile4G ``` -------------------------------- ### Configure Microsoft repository for RedHat Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Installation Configure the Microsoft product repository for Red Hat Enterprise Linux 8. Change the URL to .../rhel/7/... to point to a Red Hat Enterprise Linux 7 distribution. ```bash sudo rpm -Uvh https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm sudo dnf update ``` -------------------------------- ### Mount BlobFuse using a configuration file Source: https://github.com/azure/azure-storage-fuse/wiki/Mount-Blobfuse Mounts a container using a YAML configuration file that contains BlobFuse and Azure storage settings. ```bash # blobfuse2 mount –-config-file= ``` -------------------------------- ### Mount blobfuse with config file (Option 1) Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse-Configuring-and-Running Mounts a container using a configuration file. Requires absolute paths for mountpoint and tmp-path. Recommended FUSE timeouts are attr_timeout=240, entry_timeout=240, negative_timeout=120. ```bash blobfuse /path/to/desired/mountpoint --tmp-path=/mnt/blobfusetmp -o attr_timeout=240 -o entry_timeout=240 -o negative_timeout=120 --config-file=../connection.cfg --log-level=LOG_DEBUG --file-cache-timeout-in-seconds=120 ``` -------------------------------- ### blobfuse2 completion zsh command syntax Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_zsh.md Shows the command syntax for generating the zsh completion script. The [flags] placeholder indicates optional flags. ```bash blobfuse2 completion zsh [flags] ``` -------------------------------- ### Print primary medians and MAD values Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Uses jq to extract each benchmark's name, primary metric, median, and MAD from the summary.json file, then formats the output as tab-separated columns. ```bash jq -r '.benchmarks[] | . as $b | [ $b.name, $b.primary_metric, ($b.metrics[$b.primary_metric].median | tostring), ($b.metrics[$b.primary_metric].mad | tostring) ] | @tsv' "$RESULT_ROOT/publish/public/summary.json" | column -t -s $'\t' ``` -------------------------------- ### Docker run command with SYS_ADMIN privilege Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Limitations Command to spawn a Docker container with the required SYS_ADMIN capability and fuse device access for Blobfuse2 mounting. Without these privileges, mount will fail. ```bash docker run -it --rm --cap-add=SYS_ADMIN --device=/dev/fuse --security-opt apparmor:unconfined ``` -------------------------------- ### Retrieve and extract a successful X86 bundle Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Downloads a benchmark ZIP from the results container using the blob_results.sh script and extracts it into a local directory. Requires PERF_RESULTS_ACCOUNT and PERF_RESULTS_KEY environment variables. ```bash RUN_ID= ATTEMPT= SHORT_SHA=<12-character-workflow-commit> ARCH=X86 STATUS=success SUITE=public BUNDLE="blobfuse2-perf-${ARCH}-suite-${SUITE}-status-${STATUS}-run-${RUN_ID}-attempt-${ATTEMPT}-sha-${SHORT_SHA}.zip" REMOTE="benchmark-runs/run-${RUN_ID}-attempt-${ATTEMPT}/${ARCH}/${BUNDLE}" mkdir -p benchmark-artifacts/perf-${ARCH} ./perf_testing/scripts/blob_results.sh download ./blobfuse2 "/tmp/${BUNDLE}" "$REMOTE" unzip -q "/tmp/${BUNDLE}" -d "benchmark-artifacts/perf-${ARCH}" ``` -------------------------------- ### Run developer regression suite with block cache Source: https://github.com/azure/azure-storage-fuse/blob/main/perf_testing/README.md Runs the developer regression suite using block cache mode. ```bash python3 perf_testing/scripts/run_benchmark.py \ --binary ./blobfuse2 --config "$CONFIG" --suite regression \ --mount-dir "$MOUNT_DIR" --cache-dir "$CACHE_DIR" \ --output-dir "$RESULT_ROOT/publish/regression-block" \ --run-id "$RUN_ID" --label manual --commit "$COMMIT" --ref "$REF" \ --architecture X86 --account-type "$ACCOUNT_TYPE" --cache-mode block_cache ``` -------------------------------- ### Persist zsh completions on Linux Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_completion_zsh.md On Linux, run this command once to generate the completion script into the first directory in the fpath array, making it available for every new session. ```bash blobfuse2 completion zsh > "${fpath[1]}/_blobfuse2" ``` -------------------------------- ### List running container instances Source: https://github.com/azure/azure-storage-fuse/wiki/Blobfuse2-Docker-Container Lists running Docker containers to retrieve the instance ID for attaching. ```bash dokcer ps ``` -------------------------------- ### blobfuse2 version options Source: https://github.com/azure/azure-storage-fuse/blob/main/doc/blobfuse2_version.md Options for the blobfuse2 version command: --check verifies if a newer version is available, and -h or --help shows help for the version command. ```bash --check To check whether latest version exists or not -h, --help help for version ```