Installing the virtual appliance by using KVM

Edit online

The use of a Kernel-based virtual machine or KVM is supported. You can use KVM with the provided .iso image to run the virtual appliance.

Procedure

  1. Create a new virtual machine.
    Note:
    • The instructions for creating a virtual machine might differ based on the utility that you are using to manage your virtual machines. See the KVM documentation that suits your version for specific instructions.
    • For the latest list of supported hypervisors and host operating systems, see Software Product Compatibility Reports.
    • Ensure that the virtual machine's CPU model supports x86-64-v2. In some environments, the default CPU model selected is qemu64, which is not suitable. For a list of CPU models and their supported compatibility levels, refer to the QEMU documentation.
    • Ensure that the virtual machine has sufficient disk space allocated to store configuration and log file data for the appliance. Allocate at least 100 GB of disk space.
    • The memory size has influence over how many Reverse Proxy instances can be created and how many sessions can be active at a single point in time. The minimum memory size is 4096 MB.
    • A virtual appliance must have a minimum of one and a maximum of eight network adapters.
    • Each network adapter must be of the type E1000 or Virtio. Use Virtio for better performance.
    • The hard disk drive must be configured as a Virtio disk device.
    • If you use certain versions of the Virtual Machine Manager (virt-manager) software to create your virtual machines, it might by default add some CPU definitions that are incompatible with the appliance and thus cause deployment errors. To fix this issue, you can use one of the following methods:
      • From the Virtual Machine Manager console, open the VM definition. Go to Processor. Expand the Configuration option and then change the value of the Model field to Clear CPU configuration. Click Apply.
      • From the virsh shell, edit the virtual machine definition (for example, edit isva_appliance). Locate and then remove the <cpu>...</cpu> entry. Save the file.
  2. Configure the virtual machine to boot from the .iso file, and then start the virtual machine.
    • To run the installer in silent mode, wait 10 seconds or press Enter. After the silent installation completes, the virtual machine is shut down automatically. If you want to continue with setting up the appliance, restart the virtual machine.
    • To run the installer in interactive mode, enter interactive and then press Enter.
      Note: If the hard disk that is attached to the virtual machine already contains a Linux partition, the installer always runs in interactive mode.
      1. Enter YES to proceed with the installation. If you do not want to proceed, enter NO to return to the restart prompt.
      2. Examine the installation messages to ensure that the installation was successful. After the installation process is complete, unmount the installation media and then press Enter to reboot the appliance.
  3. When the restart operation is complete, you can start the console-based appliance setup wizard by logging on as the admin user with a password of admin. Alternatively, the Appliance Setup wizard can be accessed through the local management interface.