Versions Compared

Key

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

...

This document describes how to upload a single disk from a local file to create a VM template. You can later edit the template to add more disks.

Panel
bgColor#FFFAE6

Privileges: Upload virtual machine template

Before you begin:

  1. Check your disk is in a compatible format

  2. You must enter the disk Capacity, which is the deployed size of the disk. See Determine the size of a VM Disk File.

Notes

  • For very large files, it may be convenient to use another method of adding templates

  • If you do not have any hypervisors, the platform will convert the template into ALL possible hypervisor formats. So before you add templates, add your hypervisors to save space on the NFS repository. See V2V Conversion.

To add a new template from a disk in a local file:

  1. Go to

...

  1. Catalogue

  2. Select the datacenter 

  3. On the Virtual machine templates tab, at the bottom of the templates panel, click the + add button

  4. Select Create from local or ISO file

General information

Enter the General information to create a new VM template

...

Field

Value

Name

A short name to identify the VM template.

Description

A description of the services and applications installed on the VM template

Category

Select a category to organize the template. See Manage VM templates#OrganizeVMtemplatesintocategories.

CPU

Number of CPUs to assign to VMs from this template. If you are not sure, you can edit the template later

RAM

RAM for VMs from this template in MB, GB, or TB. If you are not sure, you can edit the template later

Cores per socket

Must be a divisor of CPUs

Icon

The URL of the template's icon in PNG, JPG or GIF format. Enter a complete URL with an IP address that is not localhost or 127.0.0.1. It may be a URL on a platform server.

  • Recommendation: square images, 128x128 pixels, with a transparent background

  • If you share the template, the same icon will display for all users.

Disks

Go to Disks and click the + add button

  1. Select Disk from local file

  2. Enter the details of the disk

  3. Click Save. The platform will load the disk as the boot disk.

...

  1. Image Added

Field

Value

Type

The type of the template disk. See Disk Format Information.
To use the disk in the platform, it must have a correct type (not Unknown).
(warning) If you have not added any hypervisors yet, the V2V conversion process will generate conversions for ALL supported hypervisors

Capacity

The hard disk size required for the deployed disk in MB, GB, or TB. See Determine the size of a VM Disk File.

  • Fixed formats, the capacity is the physical size of the template disk.

  • For sparse and compressed formats, the capacity is the provisioning size.

File name

Click Select file and use your browser to choose the file to upload.

Require DS tier

Select Datastore tier will be required when creating a virtual machine to ensure that the user will select a datastore tier.

Allocation type

The user with appropriate privileges can modify this value in a VM before they deploy it

Controller type

Select a controller type from: IDE, SCSI, SATA (ESXi), and VIRTIO (KVM)

Controller

On ESXi you can enter a SCSI controller type. The default value is the lsilogic controller.

Name

The name of the disk

Image RemovedImage Added

The platform saves the disk you uploaded as disk 0 in the boot Sequence.

...

Optionally go to Variables and enter variables as Key and Value pairs.

...


The variables platform will be added automatically add these variables to new VMs. Users can edit the variables when configuring the VM.

After the user deploys the VM deploys, users they can then access variables in the guest. Cloud-init may use variables to configure the VM

(warning) We recommend that you do not store confidential information in variables.

Advanced

Go to Advanced

  1. Configure the Operating system and OS version for VMware and icon display. See:

    1. Guest operating system definition for VMware

    2. Extended OVF Support and Template Definition

    3. Configure default template icons by operating system type

    To use the latest version of an operating system, do not set the OS version.

  2. Enter the default User and Password of the template for VM remote access

  3. Select the NIC driver. For all private cloud hypervisors, the platform supports E1000 drivers. 
    On ESXi and vCloud, it also supports PCNet32 and VMXNET3. On KVM, it also supports VIRTIO drivers

...

Image Added

To create the template, click Save.

...