cloud:quickstart
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
cloud:quickstart [2017/09/14 08:24] – [Floating IP] rmueller | cloud:quickstart [2017/10/05 13:12] (current) – [SSH Setup] rmueller | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~NOTOC~~ | ||
+ | This is the **quickstart** to start your own running virtual maschine in the de.NBI cloud. To start this guide you should have an individual account and be a member of an existing project. If you do not have an account, please visit [[https:// | ||
+ | |||
+ | Throughout this guide, we will achive following goals: | ||
+ | - [[cloud: | ||
+ | - [[cloud: | ||
+ | - [[cloud: | ||
+ | - [[cloud: | ||
+ | - [[cloud: | ||
+ | - [[cloud: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ====== First Login ====== | ||
+ | First of all, visit [[https:// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Enter " | ||
+ | |||
+ | If you are an internal user of the bcf, please visit our [[cloud: | ||
+ | ====== OpenStack Dashboard Overview ====== | ||
+ | |||
+ | If the login was successful, you should see the overview page of the OpenStack dashboard: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | At the top left you should see your current [[cloud: | ||
+ | |||
+ | At the top right you see your [[cloud: | ||
+ | |||
+ | On the left is the **control menu** (blue box) to navigate you through your project. The current page is highlighted in blue (In our case Project -> Compute -> Overview). This information can also be found in the yellow box. This could help you navigate to the right page, in the case you have trouble to find the current page we are operating on. | ||
+ | |||
+ | The overview page summarizes the resource allocation within the current project (center of the page): | ||
+ | * Launched [[cloud: | ||
+ | * Used VCPUs | ||
+ | * Used RAM | ||
+ | * Allocated [[cloud: | ||
+ | * Used [[cloud: | ||
+ | * Number of [[cloud: | ||
+ | |||
+ | ====== SSH Setup ====== | ||
+ | Next, we have to setup SSH to login to our instances after they are launched. Go to {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | If you do not have an SSH key or you are not sure whether you have one, please visit [[https:// | ||
+ | |||
+ | Now, you can click on **Import Key Pair** (right button in the yellow box) and import your SSH key. Afterwards, your key should be listed on {{: | ||
+ | |||
+ | ====== Creating a Router and a Network ====== | ||
+ | We want to create a network to get access to our in the near future launched instances. First, we get to the Network Topology page: {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Here you can see the external network (blue elipse). | ||
+ | |||
+ | What do we need to access our instances: | ||
+ | |||
+ | * Router | ||
+ | * Network | ||
+ | * Subnet | ||
+ | |||
+ | ===== Router ===== | ||
+ | |||
+ | Click on the **Create Router** button (green box). A form should appear: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Fill in the **Router Name** and select the **external_network** for the **External Network**. Click on the blue button **Create Router**. Your network topology should looks like this: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Network and Subnet ===== | ||
+ | |||
+ | |||
+ | Now, we need a network. Click on **Create Network** (yellow box). A three-part form should appear (**Network**, | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | In the first part fill in the **Network Name** and then click on the blue **Next** button. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Here, you have to specify your **Subnet Name** and your **Network Adress** (e.g. **192.168.0.0/ | ||
+ | |||
+ | Now your topology should include your network: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | We want to connect our **Router** with our new **Network**. Click on your Router {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Select your **Subnet** and click on the blue **Submit** button. Your topology graph should look like this: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | **For further reading visit our [[cloud: | ||
+ | ====== Launching an Instance ====== | ||
+ | |||
+ | Finally, we can launch our instances. We are still on {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | OpenStack fills some information with defaults. Thus, we have to fill the fields on the pages marked with a blue star (blue box). | ||
+ | |||
+ | On the first page we have to specify an **Instance Name**. After this, click on the **Next** button or on **Source* **. The blue star next to **Details** should disappear: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | - Select **Image** as **Boot Source** (red box). | ||
+ | - Select **No** for **Create New Volume** (yellow box) | ||
+ | - Select an image as source to create the instance (e.g. **Ubuntu 16.04 Xenial 2017/ | ||
+ | |||
+ | After this, click on the **Next** Button or **Flavor* **. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | A flavor defines a virtual machine setup by defining parameters like hard disk size, available memory or CPU core number. Click on the **+** Button next to de.NBI.default flavor (red box). Now the star next to **Flavor** should disappear. You can click on the blue **Launch Instance** button to launch your instance. Your **Network Topology Graph** should look like this: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Great!!!8-) | ||
+ | |||
+ | |||
+ | ====== Getting Access to the Instance ====== | ||
+ | On the Project -> Compute -> Overview page, we can see that we have allocated some resources: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | On Project -> Compute -> Instances we can see our instance and that it is running: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Floating IP ===== | ||
+ | In order to connect to your virtual machine (= instance), it must be related to a public network address. A private, fixed IP address, used "for communication between instances", | ||
+ | Click on **Associate Floating IP**:{{ : | ||
+ | Click on the **+** next to **No floating IP addesses allocated** in the **IP Address** field: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Select the **external_network** in the pool field (red box) and click on the blue **Associate IP** Button: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Click on **Associate** to associate your new floating ip to your instance. Now, your instance should have two ip adresses: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Security Groups ===== | ||
+ | First of all, you should read our [[cloud: | ||
+ | You are responsible for a secure setup of your VMs. To allow external access to your instance via SSH, you have to change the security group and allow SSH! Go to Project -> Compute -> Access & Security {{: | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Click on the **Security Groups** Tab (red box). You should see one security group with the name **default**. Click on **Manage Rules** next to the **default** security group (green box). | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | Click on **Add Rule** (yellow box) | ||
+ | |||
+ | ---- | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ---- | ||
+ | |||
+ | In the **Rule** field, select **SSH** (maybe you have to scroll a little bit down)(pink box). Click on the blue **Add** button. | ||
+ | |||
+ | ===== Login ===== | ||
+ | |||
+ | Now you can login (in our case as the ubuntu user): | ||
+ | '' | ||
+ | |||
+ | |||
+ | Great! You have started your first instance in the de.NBI cloud 8-) | ||
+ | |||