Abiquo 2.6


Skip to end of metadata
Go to start of metadata

Introduction to Template Categories

In the appliance library, virtual machine templates can be classified into logical groups called categories. In Abiquo there are two types of categories: local categories and global categories.

  • Local categories:
    • belong to one enterprise only
    • cannot be seen or used by other enterprises
    • can be managed with the Manage VM template categories privilege
  • Global categories:
    • are visible to all users
    • are marked with the text (Global Category) in the category list
    • are created when you download an image with a category name that does not exist yet
    • can be managed with the Manage VM template global categories privilege
    • are also called system categories

The image below shows the local category "Enterprise Firewall" selected from a list that also includes several global categories.


 

You can manage categories using the buttons next to the Category pull-down list. You can create or delete a category.

Modify Categories in the API

You can only create or delete categories in the GUI; you cannot modify categories. If you have the "Administer all enterprises" privilege, you can use the API to change a category from local to global if there is no global category with the same name. You cannot move a local category from one enterprise to another or change a category from global to local.

Manage Local Categories

To manage local categories, you must have the Manage VM template categories privilege. By default, the Cloud Admin and Enterprise Admin have this privilege.

Create a Local Category

To create a local category:

  1. Check that there is no other local category in your enterprise or global category with the name you wish to use.
  2. Click the Add button and enter the category name.
  3. Click Accept to continue. The new category will be added to the end of the pull-down list.

Delete a Local Category

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

  1. Select the category from the Category pull-down list.
  2. Click the delete button
  3. Click Yes to confirm

Manage Global Categories

To manage global categories, you must have the Manage VM template global categories privilege. By default, the Cloud Admin has this privilege.

Create a Global Category

To create a global category:

  1. Check that there is no other category with the name you wish to use.
  2. Click the add button and enter the category name.
  3. Mark the checkbox to Make the category global
  4. Click Accept to continue. The new category will be added to the end of the pull-down list.

Download Automatically Creates a New Global Category

If you download a VM template from a remote template repository and it belongs to a global category that does not exist yet in Abiquo, the platform will create the new global category with this name.

Delete a Global Category

When you delete a global category, all the templates belonging to this category will be changed to the category ''Others''. Others is the default global category and it cannot be deleted.

To delete a system category:

  1. Select the category from the Category pull-down list.
  2. Click the delete button
  3. Click Yes to confirm

 

Add a VM Template to a Category

To add a VM template to a category, move the mouse over the template and click the edit button .

Select the new category from the pull-down list.