Before you deploy the Virtual Appliance, ensure that:

• The NTP service is enabled to synchronize time across hypervisors.

  $ timedatectl status
                 Local time: Thu 2024-10-03 22:36:06 UTC
             Universal time: Thu 2024-10-03 22:36:06 UTC
                   RTC time: Thu 2024-10-03 22:36:06
                  Time zone: Etc/UTC (UTC, +0000)
  System clock synchronized: yes
                NTP service: active
            RTC in local TZ: no

• The KVM is enabled in the server.

  $ kvm-ok
  INFO: /dev/kvm exists
  KVM acceleration can be used

• The bridged device is available. Make a note of the device name to specify in the config.cfg file in a later step.

For more information, see Installing Ubuntu Server Considerations in Readme.md.

The custom scripts uses the configuration specified in the config.cfg file. Update and verify the configuration in the config.cfg file. This file includes the following parameters:

Exampleconfig.cfgscript

## libvirt/kvm host user with virt permissions
DEPLOY_ID=${USER}   ## defaults to current user

## Libvirt directory storage pool name
# Storage pool parameters
STORAGE_POOL="appdva-storage"         # node-local directory
STORAGE_PATH="/data/${STORAGE_POOL}"  # path to local storage on each node

# Network parameters (kvm phys host VM bridge name)
BRIDGE_NAME=<Name of the Bridge Network>

# Physical libvirt hypervisor IPs
# used for virsh remote connections:
#   VIRT_CONNECTION_URL="qemu+ssh://${DEPLOY_ID}@${HOSTIP}/system"
# enabling remote operations on different physical libvirt nodes
#
LIBVIRT_HOST_SELF="10.0.0.1" # specify the primary node here 
LIBVIRT_HOST_PEERS=(
    "10.0.0.2"
    "10.0.0.3"
)
# LIBVIRT_HOST_PEERS=( )

## VM Network parameters
VM_CLUSTER_NAME="libvirt1"
# these CIDR values change with the cluster name, consult the wiki
VM_CIDRS=(
    "10.0.0.11/20"
    "10.0.0.12/20"
    "10.0.0.13/20"
)
VM_GATEWAY=10.x.x.x
VM_DNS=10.x.x.x
VM_HOSTNAME_PREFIX="appdva-${VM_CLUSTER_NAME}-vm"
VM_NAME_PREFIX="${DEPLOY_ID}-${VM_HOSTNAME_PREFIX}"

## VM size parameters
# profile=small
NUM_VMS=3
VM_VCPUS=16
VM_MEMORY_GB=64
VM_OS_DISK_GB=200
VM_DATA_DISK_GB=500

Run the scripts in the given order to deploy virtual machines in KVM.

1. Set Up the Hypervisor

2. Run the Cluster

3. Verify the Cluster Status

Set Up the Hypervisor

Run 01-prepare-hypervisor.sh to set up the hypervisor. This script:

• Installs required packages for deploying Virtual Appliance:

  cloud-image-utils, cpu-checker, libvirt-clients, libvirt-daemon, libvirt-daemon-driver-qemu, libvirt-daemon-system, jq, ovmf, virtinst, virt-viewer, qemu-system-x86 qemu-block-extra, qemu-utils, numad, numactl, and sysstat

• Adjusts kernel cmdline to host virtual machines.
• Updates the KVM parameters.
• Generates SSH keypair.

Run the Cluster

Run the run-cluster command. This script:

• Creates a three-node cluster using the virtual machines.
• Configures the storage in each node in the cluster.
• Enables libvirt to manage the storage directory for creating images for the virtual machines.

Verify the Cluster Status

If you decide to clean up storage and virtual machines, you can run the following scripts for those tasks: