|
|
| Line 15: |
Line 15: |
| When you log in, the OpenStack dashboard shows an overview of your resources. | | When you log in, the OpenStack dashboard shows an overview of your resources. |
|
| |
|
| ==SSH key pair==
| | To create a VM see instructions for creating a [[Creating a Linux VM|Linux]] or [[Creating a Windows VM| Windows]] VM. |
| | |
| When you start a virtual machine (also often referred to as an ''instance'' or a ''VM''), there is no password for an admin or a root account on the virtual machine. This is for security reasons, so that no one can log in with a password (you wouldn't want a hacker to be able to access the brand new virtual machine you just started using some default password...).
| |
| | |
| OpenStack creates your VM with one SSH public key installed and you can only log in using this SSH key pair. The SSH public key can either come from a key pair which you have already created on some other machine, or can be created by OpenStack. If you are using an existing key pair from a remote machine, you will need to import the SSH public key into OpenStack so that it can be injected into the newly created VM. Alternatively, OpenStack can create a key pair for you with the private key downloaded to your local machine. In order to manage your key pairs, click on ''Access & Security'' from the left menu, then on the ''Key Pairs'' tab. From here you will have the option of importing an existing key pair, or creating a new key pair.
| |
| | |
| ===Importing an existing key pair===
| |
| [[File:Import-Key-Pair-Form.png|400px|thumb| Import key pair (Click for larger image)]]
| |
| #Click [[File:Import-Key-Pair-Button.png]]; the ''Import Key Pair'' window is displayed.
| |
| #Name your key pair.
| |
| #Paste your public key.
| |
| #Click on the ''Import Key Pair'' button.
| |
| | |
| ===Creating a new key pair===
| |
| [[File:Create-Key-Pair-Form.png|400px|thumb| Create key pair (Click for larger image)]]
| |
| #Click on [[File:Create-Key-Pair-Button.png]]; the ''Create Key Pair'' window is displayed.
| |
| #Name your key pair.
| |
| #Click on the ''Create Key Pair'' button.
| |
| #Save the ''<key name>.pem'' on your disk.
| |
| | |
| {{Box |
| |
| ;UNIX: On your local machine (not the VM), you will need to change key permissions with the <code>chmod 400 <key name>.pem</code> command in order to connect with this key.
| |
| ;WINDOWS: To use the key downloaded from OpenStack with PuTTY or MobaXterm to connect to the VM, you need to convert it to a format compatible with that software (see [[Generating SSH keys in Windows#Converting an OpenStack Key]].)}}
| |
| | |
| ==Launching a VM==
| |
| [[File:Launch-Instance-Form.png|400px|thumb| Launch Instance (Click for larger image)]]
| |
| To create a virtual machine, click on the ''Instances'' menu item on the left, then click on [[File:Launch-Instance-Button.png]] | |
| | |
| A form is displayed where you define your virtual machine (if you are following along with this example, you can use the same values).
| |
| *''Details'' tab
| |
| **''Availability Zone'': There is only one zone; do not change its name.
| |
| **''Instance Name'': Enter a name for your virtual machine. [https://en.wikipedia.org/wiki/Hostname#Restrictions_on_valid_host_names Rules] for valid host names apply.
| |
| **''Flavor'': The flavor defines virtual machine hardware specifications. For a first attempt, pick either 'c1-3.75gb-36' flavor on east-cloud or 'c1-7.5gb-30' flavor on west-cloud. For more details, see [[Virtual machine flavors]].
| |
| **''Instance Count'': Number of virtual machines to create.
| |
| **''Instance Boot Source'': What source should be used to boot the VM. <p>''Boot from image'' indicates that you wish to boot from an already created image. Another common option is ''Boot from volume'' which allows one to boot from an existing volume which is commonly done with "p" flavors.</p>
| |
| **''Image Name'': name of the image to boot from, e.g. ''CentOS-7-x86-64-GenericCloud-1503''.
| |
| **''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, 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
| |
| **''Key Pair'': Select your SSH key pair.<p>If you have only one, it is selected by default. If you do not have a key pair, please see [[#SSH key pair | above]].</p>
| |
| :*''Security Groups'': ensure that the ''default'' security group is checked.
| |
| *''Networking'' tab: Do not change this now. <p>Networking will be discussed later, after you have launched a virtual machine.</p>
| |
| *''Post-Creation'' tab: Do not change this now. <p>This is where you would paste a cloud-init script which can do things such as install and configure software, add users, and additional SSH keys (see [[OpenStack#Accessing a VM with Multiple Users|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 cloud-init.</p>
| |
| *''Advanced Options'' tab: Leave ''Disk Partition'' on ''Automatic'' for now.
| |
| | |
| Once you have reviewed all the tabs and defined your virtual machine, click on the ''Launch'' button and your virtual machine will be created.
| |
| The ''Instances'' list will be displayed and the ''Task'' field will show the current task for the VM; it will likely be ''spawning'' initially. Once the VM has spawned it will have the ''Power State'' of ''Running''. It may take a few minutes for your virtual machine to start, depending on a variety of factors.
| |
| | |
| Note: When creating a persistent service, we recommend that you boot your virtual machine from a volume; see [[Persistent Services In The Cloud]].
| |
| | |
| ==Network==
| |
| | |
| ===Private IP===
| |
| On the ''Instances'' list are the IP addresses to which your virtual machine 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).
| |
| The list shows your virtual machine's private IP. You can use this IP to communicate with other virtual machines running on the same cloud.
| |
| | |
| ===Public IP===
| |
| [[File:Manage-Floating-IP-Associations-Form.png|400px|thumb| Manage Floating IP (Click for larger image)]]
| |
| To assign a public IP, you need to select ''Associate Floating IP'' from the drop-down menu button (indicated by ▼) of the ''Actions'' column in the ''Instances'' list. If this is your first time through this Quick Start Guide, your tenant hasn't been assigned an external IP address yet. You need to click on the “+” sign to bring up the ''Allocate Floating IP'' dialog box. There is only one pool of public addresses, so the correct pool will already be selected; simply click on the ''Allocate IP'' button.
| |
| The ''Manage Floating IP Associations'' screen is displayed, indicating the IP address and the port to which it is [https://en.wikipedia.org/wiki/Network_address_translation NATted]; simply click on the ''Associate'' button.
| |
| | |
| ===Firewall, add rules to allow SSH===
| |
| To connect to your virtual machine via SSH, you will need to allow SSH to get through.
| |
| | |
| #On the ''Security Groups'' tab, select ''Access & Security''; on the default row, click [[File:Manage-Rules-Button.png]]
| |
| #On the next screen, click [[File:Add-Rule-Button.png]]
| |
| #SSH rules are predefined. Simply select SSH in the'' Rules'' dropdown menu and leave ''CIDR' under ''Remote''.
| |
| #If you know which address you are connecting from, type it in the ''CIDR'' text field; otherwise leave 0.0.0.0/0. This will allow universal access to your server via SSH.
| |
| #Finally, click the ''Add'' button.
| |
| | |
| [[File:Add-Rule-Form.png|400px|thumb| Add Rule (Click for larger image)]]
| |
| | |
| ==Connecting to your VM with SSH==
| |
| If you created a key pair on the first step, you will need to know where it is.
| |
| | |
| ===Connecting from a Linux machine===
| |
| {{Command| ssh -i /path/where/your/key/is/my_key.key username@<public IP of your server>}}
| |
| Most common Linux distributions have standardized on the name of the distro as the username. To connect to the provided CentOS images, you would use:
| |
| {{Command|ssh -i /path/where/your/key/is/my_key.key centos@<public IP of your server>}}
| |
| where <code><public IP of your server></code> is the public IP you set in the [[#Public IP | previous step]]. The username for Ubuntu instances is ''ubuntu'', and Debian instances have the ''debian'' username. By default the preconfigured cloud username will have full sudo privileges. The root account is normally disabled.
| |
| | |
| You are now connected to your virtual machine.
| |
| | |
| === Connecting from a Windows machine===
| |
| See [[Connecting with PuTTY]] or [[Connecting with MobaXTerm]].
| |
| | |
| =Where to go from here=
| |
| * learn about using the [[Linux_introduction|Linux command line]] in your VM
| |
| * learn about [[security considerations when running a VM]]
| |
| * [[Configuring a data or web server]]
| |
| * use an [[OpenStack VM Setups|available pre-made cloud configuration]]
| |
| * learn more about working with [[OpenStack]]
| |
| * [[automating VM creation]]
| |
| * [[backing up your VM]]
| |
| * For questions about the Compute Canada cloud service send an e-mail to [mailto:cloud@computecanada.ca cloud@computecanada.ca]
| |
|
| |
|
| [[Category:CC-Cloud]] | | [[Category:CC-Cloud]] |
