| Table of Contents | ||
|---|---|---|
|
...
Modify a virtual machine template
Before you begin:
- Find out which enterprise owns the template
...
- .
- Log in to the owner enterprise, or switch enterprises to this enterprise.
- You can switch enterprises in Home View or Users view.
To modify a VM template:
- Select the template and click on the control menu button in the top-right corner and select Edit.
| Panel |
|---|
Privilege: 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.
General information
The General information tab contains the basic template details. A user can only modify a template from
Field | Value |
|---|---|
Name | A short name to identify the VM template. This will be the default name of a VM created from this template. |
Description | A description of the services and applications installed on the VM template |
Category | Logical grouping of VM templates to enable you to organize them. "Others" is a default category that cannot be deleted |
Icon | Enter the URL for the template's |
...
icon. This must be a URL with a public IP address, not localhost or 127.0.0.1. It may be the URL of the Abiquo Server. A default icon is assigned if the template does not have one. Abiquo recommends that you use square icon images with a size of 128x128 pixels. A transparent background also makes icons look better. The compatible image formats are PNG, JPG and GIF. If the template is a shared template, then all users will see the icon. Changing the icon of a master template will not change the icon of instances you created earlier. However, new instances will be created with the new icon. |
It also contains the CPU and RAM, or hardware profile selection.
Set CPU and RAM
Field | Value |
|---|---|
CPU | Number of CPUs assigned to this template. |
RAM | RAM memory size assigned for this template in MB or GB. |
Min CPU | Minimum value of CPU or RAM. If 0 or empty, then there is no constraint. The platform stores 0 as an empty value, so if you enter "0", it will disappear! You cannot set a minimum below the current template value. Changes apply to new VMs, they are not retroactive. However, 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 |
| Max CPU Max RAM | Maximum value of CPU or RAM. If 0 or empty, then there is no constraint. The platform stores 0 as an empty value, so if you enter "0", it will disappear! Changes apply to new VMs, they are not retroactive. However, 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 |
| Cores per socket | The number of cores per socket. The number of CPUs must be divisible by the number of cores per socket. The maximum value is 32 |
Set hardware profile
Field | Value |
|---|---|
| Hardware profile | Select a hardware profile |
CPU | Number of CPUs assigned to this template. |
RAM | RAM memory size assigned for this template in MB or GB. |
Manage VM template disks
The Disks tab contains details of disks currently attached to the machine and enables the user to edit, delete, and add new disks, as well as download disks to their local file system, depending on the user's privileges.
States of disks in private cloud
The platform uses the state of the disks to determine the template's state. The disks can be in the following states:
- DONE: the disk is ready, but conversions may still be in progress
- IN PROGRESS
- UNAVAILABLE: the disk is defined in the template but not present in the Apps library
- FAILED: the disk was not properly created because of an issue during its creation
- The state of a disk conversion can be as follows
- ENQUEUED
- FINISHED
- FAILED
Manage VM template disks in private cloud
To edit VM template disks in private cloud, edit a template and go to Disks
To change the boot order of a disk, click the pencil icon near the sequence number. There must always be a boot disk in the 0 position, and the boot disk cannot be an empty disk.
To download a disk, select the disk and click the download symbol on the right-hand side of the disk details
- To manually launch conversions to new template formats if you have added any new hypervisor types after the initial conversion process ended, click Generate missing conversions.
- To restart a failed conversion, click the Restart conversion link
- To add a disk to a template, click the + button in the top right of the disk dialog and select one of the options: Disk from local file, Disk from iso file, Empty disk or Template disk.
| Expand | ||
|---|---|---|
| ||
Enter the details of the local file.
| Include Page | ||||
|---|---|---|---|---|
|
Disk from ISO file
Enter the details of the local ISO file.
Include Page GUI Uploading from the Local Filesystem Disks ISO GUI Uploading from the Local Filesystem Disks ISO
Empty disk
To add an empty disk to a VM template, enter the size of the disk and the disk controller type and controller information.
Abiquo will store the disk definition in the template and when you deploy a VM based on this template, Abiquo will create the disk on the hypervisor datastore.
| Expand | ||
|---|---|---|
| ||
Template disk
To add a template disk to a VM template, select a template from the Apps library and then select a disk from the template.
Abiquo will select the original disk, not the conversions. If you require other formats, generate conversions for these formats.
| Expand | ||
|---|---|---|
| ||
Public cloud region
To edit a public cloud template in the Apps library do these steps:
...
The fields you can modify are described in the table below.
General information
| Include Page | ||||
|---|---|---|---|---|
|
Disks table
| Include Page | ||||
|---|---|---|---|---|
|
...