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

@@ -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.

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