Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To create a VM template category:

  1. Go to Catalogue → Private or Public → select datacenter or public cloud region → Virtual machine templates

  2. Check that there is no other category with the name you wish to use

  3. Open the Categories menu

  4. At the bottom of menu, click the + add button

  5. Enter the category name

  6. Optional: to create a global category, mark the checkbox to Make the category global

  7. Click Save to continue

    Create categoryImage Modified

The new category will be added to the Categories list.

To add a VM template to a category:

  1. Edit the template

  2. Go to General

  3. Select the category.

When you delete a category, all the templates belonging to this category will be changed to the category ''Others''.

...

To export a template to a datacenter or public cloud

  1. Go to 

...

  1. Catalogue → select the private cloud datacenter where the VM template is stored.

  2. Select the VM template and from its options menu, select Export

    Export VM templateImage Modified
  3. From the dialog, select Private or Public cloud.

    1. For public cloud

      1. select the public cloud provider and region

      2. select one bootable system disk.

    2. For private cloud

      1. select the datacenter

      2. select disks from the template to export.  

  4. Click Export

For private cloud, select the datacenter

...

To delete a shared template or make it unavailable, you must be logged in to the owner enterprise. If you make it unavailabe, it will only be marked as unavailable for all users when the template owner performs a refresh of the Apps LibraryCatalogue.

To remove a template that is not in use, click the template edit menu button and select Delete from the menu. 

...

Abiquo will remove the template from the Apps Library Catalogue and the NFS repository file system.

...

To make a template unavailable in the UI:

  1. Select the edit menu button of a template that is in use and select Delete from the menu. A confirmation popup will open with details of the template use.

  2. Confirm that you would like to force the delete. Abiquo will delete the disk files but not the template definition. The platform will mark this template as unavailable.

    Virtual machine template in useImage Modified

In the Apps libraryCatalogue, the platform will not display the unavailable template in the default view. To display the template again, click the filter button and mark the checkbox to display Deleted templates, which are unavailable templates with no disk files. The platform will mark the template icon with a red X symbol.

...

Expand
titleClick here to show/hide the example

Screenshot: Deploy an instance of the Core in a new VM. There are now two VMs - one with the core template and one with an instance of the core template VM

Deploy an instance of the Core in a new VMImage Removed

Screenshot: The core template has two instances: Core_Instance_1 and Core_Instance_1_Instance_1

Instances of the Core

Now the administrator would like to delete the template, but there are VMs and instances. So the administrator will make the template unavailable. The platform will delete the disk files and users cannot create new VMs from the template.

Screenshot: The administrator clicks the template edit menu and selects Delete

Delete template

Screenshot: The platform displays the details of deployed VMs and instances on the "Virtual machine template in use" popup. The administrator clicks Yes to continue.

The template disk files and the disk conversions will be deleted from the Apps LibraryCatalogue. You cannot recover them within the platform

Virtual machine template in use

Screenshot: To view the unavailable template, click the template filter and select the Deleted checkbox. Click on the unavailable template to view the instances and they will display in the Instances panel below the master templates.

...

To display the instances under a master template:

  1. Click on the master template and the Instances panel will open with the instance templates.

Expand
titleClick here to show/hide the screenshot
Virtual machine templates in Apps library view

...

Tip

This feature is available in the API. See https://wiki.abiquo.com/api/latest/VirtualMachineTemplatesResource.html#create-a-virtual-machine-template-in-a-datacenter-repository-by-download-promote-or-export

To promote an instance:

  1. Select the original master template to display its instances

  2. Select the instance, and from its options menu, select Promote to master

  3. Enter a Name for the new master template. Select the disks to promote 

    • Remember that there must always be at least one disk and that the disk at position 0 must be a boot disk. 

    • The name should help users to identify this template among the other templates 

The platform will display the completed template in the Apps library Catalogue view and you can edit it as required

Expand
titleClick here to show/hide screenshots

From the instance template's options menu, select Promote to master

Virtual machine templates in Apps library view

Enter a Name to identify the template

Promote to master template

The platform displays the promoted instance in the main section of the Apps library Catalogue

Promote to master template

Manage instances of deleted templates

...

Expand
titleClick here to show/hide the screenshots

Confirm that you would like to delete the instance template

Virtual machine template in use

To display the unavailable instance:

  1. Select the filter to display Deleted VM templates

  2. Select the master template

Instances for virtual machine template - core
  • You cannot force the delete of an instance if it is in use in a VM. 

  • If you try to delete an unavailable instance, an error popup will appear because the template is already unavailable. 

  • To make the instance available again, replace the unavailable template files on the file system. When it detects the template files, the platform will mark the instance as available.

...

To remove a failed instance template:

  1. Select the template 

  2. From the options menu, select Delete 

...

Manage instance templates in public cloud

...

To find an Abiquo instance that was deleted from the Catalogue but not from the public cloud provider:

  1. Go to Catalogue view, click on Import template

  2. Select Private

  3. To search for the template by the Name field, enter the name you gave your Abiquo instance template when you created it, or the Template ID

  4. Click Search

Note

Troubleshooting

If a template is still in the Catalogue, it will not display in the results of the remote search.

...

In public cloud, to delete a private template (or custom template), such as an Abiquo instance:

  1. Move the mouse over the template and from the options menu, select delete  

  2. Optionally select the checkbox to Delete this template in the cloud provider

  3. Confirm the delete

By default, the platform will delete the template from the Apps library Catalogue only and it will remain in the cloud provider.

...

Other Pages related to VM template management