Cloud Quick Start: Difference between revisions

Go to [https://east.cloud.computecanada.ca https://east.cloud.computecanada.ca] or [https://west.cloud.computecanada.ca https://west.cloud.computecanada.ca] and enter your WestGrid credentials. After you have logged in, you are presented with the dashboard. From here you can see an overview of the resources you are using.  

When you start a virtual machine (or "instance") there is no password for admin or root account on the VM, and no one can log in to it using a password. We do this for security reasons: You would not want a hacker to be able to access the brand new VM you just started using some default password. Therefore OpenStack will create your VM with one SSH public key installed, and you can only log in to it with that SSH key pair. You can either import an existing SSH key pair through OpenStack, or you can create a new pair.

In order to manage your key pair, click on “Access & Security” from the left menu, then on the “Key Pairs” tab.

##Click on the blue Import Key Pair button.

#Click [[File:Create-Key-Pair-Button.png]]

##Click on the blue Create Key Pair button.

On UNIX hosts, you will need to <code>chmod 400 <key name>.pem</code> in order to connect later on. This needs to be done on your machine, not the VM. In windows to use the key downloaded from OpenStack with PuTTY or MobaXterm you need to convert it to a format they understand steps to do this are given on the [[Generating ssh keys in Windows#Converting an OpenStack Key]] page.

To launch an instance, click on the Instances menu on the left, then click [[File:Launch-Instance-Button.png]]

You are now presented with a form to define your instance. For this walk-through, fill in the arbitrary values described below.

*Details tab

**Availability Zone: There is only one zone.  Leave it unchanged.

**Instance name: <code>test</code><br/>Make up a name for your instance.

**Flavor: <code>c1-3.75gb-36</code><br/>The flavor name defines the specifications of the VM. This particular flavor has one virtual CPU, 3.75 GB of RAM (memory) and an ephemeral disk of 36GB. Ephemeral disks are disks created and destroyed with the instance and reside on the local hardware running the VM. Flavors starting with a "p" do not have an extra ephemeral disk and thus no "-##" on the end. They also have a very small root disk of only 2.2G, with a typical OS taking about 770MB of that. The root disk, as you might have guessed, is mounted at the root of the linux file system. Flavors starting with a "c" have an extra ephemeral disk attached, as well as a 20GB root disk.

**Instance Count: <code>1</code><br/>The number of VMs to create.

**Instance Boot Source: Boot from image<br/> Indicates that you wish to boot from an already created image.

**Image Name: <code>CentOS-7-x86-64-GenericCloud-1503</code><br/>Name of the image to boot from.

**Project Limits: The green bars reflect the fraction of your available resources that will be consumed by the VM you are about to launch. If the bars become red it indicates the flavor chosen will consume more resources than your project has available. Blue bars indicate any existing resources your project may be using.

*Access & Security tab<br/>

**Key Pair: Select your SSH key pair. If you have only one, it will be selected by default. If you do not have a key pair please see above steps [Cloud Quick Start#SSH Key Pair].

**Security Groups: Leave <code>default</code> selected here.

*Networking tab<br/>You do not need to change this now. Networking will be discussed below after you have launched in instance.

*Post-Creation Tab<br/>No need to change this now. This is where you can paste a '''cloud-init''' script which can do things like install and configure software and add users and additional SSH keys (see [[OpenStack#Accessing a VM with Multiple Users]]) in an automated step after the VM is created. See [http://cloudinit.readthedocs.org/en/latest/index.html# cloudinit] for more details about clout-init.

*Advanced Options tab<br/>Leave Disk Partition on "Automatic" for now.

Once you have reviewed all the tabs and defined your instance, click on the blue Launch button and your instance will be created. The Instances list will appear, and the Status field will change, reflecting the different tasks that have to happen until it is running. It may take a few minutes for your instance to start, depending on a variety of factors.

Note: When creating a persistent service, we recommend that you boot your instance from a volume. See [[Persistent Services In The Cloud]].

On the Instance list, you will see the IP addresses to which your instance is linked. By default a network on <code>192.168.X.0</code> is created for your tenant (also referred to as a "project" on the OpenStack dashboard). You can see the private IP your instance has on the Instance list screen. You can use this IP to communicate with other instances you have started on the same cloud.

To assign a public IP, you need to select “Associate Floating IP” from the More button of the Actions column of the Instances list. If this is your first time through this Quick Start Guide, your tenant hasn't been assigned any external IP addresses yet. You need to click on the “+” sign to bring up the "Allocate Floating IP" dialogue box. There is only one pool of public addresses, so the correct Pool will already be selected. You simply click on the blue Allocate IP button. You will be returned to the "Manage Floating IP Associations" screen, the IP Address field should be populated, and the port to which it should be [https://en.wikipedia.org/wiki/Network_address_translation NATted] should

already be selected. Simply click on the blue Associate button.

In order to be able to connect to your instance via SSH, you will need to allow SSH to get through.

Go to “Access & Security”, in the “Security Groups” tab, then on the default row click [[File:Manage-Rules-Button.png]]

On the next screen, click [[File:Add-Rule-Button.png]]

For SSH, there are already predefined rules. Simply select SSH in the Rules drop down menu, then under Remote, keep CIDR.

If you know which address you are connecting from, type it in the CIDR text field; otherwise keep 0.0.0.0/0. This will allow the whole world to connect to your server via SSH.  

Finally, click the blue Add button.