Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3

...

Modify a virtual machine template

Include Page
doc:Modify a virtual machine template general
doc:Modify a virtual machine template general

...

Excerpt
nameShare VM templates

In the Catalogue view, shared templates are marked with the outstretched hand symbol. 

Panel

Privileges: Allow user to switch enterprises

By default, templates are local to the tenant that creates them (the "owner" enterprise). To share templates, assign scopes to them. 

Tip

Users who belong to the owner enterprise or enterprises in a template's scopes can display and use the template. 

To share a template with a scope:

  1. Go to Users → Scopes

  2. Create a scope

    1. For enterprises to use the template, select them in the scope

  3. Log in or switch to the enterprise that owns the template

  4. Go to Catalogue → Templates

  5. Edit a template

  6. Go to Scopes

  7. Select the scope

For more information, see Manage scopes and Manage resource scopes

To share a template with the enterprises in one or more scopes, select template scopes.

To remove enterprise access to a template, remove the scope containing the enterprise. 

  • You cannot remove a scope from the template if an enterprise in the scope is using the template, for example, if it has deployed VMs or instances of VMs. 

To make a template private to the owner enterprise, unselect all scopes.

In private cloud, the instances of shared templates belong to the enterprise that created them. When a template has instances, it is "in use" by the enterprises with instances. This may mean that you cannot delete a template without deleting or promoting the instances first.

When you make a shared template unavailable, other enterprises cannot deploy it, but it may not be marked as "unavailable" in the Catalogue of other enterprises until you refresh your Catalogue.

...

To activate a set of selected hardware profiles for a VM template:

  1. Go to Apps library → Public/Private → select region or datacenter → Templates

  2. Edit a template

  3. Go to Recommended

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

  5. To activate and display the recommended hardware profiles only, select the Enable only recommended HPs option

...

...


Activate datastore tiers for a VM template

...

To activate a set of selected datastore tiers for a template:

  1. Go to Apps library → Private → select region or datacenter → Templates

  2. Edit the template

  3. Go to Recommended

  4. Select the datastore tiers to recommend for this template. The platform will display these datastore tiers in the selection list with (Recommended) beside them. Remember that the administrator must allow the user's tenant to access the datastore tiers

  5. To activate and display the recommended datastore tiers only, select the Enable only recommended DS tiers option

...

...


Add a bootstrap script to a VM template

Excerpt
nameAdd 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:

  1. Prepare a template that is compatible with cloud-init version 0.7.9 or above, or cloudbase-init, or a similar system

  2. In private cloud, the platform will create an ISO disk for Configuration drive

To add a VM bootstrap configuration or script:

  1. Go to Catalogue →  Edit VM template

  2. Go to Bootstrap

  3. Paste your configuration or script in the Bootstrap script text box

    Image Modified
  4. 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.

Insert excerpt
doc:VM bootstrap script
doc:VM bootstrap script
nameTEXT bootstrap scripts
nopaneltrue

...

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 codes

(info) The extra charges with cost codes for extra charges are now on the separate Extra charges tab.
For more details, see Multiple see Manage extra charges with 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.

...

To allow users to reconfigure their VMs without powering off:

  1. Go to Apps library and select Private or Public

  2. Select datacenter or public cloud region

  3. Select and edit the VM template

  4. Go to Advanced tab

  5. Select the options under Enable hot-add/reconfigure

  6. Save the template

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 extra charges with cost codes 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: View virtual machine template extra charges, Manage virtual machine template extra charges

  1. Create cost codes for extra charges.

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

    1. For the Type select VM template or All

  2. Set values for cost codes for extra charges. See Create a new pricing model

  3. Go to the Catalogue

  4. Edit a VM template

  5. Go to Extra charges with cost codes

for Extra charges
  1. Add extra charges with cost codes

for extra charges
  1. 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 

    Image Modified

    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.

...