Versions Compared

Old Version 97

changes.mady.by.user MS

Saved on

compared with

New Version 98

changes.mady.by.user MS

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: 6.0.3 - release
Table of Contents
maxLevel3

...

Excerpt
nameModify a virtual machine template

Before you begin:

  1. Log in or switch enterprises to the tenant that owns the template

To modify a VM template:

  1. Go to Catalogue → Virtual machine templates

  2. Select Private or Public cloud

  3. Select a datacenter or cloud location

  4. Select the template and click on the control menu button in the top-right corner and select Edit

Panel

Privileges: Manage VM templates from Apps libraryCatalogue, Manage virtual machine template extra charges

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:

  1. Enter a Name to identify the template. This is the default name in the hypervisor of the VMs that users create from the template

  2. Optionally, select the Category in which the template will appear for users

  3. If you are not using hardware profiles only, enter default values for CPU and RAM

    1. 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.

    2. 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.

  4. For Cores per socket, the number of CPUs must be divisible by the number of cores per socket. The maximum value is 32

  5. 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

Note

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

...

Excerpt
nameEdit template Advanced tab

You can also specify some Advanced template values using the OVF and the API. See Extended OVF support and template definition.

Field

Value

Guest setup

Select Guest setup option of Cloud-init or Hypervisor tools.

Guest initial password

If Guest setup is selected, select this option to request an initial password

Cost codecodes

(info) The cost codes for extra charges are now on the separate Cost codes Extra charges tab. For more details, see Multiple cost codes.

Operating system

Sets the VMware guest operating system type. Select from the pull-down list.
For more details, see Guest operating system definition for VMware and Extended OVF support and template definition.
This attribute also enables users to search for templates in public cloud (e.g. Ubuntu 64-bit template).
To use the latest version of an operating system, select a generic type, e.g. WINDOWS, and do not enter the version. 
If the template does not have an icon, the platform will load the default icon defined for the OS or the generic OS type.

Os Version

OS version is used to:

  • add operating systems not included in the list of codes

  • provide details of operating systems

  • set the VMware guest operating system type

See Guest operating system definition for VMware and Extended OVF support and template definition for further details. 

User

Default user for a VM created from this template for SSH access.

  • To use the Guest initial password option, set an appropriate administrator user.
    For Windows it should be Administrator. For Linux, it should be a sudoer always with password.
    See Edit VM templates for guest setup

Password

Default password for the default User of a VM created from this template.

NIC driver

  • Abiquo always supports E1000 drivers

  • On ESXi, Abiquo also supports PCNet32 and VMXNET3

  • On KVM, Abiquo supports VIRTIO drivers.

Enable UEFI boot

When selected, disable BIOS boot and enable UEFI boot.

  • Requires templates with UEFI firmware and operating system support for UEFI boot.

  • Abiquo recommends that users:

    • Do not change the template's disk controllers

    • Meet the minimum hardware requirements for the OS

    • Correctly indicate the 32/64 bit architecture

For VMs, the uefiEnabled attribute is read-only and it is available via the API.

Enable hot add / reconfigure in VM

See separate section

Creation user

SYSTEM means that the platform created the template, for example, from an OVF file in the NFS repository.

Creation date

Date and time when the template was created.

...

Excerpt
nameHot add and hot reconfigure options table

Hot add and hot reconfigure options table

Option

Description

Enable hot-add or
hot reconfigure in VM

Supported providers only with supported guest operating systems. 
Check that the Operating system and OS version are correctly set for your system
ESXi: See VMware documentation. After you hot-add or hot-reconfigure, remember to update your guest system as required

CPU hot-add

Enable users to add CPUs in the platform while the VM is powered on

RAM hot-add

Enable users to add RAM in the platform while the VM is powered on

Disks hot-reconfigure

Enable users to remove SCSI disks from the boot sequence and add SCSI disks to the end of the boot sequence while the VM is powered on

  • IDE disks are not supported

  • The platform will save other changes to the boot sequence but it will not implement them in the hypervisor. 

  • To implement these changes, power off the VM and make another configuration change that will trigger a reconfigure

NICs hot-reconfigure

Enable users to add and remove NICs in the platform while the VM is powered on

Remote access hot-reconfigure

Enable users to reset remote access in the platform while the VM is powered on.
On ESXi, if the user changes the VNC password, the change will apply after the power on

...

Add cost codes for extra charges for a VM template

Excerpt
nameAdd cost codes for extra charges for a VM template

When you edit a VM template, you can add cost codes for extra charges for cloud billing.

Panel
bgColor#DEEBFF

Privileges: Manage virtual machine template extra charges

  1. Create cost codes for extra charges. See “Create a new extra charge” in Pricing view

    1. For the Type select VM template or All

  2. Set extra charge values. See Create a new pricing model

  3. Go to the Catalogue

  4. Edit a VM template

  5. Go to Extra charges

  6. Add cost codes for extra charges as required.

...

Add tags to a VM template

Excerpt
nameAdd tags to a VM template

When you edit a VM template, you can add tags to group resources and manage them in Control view.

To manage tags for a template:

  1. Go to Apps library → select a datacenter or public cloud region

  2. Go to Templates

  3. Edit a template

  4. Go to Tags

  5. Add tags 

    For more details see Edit resource tags

...


Manage VM templates with the API

Tip

API Documentation

For the Abiquo API documentation of this feature, see Abiquo API Resources and the page for this resource VirtualMachineTemplatesResource.

...