| Table of Contents | ||
|---|---|---|
|
...
To create a new private cloud datacenter:
Go to Infrastructure view
...
Go to the Private tab, click the + add button
Enter the Name of the datacenter and the Location. Click Next
...
Enter the IP address of the monolithic Abiquo server, and click Duplicate IP addresses to copy the remote service locations
Click Accept to use this remote services configuration for the datacenter.
...
Expected results: A new Abiquo datacenter is created with resources managed by Abiquo.
You can create public cloud regions that will share the same remote services.
...
| Info |
|---|
Prerequisites
|
Steps:
To create a rack:
Open the Infrastructure view and select Private and the datacenter name. If you are not on the Infrastructure details tab (with Servers, Network, etc.), open it by clicking the server button.
On the DATACENTERS list, click the plus button
Select Create Rack
Enter details of the Rack
...
Click Network and enter details for your switch and environment. The platform will use these settings to create a pool of VLAN tags to assign to private networks
...
Click Save
Expected results: The rack will be available in the datacenter to add hypervisors to the physical infrastructure.
...
To create datastore tiers
In the Infrastructure view, click the Datastore tiers tab, and click + Add to create a datastore tier.
...
On the Enterprise access tab, allow all enterprises to access the tier.
Expected results: When you add your hypervisors, you can add their datastores to the appropriate service levels.
See Manage datastore service levels with datastore tiers and Abstract datastore tiers for storage service levels
...
To add a physical machine (host):
Use the + button to create a new physical machine. For example, for a vCenter host (note: you can also add vCenter clusters as hosts).
...
Select the hosts to add to Abiquo and configure them as described here.For each hypervisor host, you must enable a network interface (by assigning a Network Service Type). This is the network interface that is listening on VLANs.
For each hypervisor host, you must enable at least one datastore (mark the checkbox).
Do not enable the vm_repository for use as a datastore.
Repeat the process of adding the physical machine for additional hypervisor hosts. Add the datastores to a datastore tier.
...
To create allocation rules
Select the data center and edit. Select the Allocation Rules tab
...
Add a new DATACENTER rule on the right pane with the + icon. Select the Rule type such as 'Compute load level' as below. This rule can be used for oversubscription of CPU. For example, in a test system with small VM templates, you could set RAM to 100% and CPU to 400%. You can also set a storage load level rule for datastore usage.
...
Note: If you are adding a "vCenter cluster" directly as a physical machine, use the server rule not the cluster rule.
...
This rule can be used for oversubscription of CPU. For example, in a test system with small VM templates, you could set RAM to 100% and CPU to 400%. You can also set a storage load level rule for datastore usage.
...
To create a public network and IPs
From the Infrastructure view, select Datacenter, Network tab, and select the Public sub-tab.
Click the + icon to add a network
Fill in the necessary information and click Save
...
Create IPs as required. Click Accept
Review the list of available IPs and make unavailable any IPs that are required for administration purposes. Use the arrow button to move selected IPs from available to unavailable. Use the double arrow buttons to move all IPs.
...
You can quarantine a public IP if it is misued. Enterprises cannot use IPs that are in quarantine. Select the IP and Click the quarantine button to make an IP unavailable to enterprises.
Expected results: Users of the datacenter will be able to obtain public IPs for their virtual datacenters.
*Note: External networks are functionally the same as public networks but they belong to a single enteprise and they DO NOT get accounted for billing purposes. External networks can also use an external DHCP server (as Unmanaged networks) and be set as defaults for VMs at Enterprise and VDC level. Public networks can be set as the default at virtual datacenter level.
...
| Info |
|---|
Prerequisites
|
Steps:
Create virtual datacenters for the host hypervisor type and appropriate networks for the VMs
In Infrastructure view, select the host and press the retrieve VMs button to scan for VMs
Select a VM that is not managed by Abiquo
Click the Capture VM button.
See: Import and capture virtual machines for more information.
...
To create a new public cloud region
Go to Infrastructure → Public
Click the + add button
Enter the Name for the region, select the public cloud Provider and mark the checkboxes for the Region(s) you wish to use. Click Next.
...
Enter the IP address of the monolithic Abiquo server. Click Duplicate IP addresses to copy the remote service location.
...
Click Save to use this remote services configuration for the datacenter.
Expected results: Abiquo creates new public cloud region(s) and resources can managed by Abiquo.
...
To add credentials for the current enterprise:
In the bottom left-hand corner of the screen, click on the user icon.
From the dropdown menu, select Edit credentials
Select the cloud provider
Enter the Access key ID and the Secret access key
Click Add account
...
Click Close
Expected results: The credentials will be added to the tenant's account
...
| Info |
|---|
Prerequisites
|
Steps:
In the Catalogue select the data center.
Click the + add button and select Create from remote repository
...
The Abiquo Repository should have been added as default
...
. You can add a testing repository at https://
...
...
...
...
.
Select the templates and click Download to save them to the local datacenter catalogue
Note that by default the Cloud Admin has the privilege to Manage repository (to add and delete remote repositories) and Admins have access to the catalogue and the privilege to Download VM templates from remote repository.
...
To upload a custom VM template:
On the Catalogue tab select the data center
Click the + add button and select the option to Create from OVA
Select the OVA file.
After you upload the OVA, edit the template as required. On the Advanced tab, check that the Operating system is set correctly
Also set the User and Password
Expected results: The template will be uploaded to your catalogue and you can use it to deploy VMs within a virtual appliance.
...
To import a template from a public cloud region into the platform's template cache, do the following steps:
Go to Catalogue → Public
Select the public cloud region
Then click the + add button at the bottom of the screen
...
The Import template popup will open
Enter the search criteria for your template
In the ID field, you can enter an ID, such as an AMI ID
In the Name field, you can enter text to search for in the name
Select Private templates to display images that are only available to your user account in the public cloud provider.
In vCloud Director this option displays templates in the same organization as your user
In OCI, to search for private templates, you must search by the template ID only.
Then click Search to perform the search. The search can take some time and return several pages of templates
To import a template, click the import symbol in the top right-hand corner of the template
If your Azure template has terms of use, then you will need to accept these now or when you first create a VM from the template.
Accepting the terms of use requires the privilege to Manage virtual machine template terms of use and it enables programmatic deployment of the template for your Azure subscription. If you then disable programmatic deployment in the portal but you would like to deploy the template, you will need to delete it from the platform and import it again.
If you share the template with another enterprise, then a user of that enterprise will need to accept the terms of use before they can create a VM
When a template has been imported, the color of the import symbol will change to gray
When you have finished importing templates click Close
Expected results: Abiquo caches the details of the VM Templates to make them available to users on a self-service basis
...
ACME Hosting {root level – Reseller (corporate or service provider level)}
Local Bank {Enterprise}
Wernham Hogg {Enterprise}
Dundler Mifflin {Enterprise}
You can manage reseller customers and their credentials in a tenant hierarchy. Your customers will be able to access their billing data on the Dashboard.
...
To define a basic enterprise hierarchy, first define a reseller enterprise, and a reseller scope.
Go to Users
Go to Scopes and for the reseller, create a reseller scope
Name the scope with the same name as the reseller, e.g. ResellerEnterpriseScope
Select an appropriate Parent scope, for example, the Global scope or no parent scope
Create an enterprise and select the Reseller checkbox to make it a reseller enterprise
For the Default scope of the enterprise, select the reseller scope for the enterprise. Abiquo will automatically add the enterprise to its Default scope
Note that if you change the default scope of an enteprise, Abiquo will not remove the enterprise from its previous scope
Go to the Datacenters tab and drag datacenters and/or public cloud regions into the Allowed pane
Then create a customer of your reseller:
Go to Scopes again and create a customer scope
Name the scope with the same name as the customer, e.g. CustomerEnterpriseScope
As the Parent scope, for example, the Reseller scope
Create the customer enterprise
For the Default scope, select the Customer scope for the enterprise. Abiquo will automatically add the enterprise to its Default scope
Note that if you change the default scope of an enteprise, Abiquo will not remove the enterprise from its previous scope
Go to the Datacenters tab and drag datacenters and/or public cloud regions into the Allowed pane
Expected results: After you create users, the enterprises will be available for logins, resource allocation, and for the customer to login to via the customer portal.
...
To create an Enterprise Admin user do these steps:
Log in as SysAdmin
Select a specific enterprise
Go to the Users pane and click + to add the new user
Select the default role ENTERPRISE_ADMIN
For the Scope, select the enterprise scope
...
Go to the Advanced tab and enter user details as required. The public key is required for remote access to VMs
...
Click Save
Expected results: An Enterprise Admin will be available. This user can manage template libraries and users for the enterprise.
...
To set limits based on the business agreement with the Enterprise holder
Log in as SysAdmin
In Users view, select a specific enterprise
Select Edit and go to Reservations
Select a datacenter and rack where a server will be reserved for this enterprise
Move one of the available servers to add the server to the Reserved servers list.
...
Log in as ANY user NOT in this enterprise (note rack reserved servers should not be available).
Log in as ANY user in the enterprise with the reserved server.
Expected results: The reserved hardware is only available to the users in the enterprise that has been allocated the reservation of the hardware.
...
To create a virtual datacenter:
Log in as an Enterprise admin or the Cloud Admin.
Click the Cloud icon to open myCloud Virtual datacenters view
Click on the + icon in the V. Datacenters pane
Fill in necessary info, select Datacenter, and Hypervisor type. Specify the virtual datacenter's name, select the physical datacenter where its applications will be deployed and if there is more than one hypervisor type, select the hypervisor you want to use. Please note that the hypervisor depends on the physical datacenter configuration, so select the physical datacenter first.
Click Save. A virtual datacenter for the enterprise will be available for virtual appliances to be created and deployed within.
...
Note: To create a virtual datacenter for another cloud tenant, you will need to switch to that tenant first in Home view or Users view.
...
| Info |
|---|
Prerequisites
|
Steps:
From V. Datacenters, select a virtual datacenter and select the Network tab, then the Private sub-tab
Click the + icon to add a new network
Fill in the necessary information
Click "Accept"
Expected results: A specified private IP range is now available for the specific enterprise/virtual datacenter
...
To optionally obtain public IP addresses for your virtual datacenter, so that you can later assign them to your VMs:
Go to Virtual datacenters → Select a virtual datacenter → Network → Public
On the Allocated public IPs page, click the + add button
To add the public IP to a virtual datacenter, click the Add to VDC link near the IP address
Now when you edit a VM in the VDC and go to Network → Public, the platform will display the public IP address and you can add it to your VM.
...
To onboard public cloud resources
Go to Virtual datacenters view. Click the + add button and select Synchronize public cloud.
Select the public cloud region
Select the virtual datacenter to synchronize from the list.
...
Click Synchronize
Abiquo will import this virtual infrastructure from the provider. Note that Abiquo will detect network configuration but it will not enforce a standard configuration.
...
| Info |
|---|
Prerequisites
|
Steps:
In the V. Datacenters list, click on the name of a virtual datacenter in public cloud
Go to Network → Public
Click on the round arrow synchronize button to obtain any existing public IP addresses
Click on the + button to obtain a new floating IP address
Click on the Add to virtual datacenter link
If you have created a VM, then you can now edit its configuration and add the IP address. Or you can remove the IP address from the virtual datacenter and delete it from Abiquo.
Expected results: A public IP will be created and can be added to the virtual datacenter and VM as required. As in private cloud you can also obtain a public IP from within the VM configuration.
...
| Info |
|---|
Prerequisites
|
Steps:
Login as Cloud Admin or Enterprise Admin
Select the enterprise
Go to the "Users" pane click + to add the new user
For the Role, select USER and for the Scope, select the "Enterprise scope" and fill in necessary info
...
Optionally restrict the user to a set of VDCs
...
Enter public key for remote access to VMs
...
Expected results: An Enterprise user is created and they can log in and deploy VMs in the selected enterprise.
...
To create a custom user role:
Login as SysAdmin
Select Users → Roles
Select the USER role and click the Clone button (or click + to add the new role)
Fill in the necessary info. (Do not enter External roles now, but you can enter them later to provide AD support)
...
Save the role
Select the role again and select the required privileges, then click Save. See Manage Roles#Privileges table
Create a new user and assign the new role to this user
Expected results: A custom role is created and a user who is assigned the new role is restricted by the selected privileges.
...
To create a virtual appliance:
Open the cloud Virtual datacenters view. It should open at the Virtual appliances tab
Select the virtual datacenter you want to deploy a virtual appliance in
Click the + add button at the bottom of the the Virtual Appliances tab
...
Enter the details of the virtual appliance
...
Click on Open or the virtual appliance Name to enter the virtual appliance editor. A virtual appliance will not do anything unless you add at least one VM template to it
Click the Create virtual machine button. You can now select from the VM templates that are ready to be deployed.
Simply double-click a template to create a VM with the default label, or click once and enter your own friendly name for the your VM
...
Expected results: A virtual appliance is created with a VM template available from the Catalogue.
...
| Info |
|---|
Prerequisites
|
Steps:
To change VM settings, from the VM options menu, select Edit.
...
The VM edit dialog will open. On the General tab, enable remote access, obtain the password and optionally increase CPU and/or RAM. Also make a note of the SSH user and password if they are available.
On the Network tab, go to Private and select the default_private_network or another network
...
Add an IP address or add the Auto-generated IP tag to the VM
If the original IP is in the same network, remove the original IP, so as to not have two IP addresses in the same network
On the Storage tab, add a hard disk by clicking the + add button at the bottom of the page
...
Enter appropriate values for a disk in your environment and click Save.
Expected results: The platform will reconfigure your VM
...
To create a new storage volume:
Select the virtual datacenter
Click the + add button
Enter the details as described below.
...
Total size, where the minimum size is as follows:
AWS and Azure: 1 GB
GCP: 10 GB
OCI: 50 GB
Tier is the service level. Some tiers may not be available in all regions, for example, the AWS "io2" service level.
Availability zone, for AWS and GCP. This must be the same Availability zone as for the VM network
Controller type for OCI: PARAVIRTUALIZED or SCSI. Note that in OCI, volumes may onboard as IDE but the platform will later update them.
Controller: In public cloud, the platform does not apply the Controller
Encrypted: Available in AWS and OCI
Expected results: The volume is now available to be attached to a virtual machine before or after it is deployed.
...
You must first prepare the template according to the cloud provider instructions. See VM Template Mobility
Go to Catalogue → select the private cloud datacenter where the VM template is stored.
Select the VM template and from its options menu, select Export
For private cloud, select the datacenter
...
For public cloud, select the public cloud region
...
For public cloud, select one bootable system disk. For private cloud, select disks
...
Expected results: A compatible VM template can be exported (copied) to another private cloud datacenter or a public cloud region
...
| Info |
|---|
Prerequisites
|
.Steps:
Obtain the login credentials for the VM, which may be assigned to the VM template.
Select the VM and on the VM control panel, near Remote access, click Show password to obtain the password. (You may also be able to obtain the login credentials from here).
To open a remote access window, click the console icon on the left-hand side of the control panel buttons.
Enter the remote access password or private key as prompted
At the VM login prompt, enter the VM login credentials.
Expected results: A console window will open and the user is presented with the login to the VM
...
| Info |
|---|
Prerequisites
|
Steps:
Log in to the platform as an enterprise user
Create a virtual appliance within an existing virtual datacenter using VM templates available from the Catalogue
Deploy the virtual appliance
Review the virtual appliance configuration. E.g. networking, hard disk
Expected results: A customer user can deploy a virtual appliance and consume physical resources that have been made available to them.
...
| Info |
|---|
Prerequisites
|
Steps:
Log in to the platform as a cloud user
Open the configuration of a deployed VM
Mark the checkbox to Fetch metrics
Select the metrics you wish to retrieve
Save the VM configuration
Open the Monitoring view and after a short time, the metrics should display
Expected results: A customer user can retrieve and display metrics to monitor the performance of their VM
...
| Info |
|---|
Prerequisites
|
Steps:
Configure the Abiquo server to use LDAP authentication. See LDAP and active directory integration. Please review the documentation as you will need to manually edit the configuration files.
Assign the LDAP groups or OpenID groups to User roles as external roles. A user in matching groups will be assigned the Abiquo Role
Example for OpenID:
id=admins,ou=group,o=qa,ou=services,dc=openam,dc=forgerock,dc=org
Examples for LDAP:
ldap_group_01
ldap_group_02
Log in to Abiquo using the credentials of an LDAP or OpenID user in the Abiquo group.
Expected results: A user can log in to Abiquo using the credentials that already exist in the Abiquo/LDAP source.
...
For example, to configure billing dashboards for Google Cloud Platform (GCP):
Log in to GCP as an administrator
Set up billing data export. See https://cloud.google.com/billing/docs/how-to/export-data-bigquery-setup
To summarize, at the time of writing this doc: Go to Google console → BigQuery → select the Project and create a dataset, for example, "billingDatasetId". Note the name of your billing dataset.Check that the account for use in Abiquo has the "Big Query Viewer" role
Log in to Abiquo and edit the Abiquo enterprise
Go to Properties and enter the properties as described here.
dataset_id: Name of your billing dataset, e.g. billingDatasetId
googleCloudPlatform_price_factor: Optional markup property
googleCloudPlatform_discount: Optional discount property
If you already entered the compute credentials but did not mark Also use for pricing, go to Credentials→ Pricing and enter them in the following format:
Access key ID: project_id#client_id#client_email#private_key_id
Secret access key: private_key
For details of how to obtain these credentials, see Obtain Google Cloud Platform credentials
Assign the "View bills" privilege to user roles
Wait for the platform to obtain billing data, then go to Dashboard → Hybrid
...
Expected results: The billing data will display on the dashboard
...
| Info |
|---|
Prerequisites
|
Steps:
To create a cost code for resource pricing
Go to Pricing → Cost codes
Click the + add button
Enter the details and initial prices
Configure a VM template in the Catalogue.
Edit the VM template and go to the Advanced tab
Select the appropriate Cost codes for the VM template
...
When you create or edit a hardware profile, you can also assign a cost code.When you create a VM you can also assign cost codes
You can use the cost code to track a VM or hardware profile in the Abiquo database either for licensing or charge back.
Expected results: A virtual image or hardware profile can be tracked for licensing or chargeback purposes.
...
| Info |
|---|
Prerequisites
|
Steps:
User should configure collectd to gather the metrics they wish to display in Abiquo
By default, all collectd metrics will be pushed by the Abiquo plugin
Open the VM configuration
Select Fetch metrics
Open the Monitoring view for the VM or virtual appliance
Expected results: The user should be able to view the metrics gathered by collectd in Abiquo
...
This use case describes a basic load balancing setup for you to test load balancers in public or private cloud. It contains these secondary use cases:
Create security group
Create web servers
Add load balancer
Retrieve index files from web servers
Use Case 11.1 - Create security groups
...
Steps:
To create firewalls:
Go to Virtual datacenters → select a virtual datacenter → Network → Firewalls
...
Select the location or the virtual datacenter and click the double-arrow synchronize button in the top right-hand corner of the page
Click the + button and enter firewall general information
...
Click the synchronize button to synchronize firewall rules. You will probably see a default rule to allow all outbound traffic.
Click the pencil edit button to edit firewall rules. Enter firewall rules, for example, to allow SSH and HTTP traffic
Expected results: Each firewall is created with the appropriate security group policies. As always, check your provider documentation for specific information about security group functionality. And see Manage Firewalls
...
| Info |
|---|
Prerequisites
|
Steps:
Use a Linux template to create two VMs (AWS instances)
Assign a private IP to each VM that is in the same availability zone (determined by private network)
Assign a public IP to each VM
If your cloud provider supports firewalls, assign the firewall you created earlier to the VM
Deploy the VM
Log in using SSH and perform the following actions on both instances
echo"Displaying content from VM 1"> index.htmlpython -mSimpleHTTPServerFor VM 2, change the text string to "Displaying content from VM 2"
Expected results: This command will start a HTTP server listening on port 8000
...
Steps:
To add a load balancer:
Select the location or the virtual datacenter and synchronize it (round arrow button beside the name)
Go to Network → Load balancers
Click the + button and enter load balancer general information. Select Public address and "An automatically created public address"
...
Create routing rules. Add a routing rule with HTTP and port 8000 (unless you have certificates prepared for HTTPS)
...
Enter a health check if required. AWS will automatically create one if you do not enter one. For the health check enter: Name, HTTP, 8000, Path: /index.html, interval (sec) e.g. 30, timeout (sec) e.g. 5 and attempts e.g. 3
Select the firewall you created earlier
Assign nodes, adding both instances
Click Save
A load balancer is created. As always, check you provider documentation for pricing and functionality. For more information about load balancers in Abiquo, see Manage load balancers.
...