Commvault
Integration
To integrate Storj with Commvault, you will need to create S3 credentials in Storj and add them within Commvault.
Requirements
- An active Storj account
- A bucket for use with Commvault in your Storj instance
- An active Commvault account
- Commvault MediaAgent installed and connected to CommCell server or Metallic.io
Download a free trial of Commvault or sign up for a Demo.
Trial users using Metallic.io may obtain a MediaAgent by performing a File Server installation.
Create an Account
To begin, you will need to create a Storj account.
Navigate to https://www.storj.io/signup?partner=commvault to sign up, or log in https://storj.io/login if you already have an account.
Create a Bucket
Once you have your Storj account you can create a bucket for your data to be stored in.
Navigate to Browse on the left side menu.
Click on the New Bucket button.
Assign the bucket an easily identifiable name, such as "my-bucket".
Optional: Enable Object Lock (required for immutability in many applications).
- If you enable Object Lock, you can also set a default retention period using either Governance or Compliance Mode
Optional: Enable Object Versioning (note that this will be enabled by default if Object Lock is enabled)
Click Create bucket
Generate S3 credentials
Storj has an Amazon S3 compatible API and you'll need generate S3 credentials to use it. S3 credentials consist of an access key, secret key, and endpoint.
Create S3 credentials in the Storj console:
Navigate to Access Keys on the left side menu.
Click the New Access Key button.
When the New Access dialog comes up, set specifications according to the following guidelines:
- Name: The name of the credentials (e.g. my-access)
- Type: S3 Credentials
Choose Full Access or Advanced
- In most cases, you DO NOT want to choose full access.
Provide Access encryption Information
In order to see the data uploaded to your bucket in the Storj console, you must unlock the bucket with the same encryption passphrase as the credentials.
- Use the current passphrase: this is default option
- Advanced: you may provide a different encryption phrase either your own or generate a new one.
- Enter a new passphrase: use this option, if you would like to provide your own new encryption phrase
- Generate 12-word passphrase: use this option, if you would like to generate a new encryption phrase
Select the permissions you want to allow:
- Read
- Write
- List
- Delete
Select the object lock permissions you want to allow
- PutObjectRetention
- GetObjectRetention
- BypassGovernanceRetention
- PutObjectLegalHold
- GetObjectLegalHold
- PutObjectLockConfiguration
- GetObjectLockConfiguration
Choose the buckets you want the access to include:
- All Buckets
- Select Buckets
Set an expiration
Click Create Access to finish creation of your S3 credentials
Your S3 credentials are created. Write them down and store them, or click the Download all button. You will need these credentials for the following steps.
Object Lock Permission Details
Permission Name | Description |
---|---|
PutObjectRetention | Allows you to set retention policies, protecting objects from deletion or modification until the retention period expires. |
GetObjectRetention | Allows you to view the retention settings of objects, helping ensure compliance with retention policies. |
BypassGovernanceRetention | Allows you to bypass governance-mode retention, enabling deletion of objects before the retention period ends. |
PutObjectLegalHold | Allows you to place a legal hold on objects, preventing deletion or modification regardless of retention policies. |
GetObjectLegalHold | Allows you to view the legal hold status of objects, which is useful for auditing and compliance purposes. |
PutObjectLockConfiguration | Allows you to set retention policies on the specified bucket, automatically applying them to every new object added to that bucket. |
GetObjectLockConfiguration | Allows you to view the default retention policies configured for the specified bucket. |
Connecting Commvault to Storj
Cloud Credentials Configuration
Log in to the Commvault Command Center or Metallic.io web console
From the navigation pane on the left, click Manage then Security
On the Security page, click Credential Vault, then click Add
On the resulting Add credential page configure the following fields:
- Account type : "Cloud Account"
- Vendor type : "S3 Compatible Storage"
- Credential name : Any name you choose
- Access key ID : The Access Key ID you generated in Storj
- Secret access key : The Secret Access Key you generated in Storj
- Description : Any description you choose
Click Save
Cloud Storage Configuration
From the navigation pane on the left, click Storage then Cloud
On the Cloud Storage page, in the upper right, click Add
On the resulting Add cloud storage page configure the following fields:
- Type : "S3 Compatible Storage"
- Name : Any name you choose
- MediaAgent : The MediaAgent you wish to use for this storage
- Service host : "gateway.storjshare.io"
- Credentials : Select the credentials you created in the previous section
- Bucket : The name of the bucket you created in Storj
- Use deduplication: Unselect or configure as desired
Click Save
Backup Configuration
- Storj should now be available as a storage target for your Commvault backups.