Automated CloudVision on KVM Deployment

This deployment script targets the following use cases for CloudVision Portal:

• Baremetal installation
• VM specs outside of provided KVM image (especially HDD)

The installation is fully automated and parameterized. It can either use local available files or download them from the appropriate sources.

Compatibility

Host Operating System

Distribution	Version
Alma Linux	8.3
CentOS	7.9
CentOS	8.3
Debian	10 (buster)
Fedora	32
Red Hat Enterprise Linux	7.9
Red Hat Enterprise Linux	8.3

CloudVision Portal

Product	Version	CentOS
CloudVision Portal	2020.2.x	7.7.1908
CloudVision Portal	2020.3.x	7.7.1908
CloudVision Portal	2021.1.x	7.7.1908
CloudVision Portal	2021.2.x	7.9.2009

Parameters

Credentials

Username	Password
root	cvpadmin

IMPORTANT

Please change root password after first boot!

Network Configuration

Option	Parameter	Example	Required	Description
--network			Yes	Enables network configuration mode
--host-nic	Device name	ens192	Yes	NIC of the hypervisor (management)
--ip	IPv4 address/CIDR	192.168.0.10/24	No	IP of the hypervisor (management) (only if --host-nic and --libvirt-nic are identical)
--gw	IPv4 address	192.168.0.1	No	Gateway of the hypervisor (management) (only if --host-nic and --libvirt-nic are identical)
--dns	IPv4 address	192.168.0.1	No	Name server of the hypervisor (management) (only if --host-nic and --libvirt-nic are identical)
--host-vlan	VLAN ID	2000	No	Tagged VLAN for --host-nic (default: untagged)
--libvirt-nic	Device name	ens192	Yes	NIC used to bridge CVP VM (can be identical to --host-nic)
--libvirt-bridge	Device name	cvpbr0	No	Name of bridge for CVP VM (default: cvpbr0)
--libvirt-vlan	VLAN ID	1000	No	Tagged VLAN for --host-nic (default: untagged)

IMPORTANT

The host NIC configuration will only be touched, if --host-nic and --libvirt-nic are identical! Otherwise only libvirt-related configuration will be taken into account.

Example

./deploy.sh 
    --network \
    --host-nic ens192 \
    --ip 192.168.0.10/24 \
    --gw 192.168.0.1 \
    --dns 1.1.1.1 \
    --libvirt-nic ens192

./deploy.sh 
    --network \
    --host-nic ens32 \
    --libvirt-nic ens160

./deploy.sh 
    --network \
    --host-nic ens32 \
    --ip 192.168.0.10/24 \
    --gw 192.168.0.1 \
    --dns 1.1.1.1 \
    --host-vlan 1000 \
    --libvirt-nic ens32 \
    --libvirt-vlan 1000

./deploy.sh 
    --network \
    --host-nic ens32 \
    --libvirt-nic ens160
    --libvirt-vlan 1000

VM Configuration

Option	Parameter	Example	Required	Description
--vm			Yes	Enables VM configuration mode
--centos	download or local file	/tmp/CentOS.iso	Yes	Downloads CentOS image or uses locally specified file
--cloudvision	download or local file	/tmp/cvp-rpm-installer-2020.3.0	Yes	Downloads CVP installer or uses locally specified file
--version	CVP version	2020.3.0	Yes	Specifies CVP version
--install-cmd	Installer command	/tmp/cvp-rpm-installer-2020.3.0 --install --demo	Yes	Specifies command to run to start the installer
--apikey	API key from arista.com	xxxxxxxxxxxxxxxxxxxxxxxxx	No	API key for CVP download from arista.com (only if --cloudvision download)
--libvirt-bridge	Device name	cvpbr0	No	Name of bridge for CVP VM (default: cvpbr0)
--cpu	VM CPUs	8	Yes	Amount of CPUs in VM (Minimum: 8)
--memory	VM memory in GB	32	Yes	Amount of memory in VM (Minimum: 16)
--rootsize	VM disk size in GB	50	Yes	Disk size for root file system (Minimum: 35)
--datasize	VM disk size in GB	700	Yes	Disk size for data file system (Minimum: 110)
--vm-fqdn	Hostname + domain name	cvp.test.local	Yes	Hostname + domain name for CVP VM
--ip	IP address/CIDR	192.168.0.11/24	Yes	IP address of CVP VM
--gw	IP address	192.168.0.1	Yes	Gateway of CVP VM
--dns	IP address	192.168.0.1	Yes	Name server of CVP VM
--ntp	IP address/FQDN	pool.ntp.org	Yes	NTP server of CVP VM

Example

./deploy.sh 
    --vm \
    --centos download \
    --cloudvision download \
    --version 2020.3.0 \
    --install-cmd "/tmp/cvp-rpm-installer-2020.3.0 --install --demo" \
    --apikey xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
    --cpu 14 \
    --memory 28 \
    --rootsize 35 \
    --datasize 110 \
    --vm-fqdn cvp.test.local \
    --ip 192.168.0.11/24 \
    --gw 192.168.0.1 \
    --dns 192.168.0.11 \
    --ntp pool.ntp.org

./deploy.sh 
    --vm \
    --centos /tmp/CentOS-7-x86_64-Minimal-1908.iso \
    --cloudvision download \
    --version 2020.3.0 \
    --install-cmd "/tmp/cvp-rpm-installer-2020.3.0 --install --demo" \
    --apikey xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
    --cpu 8 \
    --memory 16 \
    --rootsize 50 \
    --datasize 110 \
    --vm-fqdn cvp.test.local \
    --ip 192.168.0.11/24 \
    --gw 192.168.0.1 \
    --dns 192.168.0.11 \
    --ntp pool.ntp.org

./deploy.sh 
    --vm \
    --centos /tmp/CentOS-7-x86_64-Minimal-1908.iso \
    --cloudvision /tmp/cvp-rpm-installer-2020.3.0 \
    --version 2020.3.0 \
    --install-cmd "/tmp/cvp-rpm-installer-2020.3.0 --install --demo" \
    --cpu 8 \
    --memory 16 \
    --rootsize 50 \
    --datasize 110 \
    --vm-fqdn cvp.test.local \
    --ip 192.168.0.11/24 \
    --gw 192.168.0.1 \
    --dns 192.168.0.11 \
    --ntp pool.ntp.org

Option	Parameter	Example	Required	Description
--vm-cleanup			Yes	Deletes disk files and removes VM

Example

./deploy.sh
    --vm-cleanup

Additional information

Fedora 32

On Fedora 32 in a nested virtualization environment (Fedora 32 under ESX 6.5 -> Creating KVM VM for CentOS 7.7 (CloudVision)) an issue had been encountered, which required updating a parameter in GRUB to disable MSR in KVM.

The issue encountered manifests like the following during the installation/start of the VM:

qemu-system-x86_64: error: failed to set MSR 0x38d to 0x0
qemu-kvm: error: failed to set MSR 0x48e ...

To mitigate this issue, edit /etc/default/grub and append the following statement to the GRUB_CMDLINE_LINUX constant:

kvm.ignore_msrs=1

As an example the result could look like this:

GRUB_CMDLINE_LINUX="console=ttyS0 console=ttyS0,115200n81 no_timer_check crashkernel=auto rhgb quiet kvm.ignore_msrs=1"

Afterwards update your grub configuration and reboot the hypervisor:

grub2-mkconfig -o "$(readlink -e /etc/grub2.conf)"

To verify if the fix is active, it shoudl look like this:

[root@fedora32 ~]# cat /sys/module/kvm/parameters/ignore_msrs
Y