You will require your OVHcloud account access to create a Filespace via the manager portal

Filespaces require S3 compatible Access and Secret key API credentials along with a Container, your S3 Endpoint and Region to initialize. 

OVHcloud object storage is provided by OpenStack. You will need to generate OpenStack Swift S3 credentials within the object storage region you wish to host your Filespace data. 

In order to generate S3 credentials you will require a Compute instance within OVHcloud. Follow the step by step instructions provided in this article for guidance.

Documentation and assistance with OVHcloud is available at https://docs.ovh.com/ 

1. Begin within your OVHcloud private cloud dashboard

2. Select Users & Roles and Create User or Add user

3. Provide user description

4. Specify Compute Operator and ObjectStore operator user roles

6. Once your user has been created you will be provided your Username and Password 

7. Please keep these Username and Password in a safe place. we will require the Password in future steps. 

user: GAhfDKFm3wqp 
password: RNhzQEPSU6ttGRYTjAKvWYMhv3QbWgF9

8. Download your OpenStack's RC file from the more menu of your user


9. Select Region for your OpenStack configuration RC file. Specify the Region you will be creating your Filespace10. Return to your Public Cloud dashboard and select Compute and Create an instance. we will require this instance to generate your OpenStack Swift S3 compatible object storage credentials11. Select a General Purpose instance type and Next

B2-7 will be sufficient

12. Select a Region for your instance and Next

13. Choose an instance Image and Next

Ubuntu 16.04 will be appropriate for this exercise.

14. Generate a SSH key or select an existing and Next

PuTTY Key Generator provides a simple interface to easily generate and Save your Private Key

15. Assign your SSH Key and Next

16. Configure your instance and Next

17. And finally choose your Billing period and Create an instance

18. Allow sufficient time for your instance creation before proceeding to the next step

19. Launch a SSH session into your instance. Provide your user and IP address along with your SSH Key file generated or specified during instance creation

we will use PuTTY to connect. our username is ubuntu we also need to provide our @Public IP for our session properties

20. Once you've successfully connected we can proceed to the next several steps of:

  1. uploading our OpenStack configuration RC file
  2. upgrading our operating system
  3. installing OpenStack CLI 
  4. and generating our S3 compatible credentials

Further information is available https://docs.ovh.com/gb/en/public-cloud/getting_started_with_the_swift_S3_API/


21. Upload openrc.sh and run it with the source command to read and execute the content of the file providing your OpenStack user Password you set aside in Step 7

source openrc.sh

Uploading your openrc.sh is simple you can leverage vi or nano text editors to paste contents into equivalent file within instance session - make sure file formatting remains intact. 

22. Install operating system updates

sudo apt-get update

23. Install OpenStack command-line interface tools and Python

sudo apt-get install python-openstackclient python-novaclient -y

24. Generate OpenStack Swift S3 compatible credentials

openstack ec2 credentials create

25. Your S3 credentials have been successfully generated. These come in the form of Access and Secret keys

+------------+----------------------------------------------------------------------------------------------------------------------------------------------+
| Field      | Value                                                                                                                                        |
+------------+----------------------------------------------------------------------------------------------------------------------------------------------+
| access     | 001b2233d7ab4052af1d08f089ec7a54                                                                                                             |
| links      | {u'self': u'https://auth.cloud.ovh.net:35357/v3/users/0931022c579740478cc4c0464ab2c422/credentials/OS-EC2/001b2233d7ab4052af1d08f089ec7a54'} |
| project_id | ad732a2520f045ebb049aab9c2ed36ca                                                                                                             |
| secret     | 70008f65c63d4f029ee8ed7d95c17de4                                                                                                             |
| trust_id   | None                                                                                                                                         |
| user_id    | 0931022c579740478cc4c0464ab2c422                                                                                                             |
+------------+----------------------------------------------------------------------------------------------------------------------------------------------+
Also keep these credentials in a safe place. we will require these to initialize our Filespace

26. Return to your OVHcloud Private Cloud dashboard. Select Storage, Object Storage and Create and object container

27. Select the Region for your container and Next.

It is important to select the same Region as your Compute instance which generated your S3 credentials. Your Container will be the location your Filespace data is hosted. 

28.  Select Private container type and Next

29. Specify your Container name and Create the container

30. Once your Container has been successfully created you are ready to create your Filespace. 

31. Create a new Filespace and choose LucidLink Custom as your pricing model

32. Provide a Filespace name and Next

33. Provide your OVHcloud endpoint URL in the appropriate https://storage.<region>.cloud.ovh.net syntax and Region alias. Be sure to check the Configure advanced Settings option to provide your Container and Next

OVHcloud object storage regions syntax:

Germany, Frankfurt - storage.de.cloud.ovh.net

France, Gravelines - storage.gra.cloud.ovh.net

France, Strasbourg - storage.sbg.cloud.ovh.net

United Kingdom, London - storage.uk.cloud.ovh.net

Poland, Warsaw - storage.waw.cloud.ovh.net

Canada, Beauharnois - storage.bhs.cloud.ovh.net

34. Specify your Container in the Bucket name field and Next

35. Review and confirm your Filespace settings are correct and select Create

36. Your Filespace is being setup. It will take up to a minute at which point your will be able to proceed to initialization

37. Initialize your Filespace and Download the LucidLink Client to complete the process from the client-side

38. Provide your Access and Secret keys put aside in Step 25

39. Provide a Filespace Root password. Confirm your Root password and please keep it in a safe place. Only you know it as initialization is conducted on the client-side. LucidLink does not know your Filespace user credentials. 

40. Well done! You have successfully created your Filespace on OVHcloud object storage. 

41. Open your Filespace folder and write a test file or upload some data. 

42. Confirm your OVHcloud object storage Container updates with objects as content is written to the Filespace

43. Review our additional knowledgebase articles on our support site for additional information on creating users, providing shared data access and implementing snapshots.

Initialize your Filespace can be also achieved via the command-line should you not have a GUI desktop available.

Example OVHcloud initialization string:

lucid init-s3 --fs <filespace.domain> --endpoint storage.<region>.cloud.ovh.net --https --access-key <accesskey> --secret-key <secretkey> --provider OVH --password <rootpwd> --region <region> --bucket-name <container-name>

Please reach out to LucidLink Support should you require any further assistance.