Quick Start Instructions to Get Rolling with OpenStack

From UCSC Genomics Institute Computing Infrastructure Information

Revision as of 21:14, 28 April 2020 by Weiler (talk | contribs)

Request an OpenStack Account

Once you have PRISM/GI VPN access, you can request an OpenStack account. You will need to send an email to cluster-admin@soe.ucsc.edu asking for access, and let us know which lab you are in, or who your PI is, so we can place you in the right OpenStack group.

Create a SSH Public/Private Keypair

To log into an OpenStack VM instance, you will need a SSH public key. The key is "injected" into the instance upon creation, and only someone with that key (i.e. you) will be able to log in via SSH initially. If you already have a SSH public and private key that you use elsewhere, you can use that one, and can skip to the next step. If you don't have a SSH keypair set up yet, then you will need to log into the UNIX compatible machine you will be logging in from (a Mac/Apple computer will also work), and then run the 'ssh-keygen' command. If you are behind the VPN, you can first log into mustard, crimson or razzmatazz, which are linux servers. The command will look something like this: 

$ ssh-keygen -t rsa

Generating public/private rsa key pair.
Enter file in which to save the key (/public/home/frank/.ssh/id_rsa):
Created directory '/public/home/frank/.ssh'.
Enter passphrase (empty for no passphrase): [JUST HIT ENTER]
Enter same passphrase again: [JUST HIT ENTER]
Your identification has been saved in /public/home/frank/.ssh/id_rsa.
Your public key has been saved in /public/home/frank/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:dhJG1A3gcwj7Mz17ommt3NIczMVVgrzp8Tf6F1X4jpI
The key's randomart image is:
+---[RSA 2048]----+
|      ..+o.+ ..o.|
|       = .. + o..|
|      . * .. + ..|
|       o =  *   o|
|        So+o + o.|
|       . =+oE ooo|
|         +o.....o|
|       .o++o .  .|
|       .=o.   ...|
+----[SHA256]-----+

You will then have a new directory, "~/.ssh", and inside that directory you will have a file called "id_rsa.pub". That is your SSH public key. You will need this in the next step in order to set up your key in OpenStack.

Log In To giCloud

Once you have been notified that your account has been set up and have been given login credentials, connect to the VPN and then go to this link in your favorite web browser, which is the login page: 

https://gicloud.prism

To login, enter your username and password. Also you will see a "Domain" field, just enter the word "default" for the domain. Click "Log In". You will be logged into your group's summary page.

Upload your SSH Public Key

After creating your new key in the above "Create a SSH Public/Private Keypair" step, you will need to upload that key into OpenStack. Once you are logged in, on the left hand navigation menu, click "Project", then in the submenu, select "Compute", and finally select "Key Pairs". It should take you to the "Key Pairs" window as shown here.

Next click the "Import Public Key" button on the top right of the window. In the resulting window, name your key in the "Key Pair Name" field. Name it something descriptive like "laptop-key" if the key is on your laptop, or "mustard-key" if you are logged into mustard, etc.

To get your key, open a terminal window and type "cat ~/.ssh/id_rsa.pub" to get your full key, as so: 

$ cat ~/.ssh/id_rsa.pub

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAyVKNfdBbDIk7Iq8JmL+u3vxAn4M1iaQgMU5tHJhMSAYBZEZRLZAFc+Qovxe5zzs1ixte9lCipLep39q2I4U8XND17nYliZ4HVM4MW4GsMUfKsgX2FI3mB2vAQ9pZSLkAhTg2D+92uALUSSv1cDZhTqo7DuPRX2Upxyd5QbRL6TRFswBjHz2vY/JpaPQm1S1d10mokPpmxehLfwp0mVgmz1Uv/6FflqiZ68DhDN67cs1yQgWYXQ01IHPjzTKRwCuZVkgT99rkoqy6TkAyrvsfzYPZbIA2y+ovOBzq6WCUT9gp5Jx/UE6CxLSmAuGPAJkV5D/twKIe75xc+5jdi3I1cgKw== user@laptop

Copy that whole line, starting with "ssh-rsa" all the way through the very last character, including the "user@laptop" bit (which may be different for you, just be sure to include it in the line copy).

Then back in the OpenStack Key Pair dialogue window, paste in the keypair in the "Public Key" window, then click "Import Key". The key should then appear in the key list.

Launch a New Instance

We are now ready to launch our new VM instance. On the left navigation menu, select "Project", then in the submenu, select "Compute", and finally select "Instances". You will see any currently running instances in your group in the resulting screen.

Next you need to click the "Launch Instance" button on the top right. You will be put into the "Details" tab in the instance creation dialogue. You need to choose an instance name and enter it into the "Instance Name" field. It should include your username as a prefix so that others know who owns each instance. Something like "frank-newtest1" would work well. You can ignore the "Description" field, "Availability Zone" should be "nova: and "Count" should be "1".

Next click the "Source" tab on the left. In the "Source" menu, in the "Select Boot Source" field, select "Image". Then in the below list of images, choose your image and click the little "Up Arrow" icon to the right of the image you want to add it.

Next click the "Flavor" tab on the left. In that menu, choose how much CPU, RAM and disk space you want for your new VM. Some images have minimum requirements, and as such some of the smaller flavors may not be available. Select your flavor by clicking the little "Up Arrow" icon on the right of your flavor.

Next click the "Key Pair" tab on the left. Click the little "Up Arrow" to the right of the Kep Pair you created in the previous step where you create a Key Pair.

Ignore the rest of the options on the left, you have configured all you need to launch the instance. Click the blue "Launch Instance" button on the bottom right of your window.

Retrieved from "http://giwiki.gi.ucsc.edu/index.php?title=Quick_Start_Instructions_to_Get_Rolling_with_OpenStack&oldid=201"