How to use the BlobFuse2 mountv1 command
Use the blobfuse2 mountv1 command to generate a configuration file for BlobFuse2 from a BlobFuse v1 configuration file.
Syntax
blobfuse2 mountv1 [path] --[flag-name]=[flag-value]
Arguments
[path]
Specify a file path to the directory where the storage container will be mounted. Example:
blobfuse2 mountv1 ./mount_path ...
Flags (options)
Some flags are inherited from the parent command, blobfuse2, and others only apply to the blobfuse2 mountv1 command.
Flags inherited from the BlobFuse2 command
The following flags are inherited from parent command blobfuse2):
| Flag | Short version | Value type | Default value | Description |
|---|---|---|---|---|
| disable-version-check | boolean | false | Enables or disables automatic version checking of the BlobFuse2 binaries | |
| help | -h | n/a | n/a | Help info for the blobfuse2 command and subcommands |
Flags that apply only to the BlobFuse2 mountv1 command
The following flags apply only to command blobfuse2 mountv1 command:
| Flag | Short version |
Value type |
Default value |
Description |
|---|---|---|---|---|
| background-download | boolean | false | File download to run in the background on open call | |
| basic-remount-check | boolean | false | Check for an already mounted status using /etc/mtab | |
| block-size-mb | uint | Size of a block to be downloaded during streaming (in MB) |
||
| ca-cert-file | string | Specifies the proxy pem certificate path if it's not in the default path | ||
| cache-on-list | boolean | true | Cache attributes on listing | |
| cache-poll-timeout-msec | uint | Time in milliseconds in order to poll for possible expired files awaiting cache eviction (in milliseconds) |
||
| cache-size-mb | float | File cache size (in MB) |
||
| cancel-list-on-mount-seconds | uint16 | A list call to the container is by default issued on mount (in seconds) |
||
| config-file | string | ./config.cfg | Input BlobFuse configuration file | |
| container-name | string | Required if no configuration file is specified | ||
| convert-config-only | boolean | Don't mount - only convert v1 configuration to v2 | ||
| d | -d | boolean | false | Mount with foreground and FUSE logs on |
| empty-dir-check | boolean | false | Disallows remounting using a non-empty tmp-path | |
| enable-gen1 | boolean | false | To enable Gen1 mount | |
| file-cache-timeout-in-seconds | uint32 | 120 | During this time, blobfuse will not check whether the file is up to date or not (in seconds) |
|
| high-disk-threshold | uint32 | High disk threshold (as a percentage) |
||
| http-proxy | string | HTTP Proxy address | ||
| https-proxy | string | HTTPS Proxy address | ||
| invalidate-on-sync | boolean | true | Invalidate file/dir on sync/fsync | |
| log-level | LOG_OFF LOG_CRIT LOG_ERR LOG_WARNING LOG_INFO LOG_DEBUG LOG_WARNING |
LOG_WARNING | The level of logging written to syslog. | |
| low-disk-threshold | uint32 | Low disk threshold (as a percentage) |
||
| max-blocks-per-file | int | Maximum number of blocks to be cached in memory for streaming | ||
| max-concurrency | uint16 | Option to override default number of concurrent storage connections | ||
| max-eviction | uint32 | Number of files to be evicted from cache at once | ||
| max-retry | int32 | Maximum retry count if the failure codes are retryable | ||
| max-retry-interval-in-seconds | int32 | Maximum length of time between 2 retries (in seconds) |
||
| no-symlinks | boolean | false | Whether or not symlinks should be supported | |
| o | -o | strings | FUSE options | |
| output-file | string | ./config.yaml | Output Blobfuse configuration file | |
| pre-mount-validate | boolean | true | Validate blobfuse2 is mounted | |
| required-free-space-mb | int | Required free space (in MB) |
||
| retry-delay-factor | int32 | Retry delay between two tries (in seconds) |
||
| set-content-type | boolean | false | Turns on automatic 'content-type' property based on the file extension | |
| stream-cache-mb | uint | Limit total amount of data being cached in memory to conserve memory footprint of blobfuse (in MB) |
||
| streaming | boolean | false | Enable Streaming | |
| tmp-path | string | n/a | Configures the tmp location for the cache. (Configure the fastest disk (SSD or ramdisk) for best performance). |
|
| upload-modified-only | boolean | false | Turn off unnecessary uploads to storage | |
| use-adls | boolean | false | Enables blobfuse to access Azure DataLake storage account | |
| use-attr-cache | boolean | false | Enable attribute cache | |
| use-https | boolean | false | Enables HTTPS communication with Blob storage |
Examples
Mount a blob container in an Azure Data Lake Storage account using a BlobFuse v1 configuration file:
sudo blobfuse2 mountv1 ./mount_dir --config-file=./config.cfg --use-adls=trueCreate a BlobFuse2 configuration file from a v1 configuration file in the same directory, but do not mount any containers:
sudo blobfuse2 mountv1 --config-file=./config.cfg --output-file=./config.yaml --convert-config-only=true