Abiquo 5.4

Skip to end of metadata
Go to start of metadata

This walkthrough:

  • 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 Linux VM in public cloud

This walkthrough assumes that:

  1. The Abiquo platform has been configured
  2. The user has a public cloud account for Amazon and/or Azure and/or GCP and/or OCI with API credentials.
    1. See Obtain AWS credentials or Obtain Azure ARM credentials or Obtain Azure ARM credentials for CSP (for partner accounts) or Obtain Google Cloud Platform credentials or Obtain OCI credentials.
  3. The examples in this walkthrough generally 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:

  1. Click the username icon in the bottom left corner of the screen to open the menu and select Edit user
    • OR go to Users view → Users → select and edit a user
  2. Add an Email address and Phone number to receive notifications from the platform
  3. To be able to connect to your VMs in public cloud, go to Advanced and 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.

  1. Open Infrastructure View by clicking the servers icon at the top of the main menu
  2. Go to Public
  3. Click the + add button at the bottom of the Public cloud regions list
  4. Enter the Name of your public cloud region
  5. Select the Provider
  6. Select the Region to add. You can add more than one region, and the platform will add a suffix to the region name
  7. Click Next
  8. 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
  9. Click Check all to check the connection to the remote serivces
  10. Click Save

Help Button

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.

  1. Open the Users view by clicking the users icon
  2. From the Enterprises list, select the tenant to allow access. Or create a new tenant, entering the Name and selecting Global scope.
    • Tip: When you are creating or editing an enterprise, you can restrict the tenant's resources with Allocation limits!
  3. At the bottom of the Enterprises list, click the pencil edit button.
  4. To allow users to deploy in the public cloud region, enable the region datacenter for the enterprise. Go to Datacenters, select the public cloud region, and drag it to the Allowed datacenters list.

    Note: You don't need to save the tenant yet, because in the next step you will also change 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.

  1. Edit tenant enterprise and go to Credentials
  2. Select the Provider
  3. Enter the Access key and the Secret access key. For more details, see Obtain AWS credentials and Obtain Azure ARM credentials.
  4. Click Add account
  5. 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.

  1. Open the Apps library view by clicking the apps library icon
  2. Go to Public
  3. Select the public cloud region
  4. Click the import template button
  5. Enter the ID of a template to import, or a Name text, for example "Linux" because we recommend that you use a Linux template. In Azure, optionally filter by template providers, for example, use the Canonical provider and search for an "ubuntu" template.
    • Tip: In Amazon in the EC2 console, you can easily find a few basic templates with IDs in the launch wizard!
  6. Click Search
  7. Select a Template to import and click the import symbol beside 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. Edit the VM templates to add a password

  1. The VM template will have a default user, and you should add a password for this user.

    1. Go to Apps library → Public → select region → Templates
  2. Select and edit the template
  3. Go to Advanced
  4. Select the template operating system, for example, LINUX_64
  5. For Azure enter a Username and for Windows on Azure enter a Password
    1. For Linux, note the username that the platform has obtained from the Azure template
    2. For Windows, enter a valid username and password. See Azure Portal and documentation about usernames at https://docs.microsoft.com/en-us/azure/virtual-machines/windows/faq#what-are-the-username-requirements-when-creating-a-vm. The RDP password must be more than 12 characters long. It should contain at least one each of uppercase character, lowercase character, number, and special character. See https://docs.microsoft.com/en-us/azure/virtual-machines/windows/faq#what-are-the-password-requirements-when-creating-a-vm

    If you do not add a user and password to the template, the platform will use the default set in Abiquo Configuration Properties.

  6. For AWS enter a Username
    1. For Linux, see Amazon default instance users table. If necessary, enter the Username
    2. For Windows, enter "Administrator"

  7. Click Save

8. In Azure and OCI create a resource group

In order to create a virtual datacenter in Azure or OCI, you must first create a resource group. You can use resource groups to manage groups of related resources in the cloud provider. 

To create a resource group:

  1. Go to Virtual datacenters by clicking the cloud button
  2. Go to Global → select the cloud provider
  3. Go to Resource groups
  4. Click the + add button
  5. Complete the dialog and click Save

Screenshot: Create a resource group in Azure

Screenshot: Create a resource group in OCI




The name of the resource group. We recommend that you check the provider documentation, because if the name is invalid, the platform will return the provider's error.
In Azure, the Name must be unique in the subscription, which means in the enterprise


The provider where that platform will create the resource group


Azure: the public cloud region where the platform will store the resource group's metadata

ParentOCI: the resource group above this resource group in the OCI hierarchy

When you create a resource group, OCI may take some time to create it, so please be patient. 

9. In Google Cloud Platform create a global network

In the Google Cloud Platform integration there are two new types of networks: global networks and their subnets. Global networks are private VPC networks that span different regions. So each global network may be available in different cloud locations. When you onboard or synchronize a region, the platform will update all global networks and all the subnets from the synchronized region.

In order to deploy a VM in the Google Cloud Platform, users must add an IP in a subnet of a global network, and this means that each virtual datacenter must have a subnet.

To create a global network:

Privileges: Manage global networks

  1. Go to myCloud virtual datacenters view → Global
  2. Select a Google provider
  3. On the Global networks page, click the + add button  and complete the dialog



NameThe name of the global network
DescriptionThis will display beneath the network name in the list
Routing modeSelect Regional or Global.

Automatic subnet creation

Select to automatically create subnets in all regions of Google Cloud Platform. This option is recommended for test environments only. To onboard the subnet for a region synchronize the global network and select the region. The subnets will have an address in CIDR notation of

Related links

10. 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.

  1. Open the Virtual datacenters view by clicking the cloud icon
  2. Click the + add button at the top of the Virtual Datacenters list and select Create virtual datacenter
  3. Enter a Name, and select the Public cloud region
  4. If required, select a resource group

11. In Google Cloud assign a subnet to the virtual datacenter

  1. In Virtual datacenters view, go to Global
  2. Select the public cloud provider → Global networks
  3. Select a global network
  4. To onboard existing subnets, click the round arrow synchronize button and select the public cloud region
  5. In Global view or Locations view:
    • Select a subnet and click the pencil edit button OR
    • Create a subnet. See Create a subnet
  6. When you edit or create the subnet, select the Virtual datacenter you created earlier

12. 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:

  1. Select the Virtual datacenter in public cloud
  2. 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 .

13. 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.

  1. Click on the Virtual appliance name to open your virtual appliance
  2. To create a VM, click Create virtual machine and select a VM template
  3. For the Label, enter a user-friendly name for the VM that meets provider criteria, then click Save
  4. For each template, select an appropriate Hardware profile. You can enter a text string to search for specific profiles.

14. 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 in a public subnet (in AWS and OCI). If you don't configure the network, by default Abiquo will add a private IP address only and you probably won't be able to connect to your VM.

  1. On the VM icon from the options menu, select Edit
  2. Click Network → select Private networks. Select a Private network.
    In Amazon select subnet-xxxx, which is the public subnet. In OCI, also select a public subnet, which has an internet gateway. In GCP, select the subnet of the global network.
  3. Drag the Auto-generated IP label into the NICs pane.
  4. Click NetworkPublicPurchase public IP
  5. Then on the Purchase public IPs popup, click the + add button
  6. Select an IP address and click Add
  7. Drag the public IP into the NICs pane

15. Configure the VM firewall for public cloud

To connect to a VM in public cloud, create a firewall to allow access. Because this VM will only be active for a very short time, we will use basic default settings.

  • For a Linux VM, use an SSH connection to port 22.
  • For a Windows VM, use a standard RDP connection to port 3389

Create a firewall in AWS, Azure, or OCI

  1. Go to Virtual datacenters → Networks → Firewalls
  2. Click the + add button to create a firewall for connections and enter the Name, and select the Location and Virtual datacenter

  3. Edit the Firewall rules and select Inbound, then from Common protocols, select SSH for a Linux VM or RDP for a Windows VM. Or for convenience, you could allow both in a test system
  4. In this example, we allowed connections, but you should allow only incoming connections from your IP address.
  5. Click Add, then click Save.

    Note that AWS will not allow you to create duplicate firewall rules.

Create a firewall policy in GCP

In GCP, the platform can create firewall policies in virtual datacenters or in global networks, to later attach to VMs.

Privilege: Manage firewall, Manage global networks

To create a new firewall, do these steps:

  1. Go to Virtual datacentersNetworkFirewalls
    or go to myCloud → Global → select the GCP provider → Network → Firewalls
  2. Click the Add button
  3. Enter the firewall details and select the direction




    Name of the firewall policy. See GCP entity naming conventions

    Virtual datacenter

    Optionally select a virtual datacenter. This option is useful in recommending firewalls for your users and to enable you to set a default firewall. If you do not select a virtual datacenter, the platform will still create the firewall in the provider and users can still attach this firewall to their VMs

    DirectionSelect INGRESS for incoming traffic or EGRESS for outgoing traffic

    Sources or Targets

    Enter a list of comma separated values in CIDR format

    PriorityThe default is 1000 and lower numbers have higher priority
    AllowIf selected, allow traffic; if unselected, deny traffic
    DisabledIf selected, disable the firewall
    Logs activatedIf selected, activate firewall rule logs in GCP
  4. Go to Inbound or Outbound and add firewall rules



    Common protocols

    Optionally select from a predefined common protocol to automatically complete the Protocol and default Ports


    Enter the protocol

    PortsEnter a list of ports, separated by commas, and/or a port range, separated with a dash (e.g. 80,8000-8009)

    Click Add to add the rule.

  5. After you finish adding rules, click Save

The platform will create your firewall in the provider.

Attach the firewall to the VM

  1. Go to Virtual appliances → click on the Name to open the virtual appliance → Edit the VM
  2. Go to Networks → Firewall
  3. Select the firewall you created and click Save. Note that the provider may limit the number of firewall policies that you can apply to a VM

16. 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.

Now you can relax and give your VM some time to start up.

17. Connect to your VM

You can connect using SSH or RDP or another appropriate method.

  1. Go to Virtual datacenters and open the Virtual appliance
  2. Select the VM
  3. To obtain the default username and password, go the General tab of the VM control panel and click Default credentials
  4. To open the connection, click the console icon
  5. A console should open to allow you to log in to your VM. The platform will automatically complete the Username
    • For Windows VMs on Azure, enter the Password
    • For all Linux VMs and for Windows VMs on AWS, enter the SSH private key (also called the Decryption key)

If you cannot connect due to an unsecured certificate error, open a new tab in the same browser, enter the host IP of the VM, and accept the certificate.