The OpenStack Command Line Interface (CLI) tools are recommended for advanced users only. The majority of information about your cloud account can be managed in the OpenStack web console.
The steps to setup the CLI tools and connect to Lake Effect are as follows:
1. Install the OpenStack client tools for the operating system of your desktop/laptop.
To install the tools on Centos:
sudo yum install centos-release-openstack-ocata
sudo yum install python-openstackclient
Most Linux and MacOS distributions can install this using pip. You may want to use a virtual environment - documentation can be found online, if you are unfamiliar with this.
pip install python-openstackclient
CCR software to allow the connection of your machine and the Lake Effect cloud:
pip install git+https://github.com/ubccr/v3oidcmokeyapikey.git
Please see this documentation from Red Hat for more information on installing the OpenStack tools. Windows client installations have not been tested by CCR at this time.
2. Download the OpenStack RC file from the Lake Effect web console:
3. Create an API key in the identity management portal to allow for secure access between your machine and the Lake Effect cloud:
Click the "Create Api Key" button:
Click the "Create" button in the pop-up window:
You are then provided your API key that you'll use in your OpenStack configuration.
DO NOT SHARE THIS INFORMATION! If you believe it may be compromised, delete it and recreate a new one
As the message states, copy the key to a safe place. Once you've copied your API key from the IDM portal, you can click done and you will be redirected to the page displaying the API key you've activated. You can then exit the IDM portal:
4. Now you will need to source your RC file and then you'll be able to run OpenStack commands. Your openrc file will look something like this but your username, project_name, and API key will be different:
source openrc (or whatever you named it)
You'll be prompted to enter your API key. NOTE: it will not show up on the command line - copy & paste it, then you should be brought back to a prompt and can begin using Openstack tools such as:
openstack image list
openstack flavor list
openstack network list
openstack security group list
openstack keypair list