| 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.
...
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.
...
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.
...
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.
...
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.
...
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.
...
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.
...
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:
On In the Apps Library (Catalogue) tab select the data center.
Click the + Add add button and select Create from remote repository
The Abiquo Repository should have been added as default (http://abiquo-repository.abiquo.com/ovfindex.xml).Select the templates and click Download to save them to the local datacenter Apps librarycatalogue
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 Apps library (Catalogue) catalogue and the privilege to Download VM templates from remote repository.
...
| Info |
|---|
There are many ways to make VM templates available to users in the Apps library (Catalogue)catalogue. See Use Case 2.2. |
...
Use Case 2.2 - Leverage existing VM templates by importing into the catalogue
...
| Info |
|---|
Prerequisites
|
...
To upload a custom VM template:
On the Apps Library (Catalogue) tab select the data center
Click the + Add 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 Apps library (Catalogue) 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 Apps library Catalogue → Public → select
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
...
| Info |
|---|
You can now customize (e.g. add an icon) and share the template as required. You can also export correctly prepared VM templates from your Apps library catalogue to public cloud. |
...
Create customer organization hierarchy
...
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:
...
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.
...
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.
...
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
...
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.
...
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
...
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 Apps library ( Catalogue).
...
Use Case 5.2 - Deploy and undeploy a virtual appliance
...
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.
...
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
...
You must first prepare the template according to the cloud provider instructions. See VM Template Mobility
Go to Apps libraryCatalogue → 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
...
Log in to the platform as an enterprise user
Create a virtual appliance within an existing virtual datacenter using VM templates available from the Apps library ( Catalogue)
Deploy the virtual appliance
Review the virtual appliance configuration. E.g. networking, hard disk
...
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.
...
| 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.
...
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
...
| Info |
|---|
Prerequisites
|
...
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"
...
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
...