Thank you for choosing our OpenStack cloud platform. This guide will help you sign up for an account, configure your ssh key, configure your network and boot your first Linux server. By the time you reach the end, you'll have a CloudVPS Compute server up and running and will be able to set up more servers in a heartbeat.
Table of Contents
- Signing Up
- Booting your Cloud server
- Attach a Floating IP
- Connect with SSH
- Next Steps
If you haven't already signed up for a CloudVPS OpenStack account, please do so first. In order to sign up, plase follow these steps:
- Visit the CloudVPS OpenStack orderform at https://www.cloudvps.com/openstack/orderform and order your OpenStack project.
- Most accounts are activated instantly, but some accounts require manual review prior to activation. If your account is not immediately activated, please check your email for additional instructions.
Provisioning your Cloud
When your OpenStack account is created, it will need be prepared for operation. In this section you'll log in to the Skyline interface and configure your CloudVPS Compute environment.
Logging in to Skyline
The Skyline interface is a web-based Control Panel that allows you to manage your CloudVPS OpenStack virtual servers and services. Log in by going to https://stack.cloudvps.com and entering the username and password you created when you signed up. You can use the Skyline interface to control your virtual server(s), access monitoring statistics and perform other administrative tasks to control your cloud.
Projects are containers to isolate resources. You can create multiple projects through our customer interface at https://interface.cloudvps.com under the User Management tab. Customer accounts can be used to provide user specific rights to different projects. Every project will be billed separately.
- If you have multiple projects, select the project you are planning to use. In this guide we have just one project so we leave it at default.
After logging in into Skyline you will be presented with the Dashboard. Here you will find graphs and metering about the various resources such as servers, memory and floating ip addresses currently in use and maximum allowed.
Note: Since you haven't created any servers yet all counters will be set to zero and graphs will not be available yet.
Note: To upgrade your OpenStack quotas please contact sales at firstname.lastname@example.org
Generate an SSH Key
To connect to your server without typing a password every time you connect we will be generating and adding an SSH key pair which can be used to authenticate yourself at the servers you create.
Read the following guide on how to generate an SSH key pair http://www.cloudvps.com/community/knowledge-base/cloudvps-compute-ssh-keys/
Add your SSH Key
When you've have generated a SSH key pair you'll need to add it to OpenStack so it can be included it when launching a new server.
Follow the following steps to add a new key pair:
- Click on SSH Keys in in the menu on the left.
- Click the Add Key button.
The New SSH Key wizard will popup and asks for additional information.
- Enter your SSH Key Name. This can be any name, which will act as an identifier.
- Paste your SSH public key previously generated.
- Click Create Key to add the new key pair.
You have now added a SSH key pair which can be used for authentication when connecting to you server.
Setting up a private network
Within the CloudVPS Compute platform you have the ability to set up and define your own private network. The use of a network is recommended if you plan to deploy clustered configurations involving front-end and back-end servers. A network has the same characteristics as a VLAN or Virtual Private Cloud (VPC) as it will separate network traffic within the network from all other traffic in the cloud. When launching a cloud server through the New Server Wizard you can attach a previously created network or create a new network.
Note: We recommend the use of only one (1) network per clustered setup.
Create a new Network
Follow the following steps to create a new network:
- Click on Networks in the menu on the left.
- Click the New Network button.
The New Network Wizard will popup and asks for some additional information.
- Enter your Network Name and leave all other settings default. In this guide we use private-network as network name.
- Click Create Network to create the network.
You have now created a private network which can be used to connect your servers allowing them to communicate with each other.
A note about Security Groups
Your CloudVPS Compute servers can be protected by a firewall provided by the OpenStack platform. This firewall can be configured through Security Groups.
Security Groups make it possible to allow specific traffic to and from your server. In order to access your server, you must assign one or more security groups to the server.
Upon launching your first server through the Skyline interface we will provide you with a few built-in security groups. For now we will use the built-in security group named built-in-allow-all which allows all incoming and outgoing traffic to and from your server.
Create a new Floating IP address
- Click on the Floating IP Addresses in the menu on the left.
- Click on the New IP button.
After a few seconds a new floating IP address will be available.
Booting your Cloud server
You are now ready to launch your first server which can be launched via the New Server Wizard.
Start the New Server Wizard
- Click on the Servers in the menu on the left.
- Click on the New Server button.
- Enter the Server Name, in this guide will be using server1 as server name.
- Select the Availability Zone, in this guide we will be using NL1 as availability zone.
- Select the Flavour, in this guide we will be using Standard 1 as flavour.
- Select the Image, in this guide we will be using the CloudVPS CentOS 6.5 image.
- Click the Next button to go to next step.
Note: The 'Userdata file (advanced)' step is optional and will not be used in this guide.
Note: For more information about Availability Zones in OpenStack, see the Availability Zone information page at http://docs.cloudvps.com/openstack/compute/availability-zones
Note: For more information about Flavours in OpenStack, see the Flavour information page at http://docs.cloudvps.com/openstack/compute/flavours
Note: For more information about Images in OpenStack, see the Images information page at http://docs.cloudvps.com/openstack/compute/images
Note: For more information about userdata in OpenStack, see the Metadata information page at http://docs.cloudvps.com/openstack/compute/metadata
- Select the my-ssh-key from the dropdown which we added earlier.
- Click the Next button to go to the next step.
- Select Connect to a private network as the desired network configuration.
- Attach the private network private-network which you created earlier.
- Click the Next button to go to next step.
- Select Allow all traffic to allow all incoming and outgoing traffic.
- Click the Finish button to create your server.
Upon finishing the New Server Wizard OpenStack will start building your server for which it will go through a few steps to complete. You can follow the building progress by looking at the status, which will go from Scheduling to Spawning after which it will become Active and ready for use.
Attach a Floating IP
To be able to connect to it from a public network we will have to connect a floating ip address to the private ip address.
Select the newly created server named server1 and double click to open its details page.
- Click the Attach Floating IP button to open the Attach Floating IP to Server wizard.
The Attach Floating IP to Server wizard will open and you will be asked to select a Floating IP address.
- Select the option to use an existing Floating IP address which we generated earlier.
- Click the Attach IP button to attach the IP address to the private IP address.
After you have attached the Floating IP address, the details page will reflect the floating IP address has been assigned to the server.
ssh -i .ssh/id_rsa email@example.com
Since this is the first time you are connecting your local computer does not know server1 yet so you will have to agree to continue.
The authenticity of host '123.123.456.456 (123.123.456.456)' can't be established.
RSA key fingerprint is 45:78:90:12:86:34:a3:df:83:33:4d:04:d2:29:49:ee.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '123.123.456.456' (RSA) to the list of known hosts.
Right after you have agreed to continue you are connected through SSH!
Last login: Thu Jun 19 15:21:20 2014 from mycomputer
Now you know how to launch servers it is time to use them. To help find your way we have prepared some more guides: