How to Integrate Filecloud with Cloudian S3-Compatible Object Storage
- When changing the storage type from local to Cloudian S3-Compatible Object Storage, the files and folders that have been already stored in local storage will not be automatically moved to S3 storage.
- In this case, the administrator must manually export files and folders from local storage before changing the storage type, and then manually import them after changing the storage type.
- Only change the FileCloud storage type for new installations.
- Do not change the FileCloud storage type if FileCloud has been in use and data is already stored.
- Be careful when changing the storage path; If done improperly it could lead to data loss.
- The Cloudian S3-Compatible Object Storage should NEVER be modified outside of the FileCloud subsystem.
- Do not add, edit, or modify files directly using Cloudian tools. Doing so will destabilize your FileCloud installation.
To change the FileCloud storage path from LOCAL to Cloudian S3-Compatible Object Storage:
NOTES:
Although FileCloud does not have an explicit connector for Cloudian S3-Compatible Object Storage, the Amazon S3 connector can be used.
In this step you will need to access WWWROOT. It is typically located at:
| Windows | Linux |
|---|---|
| c:\xampp\htdocs | /var/www/html |
To enable Cloudian S3-Compatible Object Storage as the backend:
- To make sure that your server does not have any time variations, set up the time on your server to be synchronized.
Open the following file for editing:
WWWROOT/config/cloudconfig.php
Find the following line:
define("TONIDOCLOUD_STORAGE_IMPLEMENTATION", "local");Change it to:
define("TONIDOCLOUD_STORAGE_IMPLEMENTATION", "amazons3");- Save and close the file.
Find the following file:
WWWROOT/config/amazons3storageconfig-sample.php
- Rename it to:
WWWROOT/config/amazons3storageconfig.php
Nothing needs to be added or edited in amazons3storageconfig.php
To configure Cloudian S3-compatible object storage:
- Open a browser and log into the admin portal.
- Go to Settings > Storage.
- Enter the settings for your environment. See the following table for information about each setting.
- Click Save S3 Settings.
Field Description S3 Key Your Cloudian S3 authentication key. S3 Secret Your Cloudian S3 authentication secret. Use IAM role When checked, the S3 Key and S3 Secret fields disappear and the IAM role is used to connect to the S3 bucket. S3 Bucket Name Provide a bucket name. The bucket should be new (in some circumstances, a previously used bucket in FileCloud can be used).
It is important that the S3 bucket is never modified outside of the FileCloud subsystem.
The bucket name is case sensitive; make sure you are using the exact name of the bucket.
Optional: All files are stored inside this root storage folder (it is created automatically). S3 Region Optional: Provide the region string.
S3 End Point URL This is the S3 endpoint. note that for each region there is a specific endpoint URL.
Number of old versions to keep for each file When a user uploads a new version of a file, it is saved, and the latest Number of old versions to keep for each file versions are kept. When set to -1, each upload of a file overwrites the previous one, and no versions are saved.
S3 Encryption Select No encryption because Cloudian does not support managed key encryption.
- To fill in the remainder of the settings, see Setting up FileCloud Managed S3 Storage.