- Adds a public cloud region to the platform and imports templates into the Apps library
- Describes how to create a virtual datacenter and configure and deploy a VM in public cloud
Please see the Abiquo Walkthrough for further general introductory information.
This walkthrough assumes that:
- The Abiquo platform has been configured
- The user has a public cloud account for Amazon and/or Azure with API credentials. See Obtain AWS credentials or Obtain Azure ARM credentials. The examples in this walkthrough use Amazon and a Linux VM.
1. Log In
Log in as Cloud Administrator using the default account with the following data:
- Username: admin
- Password: (Your demo password supplied by Customer Service)
2. Configure your user account
To configure a user for public cloud:
- From the username menu in the top right corner of the console, select Edit user
- OR go to Users view → Users → select and edit a user
- Add an Email address to receive notifications from the platform
- To be able to connect to VMs in public cloud, add an SSH public key
3. Create a public cloud region
The cloud administrator creates public cloud regions to configure public cloud providers for users.
- Open Infrastructure View by clicking the servers icon at the top of the screen
- Go to Public
- Click the + add button in the top left corner
- Enter the Name of your public cloud region
- Select the Provider
- Select the Region to add. You can add more than one region, and the platform will add a numbered suffix to the region name
- Click Next
- Select the Remote services. Abiquo uses Remote services to connect to the providers and manage the cloud.
- In the first IP address box, click the down arrow and select the Remote service URL from the pull-down list
- Then click the link to Duplicate IP addresses at the top of the popup
- Click Check all to check the connection to the remote serivces
- Click Save
Click the help button in the top left-hand side of a pop-up to view the help screen for that pop-up.
4. Optionally allow other tenants to use a public cloud region
The tenant that creates a public cloud region can automatically use it. If you are working in the same tenant that you created the public cloud region with, then you can skip this step. For all other tenants, you must allow them access.
- Open the Users View by clicking the users icon:
- From the Enterprises list, select the tenant to allow access. Or create a new tenant, entering the name and Global scope.
- Tip: When you are creating or editing an enterprise, you can restrict the tenant's resources with Allocation limits!
- At the top of the Enterprises list, click the pencil edit button.
- To allow users to deploy in the public cloud region, enable the region datacenter for the enterprise. Go to Datacenters, select the public cloudregion, and drag and drop it to add it to the Allowed Datacenters list.
You don't need to save the tenant yet, because the next step is also a change to the tenant.
5. Add tenant credentials for the public cloud provider
Each cloud tenant will require their own set of public cloud credentials. Note that you can also register your tenants as the customer of a cloud reseller that is using the platform.
- Edit tenant enterprise and go to Credentials
- Select the Provider
- Enter the Access key and the Secret access key. For more details, see Obtain AWS credentials and Obtain Azure ARM credentials.
- Click Add account
- When you have entered all cloud provider credentials, click Save
The tenant's account will be added for the provider and displayed in the public cloud view of the Infrastructure tab.
6. Add VM templates to the Apps library in public cloud
The Appliance library (Apps library) stores VM templates so that users can easily create VMs from them. In public cloud, the platform stores VM template details and then deploys from the public cloud templates. The Apps library templates are available to users in their virtual datacenters.
- Open the Apps library view by clicking the apps library icon:
- Go to Public
- Select the public cloud region
- Click Import template
- Enter the ID of a template to import, or a Name text, for example "Linux". In Azure, optionally filter by template providers.
- Click Search
- Select a Template to import and click the import symbol in the top right-hand corner of the template
The imported templates will be added to the Apps library. Note that you may not be able to accept an end-user license agreement outside of the public cloud interface, so for example, to deploy an AMI from the Amazon Marketplace, you will need to accept the EULA in AWS before you can deploy in Abiquo.
7. Create a virtual datacenter in public cloud
Virtual datacenters contain the virtual resources for providing the cloud service. From here users can create VMs in virtual appliances and the Abiquo platform will deploy them to the infrastructure. Within virtual datacenters, users can manage their VMs, networks, storage, and more.
- Open the Virtual Datacenters view by clicking the cloud icon
- Click the + add button at the top of the Virtual Datacenters list and select Create virtual datacenter
- Enter a Name, and select the Public cloud region
8. Create a virtual appliance in public cloud
A virtual appliance is a container for a group of VMs running in a virtual datacenter. It is like a folder that can contain a related set of VMs that are used to provide a service. For example, a web stack. At the virtual appliance level, you can deploy these VMs together, view their performance statistics, create anti-affinity layers for VM high availability, and so on.
To manage a new group of VMs, create a virtual appliance:
- Select the Virtual datacenter in public cloud
- In the Virtual Appliances pane, click the add button and enter the name of the virtual appliance then click Save.
The virtual appliance you create will display in the Virtual Appliances list. For more details, see Manage Virtual Appliances.
9. Add VM templates to create VMs in public cloud
The list of available and compatible templates displays in the left pane of the virtual appliance.
- Click on the Virtual appliance name to open your virtual appliance
- To create VMs, drag VM templates into the virtual appliance
- For each template, select an appropriate hardware profile. You can enter a text string to search for specific profiles.
10. Configure the VM network connections
If you would like to connect to a VM in public cloud, you will need to add a public IP address, as well as a private IP address. If you don't configure the network, by default Abiquo will add a private IP address only.
- From the VM icon and from the options menu, select Edit
- Click Network → Public → Click +
- Then on the Purchase public IPs popup, click + add and confirm
- Select the IP address and click Add
- Drag the public IP into the NICs pane
- Then go to Private. Select a Private network. In Amazon select subnet-xxxx, which is the public subnet
- Drag the Auto-generated IP label into the NICs pane.
11. Configure the VM firewall for public cloud
To connect to a VM in public cloud, you should create a firewall to allow SSH or RDP access. As we have chosen a Linux VM in AWS, we will use an SSH connection to port 22.
Create a firewall
- While editing the VM, go to Networks → Firewalls
- Click the + add button to create a firewall for SSH connections and enter the Name, and select the Location and Virtual datacenter
- Edit the Firewall rules and add an incoming SSH rule. In this example, we allowed all connections, but you should allow only incoming connections from your IP address.
- Click + Add, then click Save (in the following screenshot the details are shown twice but AWS will not allow you to duplicate the rules).
Attach the firewall to the VM
- Go to Virtual appliances → open the virtual appliance → Edit the VM
- Go to Networks → Firewall
- Select the SSH access firewall and click Save
12. Deploy the virtual appliance in public cloud
Click the Deploy virtual appliance button to deploy the virtual appliance.
The platform will deploy all the VMs and power them on. You can select the VMs and manage them with the control buttons in the lower right corner of the screen.
13. Connect to your VM
After you have given your VM time to start up, you can connect using SSH or another appropriate method.
- Go to Virtual datacenters and open the Virtual appliance
- Select the VM and click the eye icon
- Enter the SSH private key