Difference between revisions of "ProxCP KVM Templates"

Latest revision as of 21:43, 25 July 2020

Overview

ProxCP offers support for KVM creation and rebuilding from templates. Pre-built ProxCP KVM templates are available on our template distribution site. You are not required to use these templates but these are the only templates we offer support for.

Proxmox does not currently offer a mechanism to share KVM templates between Proxmox nodes. Therefore, you need to download our KVM templates onto every Proxmox node individually. To make managing this easier, use the same Proxmox VMIDs for every KVM template between Proxmox nodes. For example, if you have a CentOS 7 template, try to make the template VMID the same number on all Proxmox nodes.

If you followed our recommendation to assign VMID ranges to Proxmox nodes, the VMIDs of your KVM templates should be less than the VMID range.

Continuing our example with node1 (VMID range 1000-2999), the KVM template VMIDs on node1 should be less than 1000

KVM Templates - Admin

In the ProxCP KVM Templates Admin menu, you can set the template VMID on a per-node level. It is possible that the same KVM template will have a different VMID on different Proxmox nodes.

As of writing, all ProxCP Linux KVM templates support Cloud-Init.

This page allows Admins to delete KVM templates from ProxCP. This action only removes the template from ProxCP and does not remove the template VM from the Proxmox node.

KVM Templates Installation

Download the desired template from our distribution site to your Proxmox server (i.e. wget)
Run the following command on your Proxmox server

qmrestore {template file} {VMID}

The restored VM should appear in Proxmox as a template with all correct settings already. Then, add the template in ProxCP.

Creating Your Own KVM Templates

Creating Your Own ProxCP KVM Templates

Proxmox VE 5.x Notes

You may need to delete and re-create the cloud-init drive depending on the Proxmox VMID you chose.

Proxmox VE 6.x Notes

The qmrestore command will fail in Proxmox 6.x unless template files are named a specific way.

Example: centos-7-amd64.vma.lzo must be renamed to vzdump-qemu-200-2020_06_10-10_00_00.vma.lzo
Required format: vzdump-qemu-{vmid}-{year}_{month}_{day}-{HH}_{MM}_{SS}.vma.lzo

The VMID in the vzdump file name and the qmrestore command must match

@@ Line 1: / Line 1: @@
-== KVM Templates Overview ==
+== Overview ==
-ProxCP offers support for KVM creation and rebuilding from templates. Pre-built ProxCP KVM templates are available on our [https://templates.proxcp.com template distribution site].
+ProxCP offers support for KVM creation and rebuilding from templates. Pre-built ProxCP KVM templates are available on our [https://templates.proxcp.com template distribution site]. You are not required to use these templates but these are the only templates we offer support for.
-Proxmox does not currently offer a mechanism to share KVM templates between Proxmox servers. Therefore, you need to download our KVM templates onto every Proxmox node individually.
+Proxmox does not currently offer a mechanism to share KVM templates between Proxmox nodes. Therefore, you need to download our KVM templates onto every Proxmox node individually. To make managing this easier, use the same Proxmox VMIDs for every KVM template between Proxmox nodes. For example, if you have a CentOS 7 template, try to make the template VMID the same number on all Proxmox nodes.
 If you followed our recommendation to [[Proxmox_Configuration|assign VMID ranges]] to Proxmox nodes, the VMIDs of your KVM templates should be less than the VMID range.
 * Continuing our example with node1 (VMID range 1000-2999), the KVM template VMIDs on node1 should be less than 1000
-* For node2 (VMID range 3000-4999), the KVM template VMIDs should be less than 3000
+== KVM Templates - Admin ==
 In the ProxCP KVM Templates Admin menu, you can set the template VMID on a per-node level. It is possible that the same KVM template will have a different VMID on different Proxmox nodes.
-As of writing, all ProxCP Linux KVM templates support Cloud-Init. The ProxCP Windows KVM templates do not support Cloud-Init.
+As of writing, all ProxCP Linux KVM templates support Cloud-Init.
+This page allows Admins to delete KVM templates from ProxCP. This action only removes the template from ProxCP and does not remove the template VM from the Proxmox node.
 == KVM Templates Installation ==
-* Download the desired template from our distribution site to your Proxmox server (i.e. wget)
+* Download the desired template from our [https://templates.proxcp.com distribution site] to your Proxmox server (i.e. wget)
 * Run the following command on your Proxmox server
-  qmrestore {template file}.vma.lzo {VMID}
+  qmrestore {template file} {VMID}
+The restored VM should appear in Proxmox as a template with all correct settings already. Then, add the template in ProxCP.
+== Creating Your Own KVM Templates ==
+[[Creating Your Own ProxCP KVM Templates]]
+== Proxmox VE 5.x Notes ==
+* You may need to delete and re-create the cloud-init drive depending on the Proxmox VMID you chose.
+== Proxmox VE 6.x Notes ==
-The restored VM should appear in Proxmox as a template with all correct settings already. You may need to delete and re-create the cloud-init drive depending on the Proxmox VMID.
+* The qmrestore command will fail in Proxmox 6.x unless template files are named a specific way.
+ Example: centos-7-amd64.vma.lzo must be renamed to vzdump-qemu-200-2020_06_10-10_00_00.vma.lzo
+ Required format: vzdump-qemu-{vmid}-{year}_{month}_{day}-{HH}_{MM}_{SS}.vma.lzo
+* The VMID in the vzdump file name and the qmrestore command must match