Here are instructions on how to setup your CORTX server in CloudShare for the hackathon.
The CloudShare environment gives you access to a CORTX instance running on a remote server with S3 credentials already preconfigured.
In this walkthrough we will show you
- How to setup your CORTX instance
- How to read and write data to your CORTX instance
- How to manage your CORTX instance and create and manage S3 accounts
How to Setup your CORTX instance.
Pre-requisites:
Before you start you should have received an e-mail from 'donotreply@cloudshare.com' like the one below which should have a subject line like 'Patrick Hession of Seagate has invited you to try the "CORTX RGW OVA Hackathon"'. If you have not received an email like this, please let us know in slack and we will send you an invitation.
Step 1:
Click the link in the e-mail to “access your self-paced class”
Step 2:
Once you log in you should see your Virtual Machines booting up, as can be seen by the spinning circle in the top tab.
Credentials:
root/CortxP@ssword190!
Wait a couple of minutes for all the machines to be 100% before proceeding on.
You should see a terminal like shown in this screenshot:
Step 3:
Make sure you are root user sudo su -
How to Read and Write data to your CORTX instance
Fantastic, now your CORTX instance is ready for action! The next step is to test it by reading and writing some data to it.
Steps:
- Get your Server URL (CORTX endpoint) from the Connection Details section -> External address on your CloudShare console page
- Check that you can connect to the CORTX server by pinging it from a computer outside the CloudShare environment by using the address above (if you run into issues let us know on slack)
Check that you can connect to the CORTX server and read and write data
-
Install aws cli
-
You can use any terminal window to do this, it works on Windows, Mac and Linux. To do this you will need the Server URL, Access Key and Secret Key.
** Note: ** Access Key: sgiamadmin Secret Key: ldapadmin
- You can either run from within CloudShare VM (the cloudshare VM already has aws cli installed and configured) or, since the S3 interface is public, you can run from your local machine too (such as your personal laptop, etc).
In your terminal type:
aws s3 help --endpoint-url http://<address url>:31949
This will list the commands available if you have never used aws s3 cli before.
Troubleshooting
-
You may need to log into your instance from your local machine via ssh before you run s3 commands for the first time. I faced this issue when I was setting up my own environment.
ssh root@<external address URL>password: CortxP@ssword190! -
Once you login once this issue seems to go away
-
Credentials for the instance: * * cortx/opensource! *
Happy hackathoning! Please reach out to us in Slack if you have any questions with any of this.