# Object Storage Configuration

Multiple S3 compatible Cloud and Object Storage providers are supported  :

Public cloud providers :

* Amazon AWS S3 Storage
* Google Cloud Storage
* Microsoft Azure Blob Storage
* Wasabi Hot Cloud Storage

Private Cloud Providers :

* Cloudian HyperStore
* Dell EMC ECS
* OpenStack Swift
* Quantum ActiveScale
* Scality Ring
*

Generic

* Generic S3

{% hint style="warning" %}
If you don't find your S3 storage in this list, there is also a "Generic" S3 connector which is available.
{% endhint %}

## S3 Storage

### Configuration

Navigate to 

> System -> Hardware -> Storage -> Cloud 

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FcMFsmOvCNcV3cSOS6HaM%2Fimage.png?alt=media&#x26;token=c424956c-f776-4c52-9306-2f1924d47f29" alt=""><figcaption></figcaption></figure>

* [ ] To connect to a new S3 Storage, click the button&#x20;

<div align="center"><figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FN1Kt4aG47e0yu8kCNXur%2Fimage.png?alt=media&#x26;token=e646fa36-437c-41c9-a237-08a6760ac25f" alt="" width="33"><figcaption></figcaption></figure></div>

* [ ] Fill the following parameters to configure the storage :&#x20;

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2Fk4GbDJCqL8yloRjFgRoQ%2Fimage.png?alt=media&#x26;token=657508e1-14e3-48cc-b083-20feada18197" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="260"></th><th></th></tr></thead><tbody><tr><td><strong>Parameters</strong></td><td><strong>Definition</strong></td></tr><tr><td>Name</td><td>Complete the name of the storage</td></tr><tr><td>Provider</td><td>Choose a provider</td></tr><tr><td>Region</td><td>Complete the region*</td></tr><tr><td>URL</td><td>Complete the url</td></tr><tr><td>Backend</td><td>Select the backend : Rclone or S3FS</td></tr><tr><td>Mount Options</td><td></td></tr><tr><td>Access Key ID</td><td>Complete*</td></tr><tr><td>Secret access key</td><td>Complete*</td></tr></tbody></table>

{% hint style="info" %}
\*Information required, if your provider doesn't enforce the usage of region, define a value representative for you.
{% endhint %}

The name of a cloud storage is unique.  You can't have several cloud storage with the same Name.

Once, the connector is defined, the buckets will automatically appear.

## Swift Storage

#### OpenStack Swift Configuration

> System -> Hardware -> Storages -> Cloud

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FDHiWhub59uPYnM4D5WlU%2Fimage.png?alt=media&#x26;token=741cb9fc-e615-416f-a051-43798777c401" alt=""><figcaption></figcaption></figure>

* [ ] To create a new storage "OpenStack Swift" click on the button&#x20;

<div align="left"><figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2FN1Kt4aG47e0yu8kCNXur%2Fimage.png?alt=media&#x26;token=e646fa36-437c-41c9-a237-08a6760ac25f" alt="" width="33"><figcaption></figcaption></figure></div>

* [ ] and complete the form

&#x20;

<figure><img src="https://1946775891-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgzbGsZqZH8Ro8zxRYgwn%2Fuploads%2F0JNEDYQ1g4MDqy52jEho%2Fimage.png?alt=media&#x26;token=44a8c129-8341-4bcb-aa33-8b3a4451585d" alt="" width="257"><figcaption></figcaption></figure>

\-         **Name:** complete the name you define in the toml (ansible playbook)

{% hint style="warning" %}
Mandatory to have the same name as the name writing in the toml (parent\_name)
{% endhint %}

\-         **Provider:** choose OpenStack Swift <mark style="background-color:red;">(</mark><mark style="background-color:red;">**+++ Mandatory**</mark><mark style="background-color:red;">)</mark>

### How to Visualize your buckets ?

Go to&#x20;

> Storage Services -> Cloud

&#x20;At this stage, This panel display the complete overview of all Cloud Bucket.

You directly see if the bucket is Online or Offline.

### S3 As a Primary Storage

Primary Storage need to be mount before launching a task.&#x20;

To mount the storage, click on the button to connect the storage.

If you change the Backend for a primary storage bucket, it's required to reconnect the Storage (in the Storage Services cloud), for doing this operation, alt click on the button:

It's required to reconnect the Storage (in the Storage Services cloud), for doing this operation, alt click on the button:

![](https://www.nodeum.io/hs-fs/hubfs/image-png-Feb-15-2022-01-58-40-22-PM.png?width=70\&name=image-png-Feb-15-2022-01-58-40-22-PM.png)

### S3 As a Secondary Storage

Secondary storage are automatically mounted by the workflow manager.

If you change the Backend for a Secondary storage bucket, it's required to restart the service Core Manager (in settings menu).