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:
- uploading our OpenStack configuration RC file
- upgrading our operating system
- installing OpenStack CLI
- 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.