For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/it/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/it/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/it/guides/storage-and-backup/object-storage/pcs-use-s3ql-to-mount-object-storage-containers.md.

Object Storage Swift - Use S3QL to mount object storage containers

Vedi come Markdown

Objective

S3QL is a remote file system that can be configured locally to store data using cloud storage solutions like OVH Object Storage. It has several features, such as data compression, encryption, and container snapshots, which makes this solution particularly suitable for creating backups.

You can find more information directly on their website.

This guide shows you how to set up an object container as file system.

Prerequisites

Instructions

Info

Using an object container as a file system can impact the performance of your operations. S3ql version 3.3 or above is required.

Create your file system

  • Create a file containing the login information:
admin@serveur1:~$ sudo vim s3qlcredentials.txt

[swift]
backend-login: OS_PROJECT_ID:OS_USERNAME
backend-password: OS_PASSWORD
storage-url: swiftks://auth.cloud.ovh.net/REGION_NAME:CT_NAME
fs-passphrase: PASSPHRASE

OS_PROJECT_ID, OS_USERNAME and OS_PASSWORD parameters can be found in your OpenRC file. You can follow this guide below in order to retrieve it: Access and Security in Horizon

The REGION_NAME and CT_NAME arguments can be adapted according the name and location of your object container.

  • Change authentication file access permissions:
admin@serveur1:~$ sudo chmod 600 s3qlcredentials.txt
  • Object container formating:
admin@serveur1:~$ sudo mkfs.s3ql --backend-options domain=default --authfile s3qlcredentials.txt swiftks://auth.cloud.ovh.net/REGION_NAME:CT_NAME

You then have to add the passphrase to your authentication file. If you do not want to configure it, you have to delete the "fs-passphrase: PASSPHRASE" line from your file.

Configure your file system

  • Create the mounting point
admin@serveur1:~$ sudo mkdir /mnt/container
  • Mount the object container
admin@serveur1:~$ sudo mount.s3ql --backend-options domain=default --authfile s3qlcredentials.txt swiftks://auth.cloud.ovh.net/REGION_NAME:CT_NAME /mnt/container/
  • Check mounting:
admin@serveur1:~$ sudo df -h

Filesystem Size Used Avail Use% Mounted on
/dev/vda1 9.8G 927M 8.5G 10% /
udev 10M 0 10M 0% /dev
tmpfs 393M 5.2M 388M 2% /run
tmpfs 982M 0 982M 0% /dev/shm
tmpfs 5.0M 0 5.0M 0% /run/lock
tmpfs 982M 0 982M 0% /sys/fs/cgroup
swiftks://auth.cloud.ovh.net/REGION_NAME:CT_NAME 1.0T 0 1.0T 0% /mnt/container

You cannot use S3QL in offline mode, you should not configure persistance via the /etc/fstab file but by using a script which will run when your server starts up.

Go further

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

Join our community of users.

Questa pagina ti è stata utile?