Knowledgebase

Introduction

ownCloud is an open-source file hosting server on the cloud that enables secure storage, collaboration, and sharing. This guide explains how to use ownCloud with Rcs's Block Storage and Object Storage.

Prerequisites

• Deploy a one-click ownCloud Application cloud server instance from Rcs Marketplace Apps

• Add Block Storage to your account

  Note: Your cloud server instance must be in the same server location with your Rcs Block Storage, or you will not be able to attach your block storage to your server instance otherwise.

• Add Object Storage to your account

Use ownCloud with Rcs Block Storage

Rcs's Cloud Block Storage technology is ideal for ownCloud because of its scalability and high-performance SSDs. You can deploy volumes as large as 10,000GB, which is perfect for file hosting.

Mounting the Block Storage

1. Attach your Block Storage to your ownCloud server instance

2. SSH to your ownCloud server instance as root.

3. List all block storage devices to verify the new device name. The first block storage device is connected to your server as /dev/vdb.

    # lsblk

4. Create a new disk label using parted.

    # parted -s /dev/vdb mklabel gpt

5. Make a primary partition to fill the entire disk.

    # parted -s /dev/vdb unit mib mkpart primary 0% 100%

6. Create an EXT4 filesystem on the primary partition and format it.

    # mkfs.ext4 /dev/vdb1

7. Make a mount point. This is also where your ownCloud files will be stored.

    # mkdir -p //owncloud/data

8. Add a blank line and a mount entry to /etc/fstab. This will automatically mount the block storage at /owncloud/data at reboot.

    # echo >> /etc/fstab
    # echo /dev/vdb1 /owncloud/data ext4 defaults,noatime,nofail 0 0 >> /etc/fstab

You can also manually mount the block storage without rebooting.

    # mount /owncloud/data

Setting up ownCloud

1. On your browser, navigate to your server's IP Address.

2. Log in to your ownCloud file server using the credentials that can be found on your cloud instance's control panel.

3. After you are logged in, go to Settings by clicking your username on the upper-right corner.

4. On the Admin section, click Storage.

5. Enable the external storage by clicking the checkbox.

6. Enter a Folder name. This folder is where you save your files, which will then be stored in your block storage.

7. Click the Add Storage dropdown menu under the External Storage column, then select SFTP.

8. For the authentication, select Username and password.

9. Enter your server's IP address on the Host text box.

10. Enter /owncloud/data on the Root text box. Notice that the /owncloud/data directory is where you mount your Block Storage.

11. Enter your cloud server instance's username and password on the Username and Password text boxes.

12. A green dot will appear beside the Folder name to confirm that ownCloud is now connected to your mounted block storage via SFTP through the mount point /owncloud/data.

13. Test if everything works fine. Create a test file using touch on your SSH terminal.

    # touch /owncloud/data/testfile.txt

14. Check if testfile.txt appears in the folder that you have created on your ownCloud file server.

Use ownCloud with Rcs Object Storage

1. Create a Bucket from the Buckets tab on your Object Storage's Control Panel.
2. On your browser, navigate to your server's IP Address.
3. Log in to your ownCloud file server using the credentials that can be found on your cloud server instance's Control Panel.
4. Go to ownCloud Market. Click the triple horizontal bar icon on the upper-left corner, then select Market.
5. From the Categories section on the sidebar menu, select Storage.
6. Look for External Storage: S3 and Install it.
7. After you install External Storage: S3, go to Settings by clicking your username on the upper-right corner.
8. On the Admin section, click Storage.
9. Enable the external storage by clicking the checkbox.
10. Enter a Folder name. This folder is where you need to save your files, which will then be stored in your Object Storage Bucket.
11. Click the Add Storage dropdown menu under the External Storage column, and select Amazon S3 Compatible (SDK v3).
12. On the Bucket text box, enter the name of the Bucket you created on step 1.
13. On the Hostname text box, enter your Object Storage's Hostname which can be found on your Object Storage's Control Panel
14. Look for your Access Key and Secret Key on your Object Storage's Control Panel and copy it, then paste it on the Access Key and Secret Key text boxes.
15. A green dot will appear beside the Folder name to confirm that your ownCloud file server is now connected to your Object Storage (Bucket).
16. Test if everything works fine. Go to your ownCloud Files and select the Folder you have created.
17. Upload any file (test file), then check if it appears on your Bucket from your Object storage's control panel.

More Information

For more information about ownCloud, Rcs Block Storage, and Rcs Object Storage, please see these resources:

• Rcs Block Storage Documentation
• Rcs Object Storage Documentation
• Rcs One-click ownCloud Documentation
• ownCloud Documentation