Breadcrumbs

How to Integrate FileCloud with Oracle Cloud Infrastructure

Administrators can change the FileCloud storage type to Oracle Cloud Infrastructure (OCI) after FileCloud has been installed but before any data has been stored. 

  • When changing the storage type from local to OCI, the files and folders that have been already stored in the local storage will not be automatically moved to S3 storage.

  • In this case, the administrator has to manually export files and folders from local storage before changing the storage type, and manually import them after changing the storage type.


WARNINGS:

  • 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 very careful when changing the storage path, If done improperly it could lead to data loss. 

  • The OCI bucket should never be modified outside of FileCloud subsystem.

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

To create the S3 storage bucket and get your S3 key values in Oracle Cloud Infrastructure

Create the S3 storage bucket and generate your S3 keys. In addition, save the values you will need to enter when you are configuring the OCI/FileCloud integration in the next procedure on this page.

  1. Log in to https://cloud.oracle.com.

  2. Click the icon that opens the navigation panel:
    OpenNav.png

  3. In the navigation panel, click Storage.
    Storage.png

    A list of storage-related pages opens.

  4. Click Object Storage & Archive Storage.
    ObjectStorage.png

    The Object Storage & Archive Storage page opens.

  5. Click Create Bucket.
    CreateBucket.png

    A Create Bucket dialog box opens.

  6. You may give the bucket a new name and change any of the options. Then click Create.
    CreateOCIBucket.png

    The bucket appears in the list of buckets.

  7. Click the bucket name.
    BucketAppears.png

    A tab with bucket information opens.

  8. Copy and save the value of Namespace to use when you enter the S3 end point URL into FileCloud.
    Namespace.png

  9. Get your region by clicking the name of your region at the top of the OCI screen, and choosing Manage regions in the drop-down list.
    Copy the Region Identifier from the top region shown (the region with the green globe icon) and save it to enter later in S3 end point URL in FileCloud.
    GetYourRegion.png

  10. In the upper-right of the OCI screen, click the profile icon and choose My profile.
    MyProfile.png

  11. In the My profile screen navigation panel, scroll down to Resources, and click Customer secret keys.
    The Customer secret keys section opens.

  12. Click Generate secret key.
    CustomerSecretKeys.png

    The screen confirms that the secret key was generated and prompts you to copy and save it.

  13. Copy and save the secret key. You will use it for the value of S3 Secret in the next procedure.
    SecretKey.png

    It is now listed in the list of secret keys.

  14. Hover over the value in the Access key column and copy and save the key. You will use it for the value of S3 Key in the next procedure.
    CopyAccess.png


To integrate FileCloud and OCI

1. Enable OCI cloud object storage

NOTES:

Although FileCloud does not have an explicit connector for OCI 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 OCI cloud 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

  8. Open amazons3storageconfig.php and find the line: 

    //define("TONIDOCLOUD_S3_USE_PATH_STYLE_ENDPOINT", 0 );


  9. Uncomment it, and change the value to 1: 

    define("TONIDOCLOUD_S3_USE_PATH_STYLE_ENDPOINT", 1 );


  10. Save and close the file.


2. Configure Credentials in FileCloud for Managed Storage

To configure OCI object storage:

  1. Open a browser and log into admin portal.

  2. In the left navigation panel, click Settings. 

  3. On the Manage Settings screen, go to Storage > My Files.

  4. Type in or select the settings for your environment. See the table below for information about each setting.

    S3Generic.png

  5. Click Save S3 Settings.

Field

Description

S3 Key

Your OCI authentication key. Enter the Access key value generated in the OCI user interface. 

S3 Secret

Your OCI cloud authentication secret. Enter the Secret key value generated in the OCI user interface. 

Use IAM role

Leave unchecked.

S3 Bucket Name

Leave empty to autogenerate.

S3 Storage Folder

Leave empty.

S3 Region

Leave empty.

S3 End Point URL

Enter https://[namespace].compat.objectstorage.[region].oraclecloud.com

For [namespace], use the Namespace value from the Bucket tab the in the OCI user interface. 

For [region], use the Region Identifier you located in the OCI user interface.


To fill in the other settings, see Setting up FileCloud Managed S3 Storage.