Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Documentation

Skip to end of metadata
Go to start of metadata

This section describes the basic concepts of the Apps Library that are common to datacenters and public cloud regions.

Virtual Machine Template

A virtual machine template is used to deploy a virtual machine together with a hardware specification. A virtual machine template consists of:

  • a virtual machine template definition
  • virtual machine template disk files, which include the system disk and auxiliary disks

The following virtual machine templates are also available in datacenters and public cloud regions as marked in the table:

API Documentation

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

Virtual machine templates are represented by VM template icons in the appliance library view. 

Virtual Machine Template Definition

A template definition contains the definition of a template for creating a virtual machine. 

The template definition includes the following information:

  • Disk templates (including a link to the disk, that contains the provisioned size, format, etc.)
  • Hardware (CPU, RAM)
  • Product (additional metadata: name, description, icon, category, installed software)

After a template definition is loaded into the appliance library with the disk files, it is known as a virtual machine template. Abiquo generates a virtual machine template based on information provided when the template definition and the disk files are loaded into Abiquo.

API Documentation

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

 Click here to show/hide an example template definition
{
    "links": [
        {
            "title": "Mary-Jane Ent",
            "rel": "enterprise",
            "type": "application/vnd.abiquo.enterprise+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6"
        },
        {
            "title": "Others",
            "rel": "category",
            "type": "application/vnd.abiquo.category+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/config/categories/1"
        },
        {
            "title": "Core",
            "rel": "edit",
            "type": "application/vnd.abiquo.virtualmachinetemplate+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68"
        },
        {
            "title": "tasks",
            "rel": "tasks",
            "type": "application/vnd.abiquo.tasks+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/tasks"
        },
        {
            "title": "repository",
            "rel": "datacenterrepository",
            "type": "application/vnd.abiquo.datacenterrepository+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1"
        },
        {
            "title": "virtual machines",
            "rel": "virtualmachines",
            "type": "application/vnd.abiquo.virtualmachines+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/action/virtualmachines"
        },
        {
            "title": "get instances",
            "rel": "instances",
            "type": "application/vnd.abiquo.virtualmachinetemplates+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/action/instances"
        },
        {
            "title": "disks",
            "rel": "disks",
            "type": "application/vnd.abiquo.disks+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks"
        },
        {
            "rel": "disk0",
            "type": "application/vnd.abiquo.disk+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/75"
        },
        {
            "title": "Hd",
            "rel": "disk1",
            "type": "application/vnd.abiquo.disk+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/131"
        },
        {
            "rel": "disk2",
            "type": "application/vnd.abiquo.disk+json",
            "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/154"
        },
        {
            "title": "template definition",
            "rel": "templatedefinition",
            "href": "http://rs.bcn.abiquo.com:9000/ovf/305/desc.ovf"
        },
        {
            "title": "template path",
            "rel": "templatePath",
            "href": "https://preprod-abiquo.bcn.abiquo.com/am/erepos/6/templates/6/rs.bcn.abiquo.com/abiport9000/ovf/305/"
        }
    ],
    "chefEnabled": false,
    "cpuRequired": 1,
    "creationDate": "2015-04-16T12:29:45.000+0000",
    "creationUser": "14",
    "description": "root : abiquo",
    "ethernetDriverType": "E1000",
    "iconUrl": "http://rs.bcn.abiquo.com:9000/public/icons/tinycore.png",
    "id": "68",
    "loginPassword": "password",
    "loginUser": "user",
    "name": "Core",
    "osType": "UNRECOGNIZED",
    "osVersion": "",
    "ramRequired": 64,
    "shared": false,
    "state": "DONE"
}

 

The virtual machine disks are stored in separate disk objects. This template has two standard disk files and an empty disk that will be created when you deploy the virtual machine. The empty disk has no diskfile link.

 {
    "links": [],
    "collection": [
        {
            "links": [
                {
                    "title": "disk",
                    "rel": "edit",
                    "type": "application/vnd.abiquo.disk+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/75"
                },
                {
                    "title": "conversions",
                    "rel": "conversions",
                    "type": "application/vnd.abiquo.conversions+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/75/conversions"
                },
                {
                    "title": "Core",
                    "rel": "diskfile",
                    "href": "https://preprod-abiquo.bcn.abiquo.com/am/files/6/rs.bcn.abiquo.com/abiport9000/ovf/305/Core.qcow2"
                }
            ],
            "sequence": 0,
            "path": "6/rs.bcn.abiquo.com/abiport9000/ovf/305/Core.qcow2",
            "diskFormatType": "QCOW2_SPARSE",
            "diskFileSize": 12976128,
            "hdRequired": 104857600,
            "state": "DONE",
            "diskControllerType": "SCSI",
            "diskController": "lsilogic",
            "creationDate": "2015-04-16T12:29:45.000+0000"
        },
        {
            "links": [
                {
                    "title": "disk",
                    "rel": "edit",
                    "type": "application/vnd.abiquo.disk+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/131"
                },
                {
                    "title": "conversions",
                    "rel": "conversions",
                    "type": "application/vnd.abiquo.conversions+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/131/conversions"
                },
                {
                    "title": "48085465-d48f-4d1c-acf0-f0c222fac674-file-disk",
                    "rel": "diskfile",
                    "href": "https://preprod-abiquo.bcn.abiquo.com/am/files/6/rs.bcn.abiquo.com/abiport9000/ovf/305/48085465-d48f-4d1c-acf0-f0c222fac674-file-disk.qcow2"
                }
            ],
            "label": "Hd",
            "sequence": 1,
            "path": "6/rs.bcn.abiquo.com/abiport9000/ovf/305/48085465-d48f-4d1c-acf0-f0c222fac674-file-disk.qcow2",
            "diskFormatType": "QCOW2_SPARSE",
            "diskFileSize": 12976128,
            "hdRequired": 104857600,
            "state": "DONE",
            "diskControllerType": "SCSI",
            "creationDate": "2015-04-22T13:48:44.000+0000"
        },
        {
            "links": [
                {
                    "title": "disk",
                    "rel": "edit",
                    "type": "application/vnd.abiquo.disk+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/154"
                },
                {
                    "title": "conversions",
                    "rel": "conversions",
                    "type": "application/vnd.abiquo.conversions+json",
                    "href": "https://preprod-abiquo.bcn.abiquo.com:443/api/admin/enterprises/6/datacenterrepositories/1/virtualmachinetemplates/68/disks/154/conversions"
                }
            ],
            "sequence": 2,
            "diskFormatType": "RAW",
            "diskFileSize": 0,
            "hdRequired": 125829120,
            "state": "DONE",
            "creationDate": "2015-04-23T09:10:28.000+0000"
        }
    ]
}

Appliance Library

The Appliance Library view displays the virtual machine templates available for the current enterprise in the selected datacenter or public cloud region. 

Users can see the Appliance Library for their enterprise in the datacenter or public cloud region, which is the Enterprise Appliance Library.

Appliance Library

An enterprise repository contains all template definitions available for the selected datacenter, organized by categories and either shared or private.

Abiquo Instance of Virtual Machine Template

Abiquo Instances are templates created from copies of virtual machine template disks. Their template definitions are also cached in the Abiquo appliance library. You can use instances just like any other template for creating new virtual machines.

In a datacenter, an instance is linked to the original master template, as shown in the above screenshot. The master template is marked with an M symbol in the top left-hand corner. An instance is marked with an S symbol in the top left-hand corner.

In a public cloud region, an instance is independent of the original master template.