Getting started with Cold Archive (Alpha) (EN)

This guide shows you how to manage your data with Cold Archive

Last updated 15th March 2022

Objective

Cold Archive is a service for long-term data storage. When archived, every object of a bucket is stored on physical tapes. Restoration can take some time as it needs to be read on tapes.

This guide explains how to set up storage on tapes with Cold Archive.

During the the Alpha period, tapes are not used.

Requirements

Instructions

In this tutorial, awscli aliases are used to simplify the commands.

mkdir -p ~/.aws/cli
touch ~/.aws/cli/alias

Add this content to the file:

[toplevel]

put-ovh-archive = s3api put-bucket-intelligent-tiering-configuration --id myid --intelligent-tiering-configuration '{"Id": "myid", "Status": "Enabled", "Tierings": [{"Days": 999,"AccessTier": "OVH_ARCHIVE"}]}' --bucket

put-ovh-restore = s3api put-bucket-intelligent-tiering-configuration --id myid --intelligent-tiering-configuration '{"Id": "myid", "Status": "Enabled", "Tierings": [{"Days": 999,"AccessTier": "OVH_RESTORE"}]}' --bucket

get-ovh-bucket-status = s3api get-bucket-intelligent-tiering-configuration --id myid --bucket

delete-ovh-archive = s3api delete-bucket-intelligent-tiering-configuration --id myid --bucket

Id will be necessary for further PUT, GET and DELETE operations on the intelligent-tiering configuration. Status and Days are mandatory but not used.

The plugin awscli-plugin-endpoint is not working with aliases, the parameter --endpoint-url will be required in every command.

If you have defined multiple profiles, add --profile <profile> to the command line.

Bucket archiving

After its creation, a bucket is in write-only mode.
Allowed actions are adding and listing objects.

Archive a bucket:

aws --endpoint-url https://s3.rbx.archive.cloud.ovh.net put-ovh-archive <bucket_name>

After this request, the bucket is not archived yet.
It will take some time before it is archived on the tapes.
From this command and until a restoration, the bucket cannot accept any read or write requests on objects (listing objects is still allowed).

During the Alpha period, nothing is stored on tapes.

Bucket restoring

Restore a bucket:

aws --endpoint-url https://s3.rbx.archive.cloud.ovh.net put-ovh-restore <bucket_name>

After this request, the bucket is not restored yet.
It will take some time before it is restored and for the objects to be accessible in read-only (writing objects is forbidden).

Bucket deletion

Delete an intelligent-tiering configuration and objects of a bucket:

aws --endpoint-url https://s3.rbx.archive.cloud.ovh.net delete-ovh-archive <bucket_name>

After this request, the objects of the bucket are not deleted yet.
It will take some time before objects are deleted.
Once objects are deleted, the bucket can be released:

aws s3 rb s3://<bucket_name>

Bucket status

Once an intelligent-tiering configuration has been pushed (via a put-bucket-intelligent-tiering-configuration operation) and until it is removed (via a delete-bucket-intelligent-tiering-configuration operation), the status of a bucket is readable through:

aws --endpoint-url https://s3.rbx.archive.cloud.ovh.net get-ovh-bucket-status <bucket_name> | jq '.IntelligentTieringConfiguration.Status'

List of bucket statuses

Status Description Objects permissions
None No Intelligent-Tiering configuration pushed on the bucket yet. Write-only + Listing
Locked Archive process asked from user. Waiting for the robot to deal with the request. Listing
Archiving Archiving in progress on tapes. Listing
Draining Objects stored on tapes and currently being removed from the disks. Listing
Archived Objects archived on tapes only. Listing
Restoring Restoration in progress from tapes. Listing
Restored Objects restored and accessible. Read-only + Listing
Deleting Objects deletion from tapes (and disks if restored) in progress. Listing
Flushed Bucket is empty and can safely be removed. Listing (empty bucket)

Go further

Join our community of users on https://community.ovh.com/en/.


Haben Ihnen die Anleitungen geholfen?

Bevor Sie Ihre Meinung abgeben, nehmen wir gerne Ihre Vorschläge auf, wie wir diese Dokumente verbessern können.

Woran liegt es? An den Bildern, dem Inhalt oder Aufbau der Anleitungen? Schreiben Sie es uns gerne, dann machen wir es zusammen besser.

Ihre Support-Anfragen werden in diesem Formular nicht entgegengenommen. Verwenden Sie hierfür bitte das Formular "Ein Ticket erstellen" .

Vielen Dank. Ihr Feedback wurde gesendet.

OVHcloud Community

Besuchen Sie Ihren Community-Bereich und tauschen Sie sich mit anderen Mitgliedern der OVHcloud Community aus. Hier können Sie Fragen stellen, zusätzliche Informationen finden und eigene Inhalte veröffentlichen.

Tauschen Sie sich mit der Community aus

Alle Preise verstehen sich inklusive der gesetzlichen Mehrwertsteuer.

In Übereinstimmung mit der Richtlinie 2006/112/EG in der geänderten Fassung können die Preise ab 01.01.2015 je nach Wohnsitzland des Kunden variieren
(die Preise in den Angeboten verstehen sich inklusive der gesetzlichen Mehrwertsteuer für die Bundesrepublik Deutschland).