Breadcrumbs

How to Integrate Filecloud with Backblaze (B2) Cloud Storage

Administrators can change the FileCloud storage type after FileCloud has been installed but before any data has been stored. 

  • When changing the storage type from local to B2 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 Backblaze B2 storage should NEVER be modified outside of the FileCloud subsystem.

  • Do not add, edit, or modify files directly using Backblaze tools. Doing so will destabilize your FileCloud installation.

To change the FileCloud storage path from LOCAL to Backblaze(B2) object storage:

1. Enable B2 object storage

NOTES:

Although FileCloud does not have an explicit connector for B2 object-based 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 B2 object storage as the backend:

  1.  To make sure that your server does not have any time variations, set up the time on your server to be synchronized.

    1. Configure an authoritative time server in Windows Server

    2. Synchronize Time with NTP in Linux

  2. Open the following file for editing:

    WWWROOT/config/cloudconfig.php
    
  3. Find the following line:

    define("TONIDOCLOUD_STORAGE_IMPLEMENTATION", "local");
    
  4. Change it to:

    define("TONIDOCLOUD_STORAGE_IMPLEMENTATION", "amazons3");
    
  5. Save and close the file.

  6. Find the following file:

    WWWROOT/config/amazons3storageconfig-sample.php
    
  7. Rename it to:

    WWWROOT/config/amazons3storageconfig.php
    

https://fileclouddocs.atlassian.net/wiki/s/1623602073/6452/05f502871a457750e4d6a5e1f585bce5603b62b2/_/images/icons/emoticons/lightbulb_on.png  Nothing needs to be added or edited in amazons3storageconfig.php



2. Configure Credentials

To configure Backblaze (B2) Credentials

  1. In the FileCloud admin portal's left navigation bar, scroll down and click Settings. Then, on the Settings navigation page, click Storage  StorageIcon.png .
    The Managed Storage settings page opens by default.

  2. Enter the settings for your environment. See the table below for information about each setting.

    BackBlazeS3.png
  3. Click Save S3 Settings.

  4. Enter values for Number of old versions to keep for each file, and, if you are using encryption, click Manage for S3 Encryption to set the encryption type.

  5. Click Save.

Field

Description

S3 Key

Your B2 authentication key.

S3 Secret

Your B2 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.

S3 Storage Folder

Optional: All files are stored inside this root storage folder (it is created automatically).

S3 Region

Optional: Provide the region string.

image2022-4-25_10-53-29.png

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

By default  encryption type is: Backblaze B2 key (SSE-B2), an encryption key that Backblaze creates, manages and uses for you.

For this integration, only Google-managed key encryption is supported. No additional actions are need in FileCloud.

  1. To fill in the remainder of the settings, see Setting up FileCloud Managed S3 Storage.

To enable HMAC access key for a bucket, go to Account > App Keys, and select the Add a New Application Key button under "Your Application Keys".

*Selecting "All" under "Allow access to Bucket(s): (optional) is a requirement for this integration. Otherwise it will throw out a missing capability error.

image2022-4-25_10-57-23.png
image2022-4-25_11-0-38.png


Troubleshooting:

How to Correct Issues with Image Previews

If you are having problems previewing images, add a line to the .htaccess file.

To add a line to the .htaccess file:

  1. Open the following file:

    1. Windows:  C:\xampp\htdocs\.htaccess

    2. Linux: /var/www/html/.htaccess

  2. Add the following line:

    Header set Content-Security-Policy: "default-src 'self' *.live.com; style-src 'unsafe-inline' 'self';script-src 'unsafe-inline' 'unsafe-eval' 'self';font-src 'self' data:;img-src 'self' *.live.com  data: *.duosecurity.com *.wasabisys.com *.googleapis.com *.backblazeb2.com"
    
How to Correct Issues with playing mp4 videos

If you are having problems playing mp4 videos, add a line to the .htaccess file.

To add a line to the .htaccess file:

  1. Open the following file:

    1. Windows:  C:\xampp\htdocs\.htaccess

    2. Linux: /var/www/html/.htaccess

  2. Add the following line:

    Header set Content-Security-Policy: "default-src 'self' *.live.com *.wasabisys.com *.googleapis.com *.backblazeb2.com; style-src 'unsafe-inline' 'self';script-src 'unsafe-inline' 'unsafe-eval' 'self';font-src 'self' data:;img-src 'self' *.live.com  data: *.duosecurity.com *.wasabisys.com *.googleapis.com *.backblazeb2.com"