All Products
Search

This Product

    Object Storage Service:Overview of ossfs

    Document Center

    Object Storage Service:Overview of ossfs

    Last Updated:Dec 19, 2024

    ossfs allows you to mount an Object Storage Service (OSS) bucket to a local directory on the Linux operating system. This way, you can manage data in the bucket in the same manner that you manage local files.

    Introduction

    ossfs is a Filesystem in Userspace (FUSE) based file system that allows you to mount an OSS bucket to a local directory on the Linux operating system and supports the following features:

    • Supports most features described in POSIX standards, such as file and directory uploads and downloads, and user permission management.

    • Uses multipart upload and resumable upload to upload OSS objects by default.

    • Supports MD5 verification to ensure data integrity.

    Runtime environment

    ossfs is a FUSE-based file system and works only on FUSE-compatible machines. ossfs provides installer packages for the following systems. To run ossfs in other environments, you need to use the source code to build the required program.

    • Linux

      • CentOS 7.0 or later

      • Ubuntu 14.04 or later

      • Anolis7 or later

    • FUSE 2.8.4 or later

      You can run the fusermount -V command to check the version of FUSE. If the value of the fusermount version parameter in the response is 2.8.4 or later, such as 2.9.2, the version of FUSE meets the requirements.

    Limitations

    The following limits apply to ossfs when you use ossfs to mount a bucket to a local directory on the Linux operating system:

    • ossfs is not suitable for scenarios that require highly concurrent read and write operations.

      Note

      • Both read and write operations consume the disk capacity. In highly concurrent read/write scenarios, disk performance limits read and write operations.

      • Concurrent read and write requests compete for resources, which affects the bandwidth.

    • ossfs does not support hard links.

    • Archive, Cold Archive, and Deep Cold Archive buckets cannot be mounted to local file systems by using ossfs.

    • If you use ossfs to edit an uploaded object, the object is re-uploaded.

    • The performance of metadata-related operations, such as list directory, is compromised because you must remotely access the OSS server.

    • Errors may occur if you rename an object or a directory. Operation failures may cause data inconsistencies.

    • If a bucket is mounted to multiple clients and data is simultaneously written to the mount points, ossfs does not guarantee consistency.

    • Make sure that your AccessKey pair have full permissions for the target bucket or resources whose names are prefixed with specified values. Insuffcient permissions may result in the failure of mount points and other potential issues.

    What to do next

    Before you use ossfs to mount an OSS bucket to a local directory, you must install and configure ossfs and perform mount operations. For more information, see Installation and Configure ossfs and perform mount operations.

    References