This page describes how to modify a VM template in private cloud.
For public cloud, see Modify a VM template in public cloud
Modify a virtual machine template
Before you begin:
Log in or switch enterprises to the tenant that owns the template
To modify a VM template:
Select the template and click on the control menu button in the top-right corner and select Edit
Privileges: Manage VM templates from Apps library
In private cloud datacenters, standard templates have disks that will deploy to the hypervisor datastore, in contrast to persistent templates that have disks on external storage volumes. This documentation describes standard templates.
Edit template general information
Enter the general information about the template as follows:
Enter a Name to identify the template. This is the default name in the hypervisor of the VMs that users create from the template
Optionally, select the Category in which the template will appear for users
If you are not using hardware profiles only, enter default values for CPU and RAM
For the Min values of CPU or RAM. If 0 or empty, then there is no minimum. You cannot set a minimum below the current template value. Changes apply to new VMs, not existing VMs.
For the Max values of CPU or RAM. If 0 or empty, then there is no maximum. Changes apply to new VMs, not existing VMs.
For Cores per socket, the number of CPUs must be divisible by the number of cores per socket. The maximum value is 32
For the Icon, enter a URL with a public IP address, not localhost or 127.0.0.1. It may contain the IP address of the API server.
We recommend square images of size 128x128 pixels with a transparent background. Compatible formats are PNG, JPG, and GIF.
If an administrator shares the template with other tenants, then this icon will display for their users
If you change the icon of a template with instance templates, when you create the next instance, it will have the new icon
If you do not set an Icon, the platform will use the default VM icon from the UI theme
If the Operating System is set on the Advanced tab, and you don't set an icon, the platform may display the icon for a specific OS type or a generic OS type. The platform will not assign this icon to VMs.
See Configure default template icons by operating system type
Troubleshooting minimum and maximum CPU and RAM values
The platform stores 0 as an empty value, so if you enter "0", it will disappear!
If users edit existing VMs that already had out-of-range values, the platform displays a warning but does not enforce the range.
Changes can affect recommended hardware profiles on the Advanced tab, so you may need to review them
Users with the Override VM constraints privilege can enter values outside this range
Modify VM template disks
Edit VM template variables
Share VM templates from the scopes tab
Activate hardware profiles for a VM template
When you edit a VM template, you can recommend some hardware profiles for users when they create VMs from this template. You can also activate only the recommended hardware profiles.
By default, users can access all hardware profiles that are active in the infrastructure (see Create a hardware profile) and allowed for their enterprise (see Configure an enterprise in a cloud location).
To activate a set of selected hardware profiles for a VM template:
Go to Apps library → Public/Private → select region or datacenter → Templates
Edit a template
Go to Recommended
Select the hardware profiles to recommend for this template. When the user creates a VM, the platform will display (Recommended) beside them.
For shared templates, remember that the administrator must allow the user's tenant to access the hardware profiles. See Configure an enterprise in a cloud location.To activate and display the recommended hardware profiles only, select the Enable only recommended HPs option
Activate datastore tiers for a VM template
Add a bootstrap script to a VM template
Add a bootstrap script to a VM template and the platform will add it to all VMs created from the template to use with the Cloud-init or similar options for Guest setup.
Before you begin:
Prepare a template that is compatible with cloud-init version 0.7.9 or above, or cloudbase-init, or a similar system
In private cloud, the platform will create an ISO disk for Configuration drive
To add a VM bootstrap configuration or script:
Go to Catalogue → Edit VM template
Go to Bootstrap
Paste your configuration or script in the Bootstrap script text box
Continue to configure the VM template or click Save to finish
Note: when you save VM disks to an instance template, Abiquo copies the VM bootstrap script to the instance template.
Edit template advanced tab
Add tags to a VM template
Manage VM templates with the API
API Documentation
For the Abiquo API documentation of this feature, see Abiquo API Resources and the page for this resource VirtualMachineTemplatesResource.
Pages related to VM templates
Main Apps library page with links to related pages: Catalogue view