Create a virtual machine
To create a virtual machine (VM) do the following steps:
- Open the Virtual datacenters view by clicking on its icon in the top menu
- Open a virtual appliance that will hold a group of VMs by clicking on its name
- To create the VM, drag and drop a VM template from the Templates tab into the Virtual machines pane. You can also double-click the VM template
- If there is more than one version of the VM template, you can select another version
- If your cloud provider uses hardware profiles, select one
The platform will create your VM. The status bar on the VM icon says it is NOT_ALLOCATED, which means that the VM has not been launched into the cloud.
Filter VM templates for creating VMs
The template tab contains compatible templates only. If you cannot see an expected template, contact your system administrator. If there are a lot of templates, you may wish to filter the templates first.
To filter templates in the left-hand Template library tab:
- Click the filter button and select a category from the pull-down list
- To display only ISOs, select the checkbox
- Enter text (including * wildcards) in the search box and press enter
To clear the search
- Click the Clear link on the Category filter popup, which will clear both category and text search box
- Click the grey X button beside the Search box
Configure a VM before you deploy it
To configure your VM before you launch it, do the following steps:
- Move the mouse over the VM icon and form the options menu, select Edit
- Change the configuration options as described in this section
- Click Save
To configure the basic general VM settings:
- Optionally change the VM's friendly name. By default, the platform powers on VMs in ascending alphanumerical order of friendly names. However, there is no guarantee that VMs will finish powering on in the same order.
- In private cloud, optionally enable guest setup
- Optionally request a Guest initial password that will be sent by SMS or email
- Optionally enter a fully qualified domain name that the platform will set at deploy time
- To Enable remote access
- Select the check-box
- Display and optionally change the password to open the remote access connection
In public cloud you will need to:
Edit your user account to add an SSH public key. See Configure your user account. You will need the SSH private key to log in to your VM
Assign a public IP to your VM. See VM Network
- Assign a firewall policy that allows access to the appropriate SSH or RDP port. See VM Firewall
- Optionally enter a description
You can now continue with further configuration or Save and deploy your VM.
If you don't add an IP, the platform will automatically add one on the default network.
To configure IP addresses on your VM
- Select the Private, External, or Public tab
- Create NICs as required:
- To request an automatically created NIC and IP, drag and drop "Automatically generated IP" to your VM
- To create a new IP address and NIC, click the + button
- To use an existing address, drag and drop the IP address into the Network interfaces list
- Continue configuring your VM or click Save to finish
Select the firewall policies to add. You can add as many firewall policies as necessary, up to the cloud provider's limit. If you can't see the expected policies, you may need to synchronize with your provider or wait for the platform to update provider data
Select the load balancers to use for the VM.
To enable monitoring and metrics
- Select the Fetch metrics checkbox.
- Select from the available options for your provider, for example, for AWS, you can select basic or advanced monitoring
- Select the metrics you would like to display for your VM
In private cloud, you can create additional hard disks that are not persistent. This means that when you undeploy the VM or remove the hard disk, the platform will delete your hard disks and destroy all data on them. To store the contents of a hard disk, create an instance template that will copy the hard disk to the template library.
To add a hard disk:
Click the add button at the top right of the Storage tab
Select Assign virtual disk.
In the dialog the options will depend on the platform configuration
You must enter the size and the controller type
- Advanced options: to force the creation of a new controller, assign a new bus value. The platform will return the bus value assigned by the provider
- Optionally select the datastore tier with the appropriate storage service level
- Click Save
Note that you cannot change the size of the primary disk before you deploy a VM.
Deploy to launch into the cloud
To launch your VMs, click the Deploy virtual appliance button on the right-hand side of the screen.
The platform will launch the VMs and power them on. The status bar below each VM icon will be coloured green. And the Deploy button changes to become the Undeploy button, which you can use to destroy the VMs.
Display VM details
To display VM details, select a VM icon. The platform will display the control panel below the VMs with different tabs, such as General and NICs.
Click here to show/hide the screenshots
Here are some examples of VM control panel tabs
- The General tab contains the CPU and RAM and other information such as the remote access password for connecting to the VM.
- The NICs tab contains the details of the IP addresses of the VM.
- The Storage tab contains the details of the hard disks and volumes attached to the VM
View VM metrics
To display VM metrics, click the metrics symbol on the VM icon.
To refresh metrics data, click the arrow refresh button on the right-hand side. To toggle the display of metrics, click the selection list symbol on the left-hand side, and select the desired metrics.
To filter metrics, click the funnel symbol. Enter the granularity, statistics, period, and dimensions.
To configure the display of metrics at the virtual appliance level, do these steps.
- Select Virtual appliance → Monitoring
- Optionally configure the refresh interval: Select the "Refresh data every" checkbox and enter a number of minutes.
- Choose the metrics you wish to display and filter by metric statistics.
Click here to show/hide the screenshot
Screenshot: filtering metric statistics
VM power actions
a VM that is deployed and powered on:
- Select the VM icon
- Click the power off button, which is square shape.
- Select from the following two options:
Shutdown: The platform will try to gracefully shut down the VM. This option may require hypervisor and guest VM configuration
Power off: The platform will perform a hard power off on the virtualization technology. Warning: Using this option may cause loss of data
Remember that stopping a VM does not destroy it in the cloud provider and the VM is still consuming resources.
To power on a VM, click the play arrow start button.
Depending on the cloud provider, you may also be perform the following actions:
- pause a VM to suspend it using the double vertical bar button
- reset a VM to restart it using the circular arrows button.
The platform displays the appropriate buttons for the provider and the current state of the VM.
Click here to show/hide walkthrough screenshots
The following screenshots show two VMs: the VM on the left is selected to perform an operation; the VM on the right shows how the result of the operation will look.
Connect to a VM
The platform enables you to connect to a console of a VM that is deployed and powered on.
- It make take up to 15 minutes after deploy for the initial guest password to propagate to a VM, especially for Windows systems
- To obtain the remote access password, go to the VM control panel → General
- To obtain VM credentials check your email or SMS, or you may click the Key button for guest initial password or the default credentials button
To connect to your VM from the user interface:
- Select the VM and on the control panel, click the eye icon
- On the remote access tab, enter:
- The remote access password
- The SSH private key in the Decryption password box
- Log in to the VM with the appropriate credentials
The remote access connection to the VM will open and you can log in and work with the VM. Remember to change your administrator password as soon as possible.
Add more VMs to a deployed virtual appliance
When you add another VM to a deployed virtual appliance, it is not allocated to the provider directly. You can deploy new VMs individually or click the Deploy all VMs button in the top right-hand corner of the screen.
Reconfigure a VM after you deploy it
After you deploy a VM, the changes you can make will depend on your cloud provider. To change the configuration of a deployed VM
- Select the VM
- If your provider or operating system does not support using hot add and hot reconfigure, power off the VM, using the Stop button on the control panel
- Move the mouse over the VM and from the options menu, select Edit.
- On the Edit VM dialog, go to General, make changes to the following as required:
- VM friendly name
- CPU and RAM if hardware profiles are not in use
- Remote access
- If you disable remote access, hypervisor configuration will remain but you cannot access it through the Eye icon
- If you change the password, the change will be applied when you save the VM. Remember that it can be a maximum of 8 alphanumeric characters, i.e.. a to z, A to Z, 0 to 9. If you delete the password, the screen requesting the password will not appear. On ESXi hypervisors, if you set a password and later delete it, the password will be blank, not null. The screen requesting the password will appear, and you should press <Enter> to continue.
- Description of the VM
- Hardware profiles
- Make changes to Networks and Storage, Firewalls, and Load balancers as required
- Click Save
The changes will be applied in the cloud provider directly.
To change a VM's fully qualified domain name (FQDN), make the change in the VM's operating system and the platform will detect the new value
Do NOT change the Abiquo tag in public cloud
Do not change the Abiquo platform's tag on a VM in public cloud provider (e.g. on an AWS instance) because you could break the link between Abiquo and the VM. If the link is broken, you will not be able to manage the VM with Abiquo.
Save VM disks to create an instance template
An Abiquo instance is a new template that you create from VM disks.
Before you begin:
- In Azure, to create a VM snapshot (instance) you must first log in to the VM and generalize it using Sysprep. See https://docs.microsoft.com/en-us/azure/virtual-machines/windows/capture-image-resource. Then you should power it off and create the snapshot in the usual way. Note: after you generalize the VM, you cannot power it on again
To create an Abiquo instance, do these steps:
- Select and shut down each VM that you want to copy, then click Create instance
- Select a VM from the dialog
- Enter a name that will enable you to identify the new template
- In private cloud, optionally select the VM disks to save to a new template in the template library. If no disks are selected, the instance will copy all disks
- If you want to create more instances, select Keep window open
- Click Create instance. The platform will lock the VM to create the instance
- If you kept the dialog open, click Back to list and create more instances as required, then close the dialog
Your new templates will be stored in the Template library.
Use a saved template in private cloud
To use an instance template in a VM, double-click or drag and drop the original template and an instance menu will open. Select the instance template.
Click here to show/hide the screenshot
Display all VMs
To display all VMs of your enterprise, go to Virtual datacenters → All virtual datacenters → Virtual machines tab.
To display all the VMs in a specific virtual datacenter, select the virtual datacenter.
To select icon or grid view, click the icon symbol or the grid symbol in the top right hand corner.
To jump directly to the virtual appliance or virtual datacenter of the VM, go to Grid view and use the shortcut links by clicking on the name fields.
To filter the VMs, enter text from the VM details with wildcards as required. See Search for VMs and filter the search
Move a VM to another virtual appliance
To move a VM to another VApp in the same virtual datacenter:
Select the VM
On the VM control panel, click the VM move button
Select the virtual appliance or create a new one, and click Accept
If you have the privilege to restrict VMs, you may also be able to move the VM to a restricted VApp in the same virtual datacenter.
Restrict a VM
To restrict a VM by moving it to a restricted VApp:
Click the VM move button on the VM control panel
Select the option to move the VM to a restricted VApp OR select a restricted VApp from the list, or create a new one
Click here to show/hide the screenshots
Delete a VM
To delete a VM, move the mouse over the VM and from the VM options menu, select Delete.
If the virtual appliance or VM is deployed, you do not need to undeploy it. You can directly delete a VM that is deployed.