Skip to content
Snippets Groups Projects
Verified Commit 6084f061 authored by Boris Parak's avatar Boris Parak :8ball:
Browse files

Remove quickstart and clean-up GUI/CLI

parent 15bd35a7
No related branches found
No related tags found
No related merge requests found
Showing
with 76 additions and 106 deletions
# Using OpenStack's Web Interface # Using OpenStack's Graphical User Interface
This introduction is intended for users that want to start a larger number of virtual machine instances in the cloud or use advanced features through the Graphical User Interface of OpenStack. This introduction is intended for users wanting to start a virtual machine instance
through the Graphical User Interface of OpenStack.
The process is similar to creating a virtual machine instance in [Quickstart](/documentation/0-quickstart/), you need to Overview of necessary steps:
* sign in via the MetaCentrum Cloud web interface, * sign in via OpenStack's Graphical User Interface - Horizon Dashboard,
* create an *ssh* key pair or use an existing key pair, * create an *ssh* key pair or use an existing key pair,
* create virtual private network,
* create virtual router,
* join virtual private network to internet through router interfaces,
* set up or update a security group, * set up or update a security group,
* start a virtual machine instance, * start a virtual machine instance,
* allocate floating IP address (add or remove IP address to/from virtual machine instance) * allocate floating IP address (add or remove IP address to/from virtual machine instance)
...@@ -16,185 +14,157 @@ The process is similar to creating a virtual machine instance in [Quickstart](/d ...@@ -16,185 +14,157 @@ The process is similar to creating a virtual machine instance in [Quickstart](/d
## Sign In ## Sign In
The web interface is available at [https://cloud.muni.cz](https://cloud.muni.cz). The Graphical User Interface is available at [https://dashboard.cloud.muni.cz](https://dashboard.cloud.muni.cz).
To sign in, To sign in,
* select `ENIFRA CESNET`, * select `ENIFRA CESNET`,
* click on `Sign In`, * click on `Sign In`,
{% reveal text="Show Screenshot" %}
![](/1-gui/sign_in1.png) ![](/0-gui/images/sign_in1.png)
{% endreveal %}
* select your institution from the drop-down list (use the search box at the top as a filter), * select your institution from the drop-down list (use the search box at the top as a filter),
{% reveal text="Show Screenshot" %}
![](/1-gui/sign_in2.png) ![](/0-gui/images/sign_in2.png)
{% endreveal %}
* provide your institution-specific sign-in credentials, * provide your institution-specific sign-in credentials,
{% reveal text="Show Screenshot" %}
![](/1-gui/sign_in3.png) ![](/0-gui/images/sign_in3.png)
{% endreveal %}
* wait to be redirected back to our web interface. * wait to be redirected back to our Graphical User Interface.
## Create Key Pair ## Create Key Pair
All virtual machine instances running in the cloud have to be accessed remotely. The most common way of accessing a virtual machine instance remotely is the secure shell - *ssh*. Using *ssh* requires a pair of cryptographic keys. All virtual machine instances running in the cloud have to be accessed remotely. The most common way of accessing
a virtual machine instance remotely is *ssh*. Using *ssh* requires a pair of keys - a public key and a private key.
1. To create a new *ssh* key pair, go to **Project > Compute > Key Pairs** and click the button "Create Key Pair" 1. To create a new *ssh* key pair, go to **Project > Compute > Key Pairs** and click the button "Create Key Pair"
{% reveal text="Show Screenshot" %}
![](/0-quickstart/CreateKeyPair1.png) ![](/0-gui/images/CreateKeyPair1.png)
{% endreveal %}
2. Name your new key and click on "Create Key Pair" again. Avoid using special characters, if possible. 2. Name your new key and click on "Create Key Pair" again. Avoid using special characters, if possible.
{% reveal text="Show Screenshot" %}
![](/0-quickstart/CreateKeyPair2.png) ![](/0-gui/images/CreateKeyPair2.png)
{% endreveal %}
3. You can see your newly created key pair and its fingerprint. We recommend you store the key in a safe location and back it up in case you accidentally delete it. 3. You can see your newly created key pair and its fingerprint. We recommend you store the key in a safe location and back it up in case you accidentally delete it.
{% reveal text="Show Screenshot" %}
![](/0-quickstart/CreateKeyPair3.png) ![](/0-gui/images/CreateKeyPair3.png)
{% endreveal %}
## Create Network ## Create Network
1. In **Project > Network > Network Topology** you can see the actual status of your networks. In the beginning there are only public networks visible, because you haven't created yet your network. You can do it by clicking on the button "Create Network". This network will serve as connection of your instances. 1. In **Project > Network > Network Topology** you can see the actual status of your networks. In the beginning there are only public networks visible, because you haven't created yet your network. You can do it by clicking on the button "Create Network". This network will serve as connection of your instances.
{% reveal text="Show Screenshot" %}
![](/1-gui/network1.png) ![](/0-gui/images/network1.png)
{% endreveal %}
2. Name the network, which will join your instances, and click "Next". 2. Name the network, which will join your instances, and click "Next".
{% reveal text="Show Screenshot" %}
![](/1-gui/network2.png) ![](/0-gui/images/network2.png)
{% endreveal %}
3. In Subnet tab name your subnet and choose a range of valid IP addresses (e.g. 10.1.1.0/24 or whatever you wanti) in CIDR format. The gateway will be automatically added as default (in our example it would be 10.1.1.1). Click "Next". 3. In Subnet tab name your subnet and choose a range of valid IP addresses (e.g. 10.1.1.0/24 or whatever you wanti) in CIDR format. The gateway will be automatically added as default (in our example it would be 10.1.1.1). Click "Next".
{% reveal text="Show Screenshot" %}
![](/1-gui/network3.png) ![](/0-gui/images/network3.png)
{% endreveal %}
4. In Subnet Details tab in Allocation Pools you can choose what ranges will be served by DHCP server (what ranges will be automatically assigned if a machine will use DHCP server for joining a subnet). Use format in description (e.g. for range between 10.1.1.220 and 10.1.1.249 write: 10.1.1.220,10.1.1.249 - so limits separated by comma). You can leave default DNS servers. Click "Create". 4. In Subnet Details tab in Allocation Pools you can choose what ranges will be served by DHCP server (what ranges will be automatically assigned if a machine will use DHCP server for joining a subnet). Use format in description (e.g. for range between 10.1.1.220 and 10.1.1.249 write: 10.1.1.220,10.1.1.249 - so limits separated by comma). You can leave default DNS servers. Click "Create".
{% reveal text="Show Screenshot" %}
![](/1-gui/network4.png) ![](/0-gui/images/network4.png)
{% endreveal %}
5. Now in **Project > Network > Network Topology** you should see the new network created by you. 5. Now in **Project > Network > Network Topology** you should see the new network created by you.
{% reveal text="Show Screenshot" %}
![](/1-gui/network5.png) ![](/0-gui/images/network5.png)
{% endreveal %}
Now you can continue by creating router. Now you can continue by creating router.
## Create Router ## Create Router
1. In **Project > Network > Network Topology** or in **Project > Network > Routers** push the button "Create Router". This router will serve as connection between your subnet and public network. 1. In **Project > Network > Network Topology** or in **Project > Network > Routers** push the button "Create Router". This router will serve as connection between your subnet and public network.
{% reveal text="Show Screenshot" %}
![](/1-gui/router1.png) ![](/0-gui/images/router1.png)
{% endreveal %}
2. Add router name, select External Network (public network, through which you will be connected to internet) and click "Create Router". The router should be created and joined to public network. 2. Add router name, select External Network (public network, through which you will be connected to internet) and click "Create Router". The router should be created and joined to public network.
{% reveal text="Show Screenshot" %}
![](/1-gui/router2.png) ![](/0-gui/images/router2.png)
{% endreveal %}
3. In **Project > Network > Network Topology** the router should be now visible. 3. In **Project > Network > Network Topology** the router should be now visible.
{% reveal text="Show Screenshot" %}
![](/1-gui/router3.png) ![](/0-gui/images/router3.png)
{% endreveal %}
4. Now you can go to **Project > Network > Network Topology** and create interface for connection to your subnet. Pointing over the router icon you will get to information window, where is a button "Add Interface". Click on it. 4. Now you can go to **Project > Network > Network Topology** and create interface for connection to your subnet. Pointing over the router icon you will get to information window, where is a button "Add Interface". Click on it.
{% reveal text="Show Screenshot" %}
![](/1-gui/router4.png) ![](/0-gui/images/router4.png)
{% endreveal %}
5. In opened pop-up window choose the available subnet. Click "Submit". 5. In opened pop-up window choose the available subnet. Click "Submit".
{% reveal text="Show Screenshot" %}
![](/1-gui/router5.png) ![](/0-gui/images/router5.png)
{% endreveal %}
6. In **Project > Network > Network Topology** you can now see your network joined to public network. 6. In **Project > Network > Network Topology** you can now see your network joined to public network.
{% reveal text="Show Screenshot" %}
![](/1-gui/router6.png) ![](/0-gui/images/router6.png)
{% endreveal %}
## Create Virtual Machine Instance(s) ## Create Virtual Machine Instance(s)
The creation of virtual machine instances is very straight-forward: The creation of virtual machine instances is very straight-forward:
1. In **Compute > Instances** push the button "Launch Instance" 1. In **Compute > Instances** push the button "Launch Instance"
{% reveal text="Show Screenshot" %}
![](/1-gui/instance0.png) ![](/0-gui/images/instance0.png)
{% endreveal %}
2. Choose Instance Name, (optionally) Description, Availability Zone and Count of instances, how many VMs you want to create. If you are creating more instances, the number in format '-X' will be added automatically to the Instance Name for each instance. 2. Choose Instance Name, (optionally) Description, Availability Zone and Count of instances, how many VMs you want to create. If you are creating more instances, the number in format '-X' will be added automatically to the Instance Name for each instance.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance1.png) ![](/0-gui/images/instance1.png)
{% endreveal %}
3. Choose the source of booting (you can boot your Instances from Image or a snapshot), Volume Size and from Available choose the desired image to boot from. According to the purpose of your project you can change these default settings Create New Volume and Delete Volume on Instance Delete (default "No"), if you want to use created volume and if you want to have not persistant volume. 3. Choose the source of booting (you can boot your Instances from Image or a snapshot), Volume Size and from Available choose the desired image to boot from. According to the purpose of your project you can change these default settings Create New Volume and Delete Volume on Instance Delete (default "No"), if you want to use created volume and if you want to have not persistant volume.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance2.png) ![](/0-gui/images/instance2.png)
{% endreveal %}
4. Pick the flavour - size of Instances created: VCPUs, RAM, Total Disk (Root). There are a few possibilities to choose from. You can add [additional disk]() later. 4. Pick the flavour - size of Instances created: VCPUs, RAM, Total Disk (Root). There are a few possibilities to choose from. You can add [additional disk]() later.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance3.png) ![](/0-gui/images/instance3.png)
{% endreveal %}
5. Next you check if your Instances were added to network created earlier 5. Next you check if your Instances were added to network created earlier
{% reveal text="Show Screenshot" %}
![](/1-gui/instance4.png) ![](/0-gui/images/instance4.png)
{% endreveal %}
6. (optional) Security Groups tab you can see to what security group instances will be added. Usually you would like to stick with default option. Click on "Next". 6. (optional) Security Groups tab you can see to what security group instances will be added. Usually you would like to stick with default option. Click on "Next".
{% reveal text="Show Screenshot" %}
![](/1-gui/instance5.png) ![](/0-gui/images/instance5.png)
{% endreveal %}
7. In Key Pair you need to add your earlier created public key. It will be added to authorized keys on instances and will allow you to ssh access to them from terminal/Putty or whatever you are using as ssh tool for connecting. 7. In Key Pair you need to add your earlier created public key. It will be added to authorized keys on instances and will allow you to ssh access to them from terminal/Putty or whatever you are using as ssh tool for connecting.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance6.png) ![](/0-gui/images/instance6.png)
{% endreveal %}
8. (optional) You can now go to Metadata (the left bottom tab) and choose the packages of software, which you want to have installed on your instances. 8. (optional) You can now go to Metadata (the left bottom tab) and choose the packages of software, which you want to have installed on your instances.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance7.png) ![](/0-gui/images/instance7.png)
{% endreveal %}
9. Then you can click on Launch Instance. After a few minutes they will be ready for using. 9. Then you can click on Launch Instance. After a few minutes they will be ready for using.
{% reveal text="Show Screenshot" %}
![](/1-gui/instance8.png) ![](/0-gui/images/instance8.png)
{% endreveal %}
## Allocate and Associate a Floating IP (optional) ## Allocate and Associate a Floating IP (optional)
Sometimes we want to have an instance accessible from public network. In OpenStack project you can do it easily from the menu for each instance in **Project > Compute > Instances** or you can manage them more conscious way with at first allocating and then associating of IP address with instance. (You can of course later disassociate IP address from instance or disallocate IP address from your pool, when you don't need it, or associate with another instance and so on.) Sometimes we want to have an instance accessible from public network. In OpenStack project you can do it easily from the menu for each instance in **Project > Compute > Instances** or you can manage them more conscious way with at first allocating and then associating of IP address with instance. (You can of course later disassociate IP address from instance or disallocate IP address from your pool, when you don't need it, or associate with another instance and so on.)
1. Go to **Project > Network > Floating IPs** and click on "Allocate IP to Project" 1. Go to **Project > Network > Floating IPs** and click on "Allocate IP to Project"
{% reveal text="Show Screenshot" %}
![](/1-gui/allocate_IP0.png) ![](/0-gui/images/allocate_IP0.png)
{% endreveal %}
2. In pop-up window choose from which public network (Pool) do you want to allocate IP address for your instance eventually what will be the name of IP address. You have to choose the public network, to which your network is connected to, otherwise it won't work. Click on "Allocate". 2. In pop-up window choose from which public network (Pool) do you want to allocate IP address for your instance eventually what will be the name of IP address. You have to choose the public network, to which your network is connected to, otherwise it won't work. Click on "Allocate".
{% reveal text="Show Screenshot" %}
![](/1-gui/allocate_IP1.png) ![](/0-gui/images/allocate_IP1.png)
{% endreveal %}
3. Now you should have IP address to your disposal. 3. Now you should have IP address to your disposal.
{% reveal text="Show Screenshot" %}
![](/1-gui/allocate_IP2.png) ![](/0-gui/images/allocate_IP2.png)
{% endreveal %}
4. The next step is associate the free IP address to an instance. Click on "Associate". 4. The next step is associate the free IP address to an instance. Click on "Associate".
{% reveal text="Show Screenshot" %}
![](/1-gui/allocate_IP2a.png) ![](/0-gui/images/allocate_IP2a.png)
{% endreveal %}
5. Select IP address and Port to be associated and click on "Associate". 5. Select IP address and Port to be associated and click on "Associate".
{% reveal text="show screenshot" %}
![](/1-gui/allocate_IP3.png) ![](/0-gui/images/allocate_IP3.png)
{% endreveal %}
6. In **Project > Compute > Instances** you should be able to see instance with the associated public IP address. 6. In **Project > Compute > Instances** you should be able to see instance with the associated public IP address.
{% reveal text="show screenshot" %}
![](/1-gui/allocate_IP4.png) ![](/0-gui/images/allocate_IP4.png)
{% endreveal %}
## Create Volume ## Create Volume
> TODO > TODO
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
File moved
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment