From edc671c576ce328645be4f8483c69682a59f416e Mon Sep 17 00:00:00 2001 From: amarcine Date: Mon, 21 Oct 2024 20:16:28 +0200 Subject: [PATCH] Add howto for CML on Nutanix and Proxmox (#49) * add howto for nutanix and proxmox * moved howto to new documentation folder --- documentation/cml_on_nutanix.md | 34 +++++++++++++++++++++++ documentation/cml_on_proxmox.md | 49 +++++++++++++++++++++++++++++++++ 2 files changed, 83 insertions(+) create mode 100644 documentation/cml_on_nutanix.md create mode 100644 documentation/cml_on_proxmox.md diff --git a/documentation/cml_on_nutanix.md b/documentation/cml_on_nutanix.md new file mode 100644 index 0000000..ab57376 --- /dev/null +++ b/documentation/cml_on_nutanix.md @@ -0,0 +1,34 @@ +### CML on Nutanix CE + +##### Requirements: +- Installed and configured Nutanix CE node (or cluster) from https://www.nutanix.com/uk/products/community-edition +- Downloaded CML installation ISO/OVA and refplat ISO image + +##### Install CML from ISO +- Upload install and refplat ISOs to datastore. Go to Settings and Image Configuration. Select correct storage container (Images in our case) and other details and click Save. +- Wait until upload task is completed. +- Go to Settings/VM and click 'Create VM'. Fill name of VM, select number of vCPUs, cores, memory. +- Switch BIOS Configuration to UEFI. If you need secure boot, switch cdrom from IDE to SATA. +- Update cdrom settings and insert CML iso there: +- Add new disk, select correct storage container (VMs in our case) +- Add also at least one NIC +- Save VM, open ssh connection to CVM and enable nested virtualization on CML VM: +```shell +nutanix@NTNX-d295a2f4-A-CVM:10.0.10.90:~$ acli vm.list +VM name VM UUID +cml-ova-import-test b7854f03-3117-453e-9221-2611eefe0b94 +cml-test-2.8.0dev e56f7e8d-a663-4826-b128-8e98ba8f1c84 +ova-cml-test a1dce5ed-5d12-4096-a48f-293c35837f88 +ubuntu-test-vm d5c8d107-d58f-4d6f-a585-77ef494cf2a5 +nutanix@NTNX-d295a2f4-A-CVM:10.0.10.90:~$ acli vm.update cml-test-2.8.0dev cpu_passthrough=true +cml-test-2.8.0dev: pending +cml-test-2.8.0dev: complete +``` +- Power on VM and launch VM console. Proceed with CML setup. Insert refplat ISO to cdrom when needed. + +##### Installing CML from OVA: +In Nutanix CE, there is no option how to import OVA, you need Prism central from paid version. There should be OVA import feature in GUI - more info is here: https://portal.nutanix.com/page/documents/kbs/details?targetId=kA03200000099TXCAY + +In Nutanix CE, untar OVA file and upload vmdk disk into image storage container. +When creating VM, just use 'Clone from Image Service'. +Everything else is same as when installing from ISO. diff --git a/documentation/cml_on_proxmox.md b/documentation/cml_on_proxmox.md new file mode 100644 index 0000000..ad108cc --- /dev/null +++ b/documentation/cml_on_proxmox.md @@ -0,0 +1,49 @@ +### CML on Proxmox + +##### Requirements: +- Installed and configured Proxmox node (or cluster) from https://www.proxmox.com/en/downloads +- Downloaded CML installation ISO/OVA and refplat ISO image + +##### Install CML from ISO + +- Import install and refplat ISOs via GUI (Folder View / Storage / local storage / ISO images / Upload or Download from URL) +If upload is not working (wrong file extension error), copy ISO files to /var/lib/vz/template/iso/ (or any other ISO compatible storage) on Proxmox host via shell. +- Start creating new VM +- General tab + - fill VM name +- OS tab + - switch storage to one where ISOs were uploaded + - select CML install ISO from ISO image dropdown +- System tab + - select VirtIO SCSI single controller + - switch BIOS to OVMF (UEFI) + - select some storage for EFI disk +- Disks tab + - set disk size to at least 32GB +- CPU tab + - set needed number of Sockets and Cores + - CPU type must be set to 'host' to support nested virtualization +- Memory tab + - set amount of memory +- Network tab + - choose correct network/MTU etc for first interface (if more interfaces are needed, they must be added after VM creation via Hardware / Add / Network Device option) + +Finish VM creation. Start VM and follow install instructions. Switch install iso for refplat when needed. + +##### Install CML from OVA + +- Import reflat ISO via GUI (Folder View / Storage / local storage / ISO images / Upload or Download from URL) +If upload is not working (wrong file extension error), copy ISO file to /var/lib/vz/template/iso/ (or any other ISO compatible storage) on Proxmox host via shell. +- Copy OVA file to folder for example /var/lib/vz/template/ova/ on Proxmox host. +- Unzip OVA with 'tar -xf cml2_2.7.0-5_amd64-21.ova' command. +- From /var/lib/vz/template/ova/ run import commad: `qm importovf 107 cml2_2.7.0-5_amd64-21_SHA256.ovf local-lvm`. 107 is VM id, choose some not used already, and local-lvm is VMs storage. +- Go to Proxmox GUI and open newly created VM (id 107 in our case). +- Edit HW of VM: + - switch BIOS to OVMF (UEFI) + - add new HW 'EFI disk' + - set processor type to 'host' + - change SCSI controller to 'VirtIO SCSI single' + - add Network Device and set model to 'VirtIO Paravirtualized' (add more NICs if needed) + - add CD/DVD Drive and select appropriate storage and iso image + +Boot VM and complete CML installaion